@johnmorrisdotca/kyogijo-stadiums 0.4.0 → 0.6.0

package/dist/types.d.ts

@@ -1,13 +1,23 @@
 import type { Background } from "./background.ts";
+import type { EmblemRef, EmblemRenderer } from "./emblems-source.ts";
 import type { Layer } from "./layers.types.ts";
 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";
+import type { Situation } from "./situation.types.ts";
+import type { BudoStyle, DojoSpec, BudoScore } from "./budo/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 budō: the contest areas of judo and karate, the kendo shiai-jo, the sumo dohyō, the kyūdōjō, and a dojo of tatami. */
+export type BudoSport = "judo" | "karate" | "kendo" | "sumo" | "kyudo" | "dojo";
+export type { BudoStyle, DojoSpec, BudoScore };
+/** 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" | BudoSport;
 /** `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 +101,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 +230,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`. Judo and karate: `contest-area`, `start`. Sumo: `ring`. Kyudo: `shajo`, `yamichi`, `azuchi`. Dojo: `kamiza`, `half`. 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" | "contest-area" | "ring" | "shajo" | "yamichi" | "azuchi" | "kamiza";
 /** 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 +362,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 +381,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 +433,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, an SVG document as text, or, with a renderer of emblems plugged in, the id of one: `"trophy:hockey-cup"`). Yours; none is supplied. */
