@johnmorrisdotca/kyogijo-stadiums 0.4.0 → 0.6.0

package/dist/draw.js

@@ -1,22 +1,52 @@
 import { ballparkDrawn, ballparkFor, ballparkSentences } from "./ballpark.js";
-import { inkOn, safeColour, safeLogo } from "./colour.js";
+import { inkOn, safeColour } from "./colour.js";
+import { withEmblems } from "./emblems-source.js";
+import { safeLogo } from "./logo.js";
 import { drawingId, feetFence, isPortrait, lengthUnit, safeClass } from "./common.js";
 import { el, esc, num } from "./format.js";
+import { fieldAttributes } from "./field.data.js";
 import { ERA_SPORTS, footballIn, rulesFor, seasonLabel } from "./eras.js";
 import { FOOTBALL } from "./geometry.js";
 import { renderLayers } from "./layers.js";
+import { arenaById, arenaCourtIn, arenaNameIn, arenaOfficialName, arenaRinkIn } from "./arenas.js";
 import { groundById, groundNameIn, groundOfficialName } from "./grounds.js";
-import { courtFor, isNetSport } from "./court.js";
+import { BOARD, courtFor, hasSetsBoard, isNetLeague, isNetSport } from "./court.js";
 import { cricketBoardMarkup } from "./cricket.board.js";
+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 { dojoSpecOf } from "./budo/dojo.js";
+import { dojoGallery } from "./budo/room.js";
+import { budoAbout, budoScoreSentences, budoSentences } from "./budo/describe.js";
+import { lookOf as budoLookOf } from "./budo/looks.js";
+import { kimariteName } from "./budo/kimarite.js";
+import { budoScoreText, budoView } from "./budo.score.js";
+import { KYOGIJO_BUDO_GALLERY_STYLE, budoStyle } from "./budo.style.js";
+import { budoBoardMarkup } from "./budo.board.js";
+import { budoSurface } from "./surfaces/budo.js";
+import { skatingSurface } from "./surfaces/skating.js";
+import { athleticsAbout, athleticsSentences } from "./athletics/describe.js";
+import { athleticsStyle, athleticsTrackRules } from "./athletics.style.js";
+import { athleticsSurface, pitchGroup } from "./surfaces/athletics.js";
 import { fieldPlan, isFieldSport } from "./fields.js";
 import { fieldScoreText, fieldTotal } from "./field.score.js";
 import { fieldsStyle } from "./fields.style.js";
 import { resolveHomeSide } from "./homeside.js";
 import { LEAGUES, chooseLeague, courtOf, diamondOf, fieldOf, hasHistory, leagueSeason, leagueSize, netOf, rinkOf, sheetOf } from "./leagues.js";
-import { diamondFence } from "./leagues/baseball.js";
-import { fenceFor, parkById, parkNameIn, parkOfficialName } from "./parks.js";
+import { MLB_DIAMOND, diamondFence } from "./leagues/baseball.js";
+import { fenceFor, parkById, parkNameIn, parkOfficialName, parkWallsIn } from "./parks.js";
 import { boardMarkup, endText } from "./curling.board.js";
 import { sheetFor } from "./sheet.js";
+import { commonOf, isPoolSport, swimPlan, poloPlan, divePlan, artisticPlan } from "./pool.js";
+import { natatorium } from "./surfaces/venue.js";
+import { poolDescription } from "./pool.words.js";
+import { KYOGIJO_POOL_STYLE, poolStyle } from "./pool.style.js";
+import { swimming } from "./surfaces/pool.js";
+import { waterPolo } from "./surfaces/polo.js";
+import { diving } from "./surfaces/dive.js";
+import { artistic } from "./surfaces/artistic.js";
 import { cropToRange, describeRange, rangeLabel, shows } from "./ranges.js";
 import { badgeMarkup, bannerMarkup, plateMarkup, stateOf } from "./score.js";
 import { setsBoardMarkup } from "./sets.board.js";
@@ -24,19 +54,32 @@ import { KYOGIJO_STRINGS, fill } from "./strings.js";
 import { courtStyle } from "./courts.style.js";
 import { annotate, annotated, wideView } from "./annotate.js";
 import { KYOGIJO_BACKGROUND_STYLE, laidOn } from "./background.js";
+import { KYOGIJO_HARDWOOD_STYLE, resolveHardwood } from "./hardwood.js";
+import { WALL_SEATS, densityOf, layoutOf as crowdLayout, resolveCrowd } from "./crowd.js";
+import { drawCrowd, KYOGIJO_CROWD_STYLE } from "./crowd.draw.js";
+import { parkLayout } from "./crowd.park.js";
 import { featureColours, featureStyle } from "./features.js";
 import { isLook, lookStyle } from "./look.js";
 import { lineLook, restyleLines } from "./restyle.js";
 import { KYOGIJO_MARK_STYLE } from "./mark.js";
-import { KYOGIJO_BASE_STYLE, KYOGIJO_CURLING_STYLE, KYOGIJO_NOTE_STYLE, KYOGIJO_WALLS_STYLE } from "./style.js";
+import { readSituation, situationSentences } from "./situation.js";
+import { badgeSituation, drawSituation } from "./situation.draw.js";
+import { KYOGIJO_SITUATION_STYLE } from "./situation.style.js";
+import { outlineOf } from "./outline.js";
+import { autoScore, pageantLayout, pageantOf, ratioOf } from "./pageant.js";
+import { emblemMarkup, picturesMarkup } from "./pageant.draw.js";
+import { KYOGIJO_PAGEANT_MOTION, KYOGIJO_PAGEANT_STYLE } from "./pageant.style.js";
+import { KYOGIJO_BASE_STYLE, KYOGIJO_CURLING_STYLE, KYOGIJO_FOLD_STYLE, KYOGIJO_NOTE_STYLE, KYOGIJO_WALLS_STYLE } from "./style.js";
 import { convertLength } from "./units.js";
-import { baseball } from "./surfaces/baseball.js";
+import { baseball, fenceOutline } from "./surfaces/baseball.js";
 import { curling } from "./surfaces/curling.js";
 import { netCourt } from "./surfaces/net.js";
 import { fieldSurface } from "./surfaces/field.js";
 import { basketball } from "./surfaces/basketball.js";
 import { football } from "./surfaces/football.js";
 import { hockey } from "./surfaces/hockey.js";
+import { NHL_RINK } from "./leagues/hockey.js";
+import { NBA_COURT } from "./leagues/basketball.js";
 import { soccer } from "./surfaces/soccer.js";
 import { frameMatrix, layoutFromFrame, resolveFrame } from "./surfaces/soccer-providers.js";
 import { composeSpecial, hostSport } from "./special.js";
