@johnmorrisdotca/kyogijo-stadiums 0.4.0 → 0.5.0

package/dist/draw.js

@@ -6,17 +6,33 @@ import { ERA_SPORTS, footballIn, rulesFor, seasonLabel } from "./eras.js";
 import { FOOTBALL } from "./geometry.js";
 import { renderLayers } from "./layers.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 { 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,13 +40,21 @@ 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 { 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";
@@ -47,7 +71,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", "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 +114,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;
@@ -177,7 +202,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 +224,30 @@ 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));
+}
+/** 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 +257,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);
@@ -248,14 +294,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 +329,91 @@ 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);
         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 })) });
+    }
+    return crowdLayout({ sport, box: surface.whole ?? surface.box ?? { x: 0, y: 0, w: 100, h: 100 }, crowd, awaySide, ground: o.ground });
+}
+/** 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";
+    const drawn = drawCrowd(stands, { id, crowd, density: densityOf(crowd, seats, ground), 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) {
@@ -315,6 +453,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. */
@@ -348,10 +503,46 @@ function teamView(team, side, role, winner, uppercase, sport, markShape) {
         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 === "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 +561,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 +572,7 @@ 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 });
 }
 /** A drawing's title and description, in a language. */
 export function describe(o) {
@@ -398,15 +589,19 @@ 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);
+    const surfaceName = 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("");
+    const aboutText = pools !== undefined ? pools.about : 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) : ""}`;
     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;
@@ -428,10 +623,21 @@ 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);
     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}${poolLine}` };
     const winner = winnerOf({ ...o, sport });
+    // 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) ?? (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];
@@ -463,12 +669,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 +699,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}${gap}${about}${parkLine}${eraLine}${rangeLine}${pageantLine}${poolLine}`.trim(),
     };
 }
 /**
@@ -515,6 +721,9 @@ export function describe(o) {
 export function drawKyogijo(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,6 +735,14 @@ 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;
+    // 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";
+    }
     const id = drawingId(o);
     const parts = o.parts === true;
     const homeSide = isScore(o) ? resolveHomeSide({ ...o, sport }) : "right";
@@ -555,6 +772,8 @@ 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;
     let notes;
@@ -563,6 +782,8 @@ export function drawKyogijo(o) {
     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 });
         viewBox = `0 0 ${badge.w} ${badge.h}`;
@@ -576,13 +797,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 = "centre";
+            if (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 +826,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 });
             }
         }
@@ -604,10 +840,19 @@ export function drawKyogijo(o) {
         defs = surface.defs + ground.defs;
         let inner = ground.base;
         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") {
                 // 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 +861,38 @@ 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;
         // 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 (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,8 +903,8 @@ 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 (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
@@ -676,14 +939,16 @@ export function drawKyogijo(o) {
         "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)}`}${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}` : ""}${o.host === undefined ? "" : `\n${specialStyle(hostSport(o.host))}`}</style>`) +
         (defs === "" ? "" : `<defs>${defs}</defs>`) +
         body);
     return root;
@@ -703,3 +968,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);
+}