+    emblem?: EmblemRef;
+    /** `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". */
@@ -333,8 +484,8 @@ export interface Team {
     abbr?: string;
     /** The score. A number, or text such as "–" before the game. */
     score?: number | string;
-    /** The logo: an `https:` or relative address, an image `data:` address, or an SVG document as text. */
-    logo?: string;
+    /** The logo: an `https:` or relative address, an image `data:` address, an SVG document as text, or, with a renderer of emblems plugged in (`useEmblems`), the id of a ready-made emblem: `"crest:shield"` takes the team's `color`, `textColor` and `abbr`. */
+    logo?: EmblemRef;
     /**
      * How the logo is drawn: `round` clips it to a circle with a thin ring (a flag, or a crest) and, for a team with no logo, draws its initials on its colour; `plain` is the
      * logo as it is, in a box. The score's `markShape` is the default for both teams.
@@ -342,13 +493,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)[];
@@ -363,6 +516,8 @@ export interface Team {
     wickets?: number | string;
     overs?: number | string;
     innings?: readonly (number | string | null | undefined)[];
+    /** Judo, karate, kendo and sumo: what the team has scored, as the sport counts it (see `BudoScore`). */
+    budo?: BudoScore;
     /** The team's colour, for its end, key or dugout. */
     color?: string;
     /** The colour of the words on that colour. Black or white by the colour's lightness when missing. */
@@ -411,6 +566,8 @@ export interface SurfaceOptions {
     description?: string;
     /** A prefix for the ids inside the drawing. Made from the options when missing, so that the same call gives the same drawing. */
     id?: string;
+    /** A renderer of ready-made emblems for this drawing alone, so that a `logo`, an `emblem` or a mark may be an emblem's id: `emblems: renderEmblem` from `@johnmorrisdotca/dougu-sports/emblems`. Over the one the page plugged in with `useEmblems`. */
+    emblems?: EmblemRenderer;
     /** The ground to draw round the playing surface, in `units` (feet by default). A default for each sport. */
     margin?: number;
     /**
@@ -471,16 +628,33 @@ 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 budō surfaces (judo, karate, kendo, sumo, kyudo): the size of the area, the marks, the number of areas, the look. See `BudoStyle`; the rulebook is the `league`. */
+    budo?: BudoStyle;
+    /** A dojo of tatami (`sport: "dojo"`): the mats, the pattern, the walls, the kamiza. See `DojoSpec` and `dojo()`. */
+    dojo?: DojoSpec;
     /** 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. */
     ground?: string;
+    /** The arena to draw an NHL rink or an NBA court of: a key of `ARENAS`. The rink or the court has the size its sources publish where that differs from the league's (the league's where none does), the markings are those of `year`, and the drawing carries the arena's name for `year`. A `league` of your own wins over the arena's size. */
+    arena?: string;
     /** Draw a soccer pitch in a data provider's own coordinates (`opta`, `statsbomb`, `wyscout`, `tracab`, `metrica`, `skillcorner`, `secondspectrum`, `impect`, `uefa`, `international`), or in a frame of your own: the lines stand where the provider puts them, and an empty `ky-data` group in its units is put in the drawing for raw data. */
     pitchType?: SoccerProviderId | SoccerFrame;
     /** Only half of a soccer pitch: the `left` half or the `right` one. Ignored when the drawing has teams. `range: "half"` does the same for every sport and for a score too. */
@@ -503,6 +677,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. */
@@ -526,6 +705,20 @@ export interface SurfaceOptions {
      * under a score's panel), cut to the surface's outline, and described in the drawing's description. See `drawLayers` and `layerTable`.
      */
     layers?: readonly Layer[];
+    /**
+     * Write what `clientPointToField` (the `pointer` entry) needs on the drawing's surface group: the box of the playing surface and the options that decide its rules (the league, the
+     * season, the park, the pitch). Off by default, so that a drawing without data is the same text as ever; a page that asks where a click is turns it on.
+     */
+    pointer?: boolean;
+    /** Write `data-mark-id`, `data-index` and `data-zone` on every mark of every data layer, for one listener to link a mark to a table (about 55 bytes a mark). Off by default; a layer whose data has an `id` has them anyway, and `pointer: true` turns them on. */
+    marks?: boolean;
+    /**
+     * The situation of the game, drawn on the surface, in the badge and in the compact card: hockey's skaters (a power play or an empty net as a pill, the attacking zone tinted) and its
+     * shootout as a strip of dots across centre ice; baseball's runners (the bases lit), outs, inning and count (a scorebug in the badge); football's down and distance (the line of scrimmage
+     * in blue, the first-down line in yellow, the red zone tinted, a tag) and a drive chart. For `nhl`, `mlb`, and the football fields; any other sport, and a special game, draws none.
+     * Off by default, and then the drawing is byte for byte as it was. See `docs/situation.md`.
+     */
+    situation?: Situation;
     /** `embed` (the default) writes the stylesheet into the drawing so that it stands alone; `none` leaves it to the page. */
     style?: "embed" | "none";
     /** An extra class on the `svg`. */
@@ -562,4 +755,12 @@ 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;
+    /**
+     * Where the score goes: `centre` (the panel stands on the middle of the surface), `strip` (the compact strip under the drawing, as a pageant's `score: "strip"` does) or `auto` (the default:
+     * the centre, unless the drawing has a `lineup` layer, whose players the panel would hide, and then the strip). The strip also carries the situation's pill, scorebug or tag, which a drawing
+     * with a lineup then leaves off the surface. A pageant has its own `pageant.score`, which says it for the drawing.
+     */
+    score?: "auto" | "centre" | "strip";
+    /** 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,20 @@ 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",
+    // The budō: the federations print their figures in metres (the kyūdōjō's and the dohyō's too), and a dojo is counted in mats of metres.
+    judo: "m",
+    karate: "m",
+    kendo: "m",
+    sumo: "m",
+    kyudo: "m",
+    dojo: "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.budo.d.ts

@@ -0,0 +1,17 @@
+import { type Upright } from "./turn.kit.ts";
+import type { SurfaceOptions } from "./types.ts";
+/** What the 3D view makes of a budō surface: the things that stand, how high the surface itself stands, and the box the view is fitted to. */
+export interface BudoUprights {
+    items: Upright[];
+    lift: number;
+    area: {
+        x0: number;
+        y0: number;
+        x1: number;
+        y1: number;
+    };
+}
+/** The walls of a dojo, 3 m high (ours). */
+export declare const DOJO_WALL = 3;
+/** What stands on the budō surface the options draw. */
+export declare function budoUprights(o: Pick<SurfaceOptions, "sport" | "league" | "budo" | "dojo" | "detail">, thin: number): BudoUprights;