@johnmorrisdotca/kyogijo-stadiums 0.4.0 → 0.5.0

package/dist/types.d.ts

@@ -4,10 +4,14 @@ import type { Unit } from "./units.ts";
 import type { SoccerFrame, SoccerProviderId } from "./surfaces/soccer-providers.ts";
 import type { SoccerPitchId, SoccerSize } from "./surfaces/soccer-spec.ts";
 import type { Frame } from "./frames.ts";
+import type { PoolSport, PoolStyle } from "./pool.types.ts";
+import type { AthleticsStyle } from "./athletics/types.ts";
+import type { SkatingStyle } from "./skating/types.ts";
 /** The field sports: lacrosse (the field and the box), rugby (union and league), Australian football, Gaelic football and hurling, cricket, field hockey and team handball. */
 export type FieldSport = "lacrosse" | "rugby" | "afl" | "gaelic" | "cricket" | "fieldhockey" | "handball";
-/** The surfaces: three football fields, a rink, a court, a ballpark, a soccer pitch, a curling sheet, five net sports (tennis, volleyball, badminton, pickleball and table tennis) and seven field sports (lacrosse, rugby, Australian football, Gaelic football and hurling, cricket, field hockey and handball). */
-export type Sport = "nfl" | "cfl" | "ifaf" | "nhl" | "nba" | "mlb" | "soccer" | "curling" | "tennis" | "volleyball" | "badminton" | "pickleball" | "tabletennis" | FieldSport;
+export type { PoolSport, PoolStyle };
+/** The surfaces: three football fields, a rink, a court, a ballpark, a soccer pitch, a curling sheet, twelve net, racket and court sports (tennis, volleyball, badminton, pickleball, table tennis, padel, squash, racquetball, sepak takraw, teqball, roundnet and netball), four pools (swimming, water polo, diving and artistic swimming), seven field sports (lacrosse, rugby, Australian football, Gaelic football and hurling, cricket, field hockey and handball) and the athletics stadium (the 400 m track with its infield, and the covered 200 m track). */
+export type Sport = "nfl" | "cfl" | "ifaf" | "nhl" | "nba" | "mlb" | "soccer" | "curling" | "tennis" | "volleyball" | "badminton" | "pickleball" | "tabletennis" | "padel" | "squash" | "racquetball" | "sepaktakraw" | "teqball" | "roundnet" | "netball" | PoolSport | FieldSport | "athletics" | "skating";
 /** `auto` follows the device's light or dark setting (and `data-theme` on the page's root), the others force one. */
 export type Theme = "auto" | "light" | "dark";
 /** The language of the words the drawing says itself: its title, its description and its status labels. */
@@ -91,7 +95,7 @@ export interface GoalInfo {
     line: number;
 }
 /** The looks a drawing can have, alongside `court` (a basketball court's own). See `LOOKS`. */