@@ -47,7 +90,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", "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", "lacrosse", "rugby", "afl", "gaelic", "cricket", "fieldhockey", "handball"];
 /** The CSS custom property each colour of `Colors` sets. */
 export const COLOR_PROPERTIES = {
     apron: "--ky-apron",
@@ -90,7 +133,8 @@ const isScore = (o) => o.home !== undefined && o.away !== undefined;
 function minSets(sport, league) {
     if (sport === "volleyball")
         return league === "fivb-beach" ? 3 : 5;
-    return sport === "tabletennis" ? 5 : 3;
+    // Table tennis, squash (World Squash Singles Rules 2.3) and racquetball (IRF Rule 1.5) are played to the best of five games.
+    return sport === "tabletennis" || sport === "squash" || sport === "racquetball" ? 5 : 3;
 }
 /** The standard statuses, spelled out. */
 const FINAL = /^(?:final|f\b|ft\b|試合終了|終了)/i;
@@ -139,8 +183,8 @@ export function winnerOf(o) {
     const mode = o.winner ?? "auto";
     if (mode === "home" || mode === "away" || mode === "none")
         return mode;
-    const h = fieldTotal(o.sport, o.home) ?? numeric(o.home.score);
-    const a = fieldTotal(o.sport, o.away) ?? numeric(o.away.score);
+    const h = fieldTotal(o.sport, o.home) ?? numeric(o.home.score) ?? (o.sport === undefined ? undefined : numeric(budoScoreText(o.sport, o.home)));
+    const a = fieldTotal(o.sport, o.away) ?? numeric(o.away.score) ?? (o.sport === undefined ? undefined : numeric(budoScoreText(o.sport, o.away)));
     if (h === undefined || a === undefined)
         return "none";
     if (mode === "auto" && !(o.status !== undefined && FINAL.test(o.status.trim())))
@@ -177,7 +221,7 @@ const safeLength = (value) => {
 const PATTERNS = ["bands", "wide", "narrow", "lengthwise", "checks", "diagonal", "circles", "rings", "fan", "none"];
 const GOALS = ["box", "line", "strip", "none"];
 /** The pitch the options ask for: a `pitch` of the caller's, else the size a `ground` publishes, else none (the international pitch). */
-function pitchOf(o) {
+export function pitchOf(o) {
     if (o.pitch !== undefined)
         return o.pitch;
     const ground = groundById(o.ground);
@@ -199,10 +243,35 @@ function buildSoccer(o, common, scored, unit) {
         frame: frame === undefined ? undefined : { id: frame.id, matrix: frameMatrix(frame, spec) },
     }, common);
 }
+/** The athletics stadium: its plan, with the soccer pitch laid inside the track as the soccer builder draws it. */
+function buildAthletics(o, common) {
+    const plan = athleticsPlan({ ...o, detail: common.detail });
+    let embedded;
+    if (plan.pitch !== undefined) {
+        const spec = plan.pitch.spec;
+        const goals = common.goals ?? "box";
+        const pitch = soccer({ spec, layout: layoutOf(spec), half: undefined, pattern: "bands", goals, flags: common.detail === "full", frame: undefined }, { ...common, portrait: false, margin: 0, score: false, landmarks: false, id: `${common.id}-pitch` });
+        embedded = { base: pitchGroup(pitch.base), lines: pitch.lines, defs: pitch.defs };
+    }
+    // A cropped view has less ground round it than the stadium whole.
+    return athleticsSurface(common, plan, embedded, common.margin ?? (o.range === undefined ? 20 : 5));
+}
+/** The skating rink: its plan, drawn as it lies. */
+function buildSkating(o, common) {
+    const plan = skatingPlan({ ...o, detail: common.detail });
+    return skatingSurface(common, plan, common.margin ?? (o.range === undefined ? 20 : 5));
+}
+/** 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));
+}
+/** One text for both ends or sides, or a pair of them. */
+const pair = (text) => (text === undefined ? undefined : typeof text === "string" ? [text, text] : text);
 /** The surface the options ask for, whole: before it is cropped to a `range`. */
 function buildWhole(o, portrait, id, score, scored, extra) {
     const court = o.court;
-    const baselineText = court?.baselineText === undefined ? undefined : typeof court.baselineText === "string" ? [court.baselineText, court.baselineText] : court.baselineText;
+    const baselineText = pair(court?.baselineText);
     const unit = lengthUnit(o);
     const common = {
         portrait,
@@ -212,12 +281,13 @@ function buildWhole(o, portrait, id, score, scored, extra) {
         stripes: o.stripes !== false,
         id,
         score,
-        court: { baselineText, centreLogo: safeLogo(court?.centreLogo), paintThreePoint: court?.paintThreePoint },
+        court: { baselineText, centreLogo: safeLogo(court?.centreLogo), paintThreePoint: court?.paintThreePoint, hardwood: resolveHardwood(court, o.detail === "simple", o.width), sidelineText: pair(court?.sidelineText) },
         features: extra.features,
         mow: PATTERNS.includes(o.stripePattern) ? o.stripePattern : undefined,
         goals: GOALS.includes(o.goals) ? o.goals : undefined,
         goalMarkup: typeof o.goalMarkup === "function" ? o.goalMarkup : undefined,
         landmarks: o.landmarks === true,
+        pageant: extra.pageant === true ? true : undefined,
     };
     // A league's rulebook (`league`), else the markings of the season asked for (`year`), today's without one.
     const { sport, league } = chooseLeague(o);
@@ -232,10 +302,19 @@ function buildWhole(o, portrait, id, score, scored, extra) {
             const season = rulesFor(sport, o.year).rules;
             return football(footballIn(sport, o.year), common, { hashMarks: season.hash !== null, postShape: season.postShape });
         }
-        case "nhl":
+        case "nhl": {
+            // An arena's rink is the size its sources publish, with the markings of the season asked for; an arena with none published has the NHL's.
+            const sized = league === undefined ? arenaRinkIn(arenaById(o.arena), o.year) : undefined;
+            if (sized !== undefined)
+                return hockey(common, rulesFor("nhl", o.year).rules, { ...NHL_RINK, length: sized.length, width: sized.width });
             return league?.family === "hockey" ? hockey(common, undefined, rinkOf(league, o.year)) : hockey(common, rulesFor("nhl", o.year).rules);
-        case "nba":
+        }
+        case "nba": {
+            const sized = league === undefined ? arenaCourtIn(arenaById(o.arena), o.year) : undefined;
+            if (sized !== undefined)
+                return basketball(common, rulesFor("nba", o.year).rules, { ...NBA_COURT, length: sized.length, width: sized.width });
             return league?.family === "basketball" ? basketball(common, undefined, courtOf(league, o.year)) : basketball(common, rulesFor("nba", o.year).rules);
+        }
         case "mlb": {
             if (league?.family === "baseball") {
                 const diamond = diamondOf(league, o.year);
@@ -248,14 +327,33 @@ function buildWhole(o, portrait, id, score, scored, extra) {
         case "curling": {
             const plan = sheetFor(o);
             // A score always shows the whole sheet, for the board's sake.
-            return curling(common, { pebble: plan.pebble, guardZone: plan.guardZone, show: scored ? "sheet" : plan.show, end: plan.end, figures: plan.spec });
+            const words = KYOGIJO_STRINGS[o.language === "ja" ? "ja" : "en"].ranges.folded;
+            const labels = portrait ? [words.top, words.bottom] : [words.left, words.right];
+            return curling(common, { pebble: plan.pebble, guardZone: plan.guardZone, show: scored ? "sheet" : plan.show, end: plan.end, figures: plan.spec, fold: { panels: plan.panels, fit: plan.fit, labels } });
         }
         case "tennis":
         case "volleyball":
         case "badminton":
         case "pickleball":
         case "tabletennis":
+        case "padel":
+        case "squash":
+        case "racquetball":
+        case "sepaktakraw":
+        case "teqball":
+        case "roundnet":
+        case "netball":
             return netCourt(common, courtFor({ ...o, sport }));
+        case "swimming":
+            if (o.pool?.venue !== undefined)
+                return natatorium(common, o.pool, commonOf(o.pool), o.language === "ja" ? "ja" : "en");
+            return swimming(common, swimPlan({ ...o, sport }));
+        case "waterpolo":
+            return waterPolo(common, poloPlan(o));
+        case "diving":
+            return diving(common, divePlan(o));
+        case "artisticswimming":
+            return artistic(common, artisticPlan(o));
         case "lacrosse":
         case "rugby":
         case "afl":
@@ -264,18 +362,103 @@ function buildWhole(o, portrait, id, score, scored, extra) {
         case "fieldhockey":
         case "handball":
             return fieldSurface(common, fieldPlan({ ...o, sport, detail: common.detail }), { goals: common.goals });
+        case "athletics":
+            return buildAthletics({ ...o, sport }, common);
+        case "skating":
+            return buildSkating({ ...o, sport }, common);
+        case "judo":
+        case "karate":
+        case "kendo":
+        case "sumo":
+        case "kyudo":
+        case "dojo":
+            return buildBudo({ ...o, sport }, common);
         default:
             throw new Error(`Unknown sport "${String(o.sport)}": use one of ${SPORTS.join(", ")}`);
     }
 }
+/**
+ * The crowd the options ask for, or `undefined` for none: a special game has none, and nor has a folded curling sheet (its houses are enlarged over where the stands would be, so the
+ * stands would show only as strips behind the panels). A score on a curling sheet shows the whole sheet, which has its stands.
+ */
+function crowdOf(o) {
+    if (o.host !== undefined)
+        return undefined;
+    if (chooseLeague(o).sport === "curling" && !isScore(o) && sheetFor(o).show === "folded")
+        return undefined;
+    return resolveCrowd(o.crowd);
+}
 /** The surface the options ask for, cropped to their `range` when they have one (a curling sheet's named ranges are its builder's own: `sheet.show`). */
 function buildSurface(o, portrait, id, score, scored, extra) {
-    const surface = buildWhole(o, portrait, id, score, scored, extra);
+    const crowd = crowdOf(o);
+    const surface = crowd === undefined ? buildWhole(o, portrait, id, score, scored, extra) : buildCrowded(o, portrait, id, score, scored, extra, crowd);
     // A score on a curling sheet shows all of it, for the board's sake.
     if (o.range === undefined || (scored && chooseLeague(o).sport === "curling"))
         return surface;
+    // A close-up of a start is the athletics builder's own view, turned to the start's line.
+    if (chooseLeague(o).sport === "athletics" && rangeLabel(o) === "start")
+        return surface;
     const given = typeof o.margin === "number" && Number.isFinite(o.margin) && o.margin >= 0 ? convertLength(o.margin, lengthUnit(o), "ft") : undefined;
-    return cropToRange(surface, o, { id, margin: extra.room ?? extra.margin ?? given, panel: score });
+    return cropToRange(surface, o, { id, margin: extra.room ?? extra.margin ?? given ?? surface.crowdMargin, panel: score });
+}
+/** The fence of the ballpark the options ask for, as the drawing has it, and how far behind home plate the backstop stands. */
+function parkFence(o) {
+    const unit = lengthUnit(o);
+    const { league } = chooseLeague(o);
+    if (league?.family === "baseball") {
+        const diamond = diamondOf(league, o.year);
+        return { points: fenceFor(parkById(o.park), feetFence(o.fence, unit), o.year, diamondFence(diamond)), backstop: diamond.backstop };
+    }
+    return { points: fenceFor(parkById(o.park), feetFence(o.fence, unit), o.year), backstop: MLB_DIAMOND.backstop };
+}
+/** The stands round a surface, laid out from its box (or, for a ballpark, from its fence). */
+function standsFor(o, surface, crowd) {
+    const { sport } = chooseLeague(o);
+    const awaySide = resolveHomeSide({ ...o, sport }) === "left" ? "right" : "left";
+    if (sport === "mlb") {
+        const { points, backstop } = parkFence(o);
+        // The walls that have seats on top of them: the ones the package knows (Fenway Park's Green Monster), or, asked for, every wall of 25 feet or more.
+        const park = parkById(o.park);
+        const walls = park === undefined || crowd.wallSeats === false ? [] : parkWallsIn(park, o.year).filter((w) => (crowd.wallSeats === true ? w.height_ft >= 25 : w.label !== undefined && WALL_SEATS[park.id] === w.label));
+        return parkLayout({ fence: fenceOutline(points), backstop, crowd, seatsOnWalls: walls.map((w) => ({ from: w.from, to: w.to, height: w.height_ft })) });
+    }
+    // A dojo's crowd sits in its gallery, from the room's balcony data (in feet here); the arenas (the Budokan, the Kokugikan) keep their bowls.
+    const hall = sport === "dojo" ? dojoGallery(o) : undefined;
+    const gallery = hall === undefined ? undefined : { offset: hall.offset / 0.3048, depth: hall.depth / 0.3048, height: [hall.height[0] / 0.3048, hall.height[1] / 0.3048] };
+    return crowdLayout({ sport, box: surface.whole ?? surface.box ?? { x: 0, y: 0, w: 100, h: 100 }, crowd, awaySide, ground: o.ground, arena: o.budo?.hall === "budokan", ...(gallery === undefined ? {} : { gallery }) });
+}
+/** True when the drawing is asked to be small: `detail: "simple"` or a `width` under 480 pixels. */
+const smallDrawing = (o) => {
+    const w = typeof o.width === "number" ? o.width : typeof o.width === "string" && /^\s*\d+(?:\.\d+)?(?:px)?\s*$/.test(o.width) ? parseFloat(o.width) : undefined;
+    return o.detail === "simple" || (w !== undefined && w < 480);
+};
+/** A surface with the stands and the crowd round it: the ground is made as wide as the stands need, then the stands are laid on it under the surface. */
+function buildCrowded(o, portrait, id, score, scored, extra, crowd) {
+    let margin = extra.margin;
+    if (!(typeof o.margin === "number" && Number.isFinite(o.margin) && o.margin >= 0)) {
+        // How much ground the stands need beyond what the surface has with none, then the surface is made again with it.
+        const probe = buildWhole({ ...o, margin: 0 }, portrait, id, score, scored, { ...extra, margin: undefined });
+        const stands = standsFor(o, probe, crowd);
+        const view = wideView(probe);
+        const have = { left: stands.box.x - view.x, right: view.x + view.w - stands.box.x - stands.box.w, top: stands.box.y - view.y, bottom: view.y + view.h - stands.box.y - stands.box.h };
+        const need = Math.max(stands.reach.left - have.left, stands.reach.right - have.right, stands.reach.top - have.top, stands.reach.bottom - have.bottom);
+        margin = Math.max(margin ?? 0, need + 6);
+    }
+    const surface = buildWhole(o, portrait, id, score, scored, { ...extra, margin });
+    const stands = standsFor(o, surface, crowd);
+    const seats = stands.seats;
+    const ground = groundById(o.ground)?.capacity;
+    const fine = crowd.detail === "fine" || (crowd.detail === "auto" && !smallDrawing(o));
+    const first = /^<[^>]*\/>/.exec(surface.base)?.[0] ?? "";
+    const bg = /class="([^"]*)"/.exec(first)?.[1] ?? "ky-apron";
+    // A gallery is sparsely taken unless the options say how full.
+    const taken = stands.gallery === true && crowd.density === undefined && crowd.attendance === undefined ? 0.4 : densityOf(crowd, seats, ground);
+    const drawn = drawCrowd(stands, { id, crowd, density: taken, fine, ground: bg });
+    surface.base = first + drawn.markup + surface.base.slice(first.length);
+    surface.defs += drawn.defs;
+    surface.lines += drawn.over;
+    surface.crowdMargin = margin;
+    return surface;
 }
 /** The custom properties a drawing sets on its root, from the options' colours. */
 function colourStyle(o, teams, features) {
@@ -287,6 +470,13 @@ function colourStyle(o, teams, features) {
     };
     for (const [key, property] of Object.entries(COLOR_PROPERTIES))
         set(property, o.colors?.[key]);
+    // A dojo's own colours (and its era's): the mats, the second tone, the border, the heri, the wood and the walls.
+    if (o.sport === "dojo" && o.dojo !== undefined) {
+        const c = dojoSpecOf(o.dojo).colours;
+        if (c !== undefined)
+            for (const [key, property] of [["mat", "--ky-surface"], ["alt", "--ky-surface-alt"], ["border", "--ky-red"], ["heri", "--ky-bud-heri"], ["floor", "--ky-bud-floor"], ["wall", "--ky-boards"]])
+                set(property, c[key]);
+    }
     if (o.court !== undefined)
         for (const [key, property] of Object.entries(COURT_PROPERTIES))
             set(property, o.court[key]);
@@ -315,6 +505,23 @@ function colourStyle(o, teams, features) {
         props.push(`--ky-left-ink:${leftInk}`);
     if (rightInk !== undefined)
         props.push(`--ky-right-ink:${rightInk}`);
+    // A hardwood floor's border behind each baseline: the court's colour for it, else the team's, else the border's.
+    if (o.court?.hardwood !== undefined && o.court.hardwood !== false) {
+        const ends = pair(o.court.baselineColor);
+        const endLeft = safeColour(ends?.[0]) ?? left;
+        const endRight = safeColour(ends?.[1]) ?? right;
+        if (endLeft !== undefined)
+            props.push(`--ky-hw-end-left:${endLeft}`);
+        if (endRight !== undefined)
+            props.push(`--ky-hw-end-right:${endRight}`);
+    }
+    // The crowd's colours: the home fans in the home team's colour and the visitors in the other's, or the colours the crowd names.
+    const crowd = crowdOf(o);
+    if (crowd !== undefined) {
+        const homeLeft = resolveHomeSide({ ...o, sport: chooseLeague(o).sport }) === "left";
+        props.push(`--ky-cr-home:${safeColour(crowd.home) ?? (homeLeft ? left : right) ?? `var(--ky-${homeLeft ? "left" : "right"})`}`);
+        props.push(`--ky-cr-away:${safeColour(crowd.away) ?? (homeLeft ? right : left) ?? `var(--ky-${homeLeft ? "right" : "left"})`}`);
+    }
     return props.join(";");
 }
 /** The round mark of a team, when its own `mark` or the score's `markShape` asks for one: the fit, the colour of its disc and the ink of its initials. */
@@ -324,17 +531,18 @@ function roundOf(team, markShape) {
         return undefined;
     return { round: true, fit: team.markFit === "contain" ? "contain" : undefined, color: safeColour(team.color), ink: safeColour(team.textColor) };
 }
-function teamView(team, side, role, winner, uppercase, sport, markShape) {
+function teamView(team, side, role, winner, uppercase, sport, markShape, theme) {
     const name = String(team.name ?? "");
-    const written = fieldScoreText(sport, team);
+    const abbr = (team.abbr !== undefined && team.abbr.trim() !== "" ? team.abbr.trim() : abbreviate(name)).slice(0, 5);
+    const written = fieldScoreText(sport, team) ?? budoScoreText(sport, team);
     const score = written ?? (team.score === undefined || team.score === null || String(team.score).trim() === "" ? "–" : String(team.score));
     return {
         side,
         role,
         name: uppercase ? capitals(name) : name,
-        abbr: (team.abbr !== undefined && team.abbr.trim() !== "" ? team.abbr.trim() : abbreviate(name)).slice(0, 5),
+        abbr,
         score,
-        logo: safeLogo(team.logo),
+        logo: safeLogo(team.logo, { color: team.color, accent: team.textColor, initials: abbr.slice(0, 3), theme }),
         ...roundOf(team, markShape),
         state: stateOf(winner, role),
         ends: Array.isArray(team.ends) ? team.ends.map(endText) : undefined,
@@ -345,13 +553,52 @@ function teamView(team, side, role, winner, uppercase, sport, markShape) {
         serving: team.serving === true ? true : undefined,
         wickets: sport === "cricket" && team.wickets !== undefined && team.wickets !== null && String(team.wickets).trim() !== "" ? String(team.wickets).trim().slice(0, 2) : undefined,
         overs: sport === "cricket" && team.overs !== undefined && team.overs !== null && String(team.overs).trim() !== "" ? String(team.overs).trim().slice(0, 6) : undefined,
+        budo: isBudoSport(sport) ? budoView(team.budo) : undefined,
         innings: sport === "cricket" && Array.isArray(team.innings) ? team.innings.map((value) => (typeof value === "number" ? (Number.isFinite(value) ? String(value) : "") : typeof value === "string" ? value.trim().slice(0, 7) : "")) : undefined,
     };
 }
+/** A team as the pageant lays it out. */
+function pageantTeam(view, team) {
+    return { side: view.side, role: view.role, name: view.name, abbr: view.abbr, state: view.state, href: view.logo, fit: team.markFit === "contain" ? "contain" : "cover", ratio: ratioOf(team), color: safeColour(team.color), ink: safeColour(team.textColor) };
+}
+/** True when the drawing is asked to be small: its `width` is under 320 pixels. The pageant then leaves out its fabric, hairlines and name pills. */
+function tiny(width) {
+    const px = typeof width === "number" ? width : typeof width === "string" && /^\d+(?:\.\d+)?(?:px)?$/.test(width.trim()) ? Number.parseFloat(width) : undefined;
+    return px !== undefined && Number.isFinite(px) && px < 320;
+}
+/** The teams that fill the first and the second place of a surface: a diamond's outfield is the visitors' and its infield the home team's, whichever side each is on. */
+function pageantPair(surface, t) {
+    const l = pageantTeam(t.left, t.leftTeam);
+    const r = pageantTeam(t.right, t.rightTeam);
+    return surface.pageant?.byRole === true && l.role === "home" ? [r, l] : [l, r];
+}
+function pageantParts(o, surface, p, t) {
+    const [first, second] = pageantPair(surface, t);
+    const layout = pageantLayout({ pageant: p, surface, outline: outlineOf(o), left: first, right: second, turned: surface.turned, sport: t.sport, plate: t.plate });
+    if (layout === undefined)
+        return undefined;
+    // Cropped to a range, an emblem that does not lie wholly in what is shown is left out.
+    const shown = surface.whole === undefined ? undefined : surface.box;
+    if (layout.emblem !== undefined && shown !== undefined) {
+        const e = layout.emblem;
+        if (e.cx - e.r < shown.x || e.cx + e.r > shown.x + shown.w || e.cy - e.r < shown.y || e.cy + e.r > shown.y + shown.h)
+            delete layout.emblem;
+    }
+    const draw = { id: t.id, turned: surface.turned, simple: o.detail === "simple" || tiny(o.width), parts: t.parts };
+    const pictures = picturesMarkup(layout, p, draw);
+    const emblem = emblemMarkup(layout, p, draw);
+    return { pictures: pictures.markup, names: pictures.names, emblem: emblem.markup, defs: pictures.defs + emblem.defs, plateScale: layout.plateScale };
+}
 const trimmed = (value) => String(Math.round(value * 100) / 100);
 /** What a league's surface is, in a sentence fragment: its size or its bases, from the league's own figures in the unit its rulebook uses. */
 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")
+        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);
     // The field sports: their size is the surface drawn (the one the options ask for), in the unit their rulebook prints first.
     if (league.family === "lacrosse" || league.family === "rugby" || league.family === "afl" || league.family === "gaelic" || league.family === "cricket" || league.family === "fieldhockey" || league.family === "handball") {
         const sized = sheet ?? leagueSize(league.family, league.id);
@@ -370,7 +617,7 @@ function leagueAbout(league, year, language, sheet) {
             ? rinkOf(league, year)
             : league.family === "curling"
                 ? (sheet ?? sheetOf(league))
-                : league.family === "tennis" || league.family === "volleyball" || league.family === "badminton" || league.family === "pickleball" || league.family === "tabletennis"
+                : isNetLeague(league)
                     ? (() => {
                         const f = netOf(league);
                         return { length: f.length, width: f.widthDoubles ?? f.width };
@@ -381,7 +628,29 @@ function leagueAbout(league, year, language, sheet) {
                     })();
     const to = league.unit;
     const text = fill(words.size, { length: trimmed(convertLength(size.length, "ft", to)), width: trimmed(convertLength(size.width, "ft", to)), unit: words.units[to === "m" || to === "yd" ? to : "ft"] });
-    return fill(league.family === "volleyball" && league.id === "fivb-beach" ? words.beachVolleyball : words[league.family], { size: text });
+    return fill(league.family === "volleyball" && league.id === "fivb-beach" ? words.beachVolleyball : league.family === "volleyball" && league.id === "wpv-sitting" ? words.sittingVolleyball : words[league.family], { size: text });
+}
+/** The football field a drawing is on, for a situation to know the yards between the goal lines and the downs a team has (the CFL's three). */
+function footballFieldOf(o, sport, league) {
+    if (sport !== "nfl" && sport !== "cfl" && sport !== "ifaf")
+        return undefined;
+    const spec = league?.family === "football" ? fieldOf(league, o.year) : sport === "ifaf" ? FOOTBALL.ifaf : footballIn(sport, o.year);
+    return { yards: spec.length / 3, downs: spec.id === "cfl" ? 3 : 4 };
+}
+/** The situation the options ask for, read: which team attacks, which end, what is lit. `undefined` for none, for a sport that has no situation and for a special game. */
+function situationOf(o) {
+    if (o.situation === undefined || o.host !== undefined)
+        return undefined;
+    const { sport, league } = chooseLeague(o);
+    const ctx = {
+        sport,
+        homeSide: resolveHomeSide({ ...o, sport }),
+        direction: o.direction,
+        football: footballFieldOf(o, sport, league),
+        names: isScore(o) ? { home: String(o.home.name ?? ""), away: String(o.away.name ?? "") } : undefined,
+        league: league?.id,
+    };
+    return readSituation(o.situation, ctx);
 }
 /** A drawing's title and description, in a language. */
 export function describe(o) {
@@ -398,15 +667,25 @@ export function describe(o) {
     const ground = pitch?.format === "11" ? groundById(o.ground) : undefined;
     const groundName = ground === undefined ? undefined : groundNameIn(ground, o.year, language);
     // A league other than the sport's own is named by its rulebook's, and its description is made from its figures.
-    const surfaceName = groundName !== undefined ? (language === "ja" ? `${groundName}のピッチ` : `${groundName}, soccer pitch`) : league !== undefined && parkName === undefined ? league.name[language] : parkName === undefined ? (pitch?.format === "futsal" ? words.soccer.futsal : words.surface[sport]) : language === "ja" ? `${parkName}のグラウンド` : `${parkName}, baseball field`;
+    const trackGround = sport === "athletics" ? groundById(o.ground) : undefined;
+    const trackGroundName = trackGround === undefined ? undefined : groundNameIn(trackGround, o.year, language);
+    // An arena names its rink or its court.
+    const arena = (sport === "nhl" || sport === "nba") && league === undefined ? arenaById(o.arena) : undefined;
+    const arenaName = arena === undefined ? undefined : arenaNameIn(arena, o.year, language);
+    const arenaSize = arena === undefined || arenaName === undefined ? undefined : sport === "nhl" ? arenaRinkIn(arena, o.year) : arenaCourtIn(arena, o.year);
+    const surfaceName = arenaName !== undefined ? fill(sport === "nhl" ? words.said.arenaRink : words.said.arenaCourt, { arena: arenaName }) : trackGroundName !== undefined ? fill(words.athletics.ground, { ground: trackGroundName }) : groundName !== undefined ? (language === "ja" ? `${groundName}のピッチ` : `${groundName}, soccer pitch`) : league !== undefined && parkName === undefined ? league.name[language] : parkName === undefined ? (pitch?.format === "futsal" ? words.soccer.futsal : words.surface[sport]) : language === "ja" ? `${parkName}のグラウンド` : `${parkName}, baseball field`;
     const { stop, colon, gap } = words.said;
     const sentence = (text) => (/[.。]$/.test(text) ? text : `${text}${stop}`);
     const metres = (value) => String(Math.round(value * 10) / 10);
     const plan = sport === "curling" ? sheetFor(o) : undefined;
     // A field sport: the surface as drawn, at the size the options ask for.
     const field = isFieldSport(sport) ? fieldPlan({ ...o, sport }) : undefined;
-    const aboutText = 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}`;
+    const pools = isPoolSport(sport) ? poolDescription({ sport, pool: o.pool }, language) : undefined;
+    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 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;
@@ -417,7 +696,9 @@ export function describe(o) {
     // A park's walls and quirks that are drawn are said too.
     const ballpark = park === undefined ? undefined : ballparkFor(o);
     const special = specialText(o, language, surfaceName);
-    const parkLine = (parkName === undefined ? `${groundLine}${halfLine}` : `${gap}${fill(words.said.park, { park: parkName })}${officially(parkOfficial)}${ballpark === undefined ? "" : ballparkSentences(ballpark).map((line) => `${gap}${line}`).join("")}`) + (special === undefined ? "" : `${gap}${special.text}`);
+    // What the arena says about the size: that it is the one its sources publish, or that its rink is said to have been shorter and no size is given.
+    const arenaLine = arenaName === undefined ? "" : `${arenaSize !== undefined ? `${gap}${fill(words.said.arenaSize, { arena: arenaName })}` : sport === "nhl" && arena?.rinkUnknown === true ? `${gap}${fill(words.said.arenaUnknown, { arena: arenaName })}` : ""}${officially(arena === undefined ? undefined : arenaOfficialName(arena, language, year))}`;
+    const parkLine = (parkName === undefined ? `${groundLine}${halfLine}${arenaLine}` : `${gap}${fill(words.said.park, { park: parkName })}${officially(parkOfficial)}${ballpark === undefined ? "" : ballparkSentences(ballpark).map((line) => `${gap}${line}`).join("")}`) + (special === undefined ? "" : `${gap}${special.text}`);
     // A drawing of a past season says which: the markings are those of that season.
     const dated = typeof o.year === "number" && Number.isFinite(o.year);
     const eraLine = dated && league !== undefined
@@ -428,11 +709,25 @@ export function describe(o) {
             ? `${gap}${fill(words.said.era, { season: seasonLabel(sport, o.year) })}`
             : "";
     // A range says what is shown; a curling score shows all of the sheet, whatever the range.
-    const rangeLine = isScore(o) && sport === "curling" ? "" : describeRange(o, language, o.layers !== undefined && o.layers.length > 0);
+    const hasData = o.layers !== undefined && o.layers.length > 0;
+    // A folded sheet says what is enlarged and where, in place of the range's own sentence.
+    const foldedWords = words.ranges.folded;
+    const rangeLine = isScore(o) && sport === "curling"
+        ? ""
+        : plan?.show === "folded"
+            ? `${gap}${[foldedWords[isPortrait(o) ? "tall" : "wide"], foldedWords[plan.panels], hasData ? foldedWords.data : ""].filter((part) => part !== "").join(gap)}`
+            : describeRange(o, language, hasData);
+    // A situation says what the pill, the lit bases or the line of scrimmage show.
+    const read = situationOf(o);
+    const situationLine = read === undefined ? "" : situationSentences(read, language, isScore(o) ? { home: o.home.name, away: o.away.name } : undefined).map((line) => `${gap}${line}`).join("");
     if (!isScore(o))
-        return { title: o.title ?? special?.title ?? surfaceName, description: o.description ?? `${about}${parkLine}${eraLine}${rangeLine}` };
+        return { title: o.title ?? special?.title ?? surfaceName, description: o.description ?? `${about}${parkLine}${eraLine}${rangeLine}${situationLine}${poolLine}` };
     const winner = winnerOf({ ...o, sport });
-    const s = (t) => fieldScoreText(sport, t) ?? (t.score === undefined || String(t.score) === "" ? "–" : String(t.score));
+    // A pageant says what lies on each half, and the emblem in the middle.
+    const pageant = pageantOf(o);
+    const pg = KYOGIJO_STRINGS[language].pageant;
+    const pageantLine = pageant === undefined ? "" : `${gap}${pageant.style === "stage" ? pg.stage : pg.carpet}${pageant.emblem === undefined ? "" : `${gap}${pageant.emblem.name === undefined ? pg.emblem : fill(pg.emblemNamed, { name: pageant.emblem.name })}`}`;
+    const s = (t) => fieldScoreText(sport, t) ?? budoScoreText(sport, t) ?? (t.score === undefined || String(t.score) === "" ? "–" : String(t.score));
     // The sentence follows the drawing: the team on the left is first. The words' {away} and {home} are the first and the second team named.
     const order = resolveHomeSide({ ...o, sport }) === "left" ? [o.home, o.away] : [o.away, o.home];
     const line = fill(words.scoreTitle, { away: order[0].name, awayScore: s(order[0]), home: order[1].name, homeScore: s(order[1]) });
@@ -463,12 +758,12 @@ export function describe(o) {
         const tb = endText(team.tiebreaks?.[i]);
         return `${endText(value) || "–"}${tb === "" ? "" : ` (${tb})`}`;
     }).join(words.layers.listSep);
-    const netLine = !isNetSport(sport)
+    const netLine = !hasSetsBoard(sport)
         ? ""
         : order
             .flatMap((team) => [
             team.serving === true ? fill(net.serving, { name: team.name }) : "",
-            Array.isArray(team.sets) && team.sets.length > 0 ? fill(sport === "badminton" || sport === "pickleball" || sport === "tabletennis" ? net.byGame : net.bySet, { name: team.name, list: setList(team) }) : "",
+            Array.isArray(team.sets) && team.sets.length > 0 ? fill(BOARD[sport] === "games" ? net.byGame : net.bySet, { name: team.name, list: setList(team) }) : "",
             team.points !== undefined && team.points !== null && String(team.points).trim() !== "" ? fill(net.gamePoints, { name: team.name, points: String(team.points).trim() }) : "",
         ])
             .filter((part) => part !== "")
@@ -493,7 +788,7 @@ export function describe(o) {
             : "";
     return {
         title: o.title ?? (status === undefined ? line : `${line}${words.said.sep}${status}`),
-        description: o.description ?? `${extra === "" ? "" : `${sentence(extra)}${gap}`}${sentence(line)}${result}${tied}${curlingLine}${netLine}${fieldLine}${gap}${about}${parkLine}${eraLine}${rangeLine}`.trim(),
+        description: o.description ?? `${extra === "" ? "" : `${sentence(extra)}${gap}`}${sentence(line)}${result}${tied}${curlingLine}${netLine}${fieldLine}${isBudoSport(sport) ? budoScoreSentences(sport, order, language) : ""}${gap}${about}${parkLine}${eraLine}${rangeLine}${situationLine}${pageantLine}${poolLine}`.trim(),
     };
 }
 /**
@@ -513,8 +808,14 @@ export function describe(o) {
  * ```
  */
 export function drawKyogijo(o) {
+    return withEmblems(o.emblems, () => drawnKyogijo(o));
+}
+function drawnKyogijo(o) {
     if (o.host !== undefined && o.range !== undefined)
         return drawKyogijo({ ...o, range: undefined });
+    // A special game is a surface set inside another, drawn to scale with no stands.
+    if (o.host !== undefined && o.crowd !== undefined)
+        return drawKyogijo({ ...o, crowd: undefined });
     const language = o.language === "ja" ? "ja" : "en";
     // The sport as drawn: a league that is a sport of its own (`league: "cfl"` on an `nfl`) is that sport.
     const { sport } = chooseLeague(o);
@@ -526,7 +827,23 @@ export function drawKyogijo(o) {
     // A tall curling sheet is 30 feet wide on the page and a strip under it would be unreadable: its compact size is the board on the ice.
     const asked = isScore(o) ? (o.size === "compact" || o.size === "badge" ? o.size : "full") : "full";
     let sized = asked === "compact" && sport === "curling" && portrait ? "full" : asked;
-    const id = drawingId(o);
+    // A pageant that sends the score to the strip makes the drawing compact; a tall curling sheet cannot have a strip, so its board stays in the middle and the emblem is left out.
+    let pageant = isScore(o) ? pageantOf(o) : undefined;
+    if (pageant !== undefined && pageant.score === "strip") {
+        if (sport === "curling" && portrait)
+            pageant = { ...pageant, score: "centre", emblem: undefined };
+        else if (sized === "full")
+            sized = "compact";
+    }
+    // A lineup's players stand in the middle of the surface, where the score's panel would hide them: the score goes to the strip under the drawing, as a pageant's does, unless `score: "centre"` asks for it.
+    const lineupped = (o.layers ?? []).some((layer) => layer?.kind === "lineup");
+    const stripped = isScore(o) && lineupped && o.score !== "centre";
+    if (isScore(o) && pageant === undefined && sized === "full" && (o.score === "strip" || stripped) && !(sport === "curling" && portrait))
+        sized = "compact";
+    // The situation of the game (hockey's skaters, baseball's runners, football's down), decided once: the surface, the badge and the description draw from it.
+    const situation = situationOf(o);
+    // A situation that is not drawn (a sport that has none, nothing the sport can have in it) leaves the drawing, its ids included, as it was.
+    const id = drawingId(o.situation !== undefined && situation === undefined ? { ...o, situation: undefined } : o);
     const parts = o.parts === true;
     const homeSide = isScore(o) ? resolveHomeSide({ ...o, sport }) : "right";
     const awaySide = homeSide === "left" ? "right" : "left";
@@ -540,8 +857,8 @@ export function drawKyogijo(o) {
     if (isScore(o)) {
         winner = winnerOf({ ...o, sport });
         status = statusText({ ...o, sport }, language);
-        const home = teamView(o.home, homeSide, "home", winner, uppercase, sport, o.markShape);
-        const away = teamView(o.away, awaySide, "away", winner, uppercase, sport, o.markShape);
+        const home = teamView(o.home, homeSide, "home", winner, uppercase, sport, o.markShape, o.theme === "light" || o.theme === "dark" ? o.theme : undefined);
+        const away = teamView(o.away, awaySide, "away", winner, uppercase, sport, o.markShape, o.theme === "light" || o.theme === "dark" ? o.theme : undefined);
         left = homeSide === "left" ? home : away;
         right = homeSide === "left" ? away : home;
         leftTeam = homeSide === "left" ? o.home : o.away;
@@ -555,16 +872,21 @@ export function drawKyogijo(o) {
     const featured = featureColours(sport, o.featureColors);
     const features = featured.length === 0 ? undefined : new Set(featured.map(([name]) => name));
     const walled = sport === "mlb" && ballparkDrawn(ballparkFor(o));
+    const hardwood = sport === "nba" && o.court?.hardwood !== undefined && o.court.hardwood !== false;
+    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;
     let notes;
     const theme = o.theme === "light" || o.theme === "dark" ? o.theme : undefined;
     let viewBox;
     let body;
     let defs = "";
     let grounded = false;
+    let foldedSheet = false;
+    let pg;
     if (isScore(o) && left !== undefined && right !== undefined && sized === "badge") {
-        const badge = badgeMarkup(left, right, { sport, status, parts, id });
+        const badge = badgeMarkup(left, right, { sport, status, parts, id, situation: situation === undefined ? undefined : badgeSituation(situation, language) });
         viewBox = `0 0 ${badge.w} ${badge.h}`;
         body = badge.markup;
     }
@@ -576,13 +898,28 @@ export function drawKyogijo(o) {
             const guest = buildSurface({ ...o, margin: 0 }, false, id, isScore(o) && sized === "full", isScore(o), more);
             return composeSpecial(o, guest, (host, hostId) => buildSurface(host, false, hostId, false, false, { features: undefined }), id);
         };
-        let surface = make({ features });
+        let surface = make({ features, pageant: pageant !== undefined });
+        // The score of a pageant with no emblem and no board: the plate stays in the middle if the pictures lose little to it, else it goes to the strip and the surface is built again.
+        if (pageant !== undefined && pageant.score === "auto") {
+            let score = stripped ? "strip" : "centre";
+            if (!stripped && isScore(o) && left !== undefined && right !== undefined && leftTeam !== undefined && rightTeam !== undefined && sized === "full") {
+                const [first, second] = pageantPair(surface, { left, right, leftTeam, rightTeam });
+                score = autoScore({ pageant, surface, outline: outlineOf(o), left: first, right: second, turned: surface.turned, sport, plate: true });
+            }
+            pageant = { ...pageant, score };
+            if (score === "strip") {
+                sized = "compact";
+                surface = make({ features, pageant: true });
+            }
+        }
+        foldedSheet = surface.folded === true;
         // A range too small to hold the score's panel: the score goes to the strip under the drawing, as a compact card does.
         if (surface.plateFits === false) {
             sized = "compact";
-            surface = buildSurface(o, portrait, id, false, true, { features });
+            surface = buildSurface(o, portrait, id, false, true, { features, pageant: pageant !== undefined });
         }
-        if (annotated(o) && o.host === undefined) {
+        // A folded sheet has no margin for the annotations to stand in: they are not drawn on it.
+        if (annotated(o) && o.host === undefined && surface.folded !== true) {
             const teams = { home: isScore(o) ? o.home.name : undefined, away: isScore(o) ? o.away.name : undefined };
             notes = annotate({ o, surface, turned: surface.turned, words: KYOGIJO_STRINGS[language], teams });
             // The annotations need room in the margin: unless the options fix it, the surface is drawn again with a margin that holds them.
@@ -590,7 +927,7 @@ export function drawKyogijo(o) {
             const have = surface.ground ?? (surface.box === undefined ? 0 : surface.box.y - wideView(surface).y);
             const roomed = surface.room ?? have;
             if (o.margin === undefined && (notes.need > have + 0.01 || notes.need > roomed + 0.01)) {
-                surface = make({ features, margin: notes.need > have + 0.01 ? notes.need : undefined, room: notes.need });
+                surface = make({ features, pageant: pageant !== undefined, margin: notes.need > have + 0.01 ? notes.need : undefined, room: notes.need });
                 notes = annotate({ o, surface, turned: surface.turned, words: KYOGIJO_STRINGS[language], teams });
             }
         }
@@ -602,12 +939,35 @@ export function drawKyogijo(o) {
         const ground = laidOn(surface.base, o.background, id);
         grounded = ground.base !== surface.base;
         defs = surface.defs + ground.defs;
-        let inner = ground.base;
+        // The situation: a tint under the lines, and the rest over them and the data (cut with the surface when it is cropped).
+        const sit = situation === undefined
+            ? undefined
+            : drawSituation(situation, surface, {
+                id,
+                language,
+                homeSide,
+                abbrs: left !== undefined && right !== undefined ? { [left.role]: left.abbr, [right.role]: right.abbr } : undefined,
+                plate: isScore(o) && sized === "full" && o.plate !== false,
+                strip: stripped && sized === "compact",
+            });
+        const cutSit = (markup) => (markup !== "" && surface.defs.includes(`id="${id}-rg"`) ? el("g", { "clip-path": `url(#${id}-rg)` }, markup) : markup);
+        let inner = ground.base + (sit === undefined ? "" : cutSit(sit.under));
+        if (sit !== undefined)
+            defs += sit.defs;
         let teams = "";
-        if (isScore(o) && left !== undefined && right !== undefined && sized === "full") {
+        // A pageant lays each team's picture over its half, in place of the names painted at the ends.
+        if (pageant !== undefined && isScore(o) && left !== undefined && right !== undefined && leftTeam !== undefined && rightTeam !== undefined && (sized === "full" || sized === "compact")) {
+            pg = pageantParts(o, surface, pageant, { left, right, leftTeam, rightTeam, sport, id, plate: sized === "full", parts });
+            if (pg !== undefined) {
+                defs += pg.defs;
+                if (sized === "full" && pg.plateScale !== 1)
+                    surface.plate = { ...surface.plate, w: surface.plate.w * pg.plateScale, h: surface.plate.h * pg.plateScale };
+            }
+        }
+        if (isScore(o) && left !== undefined && right !== undefined && sized === "full" && pg === undefined) {
             const onColour = surface.onColour ?? (sport === "nfl" || sport === "cfl" || sport === "ifaf" || sport === "soccer");
             // A curling sheet, the net sports' courts and a cricket ground have no place for the names: the board names the teams.
-            if (sport !== "curling" && !isNetSport(sport) && sport !== "cricket") {
+            if (sport !== "curling" && !hasSetsBoard(sport) && sport !== "cricket" && sport !== "judo" && sport !== "karate" && sport !== "kendo" && sport !== "sumo") {
                 // Cropped to a range, a team's name is written only where its place is in what is shown.
                 if (shows(surface, surface.left))
                     teams += bannerMarkup(surface.left, left, { turned: surface.turned, onColour, parts, id });
@@ -616,20 +976,43 @@ export function drawKyogijo(o) {
             }
         }
         // The teams are painted under the lines, unless the surface asks for them over (a panel that must hide them).
-        inner += surface.bannersOver === true ? surface.lines + teams : teams + surface.lines;
+        if (pg !== undefined && pageant !== undefined) {
+            // A surface cropped with room for its annotations is clipped to the cut; the pictures are cut with it.
+            const cut = surface.defs.includes(`id="${id}-rg"`);
+            const laid = cut ? el("g", { "clip-path": `url(#${id}-rg)` }, pg.pictures) : pg.pictures;
+            inner += pageant.lines !== "over" ? surface.lines + laid + pg.names + pg.emblem : laid + surface.lines + pg.names + pg.emblem;
+        }
+        else
+            inner += surface.bannersOver === true ? surface.lines + teams : teams + surface.lines;
+        // A lineup's players stand over what the situation lights (a runner's base, a drive's arrows), so that none of them is hidden; any other data goes over it.
+        if (sit !== undefined && lineupped)
+            inner += cutSit(sit.over);
         // Data goes over the markings and under the score's panel.
-        const layered = renderLayers(o, o.layers, surface.turned, surface.whole === undefined ? undefined : surface.box);
+        const layered = renderLayers(o, o.layers, surface.turned, surface.whole === undefined ? undefined : surface.box, surface.upright);
         inner += surface.frame === undefined || layered.svg === "" ? layered.svg : el("g", { transform: surface.frame }, layered.svg);
+        // A surface drawn in parts shows the data again in each enlarged part, with its own ids, hidden from a reader of the drawing (the strip says it). A colour bar sized
+        // against the whole sheet falls outside the panels' part of it and is cut away there; one given a `region` inside a panel's part is drawn there, large.
+        if (surface.panels !== undefined && layered.svg !== "" && o.layers !== undefined) {
+            surface.panels.forEach((panel, i) => {
+                const copy = renderLayers({ ...o, id: `${id}-f${i}` }, o.layers, surface.turned);
+                if (copy.svg !== "")
+                    inner += el("g", { class: "ky-fold-data", "aria-hidden": "true", transform: panel.transform, "clip-path": `url(#${panel.clip})` }, copy.svg);
+            });
+        }
         if (layered.summaries.length > 0 && o.description === undefined) {
             const { colon, gap } = KYOGIJO_STRINGS[language].said;
             description = `${said}${gap}${KYOGIJO_STRINGS[language].layers.data}${colon}${layered.summaries.join(gap)}`;
         }
+        if (sit !== undefined && !lineupped)
+            inner += cutSit(sit.over);
+        if (surface.over !== undefined)
+            inner += surface.over;
         if (notes !== undefined && notes.svg !== "") {
             inner += notes.svg;
             if (notes.summaries.length > 0 && o.description === undefined)
                 description = `${description}${KYOGIJO_STRINGS[language].said.gap}${notes.summaries.join(KYOGIJO_STRINGS[language].said.gap)}`;
         }
-        if (isScore(o) && left !== undefined && right !== undefined && sized === "full") {
+        if (isScore(o) && left !== undefined && right !== undefined && sized === "full" && o.plate !== false) {
             const foot = o.label !== undefined && o.label !== "" ? o.label : [status, o.date].filter((part) => part !== undefined && part !== "").join(" · ");
             if (sport === "curling") {
                 const board = boardMarkup(surface.plate, left, right, { competition: o.competition, foot: foot === "" ? undefined : foot, total: KYOGIJO_STRINGS[language].said.total }, { turned: surface.turned, parts });
@@ -640,17 +1023,22 @@ export function drawKyogijo(o) {
                 const board = cricketBoardMarkup(surface.plate, left, right, { competition: o.competition, foot: foot === "" ? undefined : foot, innings: words.innings, total: words.total, overs: words.overs }, { parts });
                 inner += el("g", { transform: `translate(${num(surface.plate.cx)} ${num(surface.plate.cy)})${surface.turned ? " rotate(-90)" : ""}` }, board);
             }
-            else if (isNetSport(sport)) {
-                const board = setsBoardMarkup(surface.plate, left, right, { competition: o.competition, foot: foot === "" ? undefined : foot, head: KYOGIJO_STRINGS[language].net[sport === "badminton" || sport === "pickleball" || sport === "tabletennis" ? "games" : "sets"], points: KYOGIJO_STRINGS[language].net.points }, { parts, least: minSets(sport, chooseLeague(o).league?.id) });
+            else if (isBudoSport(sport) && sport !== "kyudo" && sport !== "dojo") {
+                const b = KYOGIJO_STRINGS[language].budo.board;
+                const board = budoBoardMarkup(sport, surface.plate, left, right, { competition: o.competition, foot: foot === "" ? undefined : foot, wazaari: b.wazaari, yuko: b.yuko, shido: b.shido, senshu: b.senshu, chui: b.chui, kimarite: b.kimarite, techniques: b.techniques, kimariteName: (key) => kimariteName(key, language) }, { parts });
+                inner += el("g", { transform: `translate(${num(surface.plate.cx)} ${num(surface.plate.cy)})${surface.turned ? " rotate(-90)" : ""}` }, board);
+            }
+            else if (hasSetsBoard(sport)) {
+                const board = setsBoardMarkup(surface.plate, left, right, { competition: o.competition, foot: foot === "" ? undefined : foot, head: KYOGIJO_STRINGS[language].net[BOARD[sport] === "games" ? "games" : "sets"], points: KYOGIJO_STRINGS[language].net.points }, { parts, least: minSets(sport, chooseLeague(o).league?.id) });
                 inner += el("g", { transform: `translate(${num(surface.plate.cx)} ${num(surface.plate.cy)})${surface.turned ? " rotate(-90)" : ""}` }, board);
             }
             else
                 inner += plateMarkup(surface.plate, left, right, { competition: o.competition, foot: foot === "" ? undefined : foot }, { turned: surface.turned, parts, surfaceSport: sport });
         }
-        const group = el("g", { class: "ky-surface-group", transform: surface.turn, part: parts ? "surface" : undefined }, inner);
+        const group = el("g", { class: "ky-surface-group", transform: surface.turn, part: parts ? "surface" : undefined, ...(o.pointer === true ? fieldAttributes({ ...o, sport }) : {}) }, inner);
         const v = surface.view;
         if (isScore(o) && left !== undefined && right !== undefined && sized === "compact") {
-            const badge = badgeMarkup(left, right, { sport, status, parts, id });
+            const badge = badgeMarkup(left, right, { sport, status, parts, id, situation: situation === undefined ? undefined : badgeSituation(situation, language) });
             const scale = v.w / badge.w;
             const gap = badge.h * scale * 0.12;
             body = group + el("g", { class: "ky-strip", transform: `translate(${num(v.x)} ${num(v.y + v.h + gap)}) scale(${scale.toFixed(4)})` }, badge.markup);
@@ -671,19 +1059,21 @@ export function drawKyogijo(o) {
         "data-league": o.league === undefined || o.league === "" ? undefined : o.league,
         "data-range": isScore(o) && sport === "curling" ? undefined : rangeLabel(o),
         "data-event": o.host !== undefined && typeof o.event === "string" ? safeClass(o.event) : undefined,
-        "data-look": look,
+        "data-look": look ?? budoLook,
         "data-size": sized,
         "data-orientation": portrait ? "portrait" : "landscape",
         "data-theme": theme,
         "data-palette": palette,
+        "data-track": sport === "athletics" ? o.athletics?.track : undefined,
         "data-winner": isScore(o) ? winner : undefined,
+        "data-pageant": pg === undefined ? undefined : pageant?.style,
         "data-version": VERSION,
         width: safeLength(o.width),
         height: safeLength(o.height),
         part: parts ? "svg" : undefined,
         style: style === "" ? undefined : style,
     }, `<title id="${titleId}">${esc(title)}</title><desc id="${descId}">${esc(description)}</desc>` +
-        (o.style === "none" ? "" : `<style>${KYOGIJO_BASE_STYLE}${left?.round === true || right?.round === true ? `\n${KYOGIJO_MARK_STYLE}` : ""}${sport === "curling" ? `\n${KYOGIJO_CURLING_STYLE}` : ""}${plan === undefined ? "" : `\n${courtStyle(plan.sport, plan.look)}`}${fieldsStyle(sport) === "" ? "" : `\n${fieldsStyle(sport)}`}${palette === undefined ? "" : `\n${lookStyle(palette)}`}${walled ? `\n${KYOGIJO_WALLS_STYLE}` : ""}${features === undefined ? "" : `\n${featureStyle(sport, features)}`}${notes === undefined || notes.svg === "" ? "" : `\n${KYOGIJO_NOTE_STYLE}`}${grounded ? `\n${KYOGIJO_BACKGROUND_STYLE}` : ""}${o.host === undefined ? "" : `\n${specialStyle(hostSport(o.host))}`}</style>`) +
+        (o.style === "none" ? "" : `<style>${KYOGIJO_BASE_STYLE}${left?.round === true || right?.round === true || (pg !== undefined && pageant?.style === "stage") || (pg !== undefined && pageant?.emblem?.shape !== "plain" && pageant?.emblem !== undefined) ? `\n${KYOGIJO_MARK_STYLE}` : ""}${pg === undefined ? "" : `\n${KYOGIJO_PAGEANT_STYLE}${pageant?.animate === undefined || pageant.animate === "none" ? "" : `\n${KYOGIJO_PAGEANT_MOTION}`}`}${sport === "curling" ? `\n${KYOGIJO_CURLING_STYLE}` : ""}${foldedSheet ? `\n${KYOGIJO_FOLD_STYLE}` : ""}${isPoolSport(sport) ? `\n${o.pool?.venue !== undefined ? KYOGIJO_POOL_STYLE : poolStyle({ sport, ...commonOf(o.pool ?? {}), race: o.pool?.race !== undefined, section: o.pool?.section !== undefined && o.pool.section !== false })}` : ""}${plan === undefined ? "" : `\n${courtStyle(plan.sport, plan.look)}`}${fieldsStyle(sport) === "" ? "" : `\n${fieldsStyle(sport)}`}${athleticsStyle(sport) === "" ? "" : `\n${athleticsStyle(sport)}`}${skatingStyle(sport) === "" ? "" : `\n${skatingStyle(sport)}`}${budoLook === undefined ? "" : `\n${budoStyle(sport, budoLook)}`}${palette === undefined ? "" : `\n${lookStyle(palette)}`}${athleticsTrackRules(sport, o.athletics?.track) === "" ? "" : `\n${athleticsTrackRules(sport, o.athletics?.track)}`}${walled ? `\n${KYOGIJO_WALLS_STYLE}` : ""}${hardwood ? `\n${KYOGIJO_HARDWOOD_STYLE}` : ""}${features === undefined ? "" : `\n${featureStyle(sport, features)}`}${notes === undefined || notes.svg === "" ? "" : `\n${KYOGIJO_NOTE_STYLE}`}${grounded ? `\n${KYOGIJO_BACKGROUND_STYLE}` : ""}${crowded ? `\n${KYOGIJO_CROWD_STYLE}` : ""}${crowded && sport === "dojo" ? KYOGIJO_BUDO_GALLERY_STYLE : ""}${situation === undefined ? "" : `\n${KYOGIJO_SITUATION_STYLE}`}${o.host === undefined ? "" : `\n${specialStyle(hostSport(o.host))}`}</style>`) +
         (defs === "" ? "" : `<defs>${defs}</defs>`) +
         body);
     return root;
@@ -703,3 +1093,21 @@ export function drawScore(options) {
 export function drawBadge(options) {
     return drawKyogijo({ ...options, size: "badge" });
 }
+/**
+ * The stands round a surface as data: the rings of seats with their outlines, heights and rake, the blocks of visitors and the places left open, in feet in the surface's
+ * wide frame, so that another view (a 3D one) can raise them. `undefined` when the options ask for no crowd (or for a special game, which has none).
+ * @example
+ * ```ts
+ * import { crowdStands } from "@johnmorrisdotca/kyogijo-stadiums";
+ * const stands = crowdStands({ sport: "soccer", crowd: true });
+ * console.log(stands?.rings.map((ring) => ring.id).join(" "), stands?.shape, stands?.stadium);
+ * // lower upper bowl purpose
+ * ```
+ */
+export function crowdStands(o) {
+    const crowd = crowdOf(o);
+    if (crowd === undefined)
+        return undefined;
+    const probe = buildWhole({ ...o, margin: 0 }, false, drawingId(o), false, false, { features: undefined });
+    return standsFor(o, probe, crowd);
+}