-export type LookName = "grass" | "night" | "chalkboard" | "blueprint" | "print" | "broadcast" | "high-contrast";
+export type LookName = "grass" | "night" | "chalkboard" | "blueprint" | "print" | "broadcast" | "high-contrast" | "line-drawing";
 /** The width of the lines: a multiple of the width they are drawn at (`2`, or `{ scale: 2 }`), or an absolute width in `units` (`{ width: 0.5 }`). */
 export type LineWidth = number | {
     scale: number;
@@ -220,21 +224,100 @@ export interface CourtStyle {
     baselineInk?: string;
     /** Paint the area inside the three-point line in the key's colour. */
     paintThreePoint?: boolean;
+    /**
+     * A realistic floor: maple boards that run the length of the court with staggered ends, grain and tone, stained keys and centre circle with the wood showing through,
+     * a stained border with a baseline in each team's colour, the baskets seen from above with their shadows, and a satin sheen. `true` for the defaults, or the options
+     * (`HardwoodOptions`). Off by default, and then the drawing is byte for byte as before. See `docs/hardwood.md`.
+     */
+    hardwood?: boolean | HardwoodOptions;
+    /** The colour of the border behind each baseline (`[left, right]`, or one for both) on a `hardwood` floor: a team's colour by default, else the border's. */
+    baselineColor?: string | [string, string];
+    /** Words along the sidelines, in the border of a `hardwood` floor: one text for both, or `[top, bottom]`. */
+    sidelineText?: string | [string, string];
+}
+/** The options of a `hardwood` floor. Every part is optional. */
+export interface HardwoodOptions {
+    /** The seed of the boards' lengths and tones and of the grain: the same seed always gives the same floor. 1 by default. */
+    seed?: number;
+    /**
+     * How much is drawn. `fine`: the boards' seams and ends, the grain, the baskets' soft shadows, the table and the benches. `plain`: broad boards and one shadow, for a
+     * thumbnail. `auto` (the default) is `plain` when the drawing has `detail: "simple"` or a `width` under 480 pixels, else `fine`.
+     */
+    detail?: "auto" | "fine" | "plain";
+    /** The width of a board in inches, 1.5 to 6. 2.25 by default, as a maple strip floor is laid. */
+    board?: number;
+    /** How much of the paint is stain, 0.3 to 1: the lower, the more wood shows through the keys, the circle and the border. 0.82 by default. */
+    stain?: number;
+    /** The satin sheen, 0 (none) to 1.5. 1 by default. */
+    sheen?: number;
+    /** Draw the baskets from above, with the stanchion and its shadows (the usual `goals` choices still apply). On by default. */
+    hoops?: boolean;
+    /** The coaching box's lines, the scorers' table and the two benches along the bottom sideline. On by default in the `fine` detail. */
+    bench?: boolean;
+}
+/**
+ * How much of a curling sheet is shown: all of it (`sheet`), the half from the hog line to the back line (`half`), just the house (`house`), or `folded`: the whole sheet as a strip in the
+ * middle with its two houses enlarged beside it, so that the drawing fills a roughly square frame (see `SheetStyle.panels`).
+ */
+export type SheetShow = "sheet" | "half" | "house" | "folded";
+/** An end of a curling sheet: `left` or `right` as the sheet lies wide, or `top` (the left end) and `bottom` (the right end), as a tall sheet's ends are read. */
+export type SheetEnd = Side | "top" | "bottom";
+/** The shape of a venue's stands round the playing surface. */
+export type CrowdShape = "bowl" | "sides" | "horseshoe" | "grandstand";
+/**
+ * The stands and the crowd round a surface (`crowd`). Every part is optional. `true` is the sport's usual venue, 85 percent full, with an away end, drawn in detail.
+ * See `docs/crowd.md`.
+ */
+export interface CrowdOptions {
+    /**
+     * The venue: `bowl` (stands on every side), `sides` (the long sides only), `horseshoe` (three sides, the open end at the right, or at the left with `open: "left"`; a
+     * ballpark's outfield with a gap at the batter's eye) or `grandstand` (a ballpark's infield stands only). Each sport has its usual one.
+     */
+    shape?: CrowdShape;
+    /** The end of a `horseshoe` that is open: `right` (the usual) or `left`. */
+    open?: "left" | "right";
+    /**
+     * What a soccer pitch is inside. `auto` (the default) is a stadium of its own for most grounds and a gridiron stadium for the NFL's and the CFL's, where the stands keep a
+     * football field's footprint and the pitch stands inside it; `purpose`, `nfl` and `cfl` choose. The footprint is drawn faintly so that the gap is seen.
+     */
+    stadium?: "auto" | "purpose" | "nfl" | "cfl";
+    /** How full the stands are, 0 to 1: the share of seats with someone in them. 0.85 by default. Over `attendance`. */
+    density?: number;
+    /** The people in the stands, with `capacity` the seats: the density is their quotient. A ground's `capacity` is the default for soccer; without one, the seats the drawing's stands have. */
+    attendance?: number;
+    capacity?: number;
+    /** The seed of the crowd: the same seed is always the same crowd. 1 by default. */
+    seed?: number;
+    /** The home fans' colour and the visitors': the teams' colours of a score, else the sides' colours. */
+    home?: string;
+    away?: string;
+    /** Where the visitors sit: `auto` (the sport's usual place), `left`, `right`, `corner` (a block in a corner), or `none`. */
+    awayEnd?: "auto" | "left" | "right" | "corner" | "none";
+    /** A tifo or card display in the colours of a team, in a block of the lower stands behind a goal: `home`, `away`, `both` or `false`. Off by default. */
+    tifo?: boolean | "home" | "away" | "both";
+    /** `stripes` (the usual) or `checks`. */
+    tifoDesign?: "stripes" | "checks";
+    /** Tunnels, the benches' places and the camera platform of the media side. On by default. */
+    gaps?: boolean;
+    /** The roof's edge throws a shade on the last rows of the upper tier. On by default. */
+    roof?: boolean;
+    /** A ballpark's seats on top of a wall: `true` for every wall of the park's data that is 25 feet or more (and has a `walls` entry), `false` for none, and by default the walls the package knows have seats (Fenway Park's Green Monster). */
+    wallSeats?: boolean;
+    /** How much is drawn: `fine` (the crowd as heads and shoulders, empty seats, aisles), `plain` (blocks of colour), or `auto` (`plain` for `detail: "simple"` or a `width` under 480 pixels). */
+    detail?: "auto" | "fine" | "plain";
 }
-/** How much of a curling sheet is shown: all of it, the half from the hog line to the back line, or just the house. */
-export type SheetShow = "sheet" | "half" | "house";
 /**
  * The parts of a surface a drawing can be cropped to (`range`). Football: `red-zone`, `between-the-20s`, `end-zone`, `field-of-play`, `own-half`, `opponent-half`.
  * Hockey: `offensive-zone`, `defensive-zone`, `neutral-zone`, `half`. Basketball: `half-court`, `paint`. Soccer: `half`, `final-third`, `defensive-third`, `middle-third`,
- * `penalty-area`. Baseball: `infield`, `outfield`. The net sports: `half-court`. Curling: `sheet`, `half`, `house`. Rugby: `half`, `twenty-two` (union) or `twenty` (league), `in-goal`. Lacrosse: `half`, `crease`. Australian football: `half`, `forward-fifty`, `centre-square`.
- * Gaelic games: `half`, `large-rectangle`. Cricket: `pitch`, `circle`. Field hockey: `half`, `circle`, `twenty-three`. Handball: `half`, `goal-area`. `RANGES` lists them for each sport.
+ * `penalty-area`. Baseball: `infield`, `outfield`. The net sports: `half-court`. Curling: `sheet`, `half`, `house`, `folded`. Rugby: `half`, `twenty-two` (union) or `twenty` (league), `in-goal`. Lacrosse: `half`, `crease`. Australian football: `half`, `forward-fifty`, `centre-square`.
+ * Gaelic games: `half`, `large-rectangle`. Cricket: `pitch`, `circle`. Field hockey: `half`, `circle`, `twenty-three`. Handball: `half`, `goal-area`. Swimming: `half`, `pool-end`. Water polo: `half`, `goal-area`. Diving: `springboards`, `platforms`. Artistic swimming: `half`, `centre-stage`. Athletics: `bend`, `home-straight`, `back-straight`, `finish`, `start`, `infield`, a field event (`high-jump`, `pole-vault`, `long-jump`, `triple-jump`, `shot-put`, `discus-throw`, `hammer-throw`, `javelin-throw`) and `water-jump`. `RANGES` lists them for each sport.
  */
-export type RangeName = "red-zone" | "between-the-20s" | "end-zone" | "field-of-play" | "own-half" | "opponent-half" | "offensive-zone" | "defensive-zone" | "neutral-zone" | "half" | "half-court" | "paint" | "final-third" | "defensive-third" | "middle-third" | "penalty-area" | "infield" | "outfield" | "sheet" | "house" | "in-goal" | "twenty-two" | "twenty" | "crease" | "forward-fifty" | "centre-square" | "large-rectangle" | "pitch" | "circle" | "twenty-three" | "goal-area";
+export type RangeName = "red-zone" | "between-the-20s" | "end-zone" | "field-of-play" | "own-half" | "opponent-half" | "offensive-zone" | "defensive-zone" | "neutral-zone" | "half" | "half-court" | "paint" | "final-third" | "defensive-third" | "middle-third" | "penalty-area" | "infield" | "outfield" | "sheet" | "house" | "folded" | "in-goal" | "twenty-two" | "twenty" | "crease" | "forward-fifty" | "centre-square" | "large-rectangle" | "pitch" | "circle" | "twenty-three" | "goal-area" | "pool-end" | "springboards" | "platforms" | "centre-stage" | "bend" | "home-straight" | "back-straight" | "finish" | "start" | "infield" | "high-jump" | "pole-vault" | "long-jump" | "triple-jump" | "shot-put" | "discus-throw" | "hammer-throw" | "javelin-throw" | "water-jump" | "crossing-straight" | "first-bend" | "second-bend" | "judges" | "kiss-and-cry";
 /** A named range at the end of your choice: `{ name: "offensive-zone", end: "left" }` is the offensive zone of a team that attacks the left. */
 export interface RangeNamed {
     name: RangeName;
-    /** The end of the surface the range is at, as the surface is drawn wide: `left` or `right`. Each range has its own default (`RANGES`); a range with no end ignores it. */
-    end?: Side;
+    /** The end of the surface the range is at, as the surface is drawn wide: `left` or `right` (a curling sheet's also `top` and `bottom`: the left end and the right). Each range has its own default (`RANGES`); a range with no end ignores it. */
+    end?: SheetEnd;
 }
 /**
  * A box of your own to crop to: the corners `x0, y0` and `x1, y1`, in the drawing's frame (feet, or `units`: x along the surface from the left, y across it from the top;
@@ -273,10 +356,14 @@ export interface SheetStyle {
     pebble?: boolean;
     /** Shade the free guard zone at both ends: the ground between the hog line and the tee line, outside the house. Off by default. */
     guardZone?: boolean;
-    /** How much of the sheet to show. A bare sheet only; a score always shows all of it. `sheet` by default. `range` says the same (`range: "house"`) and wins. */
+    /** How much of the sheet to show. A bare sheet only; a score always shows all of it. `sheet` by default. `range` says the same (`range: "house"`) and wins. `folded` is the whole sheet with both houses enlarged beside it. */
     show?: SheetShow;
-    /** Which end `show: "half"` and `show: "house"` show: the `left` one (the top house of a tall drawing, the default) or the `right`. */
-    end?: "left" | "right";
+    /** Which end `show: "half"` and `show: "house"` show: the `left` one (the top house of a tall drawing, the default) or the `right`; `top` and `bottom` say the same for a tall sheet (`top` is the left end). */
+    end?: SheetEnd;
+    /** What each enlarged panel of `show: "folded"` holds: the `half` from the hog line to the back line, with the free guard zone (the default), or just the `house`. */
+    panels?: "half" | "house";
+    /** The shape of the frame `show: "folded"` fills: width over height as the drawing lies, 1 (square) by default; the panels are as large as that allows. */
+    fit?: number;
 }
 /** The named looks of a tennis court: the colour of its surface and of the ground round it. */
 export type TennisLook = "hard-blue" | "hard-green" | "clay" | "grass";
@@ -288,16 +375,31 @@ export type BadmintonLook = "green" | "blue" | "wood";
 export type PickleballLook = "blue-green" | "green" | "red";
 /** The named looks of a table tennis table. */
 export type TableTennisLook = "blue" | "green";
+/** The named looks of a padel court: the colours the FIP's rules prefer for the floor. */
+export type PadelLook = "blue" | "green" | "terracotta";
+/** The named looks of a squash court. */
+export type SquashLook = "wood" | "blue";
+/** The named looks of a racquetball court: the lines are the IRF's recommended red, or blue on a convertible court. */
+export type RacquetballLook = "wood" | "convertible";
+/** The named looks of a sepak takraw court. */
+export type SepakTakrawLook = "blue" | "green" | "wood";
+/** The named looks of a teqball court. */
+export type TeqballLook = "grey" | "blue" | "green";
+/** The named looks of a roundnet court. */
+export type RoundnetLook = "grass" | "sand" | "indoor";
+/** The named looks of a netball court. */
+export type NetballLook = "wood" | "blue" | "green";
 /**
- * The look and the variants of a net sport's court (tennis, volleyball, badminton, pickleball, table tennis). Every part is optional.
+ * The look and the variants of a net sport's court (tennis, volleyball, badminton, pickleball, table tennis, padel, squash, racquetball, sepak takraw, teqball, roundnet
+ * and netball). Every part is optional.
  * The lines and the sizes are the rulebook's whatever the look; a look is the colour of the ground and of the surface.
  */
 export interface NetStyle {
-    /** A named look: for tennis `hard-blue` (the default), `hard-green`, `clay` or `grass`; volleyball `wood` (the default for indoors) or `blue`, and `sand` for the beach; badminton `green` (the default), `blue` or `wood`; pickleball `blue-green` (the default), `green` or `red`; table tennis `blue` (the default) or `green`. An unknown name is an error that lists them. */
+    /** A named look: for tennis `hard-blue` (the default), `hard-green`, `clay` or `grass`; volleyball `wood` (the default for indoors) or `blue`, and `sand` for the beach; badminton `green` (the default), `blue` or `wood`; pickleball `blue-green` (the default), `green` or `red`; table tennis `blue` (the default) or `green`; padel `blue` (the default), `green` or `terracotta`; squash `wood` (the default) or `blue`; racquetball `wood` (the default) or `convertible`; sepak takraw `blue` (the default), `green` or `wood`; teqball `grey` (the default), `blue` or `green`; roundnet `grass` (the default), `sand` or `indoor`; netball `wood` (the default), `blue` or `green`. An unknown name is an error that lists them. */
     look?: string;
     /**
      * The free zone drawn round the court: `official` (the default: the figure a rulebook gives for its own competitions, where it gives one), `least` (the least it allows
-     * or recommends) or `none`. Tennis (Appendix X), volleyball and beach volleyball (Rule 1.1) and pickleball (Rule 3.A.3) give figures; badminton and table tennis do not.
+     * or recommends) or `none`. Tennis (Appendix X), volleyball, beach volleyball and sitting volleyball (Rule 1.1), pickleball (Rule 3.A.3), sepak takraw (Law 1.5) and netball (Rule 1, item 8) give figures; badminton, table tennis, padel, squash, racquetball, teqball and roundnet do not.
      */
     free?: "official" | "least" | "none";
     /** Tennis: draw the two singles sticks that hold a doubles net up for a singles match, 3 feet outside the singles court (Rule 1). Off by default. */
@@ -325,6 +427,49 @@ export interface FieldStyle {
 }
 /** The shape of a team's mark: its logo as it is (`plain`), or clipped to a circle with a ring (`round`). */
 export type TeamMark = "plain" | "round";
+/** How a pageant lays out each team's picture: `carpet` is its flag or logo laid flat over its half, as a rectangle with a border; `stage` is its crest on a large round disc with a ring. */
+export type PageantStyle = "carpet" | "stage";
+/**
+ * The pageant: each team's flag or logo laid out large over its own half of the surface, as a stadium lays giant flags and crests on the pitch for a final's
+ * ceremony, and an emblem or a trophy in the centre circle. Give `pageant: "carpet"`, `"stage"` or `true` (a carpet), or these options. Off by default, and a drawing without it is
+ * the same text as before. It needs a score (`home` and `away`) and the full or compact size.
+ */
+export interface PageantOptions {
+    /** `carpet` (the default) or `stage`. */
+    style?: PageantStyle;
+    /** A carpet's border band: `dark` (the default), `team` (each team's colour), or a colour. */
+    border?: "dark" | "team" | (string & {});
+    /** A carpet's border band as a share of its shorter side, 0.02 to 0.15. 0.06 by default. */
+    borderWidth?: number;
+    /** A carpet's fabric: a gentle, fixed wave of light and shade over it. On by default; left out at small sizes. */
+    fabric?: boolean;
+    /** Where the surface's lines lie: `over` the pictures (the default), `under` them (the pictures cover the lines), or `through` (under the pictures, which are a little see-through, so that the lines show faintly). */
+    lines?: "over" | "under" | "through";
+    /** A stage's ring: `gold` (the default), `team` (each team's colour), or a colour. */
+    ring?: "gold" | "team" | (string & {});
+    /** The picture in the centre circle, centre ice, centre court or at the mound: a competition's emblem or a trophy, as a logo is given (an address, an image `data:` address or an SVG document as text). Yours; none is supplied. */
+    emblem?: string;
+    /** `round` (the default): the emblem on a disc with a ring, as a team's mark. `plain`: the picture as it is, for a trophy with a cut-out outline. */
+    emblemShape?: "round" | "plain";
+    /** An emblem's fit on its disc: `contain` (the default: shown whole) or `cover` (it fills the disc). */
+    emblemFit?: "contain" | "cover";
+    /** What the emblem is, for the drawing's description: "World Cup". */
+    emblemName?: string;
+    /** Where the score goes: `centre` (the plate stays in the middle, a little smaller, and the pictures keep clear of it), `strip` (the compact strip under the drawing) or `auto` (the default: the centre, unless there is an emblem or the sport's board is large, which then go to the strip). */
+    score?: "auto" | "centre" | "strip";
+    /**
+     * How a carpet fills its half: `fill` (the default) takes the room the half gives it with a margin, as a ceremony's flags are made to the size of the half, so its shape may differ from the
+     * flag's ratio by up to 2 to 1, and the art is stretched a little and cropped a little (each by the square root of the difference, so stripes stay stripes and a centred emblem stays nearly round);
+     * `ratio` keeps the flag's own ratio and leaves the rest of the half bare. A stage is round either way.
+     */
+    fit?: "fill" | "ratio";
+    /** The size of a carpet or a stage, as a share of the room its half gives it. 0.4 to 1; 1 by default (the room less a margin). */
+    scale?: number;
+    /** Write each team's name on its picture. By default only a team with no flag or logo has its name (or its initials, when they would not fit). */
+    names?: boolean;
+    /** An entrance, in CSS only and for people who have not asked for less motion: `unfurl` (a carpet rolls out from its end, a stage grows) or `fade`. `none` by default. */
+    animate?: "none" | "unfurl" | "fade";
+}
 /** One team of a score. */
 export interface Team {
     /** The name, as it is to be written: "Harbour City Gulls". */
@@ -342,13 +487,15 @@ export interface Team {
     mark?: TeamMark;
     /** A round mark's fit: `cover` (the default) fills the circle with the picture, as a flag does; `contain` shows a crest whole on a plain disc. */
     markFit?: "cover" | "contain";
+    /** The pageant's carpet is as wide as it is tall by this ratio: 1.5 for a flag of 3 to 2. Read from an SVG logo's `viewBox` when missing, else 1.5; held between 1 and 3. */
+    logoRatio?: number;
     /** The goals it scored in a penalty shoot-out: shown with the status, and the winner of a level game. */
     penalties?: number | string;
     /** Curling: the points it scored in each end, in order (`null` for an end not played yet; `"X"` for a conceded one). */
     ends?: readonly (number | string | null | undefined)[];
     /** Curling: the team has the hammer, the last stone of the end. A marker is drawn beside its name. */
     hammer?: boolean;
-    /** Tennis, volleyball, badminton, pickleball and table tennis: what it scored in each set (tennis: its games; pickleball and table tennis: each game's points), in order; `null` for one not played yet. The set in progress is the last one given. */
+    /** The net and racket sports (not netball): what it scored in each set (tennis and padel: its games; the others: each game's or set's points), in order; `null` for one not played yet. The set in progress is the last one given. */
     sets?: readonly (number | string | null | undefined)[];
     /** Tennis: the points of a tie-break in each set (the same places as `sets`; `null` where the set had none), written small beside the games. */
     tiebreaks?: readonly (number | string | null | undefined)[];
@@ -471,12 +618,23 @@ export interface SurfaceOptions {
     quirks?: boolean | QuirkOptions;
     /** The look of an NBA court. */
     court?: CourtStyle;
+    /**
+     * The stands and the crowd round the surface, for a venue that has spectators: a bowl, two sides, a horseshoe or a ballpark's grandstands, with the people as heads and
+     * shoulders in the home colours and a visitors' end. `true` for the defaults, or `CrowdOptions`. Off by default, and then the drawing is byte for byte as it was.
+     */
+    crowd?: boolean | CrowdOptions;
     /** The size and look of a curling sheet. */
     sheet?: SheetStyle;
-    /** The look and the variants of a tennis, volleyball, badminton, pickleball or table tennis court. */
+    /** The look and the variants of a tennis, volleyball, badminton, pickleball, table tennis, padel, squash, racquetball, sepak takraw, teqball, roundnet or netball court. */
     net?: NetStyle;
     /** The size and the variants of a lacrosse, rugby, Australian football, Gaelic games, cricket, field hockey or handball surface. */
     field?: FieldStyle;
+    /** The pool of a swimming, water polo, diving or artistic swimming drawing: the course and the lanes, the look of the water and the deck, a side section, the lanes of a race with its results and splits, and several pools in one hall. */
+    pool?: PoolStyle;
+    /** The athletics stadium: the number of lanes, the colour of the track, what is in the infield, the races and the field events marked. See `AthleticsStyle`. */
+    athletics?: AthleticsStyle;
+    /** The skating rink: the long track's radius and lanes, the short track's tracks, the figure skating rink's size and furniture, the races marked. See `SkatingStyle`; the discipline is the `league`. */
+    skating?: SkatingStyle;
     /** The soccer pitch: a preset (`fifa`, `uefa`, `mls`, `nwsl`, `ncaa`, `law-min`, `law-max`, `9-a-side`, `7-a-side`, `5-a-side`, `futsal`) or a size, `{ length, width, unit }`. The international 105 by 68 m by default. */
     pitch?: SoccerPitchId | SoccerSize;
     /** The soccer ground to draw: a key of `GROUNDS`. The pitch has the size its article publishes (the international 105 by 68 m where none is), and the drawing carries the ground's name for `year`. A `pitch` of your own wins over the ground's size. */
@@ -503,6 +661,11 @@ export interface SurfaceOptions {
      * Unset, the drawing is byte for byte as before. See `BackgroundOptions`.
      */
     background?: Background;
+    /**
+     * The pageant: each team's flag or logo laid large over its half (a `carpet`) or on a round disc (a `stage`), with an emblem in the centre. `"carpet"`, `"stage"`, `true` (a carpet) or `PageantOptions`.
+     * Off by default; a score drawing only. See `PageantOptions`.
+     */
+    pageant?: PageantStyle | boolean | PageantOptions;
     /** A named look: the surface, the lines and the ground round it in one palette, light and dark. See `LOOKS`. Over the theme's colours, under `colors`. */
     look?: LookName;
     /** The width of the lines (see `LineWidth`): a multiple of the width they are drawn at, or an absolute width. */
@@ -562,4 +725,6 @@ export interface ScoreOptions extends SurfaceOptions {
     uppercase?: boolean;
     /** The shape of both teams' marks, unless a team's own `mark` says otherwise: `plain` (the default) or `round`, a flag or logo in a circle with a ring. */
     markShape?: TeamMark;
+    /** Draw the score's panel (or board) on the surface. On by default; `false` leaves the teams' names and the rest and no panel, as the 3D view does when it hangs the score up as a scoreboard. */
+    plate?: boolean;
 }

package/dist/units.d.ts

@@ -7,7 +7,7 @@ export declare const UNITS: readonly Unit[];
 export declare const FEET_PER: Readonly<Record<Unit, number>>;
 /**
  * The unit each surface's rulebook states its dimensions in: the NFL's and the CFL's fields in yards (and the IFAF's, which
- * follows them), the NHL's rink, the NBA's court and the baseball field in feet, a soccer pitch in metres (the Laws'), a tennis court and a pickleball court in feet (the ITF's and USA Pickleball's), a volleyball court, a badminton court and a table in metres (FIVB's, BWF's and ITTF's), a curling sheet in metres (World Curling's rules give metres with feet beside them; Curling Canada's give feet first, and its league `curling-canada` has feet), a rugby field, an Australian football ground, a Gaelic field, a hockey pitch and a handball court in metres (the rulebooks') and a cricket ground in yards (the Laws' and the ICC's; the NLL's box floor and the PLL's and the NCAA men's fields are in the leagues' own feet and yards). A Japanese park's fence is measured in
+ * follows them), the NHL's rink, the NBA's court and the baseball field in feet, a soccer pitch in metres (the Laws'), a tennis court, a pickleball court and a racquetball court in feet (the ITF's, USA Pickleball's and the IRF's), a volleyball court, a badminton court, a table, a padel court, a squash court, a sepak takraw court, a teqball court, a roundnet court and a netball court in metres (FIVB's, BWF's, ITTF's, FIP's, World Squash's, ISTAF's, FITEQ's, the International Roundnet Federation's and World Netball's), a curling sheet in metres (World Curling's rules give metres with feet beside them; Curling Canada's give feet first, and its league `curling-canada` has feet), a rugby field, an Australian football ground, a Gaelic field, a hockey pitch and a handball court in metres (the rulebooks'), a swimming pool, a water polo field, a diving well and an artistic swimming area in metres (World Aquatics') and a cricket ground in yards (the Laws' and the ICC's; the NLL's box floor and the PLL's and the NCAA men's fields are in the leagues' own feet and yards). A Japanese park's fence is measured in
  * metres and converted once: see `parkUnit`.
  */
 export declare const SURFACE_UNITS: Readonly<Record<Sport, Unit>>;

package/dist/units.js

@@ -11,7 +11,7 @@ export const FEET_PER = Object.freeze({
 });
 /**
  * The unit each surface's rulebook states its dimensions in: the NFL's and the CFL's fields in yards (and the IFAF's, which
- * follows them), the NHL's rink, the NBA's court and the baseball field in feet, a soccer pitch in metres (the Laws'), a tennis court and a pickleball court in feet (the ITF's and USA Pickleball's), a volleyball court, a badminton court and a table in metres (FIVB's, BWF's and ITTF's), a curling sheet in metres (World Curling's rules give metres with feet beside them; Curling Canada's give feet first, and its league `curling-canada` has feet), a rugby field, an Australian football ground, a Gaelic field, a hockey pitch and a handball court in metres (the rulebooks') and a cricket ground in yards (the Laws' and the ICC's; the NLL's box floor and the PLL's and the NCAA men's fields are in the leagues' own feet and yards). A Japanese park's fence is measured in
+ * follows them), the NHL's rink, the NBA's court and the baseball field in feet, a soccer pitch in metres (the Laws'), a tennis court, a pickleball court and a racquetball court in feet (the ITF's, USA Pickleball's and the IRF's), a volleyball court, a badminton court, a table, a padel court, a squash court, a sepak takraw court, a teqball court, a roundnet court and a netball court in metres (FIVB's, BWF's, ITTF's, FIP's, World Squash's, ISTAF's, FITEQ's, the International Roundnet Federation's and World Netball's), a curling sheet in metres (World Curling's rules give metres with feet beside them; Curling Canada's give feet first, and its league `curling-canada` has feet), a rugby field, an Australian football ground, a Gaelic field, a hockey pitch and a handball court in metres (the rulebooks'), a swimming pool, a water polo field, a diving well and an artistic swimming area in metres (World Aquatics') and a cricket ground in yards (the Laws' and the ICC's; the NLL's box floor and the PLL's and the NCAA men's fields are in the leagues' own feet and yards). A Japanese park's fence is measured in
  * metres and converted once: see `parkUnit`.
  */
 export const SURFACE_UNITS = Object.freeze({
@@ -28,6 +28,13 @@ export const SURFACE_UNITS = Object.freeze({
     badminton: "m",
     pickleball: "ft",
     tabletennis: "m",
+    padel: "m",
+    squash: "m",
+    racquetball: "ft",
+    sepaktakraw: "m",
+    teqball: "m",
+    roundnet: "m",
+    netball: "m",
     lacrosse: "m",
     rugby: "m",
     afl: "m",
@@ -35,6 +42,13 @@ export const SURFACE_UNITS = Object.freeze({
     cricket: "yd",
     fieldhockey: "m",
     handball: "m",
+    // The pools: World Aquatics' Competition Regulations print every figure in metres.
+    swimming: "m",
+    waterpolo: "m",
+    diving: "m",
+    artisticswimming: "m",
+    athletics: "m",
+    skating: "m",
 });
 /** True when `unit` is one of the six. */
 export const isUnit = (unit) => typeof unit === "string" && Object.prototype.hasOwnProperty.call(FEET_PER, unit);

package/dist/uprights.board.d.ts

@@ -0,0 +1,17 @@
+import { type Upright } from "./turn.kit.ts";
+/** Where the board goes: `hung` over the middle, or `standing` behind an end (behind centre field in a ballpark). */
+export declare const boardKind: (sport: string) => "hung" | "standing";
+/** What a badge drawing is, taken apart: its size, the attributes of its root (the colours and the look, which its rules read) and what is drawn in it. */
+export declare function badgeParts(svg: string): {
+    w: number;
+    h: number;
+    attrs: string;
+    inner: string;
+} | undefined;
+/** The scoreboard of a surface: its badge on a board, hung or standing, as one plane that faces the eye. */
+export declare function scoreboard(badge: string, sport: string, area: {
+    x0: number;
+    y0: number;
+    x1: number;
+    y1: number;
+}, thin: number): Upright | undefined;

package/dist/uprights.board.js

@@ -0,0 +1,59 @@
+// The score, stood up: in the 3D view the score is not a panel lying on the floor but a scoreboard. A court or a rink has one hung over its middle on cables; a
+// field has one standing behind an end (a ballpark's behind centre field). It is the score's badge (the compact strip `size: "badge"` draws) on a dark board that
+// turns to face the eye, so that it can be read from wherever the view is. Nothing here is a rule: the sizes and the heights are ours.
+import { plane, n } from "./turn.kit.js";
+/** The sports that hang their board over the middle: the indoor ones with a floor in the middle of a hall. */
+const HUNG = ["nba", "nhl", "volleyball", "badminton", "handball", "tennis", "pickleball", "sepaktakraw", "netball"];
+/** Where the board goes: `hung` over the middle, or `standing` behind an end (behind centre field in a ballpark). */
+export const boardKind = (sport) => (HUNG.includes(sport) ? "hung" : "standing");
+/** What a badge drawing is, taken apart: its size, the attributes of its root (the colours and the look, which its rules read) and what is drawn in it. */
+export function badgeParts(svg) {
+    const root = /^<svg\s([^>]*)>/.exec(svg);
+    if (root === null)
+        return undefined;
+    const box = /viewBox="0 0 ([\d.]+) ([\d.]+)"/.exec(root[1]);
+    if (box === null)
+        return undefined;
+    const keep = [...root[1].matchAll(/([\w:-]+)="([^"]*)"/g)]
+        .filter(([, name]) => !/^(xmlns|viewBox|width|height|role|aria-labelledby|class|part|data-version)$/.test(name))
+        .map(([, name, value]) => `${name}="${value}"`)
+        .join(" ");
+    const inner = svg
+        .slice(root[0].length, svg.lastIndexOf("</svg>"))
+        .replace(/<title[\s\S]*?<\/title>/, "")
+        .replace(/<desc[\s\S]*?<\/desc>/, "")
+        .replace(/<style[\s\S]*?<\/style>/, "");
+    return { w: Number(box[1]), h: Number(box[2]), attrs: keep, inner };
+}
+/** The scoreboard of a surface: its badge on a board, hung or standing, as one plane that faces the eye. */
+export function scoreboard(badge, sport, area, thin) {
+    const parts = badgeParts(badge);
+    if (parts === undefined)
+        return undefined;
+    const L = area.x1 - area.x0;
+    const W = area.y1 - area.y0;
+    const kind = boardKind(sport);
+    // The board: as wide as a third of a court's length or nearly half a field's width, and a third as tall, with the badge inside a margin.
+    const wide = kind === "hung" ? Math.min(0.3 * L, 44) : sport === "tabletennis" ? 0.6 * L : sport === "mlb" ? 0.24 * L : Math.min(0.36 * W, 80);
+    const tall = wide * 0.32;
+    const margin = wide * 0.025;
+    const scale = (wide - 2 * margin) / parts.w;
+    const lift = kind === "hung" ? Math.min(30, 12 + 0.1 * L) : tall * 0.9;
+    // Hung: cables from the board's top corners up; standing: legs from its bottom corners down to the ground.
+    const extra = kind === "hung" ? tall * 0.9 : lift;
+    const total = tall + extra;
+    const line = Math.max(thin * 2.5, wide * 0.008);
+    const board = `<rect x="0" y="${n(kind === "hung" ? extra : 0)}" width="${n(wide)}" height="${n(tall)}" rx="${n(wide * 0.02)}" class="u-sbframe"/>`;
+    const top = kind === "hung" ? extra : 0;
+    const badgeAt = `<g class="kyogijo" ${parts.attrs} transform="translate(${n(margin)} ${n(top + (tall - parts.h * scale) / 2)}) scale(${n(scale)})">${parts.inner}</g>`;
+    const holds = kind === "hung"
+        ? `<path d="M${n(wide * 0.12)} 0V${n(extra)}M${n(wide * 0.88)} 0V${n(extra)}" class="u-sbline" fill="none" stroke-width="${n(line)}"/>`
+        : `<path d="M${n(wide * 0.14)} ${n(tall)}V${n(total)}M${n(wide * 0.86)} ${n(tall)}V${n(total)}" class="u-sbline" fill="none" stroke-width="${n(line * 1.6)}"/>`;
+    // Where it is: over the middle of the surface, or behind an end (behind the centre-field fence in a ballpark, where the surface's top edge is the far side).
+    const cx = sport === "mlb" ? (area.x0 + area.x1) / 2 : kind === "hung" ? (area.x0 + area.x1) / 2 : area.x1 + 10 + 0.04 * L;
+    const cy = sport === "mlb" ? area.y0 - 14 : (area.y0 + area.y1) / 2;
+    const bottom = kind === "hung" ? lift : 0;
+    const high = bottom + total;
+    const planes = [{ ...plane("scoreboard", "screen", [cx - wide / 2, cy, high], [wide, 0, 0], [0, 0, -total], `${holds}${board}${badgeAt}`), billboard: true }];
+    return { id: "scoreboard", kind: "scoreboard", at: [cx, cy], height: kind === "hung" ? lift : lift, planes };
+}

package/dist/uprights.d.ts

@@ -0,0 +1,37 @@
+import { type Plane, type Upright, type UprightKind } from "./turn.kit.ts";
+import { type Unit } from "./units.ts";
+import type { Language, SurfaceOptions } from "./types.ts";
+/** What can be asked of the uprights. */
+export interface UprightOptions {
+    /** Volleyball: the net at the men's height (2.43 m, the default) or the women's (2.24 m). */
+    netHeight?: "men" | "women";
+    /** Where the score of a score drawing goes: `board` (the default) hangs it up as a scoreboard (over the middle of a court or a rink, behind an end of a field) and takes the panel off the floor; `floor` leaves it on the floor. */
+    score?: "board" | "floor";
+    /** Leave the boards and the glass off a rink, and the walls and fence off a padel, squash or racquetball court, so that it can be seen into. On by default. */
+    boards?: boolean;
+    /** Only these kinds of thing; every kind the surface has when missing. */
+    only?: readonly UprightKind[];
+}
+/** What stands on a surface. */
+export interface Uprights {
+    items: Upright[];
+    /** How far the surface itself stands over the ground, in feet: a table tennis table's top, 0 on every other surface. */
+    lift: number;
+    /** The thinnest line or strip drawn on this surface, in feet. */
+    thin: number;
+    /** The playing surface itself in feet, the part the view is fitted to (the ground round it may run out of the picture): `undefined` for a surface with no uprights, which is fitted whole. */
+    area?: {
+        x0: number;
+        y0: number;
+        x1: number;
+        y1: number;
+    };
+}
+/** All the planes of all the things. */
+export declare const planesOf: (u: Pick<Uprights, "items">) => Plane[];
+/** What stands on the surface the options draw: nothing on a curling sheet, which is flat. */
+export declare function uprightsFor(o: SurfaceOptions, settings?: UprightOptions): Uprights;
+/** The unit the heights are said in: the options' own, else the rulebook's of the sport. */
+export declare function heightUnit(o: Pick<SurfaceOptions, "sport" | "league" | "units">): Unit;
+/** What stands on the surface, in a sentence, with heights: for a reader who cannot see the 3D view. An empty string when nothing stands on it. */
+export declare function describeUprights(o: SurfaceOptions, uprights: Uprights, language?: Language): string;

package/dist/uprights.fields.d.ts

@@ -0,0 +1,32 @@
+import type { FieldPlan } from "./fields.types.ts";
+import { type FencePoint, type FootballSpec } from "./geometry.ts";
+import type { SoccerSpec } from "./surfaces/soccer-spec.ts";
+import type { ParkWall } from "./parks.ts";
+import { type Plane, type Upright } from "./turn.kit.ts";
+/**
+ * The crossbar of a football post is 10 ft over the ground (NFL 2026 Rule 1-3-1: "the top face of which is 10 feet above the ground"; CFL 2026 Rule 1-1-1:
+ * "a height of 10 feet"; NCAA 2025 Rule 1-2-5-a: "the top of which is 10 feet above the ground"). The uprights reach 35 ft over the bar in the NFL (Rule 1-3-2: 45 ft
+ * in all), 40 ft above the ground in the CFL (Rule 1-1-1: "extend 40 feet above ground level"), and at least 30 ft above the ground in the NCAA (Rule 1-2-5-a), the
+ * figure drawn for every other league.
+ */
+export declare const FOOTBALL_CROSSBAR = 10;
+/** The pylon is 18 in high: the NFL's Rule 1-2-3 names pylons but not their size; BAFA's Appendix D (14) recommends 4 in by 4 in and 18 in. */
+export declare const PYLON_HEIGHT = 1.5;
+/** A football field's uprights: the post at each end and the eight pylons. `shape` is the post of the season, `top` the height of the uprights above the ground. */
+export declare function footballUprights(spec: FootballSpec, shape: "h" | "slingshot", top: number, thin: number): Upright[];
+/** A soccer pitch's uprights: both goals and, unless the options turn them off, the four corner flags. */
+export declare function soccerUprights(spec: SoccerSpec, flags: boolean, thin: number): Upright[];
+/** The rugby posts, Gaelic goal posts, Australian football posts and cricket stumps; a goal with a net for the sports that have one. */
+export declare function fieldUprights(plan: FieldPlan, thin: number): Upright[];
+/** The fence's height where no wall is listed: 8 feet. */
+export declare const FENCE_HEIGHT = 8;
+/** How high the wall stands at an angle from dead centre, the wall that names it or the usual 8 feet. */
+export declare const wallHeightAt: (walls: readonly ParkWall[], angle: number) => number;
+/** The planes of a fence: one standing wall over each stretch of its line, as high as the wall there. */
+export declare function fencePlanes(points: readonly FencePoint[], walls: readonly ParkWall[], thin: number): Plane[];
+/**
+ * A ballpark's uprights: the fence, the two foul poles where the foul lines meet it, and the backstop behind home plate. Official Baseball Rules 2025, 2.01, gives no height
+ * for a fence or a foul pole, and only recommends the backstop 60 ft or more from home base: the 8 ft of the fence where no wall is listed, the poles' 30 ft and the
+ * screen's 70 ft by 20 ft are ours.
+ */
+export declare function ballparkUprights(points: readonly FencePoint[], walls: readonly ParkWall[], thin: number): Upright[];