@johnmorrisdotca/kyogijo-stadiums 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -7,10 +7,85 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-10-14
+
+Thirteen new sports (padel, squash, racquetball, sepak takraw, teqball, roundnet and netball, with sitting volleyball; swimming, water polo, diving and artistic swimming; athletics and skating), which makes 33. A 3D view that stands what a rulebook puts on a surface (nets, posts, goals, walls, blocks, boards, bars, hurdles, boards and platforms) on a floor that turns. A crowd in the stands, and a pageant of flags and crests over the halves. A folded curling sheet, with a heat chart and statistics. A realistic basketball floor. The clubs that played in each ballpark and ground, with their Japanese names as Japanese media say them.
+
+### Added
+
+- **Athletics and skating in the 3D view** ([docs/turn.md](./docs/turn.md#what-stands-on-each-surface)). An athletics stadium has the high jump's uprights 4.02 m apart with a bar, the pole vault's 5.20 m apart with a bar, the discus and hammer cage with its netting 4 m high and 6 m at the front of each side (Facilities Manual 2.4.1.3), the hurdles of the races a drawing marks at their heights (1.067, 0.838 and 0.914 m) in every lane, and the steeplechase's five barriers with the water jump's pit; a skating rink has the padding round a long or short track, 0.80 m high (ISU Rule 228.2), or a figure skating rink's boards, which are cut away on the eye's side like a hockey rink's. New upright kinds `hurdles`, `steeplechase`, `high-jump`, `pole-vault`, `cage`, `padding` and `rink-boards`, in English and Japanese. The javelin, the finish posts and the skating blocks have no height among the figures and are not drawn. Athletics gets a crowd profile (an oval bowl) and skating one (an arena's two tiers); both are in the e2e list.
+- **The pools in the 3D view, at the heights of World Aquatics' rules** ([docs/turn.md](./docs/turn.md#what-stands-on-each-surface), [docs/sources.md](./docs/sources.md#heights-in-the-3d-view)). A swimming pool has a numbered starting block 0.7 m high in each lane at each end, a flagged rope 1.8 m above the water 5 m from each wall and the false start rope 1.2 m above it at 15 m; a diving well its springboards (1 m and 3 m) and platforms (5, 7.5 and 10 m, or the ones asked for) on stands and towers; a water polo field a floating goal on each goal line, 3 m wide with the bar's underside 0.9 m over the water; an artistic swimming area the judges' platform (0.6 m) and the starting platform (0.7 m). New upright kinds `starting-blocks`, `backstroke-flags`, `false-start-rope`, `springboards`, `platforms` and `judges-stand`, in English and Japanese (スタート台, 背泳ぎ用フラッグ, フォルススタートロープ, 飛板, 固定台, ジャッジ台). The pools are in the e2e list of surfaces that stand up.
+- **Walls give way to the eye in the 3D view.** The glass and walls of a padel court, the walls of squash and racquetball courts and the boards and glass of a rink are cut away on the side nearest the eye, more the lower the eye is, and are whole again from above or from the far side: `Plane.shy`, `fadeOf` and `Layout.fade` (`/turn`).
+- **A folded curling sheet has no crowd.** Its enlarged houses cover where the stands would be, so `crowd` on a folded sheet draws nothing; the same sheet with a score shows the whole sheet and keeps its stands, with a pageant as well.
+- **A folded curling sheet: `sheet.show: "folded"`** ([docs/curling.md](./docs/curling.md#the-top-end-the-bottom-end-or-both-folded)). The whole sheet as a strip, with its two houses enlarged beside it, so that a sheet 150 feet long and 15 wide fills a roughly square frame. A tall drawing has the top house on the left of the strip and the bottom house on the right; a wide one has the left house above and the right house below (the same drawing turned a quarter). The strip keeps its scale and its numbers, so a data layer lies on it as on a sheet drawn whole; each panel is the same sheet from the hog line to the back line (`sheet.panels: "half"`, the default) or just the house (`"house"`), enlarged until the whole has the shape `sheet.fit` asks (width over height, 0.5 to 2, a square by default; a panel is never longer than the strip), labelled ("Top house", "Bottom house", "Left house", "Right house"; in Japanese too) and joined to the part of the strip it enlarges by a faint fan and a frame. Stones, heat and every other layer are drawn in the strip and again in each panel, at the panel's scale, with the copies hidden from a screen reader and ids of their own. `range: "folded"` says the same (a new name in `RANGES.curling`), the description says what is enlarged and where, a score still shows the whole sheet, and the annotations (`landmarks`, `axes`, `direction`) are not drawn on it. The scene, the canvas, d3, Plot, GeoJSON and PNG read it like any drawing. New: `SheetShow` has `"folded"`, `SheetStyle.panels` and `SheetStyle.fit`, `RangeName` has `"folded"`, and `KYOGIJO_FOLD_STYLE` (written in only by a folded sheet; every other curling drawing is the same text as before).
+- **`top` and `bottom` as names for a tall sheet's ends.** `sheet.end` and `range: { name, end }` take `top` (the left end, the far house of a tall drawing, the default) and `bottom` (the right end) as well as `left` and `right`; the new type is `SheetEnd`. The top end alone and the bottom end alone are `show: "half"` or `"house"` with either, and are documented as the three ways to look closer at a tall sheet.
+- **`curlingHeat`: where the stones of many ends came to rest** (`@johnmorrisdotca/kyogijo-stadiums/charts`, [docs/curling.md](./docs/curling.md#where-the-stones-of-many-ends-came-to-rest)). A chart on the heat layers: stones counted into square cells (a foot by default), hexagons, a density or the zones of the house (the button, the three rings and the free guard zone), or drawn as translucent discs in each team's colour so that stones that fall on each other build up colour. It judges the stones by `curlingScore`'s rules, and keeps one team's stones (`team`), only the free guards or only the stones in the house (`only`); on the half, the house, the whole sheet or the folded sheet (`show`). The totals say how many stones were in play and drawn, the free guards and the stones in the house for each team, and the share in each zone. New: `CurlingHeatOptions`, `CurlingHeatTotals`, the `titleCurlingHeat`, `curlingHeatStat`, `sumCurlingHeat`, `curlingHeatTeam`, `curlingHeatGuards` and `curlingHeatHouse` words of `KYOGIJO_STRINGS[...].charts` (`en` and `ja`; a custom set of words must give them) and `CurlingOptions.show`, so that `curlingStones` can be folded too.
+- **Curling statistics, beside `curlingScore`:** `curlingFreeGuards` (the free guards of a layout: a stone in play between the tee line and the hog line and not touching the house), `curlingInPlay` (the stones in play after each throw, and the most), `curlingHammers` and `curlingEndStats` (each end's record, and for each team its points, hammer efficiency, how often it scored, blanked, was held to one or was stolen from with the hammer, and its steal rate without it), `curlingGuardScores` (the free guard analysis: points against guards, by band, for the team with the hammer and the team without it) and `curlingShotStats` with `curlingIsHit` and `CURLING_HIT_TYPES` (shot percentage, hit rate and the types played). Pure functions of plain data. Written from the rules and from what curlovision and Jordan Myslik's curling analytics describe; nothing of either was copied (see [references](./docs/references.md#curling)), and [Curling](./docs/curling.md#what-other-curling-analyses-offer-and-what-is-here) compares what each offers with what is here.
+- **`HeatLegend.region`** (and the same on a `legend` layer): a heat layer's colour bar is sized and placed against a part of the surface in feet instead of the whole of what is shown, so that it can be read on the half of a sheet or in an enlarged house.
+- The docs' curling gallery has the folded sheet, the top end and the bottom end, the heat chart in each of its views and a game's ends in one picture; the demo has a Show choice for a curling sheet (whole sheet, top end, bottom end, folded) with finger-wide buttons, in English and Japanese, in the address and in the code it writes.
+- **A realistic basketball floor** (`court: { hardwood: true }`, [docs/hardwood.md](./docs/hardwood.md)). The court seen from above as a maple strip floor: boards of one width (2.25 inches by default) running the length of the court, each row ending in different places from the rows next to it, each board with a tone of its own and fine grain along it, all laid from a seed (`seed`, 1 by default) with a generator of our own, so the same options give the same floor in every renderer; the keys, the centre circle and the border are stain, with the wood and the seams showing through (`stain`, 0.82 by default); the strip behind each baseline takes the colour of the team that defends it (`leftColor` and `rightColor`, a team's `color` in a score, or the new `baselineColor`); the baseline words are set in that strip and new `sidelineText` along the sides; `centreLogo` (an image or an SVG document) fills the centre circle; each basket is drawn from above with its backboard, rim, net and padded stanchion and a soft shadow; the coaching box's lines, the scorers' table and the two benches stand along the bottom sideline; and a satin sheen and the shade at the floor's edge are gradients over the paint (`sheen`). Every league of the sport takes it (NBA, WNBA, FIBA, NCAA men's and women's, NFHS, G League), wide and tall, in light and dark, with a score, a `range`, a `host`, and the data layers and charts over it. The detail drops at small sizes: `detail: "auto"` draws the plain floor (broad boards, the stain and the sheen, one shadow, no seams, grain, table or benches) for `detail: "simple"` or a `width` under 480 pixels, and `fine` or `plain` can be asked for. It is made only of patterns, gradients and rectangles, so the scene, the canvas, d3, Plot, GeoJSON and PNG renderers all draw it: the SVG is about 30 kB in the fine detail (the clean court's is about 11 kB) and about 15 kB in the plain, from two tiles of pattern and about 90 more shapes. Off by default, and a drawing without it is the same text as before. New: the options `HardwoodOptions` and `CourtStyle.hardwood`, `CourtStyle.baselineColor` and `CourtStyle.sidelineText`, `KYOGIJO_HARDWOOD_STYLE` (also in `KYOGIJO_STYLE`) and `HARDWOOD_SMALL`.
+- The demo's court controls have a "Real hardwood" chip (a finger wide on a phone, in English and Japanese), and the court cards show the real floor in a club's colours and its plain version for small sizes; the docs gallery has the floor in nine drawings, each made from the code beside it.
+- **Multi-sport places: the clubs that played in each ballpark and ground** ([docs/atlas.md](./docs/atlas.md#tenants)). `Place.tenants` lists the clubs that played their home matches in a place, each with its `club` (and `clubJa`), `league`, `sport`, first and last year (`from`, `to`), Wikidata item and `source` (the Wikidata statement, the article and revision, and which of the two the years were read from): 443 tenants (333 clubs) at 155 of the 158 places, 117 of them still there, among them the BC Lions and the Whitecaps at BC Place, the Expos and the Alouettes at the Olympic Stadium in Montreal, the Blue Jays, the Argonauts and the Raptors (1995 to 1999) at the Rogers Centre, the Giants and the Jets at MetLife Stadium, the Patriots and the Revolution at Gillette Stadium and the Seahawks, the Sounders and the Reign at Lumen Field. The clubs and their leagues are Wikidata's (CC0, the places' occupants P466 and the clubs' home venues P115) and the `tenants` lines of the infoboxes of the places' English Wikipedia articles (CC BY-SA 4.0, at the revision named); the years are Wikidata's where it has them and the article's otherwise, never guessed. `pnpm tenants:fetch` reads them and `pnpm tenants` builds `src/tenants.data.ts`.
+- `tenantsOf(place, { year, league, sport, current })` (`/atlas`): a place's clubs, the current ones first; `placesByClub(name)`: the places a club played in, by its name in English or in Japanese, in full or by a word of it (`Whitecaps`, `ライオンズ`); `surfacesOf(place)`: every surface a place offers, its own first and then one for each sport a tenant plays that the package draws (the CFL's field for BC Place, the NFL's for MetLife Stadium, the NRL's for Stadium Australia); and `surfaceOf(place, sport)`: the surface a place offers for a sport (`surfaceOf(bcPlace, "cfl")` is `{ sport: "cfl" }`, `surfaceOf(fenwayPark, "cfl")` is `undefined`). New: `TENANTS`, the types `Tenant`, `TenantArticle`, `TenantSource`, `TenantSport`, `TenantFilter`, `PlaceSurface` and `SurfaceSport`.
+- The demo's Atlas panel lists the clubs that played in a place with their league and years, offers a button for each other surface a place has (BC Place: the CFL field; the Olympic Stadium: the CFL field, the NFL field and the soccer pitch) that opens the playground on that sport, groups the league filter into the main leagues and tournaments and the rest, and finds a place by a club's name in English or Japanese; English and Japanese words for the new controls and for the leagues that have a Japanese name.
+- **The 3D view hangs the score up as a scoreboard** (`score: "board" | "floor"` in the settings, `board` by default; [docs/turn.md](./docs/turn.md#the-score)). The badge of the score is put on a dark board that turns to face the eye: hung on cables over the middle of a court or a rink, standing on legs behind an end of a field, a pitch, a table or a curling sheet, behind centre field in a ballpark. The floor loses its panel and keeps the teams' names. This needs a new option for every drawing, `plate: false` (`ScoreOptions.plate`), which draws a score with the teams' places and no panel; on by default, and a drawing without it is the same text as before. New: `Plane.billboard`, `facing`, `scoreboard`, `UprightKind` `"scoreboard"`, `UprightOptions.score`, and the `scoreboard` word of `turn.parts`.
+- **A 3D view: `@johnmorrisdotca/kyogijo-stadiums/turn`** ([docs/turn.md](./docs/turn.md)). Any surface as a floor that turns: the flat drawing itself (with its score, data layers and labels) tipped and turned by the mouse, a finger, Ctrl and the wheel or the keys, with four viewpoints (`overhead`, `broadcast`, `end`, `corner`; the broadcast view is turned a little to show the boards, nets and goals their faces, the net sports' is from behind an end line, where a net can be seen, and a curling sheet's is square on) and a reset, in plain DOM and CSS with no dependency. `mountKyogijoTurn(container, options, settings)` mounts it and gives back `view()`, `set()`, `preset()`, `reset()`, `update()`, `svg()` and `destroy()`; `<kyogijo-field turn turn-view="end">` is the element's way (`turn-controls`, `turn-uprights`, `turn-touch`, and `turn` and `turnSettings` properties); `turnMarkup(options, settings)` is the same view as a string, pure, for a server. Every part that stands up is a flat rectangle with a little SVG on it, and every element carries its whole place on the screen in one `matrix3d`, stacked far to near by `z-index`: nothing is nested in 3D (no `preserve-3d`), so Safari on a phone cannot flatten it, and the flat drawing stays where 3D is not available (`turnSupported`), with a sentence that says so. What stands on each surface, at the height the current rulebook gives (each read on 2026-10-13 and cited by rule number in [docs/sources.md](./docs/sources.md#heights-in-the-3d-view), with what is ours said to be): the NHL's glass is 8 ft over the boards at the ends and 6 ft along the sides, the NFL's uprights 45 ft, the CFL's 40 ft and the NCAA's at least 30 ft, rugby league's 16 m, a basket's board lower edge 150 mm under the ring (FIBA 1.1.5) and its stanchion 2 m behind the end line (FIBA 1.4.3).  the volleyball net at 2.43 m or 2.24 m (`netHeight: "women"`) with its posts and antennae, the nets and posts of tennis (and singles sticks), badminton, pickleball and table tennis (the table lifted 76 cm on legs), each basket's backboard, rim, net and stanchion, a rink's boards, glass and goals, the goals of soccer (with corner flags), handball, field hockey and lacrosse, the posts and pylons of football, the posts of rugby, Gaelic football and Australian football, a cricket pitch's stumps, and a ballpark's fence (as high as its walls), foul poles and backstop. `uprightsFor` and `describeUprights` give them as planes and as a sentence; the view's description says what stands in it, with its heights in the rulebook's own unit, in English and Japanese. A finger drags sideways to turn the view and leaves a vertical swipe to the page (`touch: "turn"` keeps every touch); the wheel is the page's unless Ctrl is held or the view is focused; the keys are the arrows, plus and minus, 1 to 4 and 0; the buttons are 44 pixels or more; a viewpoint, a reset and the end of a drag are said in a polite live region; with `prefers-reduced-motion` the view jumps instead of gliding. New: `mountKyogijoTurn`, `turnMarkup`, `turnMarkupOf`, `buildTurn`, `layoutOf`, `turnSupported`, `uprightsFor`, `describeUprights`, `planesOf`, `heightUnit`, `TURN_PRESETS`, `NET_PRESETS`, `TURN_PRESET_NAMES`, `KYOGIJO_TURN_STYLE`, the camera's `fit`, `project`, `cameraMatrix`, `clampView`, `drag` and `step`, the types `KyogijoTurn`, `TurnSettings`, `TurnView`, `TurnPreset`, `TurnModel`, `Uprights`, `UprightOptions`, `Plane` and the rest, the `turn` words of `KYOGIJO_STRINGS` (`en` and `ja`; a custom set of words must give them), and `pitchOf` is exported from the drawing's own module for it.
+- The demo's playground has a View switch (Flat, 3D): the surface in 3D with the viewpoint buttons under it, the viewpoint in the address (`view=3d&viewpoint=end`), the 3D code in the code tabs; and `e2e/turn.demo.mjs` plays it in Chromium, on a phone and in WebKit.
+- **Seven more court sports, and sitting volleyball** ([docs/courts.md](./docs/courts.md)), each drawn to scale from its governing body's own current rules, with its named looks (light and dark), a free zone where the rulebook gives one, simple and full detail, wide and tall, an outline, a description and labelled parts in English and Japanese, a frame, ranges, a score and a badge (`SPORTS` is now 27):
+  - **`padel`** (the FIP's Rules of Padel, review of 1 January 2026): 20 by 10 m inside its walls, the service lines at 6.95 m, the central service line, the net, and the walls and metal fence of the enclosure.
+  - **`squash`** (World Squash's Specifications for Squash Courts, 28 November 2017): the short line, half court line and service boxes of the floor, with the front wall laid flat beside it to show its tin, service line and front wall line; `league: "wsf-doubles"` and `"wsf-doubles-wide"` for the doubles courts.
+  - **`racquetball`** (the IRF's Official Rules 2026-2028 and Court Specifications): 40 by 20 feet, the short line, service line, service boxes, drive serve lines and the broken receiving line.
+  - **`sepaktakraw`** (the ISTAF's Law of the Game, 2013 edition, the one that could be read): 13.4 by 6.1 m, the centre line, four quarter circles, two service circles, the net.
+  - **`teqball`** (the FITEQ's rules, 2026): the 3 by 1.5 m table and its net in the middle of a court of 16 by 12 m, the halfway line, the service lines, the surrounds.
+  - **`roundnet`** (the International Roundnet Federation's rules, 2022): the set, the no hit zone line, the serving line and the four service positions, on a square with no out of bounds.
+  - **`netball`** (World Netball's Rules of Netball, 2024): 30.5 by 15.25 m, the transverse lines, centre circle, goal circles and goalposts with their rings; scored as a goals sport, with the usual score and the home team on the left.
+  - **`league: "wpv-sitting"`** of `volleyball` (World ParaVolley's Official Sitting Volleyball Rules 2025-2028): 10 by 6 m, the attack line at 2 m, a 7 m net 1.15 m high.
+  - New zone sets `wall-court` (squash, racquetball) and `roundnet-rings`; `net-court` now covers padel, sepak takraw and teqball, and `field-thirds` netball. 36 coordinate frames (7 more), 7 more `half-court` ranges, and 7 more sports in the demo's picker, its gallery and the docs gallery, with the sources and licence notes in [docs/sources.md](./docs/sources.md) and [docs/references.md](./docs/references.md).
+  - The colours follow the rulebooks where they give one: squash's lines are red (a dark red on the light floor, a pale red on the dark one; World Squash's specification asks only that markings contrast, clauses 5.01.01 and 10.13, so the red is ours) on the floor and the front wall, with the wall's lines drawn separately as the specification allows; racquetball's lines are the IRF's recommended bright red (blue on the convertible look) on a floor light enough to read them; padel's, netball's and sitting volleyball's lines are white as their rules prefer or require, and sitting volleyball has the wooden floor only (a light indoor floor, Rule 1.2.2).
+  - Footvolley is not drawn: the only rulebook found that gives its dimensions is a European league's, not an international governing body's. Futsal is `pitch: "futsal"` of `soccer`, as before.
+- **The stands and the crowd** (`crowd: true`, [docs/crowd.md](./docs/crowd.md)) on every surface that has spectators. Seating bowls drawn round the surface at the distance a venue of its kind keeps: a bowl, two sides (`sides`), a horseshoe open at an end (`horseshoe`, `open`), an oval round the oval grounds of Australian football and cricket, an arena's courtside rows with a lower and an upper bowl for the rinks and courts, and for a ballpark grandstands along the foul lines and behind home plate with bleachers behind the park's own fence (laid from `fenceOutline`, with a gap at the batter's eye), each stand on a plaza of its own. A soccer pitch in the stadium of an NFL or CFL club (`GRIDIRON_GROUNDS`, or `stadium: "nfl"` or `"cfl"`) keeps the football field's footprint: the stands stand where a football field's stands are and the 360 by 160 foot field is drawn faintly over the pitch (end zones, five-yard lines, dashed outline), so that the gap is seen to scale: the touchlines are 8.5 feet from the front rows, not the 28 to 36 of a ground built for soccer. The people are a seeded tile of 36 seats repeated as an SVG pattern, each seat empty with the probability the density leaves or a dot of shirt (the team's colour in two shades, or a neutral) with a dot of hair over it, so that the stands are a few shapes and a few kB (about 9 kB added to a soccer drawing, 4.5 kB as blocks) however many seats there are: `density` (0 to 1, 0.85 by default), or `attendance` over `capacity` (a ground's own capacity by default for soccer), `seed`, `home` and `away` colours (the teams' colours of a score, else the sides'), the visitors' block at an end or in a corner (`awayEnd`), a card display in stripes or checks behind a goal (`tifo`, `tifoDesign`), and a tunnel, a camera platform, benches and a media row on the bench side (`gaps`). Aisles and the shade of each tier's front wall and roof edge are drawn in the `fine` detail; for `detail: "simple"` or a `width` under 480 pixels (`detail: "auto"`) the stands are blocks of colour with no pattern. The drawing's ground is made as wide as the stands need (a `margin` of your own is kept). It works wide and tall, light and dark (the crowd is dimmer in the dark), as a score with its round marks, with `range` (a crop shows the stands it covers) and with the data layers over it; a special game (`host`) has none. The scene, the canvas, d3, Plot and PNG renderers draw it. `crowdStands(options)` gives the stands as data in feet in the surface's wide frame (rings with their outlines, `from` and `to`, the height of the first and last row, the rake in degrees, the seats; the visitors' and the card display's sectors; the gaps; the footprint; the reach), with `outlinePath` and `outlinePoints`, so that a view that raises the stands (the 3D view of `work/turn`) can use it: a follow-up. Off by default, and a drawing without it is the same text as before. New: `CrowdOptions`, `CrowdShape`, `CrowdStands`, `StandRing`, `StandSector`, `StandGap`, `StandOutline`, `GRIDIRON_GROUNDS` and `KYOGIJO_CROWD_STYLE` (also in `KYOGIJO_STYLE`; `--ky-cr-home` and `--ky-cr-away` are the crowd's colours).
+- **The stands read as seats from above** (polish of the crowd). Row lines every second row follow each tier's curves, with aisles across every tier (square to the front on the sides, fanning round the corners) and every fourth a wider dark vomitory; the visitors' block and a card display are whole sections cut on aisle lines, not wedges (a wedge only round an oval ground); the walk between the tiers is a thin darker band (`concourses`) instead of a wide pale ring, and the roof's edge throws a shade on the upper tier (`roof`, on by default). A soccer pitch's run-off is the 6 metres along the touchlines and 8.5 behind the goal lines that stadium guidance recommends (19.7 and 27.9 feet, 27.7 on the bench side), so that a pitch in a gridiron stadium has the narrower apron at the touchlines (8.5 feet) and a wider one behind the goals (33.8). A ballpark's grandstand edge is a smooth curve with no notches, its bleachers stand 12 feet behind the fence, and where the park has seats on top of a wall (Fenway Park's Green Monster) a band of them runs along the wall at its height (`wallSeats`, `WALL_SEATS`). The stands data gains `aisles` on every ring and `concourses`, a wall's seats are a ring with the tier `wall`, and the tiers of an arena are 7 feet apart.
+- The demo has a "Crowd" chip with a "Card display" chip and a "Seats taken" slider (finger-wide on a phone, in English and Japanese), for every sport, and the docs gallery has the stands in ten drawings (soccer in a bowl, soccer in an NFL stadium, a ballpark, an NHL arena, an NBA arena, curling and more), each made from the code beside it.
+- **The pageant: each team's flag or crest laid large over its half of the surface, and an emblem in the centre** ([docs/pageant.md](./docs/pageant.md)). `pageant: "carpet"`, `"stage"`, `true` (a carpet) or `PageantOptions` on a score drawing, off by default, so a drawing without it is the same text as before. A **carpet** is the flag or logo laid flat over its half, filling the room the half gives it with a margin of about 5% (`fit: "fill"`, the default: its shape may differ from the flag's ratio by up to 1.75 to 1, the art stretched a little and cropped a little; `fit: "ratio"` keeps the flag's own ratio, `Team.logoRatio`, else the `viewBox` of an SVG logo, else 3 to 2), with a border band (`border`: `dark`, `team` or a colour; `borderWidth`), a soft shadow and a gentle fixed wave of light and shade (`fabric`); a **stage** is the crest on a large round disc with a ring (`ring`: `gold`, `team` or a colour), the crest a round mark inside it. A team with no flag or logo is its colours as a carpet of two with its name across a band, or its initials on its colour on a stage. `emblem` (an address, an image `data:` address or an SVG document as text: yours, none is supplied; `emblemShape` `round` or `plain`, `emblemFit`, `emblemName`) goes in the centre circle, centre ice, centre court, the middle of a field or sheet, or on the mound. Every surface has a place for the pictures: the halves, each side of a cricket pitch, a diamond's infield (home) and outfield (visitors), a curling sheet's two houses; each lies wholly inside the surface's outline (a rink's rounded corners, a fence, an oval). Tall and wide drawings lay the halves where the reader sees them and keep every picture upright. The score stays readable by `score`: `centre` (the plate stays, 15% smaller, and the pictures keep clear of it), `strip` (the compact strip under the drawing, carrying each team's round mark) or `auto` (the default: the strip with an emblem or a large board, else whichever leaves the pictures at least 70% of their width). `lines` is `over` (the default), `under` or `through` the pictures; `scale` and `names` size and name them; under 320 pixels wide or with `detail: "simple"` the fabric, hairlines and name pills are left out; dark theme has its own colours (`--ky-pg-border`, `--ky-pg-edge`, `--ky-pg-seam`, `--ky-pg-shadow`, `--ky-pg-disc`, `--ky-pg-groove`, `--ky-pg-light`); a `range` shows the carpet where the range shows it. `animate: "unfurl"` or `"fade"` is an entrance in CSS only, off by default, inside `@media (prefers-reduced-motion: no-preference)`. Every renderer draws it (the scene, canvas, d3, Plot, PNG); `sceneToGeoJSON` leaves it out, since the GeoJSON is of the surface. New: `Surface.pageant` and `centreRadius` (where a builder puts the pictures and its centre circle), `Team.logoRatio`, the `pageant` words of `KYOGIJO_STRINGS` (`en` and `ja`; a custom set of words must give them), `KYOGIJO_PAGEANT_STYLE`, `KYOGIJO_PAGEANT_MOTION`, the types `PageantOptions` and `PageantStyle`, the `pageant` attribute of `<kyogijo-field>`, and the root's `data-pageant`.
+- The demo has "Flags on the halves" under Look: off, carpets or stages, the lines over, under or through, a made-up cup in the centre and the entrance, in English and Japanese, each a finger wide, in the address (`pageant`, `pageantlines`, `emblem`) and in the code it shows; the docs have a page and a gallery of a carpet and a stage on each of the twenty surfaces, the emblem, tall and small, the borders, the lines, a team with no flag, dark and a crop, with made-up nations and flags drawn in code.
+
+### Added
+
+- **Swimming, water polo, diving and artistic swimming** (`sport: "swimming"`, `"waterpolo"`, `"diving"`, `"artisticswimming"`; [docs/pools.md](./docs/pools.md)). Four pools, to scale, from World Aquatics' *Competition Regulations* in force as from 25 June 2025 (Part Two Article 16, Part Four Article 13 and Appendix 2, Part Six Article 18 and Appendix 4, Part Seven Article 27; the 2017 and 2021 Facilities Rules' numbers where they differ), each figure cited in [docs/sources.md](./docs/sources.md#the-pools): the swimming pool of 50 or 25 m and one to ten lanes (25 m wide for eight lanes of 2.5 m, ten lanes 0 to 9 with the end lanes 2.4 m, or the 26 m temporary pool) with its ropes (green, blue and yellow, red floats within 5 m of the walls, a distinct run at 15 and 25 m), the lane markings with their cross lines and the cross lines at 15 m, the touch panels and their target lines, the starting blocks with their lane numbers, the backstroke flags at 5 m and the false start rope at 15 m, and a warm-up pool without the competition fixtures; the water polo field of 25 by 20 m with its ropes and referees' platforms in red, yellow and green, the 2, 5 and 6 m lines, the goals, the goal areas, the re-entry areas, the table and the substitution areas; the diving well with the 1 and 3 m springboards and the 5, 7.5 and 10 m platforms (and the 1 and 3 m platforms) at the preferred distances of Appendix 2 from the walls and from each other, and the three lines across the well; the artistic swimming area (30 by 20 m, or 25 by 15 m with its 12 by 12 m deep part) with its floor lines and platforms. A score on any of them; the home team on the left in water polo.
+- **The looks of the water and the deck** (`pool.look`: `flat`, `water`, `tiled`; `pool.deck`: `plain`, `tiled`; `pool.seed`). A flat, clean water by default; a faint net of light on the floor made from a seed (a few soft closed curves in one small repeating tile, the same seed the same light), a gradient across the lanes and, for `tiled`, the floor's tiles, all patterns defined once. Every named look has a palette for the pools, and the stylesheet carries only the rules a drawing uses.
+- **A side section** (`pool.section`): the water and its depth (2.5 m for a 50 m pool, 2 m for a 25 m one, or your own), the blocks and panels, the flags 5 m from each end, the false start rope at 15 m, a lane rope at the surface and the least depth the rules ask near a wall with blocks, the height exaggerated and said so.
+- **The lanes of a race** (`pool.race`): each swimmer in a lane with a name, three letters and a flag (an address, an image or SVG text you pass; the package bundles no flags), and, once the race is swum, places (a gold, silver or bronze disc for the first three, taken from the times when none is given), times, reaction times, splits, records and `dq`, `dns` and `dnf`. Plates at the starting and the turning end, an event title, and a description that says each lane in words, in English and Japanese. `pace` draws **split pace bars**: each lane the whole race laid flat, each split a bar as long as its share, in a colour from the field's slowest pace to its fastest, under a ruler of distances. A tall drawing lays the names and times along the lanes.
+- **`raceTimeline`** (`@johnmorrisdotca/kyogijo-stadiums/replay`): a race replay by lane. The splits of a race become a timeline of the package's replay: each swimmer goes down the first length and back the next at the speed of each split, on the block until the reaction time, with the start, the turns and the finishes as events, in the new `swimming` frame (metres from the middle of the water). `drawFrame`, `mountKyogijo(...).replay` and `<kyogijo-field>` play it. `formatTime` and `parseTime` write and read times as swimming does.
+- **`splitsChart`** (`@johnmorrisdotca/kyogijo-stadiums/charts`, [docs/charts.md](./docs/charts.md#the-splits-of-a-race)): the pace bars with a title, a summary, the numbers (`totals`, with the fastest split of the field) and a table of every split.
+- **A natatorium** (`pool.venue: "natatorium"`, or `{ pools, apart, labels, seating }`): several pools in one hall, to scale, at least 8 m apart (10 m by default, as the rules keep a swimming pool and a diving well, CR 16.2.17), each drawn by its own sport's builder with the deck, the paint and the names once, and seating along the top. `venueLayout` gives the places.
+- Ranges (`pool-end`, `springboards`, `platforms`, `centre-stage`, with `half` and `goal-area`), the zone sets `pool-lanes`, `water-polo-areas` and `pool-thirds`, the four frames, `landmarks` for every pool, features to colour (`water`, `lane-ropes`, `rope-red`, `touch-pads`, `starting-blocks`, `backstroke-flags`, `platforms`, `springboards` and more), `SWIMMING`, `WATER_POLO`, `DIVING` and `ARTISTIC` in `/geometry` (metres, any unit by `dimensionsOf`), and their words in English and Japanese. `Sport` and `SPORTS` grow from 20 to 24; the other twenty draw byte for byte as before.
+- The demo has the four pools in its sport picker with the pool's own controls, a Pools section with a made-up race (nations that do not exist, flags drawn in code in `demo/pool-data.js`), the pace bars, a race replay and the natatorium; the docs have a [Pools](./docs/pools.md) page and a gallery page of them, each picture made from the code beside it.
+
+### Added
+
+- **`sport: "athletics"`: the athletics stadium** ([docs/athletics.md](./docs/athletics.md), `@johnmorrisdotca/kyogijo-stadiums/athletics`). The 400 m standard track of World Athletics' Track and Field Facilities Manual (2019) and Technical Rules (in force 1 July 2026): eight lanes of 1.22 m (4 to 9) with the running lines at Rule 14, the finish straight (6 to 10 lanes), the lane numbers, and the start lines of 20 races: the sprints and the hurdles on the straight, the staggers of the 200 m, 400 m, 400 m hurdles, 800 m and the relays, the 800 m's and the 4 x 400 m's breakline, the curved starts of the 1000 m to the 10,000 m and the mile with the group starts, the exchange zones of the 4 x 100 m and 4 x 400 m, and the steeplechase's lap with the water jump inside or outside the second bend. The staggers are worked out from the running lines' radii and the breakline's involute (not copied from the table) and a test holds them to Table 2.2.1.6a (200 m and 400 m within 0.6 mm, 800 m and 4 x 400 m within 2.5 mm). Every field event is in its place in the standard arena (high jump, pole vault, long and triple jump with their boards and pits, shot put, discus and hammer with the cage and the sector of 34.92 degrees, javelin with the 8 m arc and the sector of 28.96 degrees), each switchable with `events`, or alone at a large scale with `layout`. The infield is the soccer pitch (a preset or a size, or a ground's own) or plain grass; the track is red, blue, terracotta or green. `league: "world-athletics-short"` is the covered 200 m banked track of six lanes with a 60 m straight and its own stagger table; a `ground` that has a track draws the stadium with that ground's pitch (six grounds). New: `range: "start"` (a close-up of the start of `athletics.start`, turned so that the athletes run to the right, or up the page in portrait, with stencil lane numbers drawn as paths and lane-sized tags on a bend), `finish`, `bend`, `home-straight`, `back-straight`, `infield`, one range for each field event and `water-jump`; the look `line-drawing` (ink only: black on white with outlines for the track, pits and mats, white on black in dark mode); the frame `athletics` (metres from the middle of the track); the zone set `athletics-track`; the `athletics` words in English and Japanese; `KYOGIJO_ATHLETICS_STYLE` and `KYOGIJO_TRACK_STYLE`.
+- **Athletics data charts** (`@johnmorrisdotca/kyogijo-stadiums/athletics`): `laneDraw` (the names and flags on the lanes of a start, at each lane's stagger, with the flags passed as SVG), `raceResults` (places as medal discs, times, reaction times and splits), `raceReplay` (a timeline for the replay: each runner on the curve of his lane from his lane's start line by his reaction time, splits and finish time) and `fieldMarks` (a throw or jump as a mark where it landed, a foul at the line and the best valid mark picked out). The entry also exports the plan, the track's geometry (`stagger`, `breaklineStagger`, `lap`, `pose`), the races and field events (names in English, Japanese and French) and the figures.
+- **`sport: "skating"`: the skating rinks** ([docs/skating.md](./docs/skating.md), `@johnmorrisdotca/kyogijo-stadiums/skating`). The ISU's standard 400 m speed skating track (`league: "isu-long-track"`, the default): two lanes (the inner 4 m, the outer 4 m or more), the inner curve of 25 m to 26 m and the straight that makes a lap 400 m (113.57 m, 112.00 m, 110.43 m for 25 m, 25.5 m, 26 m, as the ISU's table has them), the warm-up lane, the lanes' fully painted lines, the blocks of the curves (50 cm apart for the first 15 m, 2 m after, a cone at the entrance), the coaches' area on the crossing straight, the padding, the finishing line with its metres and the starting lines of the 500 m to the 10,000 m, the mass start and the team races: each lane's line worked out from the race's distance back from its finish along the skater's own way (the lane changed once a lap, not on the first straight of the 1000 m and the 1500 m) and held to the layout plan's own dimensions (6.32 m, 6.25 m, 7.32 m, 12.57 m). `league: "isu-short-track"` is the oval of 111.12 m on a rink of 60 by 30 m or more with seven blocks in each curve, five or seven tracks with their starting lines, the finishing line and the five starting positions of the 500 m and the 1000 m; `league: "isu-figure"` the rink of 60 by 30 m (56 by 26 m at the least) with the judges' and the referee's seats at the rinkboard, the technical panel and the kiss and cry. `skating` options: `innerRadius`, `laneWidth`, `warmUp`, `infield`, `blocks`, `coaches`, `padding`, `races`, `start`, `tracks`, `rink`, `furniture`. New: the ranges `crossing-straight`, `first-bend`, `second-bend`, `judges` and `kiss-and-cry` (and `home-straight`, `bend`, `finish`, `start`, `infield` and `half` for the rinks that have them), the frame `skating`, the zone set `skating-track`, the `skating` words in English and Japanese, `KYOGIJO_SKATING_STYLE`. The rinks take the hockey rink's colours in every look.
+- **Skating data charts** (`@johnmorrisdotca/kyogijo-stadiums/skating`): `skatingPairs` (a pair's names and flags on the lines of their lanes, the armbands white and red), `skatingGrid` (the starters of a short track race on the five positions), `skatingResults` (medals, times, splits along the lane, lap times in the table), `skatingReplay` (a timeline: each skater on his own way, the lane changed on every crossing) and `figureElements` (a jump, a spin, a step sequence and the other elements of a programme as marks on the ice, the track of a sequence as a line).
+- The docs have a page for the stadium, a gallery of it (52 pictures, each made from the code beside it) and the athletics rows of the sources, references, notice, limits, ranges and frames pages.
+
+### Fixed
+
+- **`toPNG` no longer stops the process on a drawing cropped to a range.** resvg (the PNG renderer) panics on a shape with an opacity below 1 that lies wholly outside the viewBox, as the net of a soccer goal does in the `penalty-area` and `defensive-third` ranges: `toPNG` now leaves out the shapes wholly outside the frame (they paint nothing). A test renders every named range of every sport and league, wide and tall, to a PNG.
+
 ### Changed
 
+- **A club's name in Japanese is the one Japanese media say.** Wikidata's label is a Japanese Wikipedia page title, and for 33 clubs it is a long transliteration of initials or of a formal name (`ブリティッシュ・コロンビア・ライオンズ`, now `BCライオンズ`; `インテルナツィオナーレ・ミラノ`, now `インテル・ミラノ`), a title with a disambiguator or "history of" (`ボルチモア・コルツの歴史`) or the club's name in another period (`OLレイン`). `scripts/tenants.names-ja.json` holds the everyday form of each, with its kind and a source note, and `Tenant.clubJa` is that form; Wikidata's label is kept in the new `Tenant.aliasesJa`, so a search by it still finds the club. `TENANT_JAPANESE_NAMES` and `nameJaOf` (`/atlas`) give the table and the note on a tenant's name.
+- The named looks (`look: "night"` and the others) write one more selector for each sport of the court group into the drawing's style, so a drawing with a look has a longer style text than before; the drawing itself is unchanged.
 - The name a reader sees is Kyogijo Stadiums (競技場 in Japanese): the demo's title, the docs site, the API page, the README and the package description. Code names (`drawKyogijo`, `<kyogijo-field>`) are unchanged.
+- The indoor volleyball court shows its centre line: it runs under the net (FIVB Rule 1.3.3) and the net was drawn over it, so only a dark bar showed. The line now shows between the net's edges. The court's other lines were already all there (the boundary, both attack lines, the attack lines' extensions and the service zone's marks in the full detail); the beach court has only its four boundary lines, as the beach rules say.
 - The demo's year switch in the atlas is a finger wide before its words arrive, in WebKit too.
+- The badminton court's labelled parts use the BWF's words: the line inside the back boundary is the "Doubles long service line" (it was "Long service line", which in singles is the back boundary line itself), and the back boundary line says it is the singles long service line (Diagram A). The short service line's label no longer runs into the net's. An audit of every net sport's figures against the current rulebooks (ITF 2026, FIVB 2025-2028, BWF as amended 26 April 2025, USA Pickleball 2026, ITTF 2026) found no figure to change.
+
+### Fixed
+
+- **The badge's code and score no longer touch.** A 3-digit score (`101`) in the badge and in the strip of a compact card sat 8 units from the team's code (`101CAL`, `AUR99`). The score is measured with the package's text width, the code and the score keep a gap of 10 (the estimate is widened by a tenth for digits and a fifth for capitals, which is what a bold face draws), the code shrinks first (to 12 at the least), then the score, and the flag is left out when the room still runs out, at any width since the strip scales as one drawing. A short score is laid out as before, and no existing drawing changed.
+- **BC Place read "FIFA World Cup, FIFA Women's World Cup" only, though it is the BC Lions' home (the CFL, since 1983) and the Whitecaps' (MLS, since 2011).** A place was known through one list, with only the tournaments it staged or the club of its park, so a stadium of two sports showed one. `Place.leagues` now has the league of every club that played there, then the tournaments; `placesBy({ league: "CFL" })` finds BC Place and the Rogers Centre, and `placesBy({ text })` finds a place by a club. A drawing of a place that has no other surface, or of a place's own surface, is the same text as before.
 
 ## [0.4.0] - 2026-10-14
 

package/NOTICE.md

@@ -28,6 +28,9 @@ picture or code of the sources is copied; each source is named here so that the
 | `leagues`: the cricket ground | The Laws of Cricket (2017 Code), 4th Edition 2026, MCC (Laws 6 to 8), and the ICC Men's and Women's One-Day International Playing Conditions, effective from October 2026 | Facts |
 | `leagues`: the field hockey pitch | Rules of Hockey including explanations, International Hockey Federation (FIH), effective from 1 March 2026 (Rule 1 and the Field and Equipment Specifications) | Facts |
 | `leagues`: the handball court | IX. Rules of the Game for Indoor Handball, International Handball Federation (IHF), edition of 1 July 2025 (Rule 1, Playing Court) | Facts |
+| `geometry`: the swimming pool, the water polo field, the diving well and the artistic swimming area | World Aquatics, Competition Regulations, in force as from 25 June 2025 (Part Two Article 16, Part Four Article 13 and Appendix 2, Part Six Article 18 and Appendices 3 and 4, Part Seven Article 27), and the Facilities Rules 2017-2021 and 2021-2025 (FR 2 to FR 5) | Facts; no text or drawing copied |
+| `leagues`: the athletics track | World Athletics' Track and Field Facilities Manual (2019 edition, Chapters 1 to 3) and its 400 Metre Standard Track Marking Plan (Figure 2.2.1.6a), the Competition and Technical Rules (Books C1.1 and C2.1, in force 1 July 2026) and the Marking Plan for the Standard Short Track (1 January 2026) | Facts; no text or drawing copied |
+| `leagues`: the skating rinks | The International Skating Union's Sports Rules - Speed Skating (Special Regulations and Technical Rules, Rules 203 to 206, 226 to 228 and 253 to 257, and "H. Track", effective 12 June 2026), Special Regulations and Technical Rules Short Track Speed Skating (Rule 280 and the diagram of the tracks, 2024) and Sports Rules - Figure Skating (Rule 342, effective 12 June 2026) | Facts; no text or drawing copied |
 | `frames`: the soccer providers' coordinates | StatsBomb's Open Data Events specification (Appendix 2), the Wyscout and Impect glossaries, the Metrica Sports and SkillCorner open-data READMEs; for Opta, Tracab and Second Spectrum, whose specifications are not public, the figures of mplsoccer, ggsoccer, kloppy and floodlight (docs/sources.md) | Facts; no text, table or code copied |
 | `parks`: the fence of each ballpark, current and past, and the seasons of a past park | The distances (and, for a park whose fence moved, the years an article dates them) published in the English and Japanese Wikipedia article of each park, at the revision cited below; the seasons a club played there from the same article's list of tenants | Facts. The articles are CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/); none of their text, tables or images is used, and the angles between the distances are our own reading |
 | `parks`: the Wikidata item of each ballpark (`wikidata`) | The item (`Q49136`) that each cited article is linked to, read with the MediaWiki API (`pageprops`, `wikibase_item`) and checked against the item's label | Wikidata's data is CC0 (https://creativecommons.org/publicdomain/zero/1.0/) |
@@ -35,6 +38,7 @@ picture or code of the sources is copied; each source is named here so that the
 | `grounds`: each soccer ground's pitch, names, years, city and capacity | The infobox and the opening text of the English Wikipedia article of each ground, at the revision cited below (the pitch's length and width where the infobox gives them for football, the names with the years the article dates them, the year it opened and closed, the first capacity); the ground's name in Japanese from its Japanese article | Facts. The articles are CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/); none of their text, tables or images is used |
 | `grounds`: the World Cups each ground staged matches of, and where each final was played | The venue section of the English Wikipedia article of each men's and Women's World Cup, at the revision cited below; FIFA's own pages are not used | Facts, CC BY-SA 4.0 articles as above |
 | `grounds`: the Wikidata item and the coordinates of each ground (`wikidata`, `lat`, `lon`) | The item that each cited article is linked to, its coordinates (P625) and its country (P17), read with the Wikidata API and checked against the item's labels by `scripts/check-grounds.mjs` | Wikidata's data is CC0 (https://creativecommons.org/publicdomain/zero/1.0/) |
+| `atlas`: the clubs that played in each park and ground (`tenants`: the club, its Wikidata item, its league, the years) | The occupants (P466) and home venues (P115) Wikidata lists for each place, with the start (P580) and end (P582) times of each statement, and the clubs' labels in English and Japanese, sports (P641) and leagues (P118), read with the Wikidata API and query service by `scripts/fetch-tenants.mjs` into `scripts/tenants.wikidata.json`; and the `tenants` line of the infobox of each place's English Wikipedia article, at the revision that `source.wikipedia` names for each club (155 articles, read on 2026-10-13) | Facts. Wikidata's data is CC0 (https://creativecommons.org/publicdomain/zero/1.0/), and the articles are CC BY-SA 4.0 as above; the names of clubs and the years are facts, no text, table or image of an article is used. Which clubs are tenants, and the league each is filed under, are our reading, in docs/atlas.md ("Tenants") |
 | `parks`: the walls, quirks, backstop, warning track, dugouts and extra points of a ballpark (`walls`, `quirks`, `backstop_ft`, `track_ft`, `dugouts`, `labels`) | The infobox and the text of the same English article of each park, at the same revision as its fence (the Japanese article for the heights of the walls of the parks of Japan): the height of the wall along a stretch of the fence and the seasons it stood, the hill, overhang, poles, bullpens, ivy and basket the text describes with figures, the infobox's backstop distance, the warning track's width, the sides of the dugouts, and the further distances the text gives (Wrigley Field's wells, Sportsman's Park's and Milwaukee County Stadium's markers). The stretch each figure covers and the angle of each extra point are our reading of the article's words | Facts. The articles are CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/); none of their text, tables or images is used |
 | `parks`: the coordinates of each ballpark (`lat`, `lon`) and the years it opened and closed (`opened`, `closed`) | The item's coordinate location (P625), its date of official opening or inception (P1619, P571) and of official closure or dissolution (P3999, P576), read with the Wikidata API by `scripts/fetch-park-coordinates.mjs` and checked by `scripts/check-parks.mjs` (ES CON Field's opening, 2023, is read from its article) | Wikidata's data is CC0 (https://creativecommons.org/publicdomain/zero/1.0/) |
 | `events`: the special games, their days, venues, hosts and where a surface stood | The English Wikipedia articles of each game and of its venue, at the revision cited below, and three articles of the press (Sports Video Group, NHL.com, The Boston Globe), named below with their authors and dates; the size of a carrier from the Nimitz class's article | Facts, CC BY-SA 4.0 articles as above; no text copied |

package/README.md

@@ -1,7 +1,7 @@
 <h1 align="center">Kyogijo Stadiums <sub>競技場</sub></h1>
 
 <p align="center"><strong>Sports surfaces as SVG, drawn to scale, with the score on them.</strong><br>
-The NFL, CFL and IFAF football fields, the NHL rink, the NBA court, the soccer pitch and futsal court, and the baseball field of every MLB ballpark, current and past, and every NPB home park, each drawn from its rulebook or its published distances, with each team's name and logo on its side and the score in the middle. Wide or tall, light or dark, a compact badge for a list, a helper for React, a custom element and a frame for a page that runs no script. One function, no dependencies.</p>
+The NFL, CFL and IFAF football fields, the NHL rink, the NBA court, the soccer pitch and futsal court, the baseball field of every MLB ballpark, current and past, and every NPB home park, and the surfaces of curling, athletics, speed, short track and figure skating, swimming, water polo, diving, artistic swimming, tennis, volleyball (indoor, beach and sitting), badminton, pickleball, table tennis, padel, squash, racquetball, sepak takraw, teqball, roundnet, netball, lacrosse, rugby, Australian football, Gaelic games, cricket, field hockey and handball, thirty-three sports in all, each drawn from its rulebook or its published distances, with each team's name and logo on its side and the score in the middle, with stands and a crowd, a pageant of flags and a 3D view. Wide or tall, light or dark, a compact badge for a list, a helper for React, a custom element and a frame for a page that runs no script. One function, no dependencies.</p>
 
 <p align="center">
   <a href="https://github.com/johnmorrisdotca/kyogijo-stadiums/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/johnmorrisdotca/kyogijo-stadiums/actions/workflows/ci.yml/badge.svg"></a>
@@ -20,14 +20,14 @@ The NFL, CFL and IFAF football fields, the NHL rink, the NBA court, the soccer p
 <td align="center" valign="top">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-desk-light.webp" alt="The demo on a desk, in English: the page header with the language chooser, five cloth patches and the Help switch, and an NHL rink drawn wide on green felt, with a made-up game on it, the Northern Owls and their owl emblem on the left, the Lakeshore Anchors and their anchor on the right, and a panel of the score 3 to 2, Final/OT, in the middle. The controls for the sport, the layout and the teams are on the right." width="640">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-desk-light.webp" alt="The demo on a desk, in English: the heading Kyogijo Stadiums with the language chooser, the Docs and API reference links, five cloth patches and the Help switch, and an NHL rink drawn wide on green felt, with a made-up game on it, the Northern Owls and their owl emblem on the left, the Lakeshore Anchors and their anchor on the right, and a panel of the score 3 to 2, Final/OT, in the middle. The controls on the right list the sports, from the NFL and the NHL to handball, and then the layout and the teams." width="640">
 </picture>
 <br><em>The demo on a desk: a rink, with the teams on their sides and the score in the middle.</em>
 </td>
 <td align="center" valign="top">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-phone-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-phone-light.webp" alt="The demo on a phone: a football field turned a quarter to stand tall, the visiting team's blue end zone at the top and the home team's red end zone at the bottom, each with its logo and name written across it, the yard numbers upright, and a score panel at midfield reading 27 to 24, Final." width="240">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-phone-light.webp" alt="The demo on a phone: the heading Kyogijo Stadiums over the page's controls, and under them a football field turned a quarter to stand tall, the visiting team's blue end zone at the top and the home team's red end zone at the bottom, each with its logo and name written across it, the yard numbers upright, and a score panel at midfield reading 27 to 24, Final." width="240">
 </picture>
 <br><em>On a phone the same surface stands tall, the words still upright.</em>
 </td>
@@ -72,11 +72,16 @@ console.log(svg.startsWith("<svg"), svg.includes("Northern Owls 3, Lakeshore Anc
 
 ## Features
 
-- **Twenty surfaces, to scale.** The NFL field (360 by 160 feet with its end zones), the CFL field (450 by 195), the IFAF field, the NHL rink (200 by 85 with a 28-foot corner radius), the NBA court (94 by 50), the soccer pitch (105 by 68 metres, in ten sizes and variants), the baseball field, the curling sheet (150 by 15 feet 7 inches) and the courts of tennis, volleyball and beach volleyball, badminton, pickleball and table tennis, and the fields of lacrosse, rugby, Australian football, Gaelic games, cricket, field hockey and handball, with the lines, circles, keys, boxes and goals of each. Every figure is cited in [sources](./docs/sources.md). [The surfaces](./docs/surfaces.md).
+- **Thirty-three surfaces, to scale.** The NFL field (360 by 160 feet with its end zones), the CFL field (450 by 195), the IFAF field, the NHL rink (200 by 85 with a 28-foot corner radius), the NBA court (94 by 50), the soccer pitch (105 by 68 metres, in ten sizes and variants), the baseball field, the curling sheet (150 by 15 feet 7 inches) and the courts of tennis, volleyball (beach and sitting), badminton, pickleball, table tennis, padel, squash, racquetball, sepak takraw, teqball, roundnet and netball, the pools of swimming, water polo, diving and artistic swimming, the athletics stadium, the skating rinks, and the fields of lacrosse, rugby, Australian football, Gaelic games, cricket, field hockey and handball, with the lines, circles, keys, boxes and goals of each. Every figure is cited in [sources](./docs/sources.md). [The surfaces](./docs/surfaces.md).
 - **Each league's rulebook.** `league: "fiba"` draws a court as FIBA marks it: 48 variants, from the WNBA, the NCAA and the IIHF to Little League, PONY, softball, Curling Canada, FIVB's beach volleyball, rugby league and the NLL's box lacrosse, each cited. [League variants](./docs/variants.md).
-- **Curling, from the rule books.** A sheet from World Curling's and Curling Canada's rules, tall by default, with the board and the hammer in a score, and `curlingStones` for the stones of an end, scored by the rules. [Curling](./docs/curling.md).
-- **Tennis, volleyball, badminton, pickleball and table tennis, from their rulebooks.** The ITF's court, the FIVB's indoor and beach courts, the BWF's, USA Pickleball's and the ITTF's table, each in its look (hard court, clay, grass, wood, sand), with a board of sets and games and a ball beside the server. [Net sports](./docs/courts.md).
+- **A realistic basketball floor.** `court: { hardwood: true }` draws maple boards that run the length of the court with staggered ends, grain and tone, stained keys, circle and border, a strip behind each baseline in the team's colour, the baskets and stanchions with soft shadows from above, a coaching box and benches, and a satin sheen, in every league and every renderer, with the detail dropping at small sizes. The clean floor stays the default. [Hardwood](./docs/hardwood.md).
+- **The stands and the crowd.** `crowd: true` draws the seating round any surface that has spectators: a bowl, two sides, a horseshoe, an arena's courtside rows, or a ballpark's grandstands and bleachers laid behind the park's own fence, with the people as a seeded pattern of heads and shoulders in the home colours, the visitors at an end, the empty seats showing (`density`, or `attendance` over `capacity`), a card display on request, and a soccer pitch inside a gridiron stadium's footprint, to scale. A few kB of patterns, blocks at small sizes, every renderer, and the stands' rings, heights and rake as data. [The crowd](./docs/crowd.md).
+- **Curling, from the rule books.** A sheet from World Curling's and Curling Canada's rules, tall by default, with the board and the hammer in a score, `curlingStones` for the stones of an end, scored by the rules, `show: "folded"` for the whole sheet with both houses enlarged beside it in a square, and a heat map and statistics (free guards, hammer, steals, shots) for many ends. [Curling](./docs/curling.md).
+- **Net, racket and court sports, from their rulebooks.** The ITF's court, the FIVB's indoor and beach courts, World ParaVolley's sitting volleyball court, the BWF's, USA Pickleball's, the ITTF's table, the FIP's padel court, World Squash's courts (with the front wall laid flat beside the floor), the IRF's racquetball court, the ISTAF's sepak takraw court, the FITEQ's teqball court and table, the Roundnet Federation's court and World Netball's court, each in its look (hard court, clay, grass, wood, sand), with a board of sets and games and a ball beside the server. [Net, racket and court sports](./docs/courts.md).
+- **Swimming, water polo, diving and artistic swimming, from World Aquatics' regulations.** The competition pool of 50 or 25 m and one to ten lanes with its ropes in the rules' colours, floor markings and cross lines, blocks, touch panels, backstroke flags at 5 m and false start rope at 15 m, with a side section and a flat, "water" or tiled look; the water polo field with its ropes, lines, goals and re-entry areas; the diving well with its springboards and platforms at the distances of Appendix 2; the artistic swimming area; several pools in a natatorium. The lanes of a race carry names, flags you pass in, places with medals, times, reaction times and splits, with split pace bars, a race replay by lane (`raceTimeline`) and a `splitsChart`. [Pools](./docs/pools.md).
 - **Lacrosse, rugby, Australian football, Gaelic games, cricket, field hockey and handball, from their rulebooks.** The fields and floors of World Lacrosse, the NCAA, the PLL and the NLL; World Rugby's union and the NRL's and IRL's league; the AFL's oval at the size of a named ground; the GAA's field for football and hurling; a cricket ground with a boundary of your own and the 30-yard circle; the FIH's pitch and the IHF's court. A score is goals and behinds (10.12 (72)), goals and points (2-14 (20)) or a board of runs, wickets and overs. [Field sports](./docs/field-sports.md).
+- **The athletics stadium, from World Athletics' rules.** The 400 m track with its lanes, the staggers worked out from the running lines (the 200 m and 400 m to the millimetre of the Manual's table, the 800 m and 4 x 400 m from the breakline's own construction), curved and relay starts, hurdles, the steeplechase with the water jump inside or outside, every field event in its place or alone at a large scale, a close-up of each start with stencil lane numbers, the covered 200 m track, an ink-only `line-drawing` look, and lane draws, results, a race replay and the marks of throws and jumps. [The athletics stadium](./docs/athletics.md).
+- **The skating rinks, from the ISU's rules.** The standard 400 m speed skating track with its two lanes, warm-up lane, blocks and coaches' area, and the starting and finishing lines of every race worked out lane by lane from the track's measurements (held to the layout plan's own dimensions); the short track's oval of 111.12 m with its seven blocks in each curve, five or seven tracks and starting positions; the figure skating rink of 60 by 30 m with its judges' seats; and pairs, results, a race replay and the elements of a programme on the ice. [The skating rinks](./docs/skating.md).
 - **Soccer, to the Laws.** A pitch from Law 1 of the IFAB Laws of the Game of any size, with presets (international, UEFA, MLS, NCAA, the FA's 9-, 7- and 5-a-side, FIFA's futsal), half pitches, five mowing patterns, four goal styles, penalties and extra time in a score. [Soccer](./docs/soccer.md).
 - **Every ballpark.** The 30 current MLB parks and 44 that MLB clubs have left (the Polo Grounds, Ebbets Field, the Astrodome and more), and the 12 home parks of Nippon Professional Baseball with eight other NPB grounds, each with its fence drawn from the distances published for it; a past park whose fence moved is drawn as it stood in a season. [Ballparks](./docs/ballparks.md).
 - **Soccer grounds and an atlas.** 64 soccer grounds, each pitch at its published size, and every park and ground on a map, by sport, league, country and year, each found by any name it has in English, Japanese or its own language (`Koshien Stadium` is also `甲子園`, `San Siro` is `サン・シーロ`). [The grounds](./docs/grounds.md), [the atlas](./docs/atlas.md), [names](./docs/ballparks.md#names).
@@ -84,15 +89,17 @@ console.log(svg.startsWith("<svg"), svg.includes("Northern Owls 3, Lakeshore Anc
 - **Special games.** A surface set inside another, to scale: an NHL rink on a ballpark's infield or a football stadium's field (the Winter Classic, the Stadium Series, the Heritage Classic), a college basketball court on the deck of a carrier, a baseball field laid over a London stadium's pitch. 18 games, each with its day, its venue and its sources, and the place of the rink cited where a source gives it and marked as a convention where none does. [Special games](./docs/special-games.md).
 - **Surfaces through the years.** `year: 1975` draws a surface as its league's rules marked it that season, each change cited. [Surfaces through the years](./docs/eras.md).
 - **Score mode.** Each team's name and logo on its side (the end zones of a football field, the ends of the ice, the halves of the court, the dugouts of a ballpark) and the score large in the middle, with the competition, the status and the date, and the winner emphasised; a flag or a crest can be round, in a circle with a ring (`markShape: "round"`). [Score and layout](./docs/score.md#round-marks).
+- **A pageant.** Each team's flag or crest laid large over its half of the surface, as a stadium lays giant flags and crests for a final: `pageant: "carpet"` (a flag at its own ratio with a border and a gentle fabric) or `"stage"` (a crest on a round disc with a gold ring), an emblem or a trophy of your own in the centre circle, the score in the middle or in the strip, upright wide and tall, in light and dark, with an entrance in CSS for readers who have not asked for less motion. [The pageant](./docs/pageant.md).
 - **Zoom to a part of a surface.** `range: "offensive-zone"` crops a drawing to a rink's zone, a half court, the paint, the red zone, a soccer half, third or penalty area, the infield, a curling house, or a box of your own in any frame, with its data, heat, labels and score following. [Display ranges](./docs/ranges.md).
 - **Wide, tall or fit the box.** Every surface lies wide or tall: tall turns it a quarter, keeps every word upright and puts the teams top and bottom. With `orientation: "auto"` the browser helpers follow the box.
 - **Data on the surface.** Points, lines, arrows, text, heat maps, hexagons, zone charts and density contours over any surface, in its feet or a data provider's frame, cut to its outline, with a table for each layer; ready-made shot and pass charts, and the road to a tournament's final (`roadToFinal`: the two finalists' matches as round flags with the scores, in four sizes). [Data layers](./docs/layers.md), [charts](./docs/charts.md).
 - **Small multiples and backgrounds.** `drawGrid` puts many drawings in one SVG, under a title and a subtitle, over a credit line, with a key they share, in a size for a social card, a square post or a phone; `background` lays a quiet pattern (felt, grass, wood, ice, paper, a grid, dots) or a photograph behind a drawing or a grid. [Layouts and backgrounds](./docs/layouts.md).
 - **Replay.** Tracking data played on any surface: the players with their numbers, the ball and its trail, and the passes, shots and goals as they happen, with controls, the keyboard and a live region, steps for a reader who prefers reduced motion, and a pause when the page is hidden. [Replay](./docs/replay.md).
+- **A 3D view.** Any surface as a floor that turns by mouse, touch, wheel or keys, with four viewpoints (overhead, broadcast, end-on, low corner) and a reset, and what the rulebook stands on it at its height: the net and antennae of volleyball, the nets of tennis, badminton, pickleball and table tennis, baskets and stanchions, rink boards and glass, goals, the posts of football, rugby, Gaelic and Australian football, stumps, a ballpark's fence, the walls of padel, squash and racquetball (cut away on the side nearest the eye), a swimming pool's blocks and flags, a diving well's boards and platforms, a water polo goal, a jump's uprights and bar, a throwing cage, the hurdles, and the padding of a skating track. Plain DOM and CSS over the same SVG, flat where 3D is not drawn. [The 3D view](./docs/turn.md).
 - **Renderers.** The same drawing as plain data (a scene), on a canvas (a browser's or a Node canvas), in a d3 selection, as a mark of an Observable Plot, as GeoJSON and as a PNG in Node, each an entry of its own that imports nothing from outside the package. [Renderers](./docs/renderers.md).
-- **Units and frames.** Each surface in its rulebook's unit and any other, and 29 coordinate frames (ten soccer providers, the NHL API, HockeyTech, NBA stats, NFL tracking, MLBAM, Retrosheet, a curling stone's place from the button, a place from the net in each net sport, the centre of each field sport's surface) to move a provider's points onto a surface. [Units](./docs/units.md), [coordinate frames](./docs/frames.md).
+- **Units and frames.** Each surface in its rulebook's unit and any other, and 42 coordinate frames (ten soccer providers, the NHL API, HockeyTech, NBA stats, NFL tracking, MLBAM, Retrosheet, a curling stone's place from the button, a place from the net in each net sport (from the centre of the court in squash, racquetball, roundnet and netball), the centre of each field sport's surface, the middle of the water of each pool, the middle of the athletics stadium and of each skating rink) to move a provider's points onto a surface. [Units](./docs/units.md), [coordinate frames](./docs/frames.md).
 - **A compact badge and a compact card.** One strip for a list, or the surface with that strip under it.
-- **Light and dark**, by the device or the page, and every colour a custom property; seven named looks, colours by feature, line widths and dashes, goal styles and mowing patterns, and arrows, axes and labels for teaching. [Theming](./docs/theming.md), [annotations](./docs/annotations.md).
+- **Light and dark**, by the device or the page, and every colour a custom property; eight named looks, colours by feature, line widths and dashes, goal styles and mowing patterns, and arrows, axes and labels for teaching. [Theming](./docs/theming.md), [annotations](./docs/annotations.md).
 - **Accessible.** Each drawing is an `img` with a title and a description that say the surface and the result, in English or Japanese. [Accessibility](./docs/accessibility.md).
 - **Four ways in.** A function that returns SVG text; a helper that draws into a container; a standard custom element; a frame for pages that run no script. A React helper that does not import React.
 - **No dependencies**, no network requests, nothing stored. Text, colours and logo addresses that come from outside are made safe before they are drawn.
@@ -103,12 +110,15 @@ console.log(svg.startsWith("<svg"), svg.includes("Northern Owls 3, Lakeshore Anc
 | Part | What it is |
 | --- | --- |
 | `drawKyogijo`, `drawSurface`, `drawScore`, `drawBadge` | The drawing, as a string of SVG. |
-| `SPORTS`, `PARKS`, `PARK_IDS`, `COURT_THEMES` | The twenty sports, the 94 ballparks, the court looks. |
+| `SPORTS`, `PARKS`, `PARK_IDS`, `COURT_THEMES` | The thirty-three sports, the 94 ballparks, the court looks. |
 | `SOCCER_PITCHES`, `SOCCER_PROVIDERS`, `rescale`, `soccerSpec` | The soccer pitches, the data providers' coordinate systems and the map between them. |
 | `GROUNDS`, `groundById` | The 64 soccer grounds, each pitch at its own size. |
 | `EVENTS`, `eventOptions` | The 18 special games: a rink in a ballpark, a court on a carrier's deck, with `host` and `placement` in the options. |
 | `./geometry`, `./frames`, `./layers`, `./charts`, `./replay` | The dimensions in any unit; the providers' frames; data layers; ready-made charts; tracking data played on a surface. |
+| `./athletics` | The athletics stadium: the plan, the track's geometry (the stagger of any lane), the races and field events, and the lane draw, results, race replay and field marks charts. |
+| `./skating` | The skating rinks: the plan, the long track's geometry (a skater's way round it, the start of a race), the races, and the pairs, starting positions, results, race replay and programme elements charts. |
 | `./parks`, `./grounds`, `./atlas`, `./eras`, `./leagues`, `./events` | The ballparks, the grounds, every place, the markings of a season, each league's rulebook, the special games. |
+| `./turn` | A surface as a 3D view that turns, with the net, basket, goal or posts standing on it. |
 | `./scene`, `./canvas`, `./d3`, `./plot`, `./geojson`, `./png` | The drawing as data; on a canvas; in a d3 selection; as an Observable Plot mark; as GeoJSON; as a PNG (the optional peer `@resvg/resvg-js`). |
 | `./layouts` | `drawGrid` and `GRID_PRESETS`: small multiples with a title, a subtitle, a key and a credit line; the grounds behind a drawing or a grid. |
 | `./mount`, `./react`, `./element`, `./element/define` | Draw into a container; React props; the `<kyogijo-field>` element and its registration. |
@@ -189,7 +199,7 @@ console.log(box(wide), box(tall));
 <br><em>The same game tall: the teams top and bottom, every word upright.</em>
 </p>
 
-[The surfaces](./docs/surfaces.md) lists the twenty, with their sizes and what is drawn; [score and layout](./docs/score.md) has the options of a score, a strip and a compact card.
+[The surfaces](./docs/surfaces.md) lists the thirty-three, with their sizes and what is drawn; [score and layout](./docs/score.md) has the options of a score, a strip and a compact card.
 
 ### A league's rulebook
 
@@ -304,7 +314,51 @@ console.log(svg.includes("--ky-key:#1e4f8f"), svg.includes("METRO BOLTS"));
 <br><em>A court in a look of its own: the paint, the border and the words on the baselines are options.</em>
 </p>
 
-The five court looks, the seven looks of every sport and every colour property are in [theming](./docs/theming.md).
+The five court looks, the eight looks of every sport and every colour property are in [theming](./docs/theming.md).
+
+### Turn it, and see the net
+
+```ts no-run
+import { mountKyogijoTurn } from "@johnmorrisdotca/kyogijo-stadiums/turn";
+
+const view = mountKyogijoTurn(document.querySelector("#court")!, { sport: "volleyball", status: "live" }, { preset: "end" });
+view.preset("corner");
+```
+
+```ts
+import { turnMarkup, uprightsFor } from "@johnmorrisdotca/kyogijo-stadiums/turn";
+
+const { items } = uprightsFor({ sport: "volleyball" }, { netHeight: "women" });
+const html = turnMarkup({ sport: "volleyball" }, { preset: "end" });
+console.log(items.map((item) => item.kind).join(), html.includes("preserve-3d"));
+// net,netposts,antennae false
+```
+
+The flat drawing is the floor, turned by a drag, a swipe, the keys or four viewpoints (overhead, broadcast, end-on, low corner), and what the rulebook stands on the surface is built up on it at its height. Each part is a flat rectangle placed by one `matrix3d`, so there is no 3D context for a phone to lose; where 3D is not drawn the flat drawing stays. In the element it is `<kyogijo-field sport="nhl" turn turn-view="broadcast">`. [The 3D view](./docs/turn.md).
+
+<p align="center">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-volleyball-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-volleyball-desk-light.webp" alt="A volleyball court from behind an end line, turned in the demo: the net at 2.43 metres on its posts with the red and white antennae, and under it the buttons for the four viewpoints, turning, raising, zooming and resetting." width="640">
+</picture>
+<br><em>A volleyball net at its rulebook height, with its posts and antennae.</em>
+</p>
+
+<p align="center">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-rink-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-rink-desk-light.webp" alt="An ice rink from a low corner, turned in the demo: the boards with their glass round the ice, a goal at each end, and the score on the ice." width="640">
+</picture>
+<br><em>A rink with its boards, glass and goals.</em>
+</p>
+
+<p align="center">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-court-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-court-desk-light.webp" alt="A basketball court from the main camera, turned in the demo: a basket on its backboard and padded stanchion at each end of the floor." width="640">
+</picture>
+<br><em>A court with a basket at each end, the rim at 10 feet.</em>
+</p>
 
 ### A shoot-out, and a famous ground
 
@@ -469,7 +523,7 @@ A page that moves (`mountKyogijo`), a file written on a server and a frame for a
 
 ## API
 
-The [API reference](https://johnmorrisdotca.github.io/kyogijo-stadiums/api.html) lists every export of every entry point with its signature and its doc comment. It is made from the source by `pnpm site`, so it cannot fall behind the code. [Entry points](./docs/entry-points.md) says what each of the 15 holds: the main one draws; `/geometry`, `/frames`, `/layers`, `/charts`, `/replay`, `/parks`, `/eras`, `/leagues`, `/grounds` and `/atlas` stand apart and need nothing else; `/mount`, `/react`, `/element` and `/element/define` put a drawing in a page.
+The [API reference](https://johnmorrisdotca.github.io/kyogijo-stadiums/api.html) lists every export of every entry point with its signature and its doc comment. It is made from the source by `pnpm site`, so it cannot fall behind the code. [Entry points](./docs/entry-points.md) says what each of the 15 holds: the main one draws; `/geometry`, `/frames`, `/layers`, `/charts`, `/replay`, `/parks`, `/eras`, `/leagues`, `/grounds` and `/atlas` stand apart and need nothing else; `/mount`, `/turn`, `/react`, `/element` and `/element/define` put a drawing in a page.
 
 Every function is pure: it returns new values and never changes what it was given.
 
@@ -479,7 +533,7 @@ Nothing is branded. The drawing is coloured by custom properties on its `svg`, w
 
 ## Limits
 
-Each is held by a test: twenty sports, ten soccer pitches and ten providers, 94 ballparks, 64 grounds, six units, twenty-nine frames, a drawing of under 22 kB. The table, made from the code, is [limits](./docs/limits.md).
+Each is held by a test: thirty-three sports, ten soccer pitches and ten providers, 94 ballparks, 64 grounds, six units, forty-two frames, a drawing of under 22 kB. The table, made from the code, is [limits](./docs/limits.md).
 
 ## Accessibility
 
@@ -532,7 +586,7 @@ Using Kyogijo Stadiums in something? Open an *Add my project* issue and we will
 ### The family
 
 <!-- family:start (made by scripts/family-readme.mjs from scripts/family-template.mjs; change those, not this) -->
-Kyogijo is one of twenty-five packages, each made for the same site, each at
+Kyogijo Stadiums is one of twenty-six packages, each made for the same site, each at
 [github.com/johnmorrisdotca](https://github.com/johnmorrisdotca). The code of every one is MIT.
 
 - [Korokoro](https://github.com/johnmorrisdotca/korokoro) (コロコロ): dice, with notation, exact odds, real sounds and the dice of many games. [Demo](https://johnmorrisdotca.github.io/korokoro/).
@@ -559,9 +613,10 @@ Kyogijo is one of twenty-five packages, each made for the same site, each at
 - [Gunjin](https://github.com/johnmorrisdotca/gunjin) (軍人): five hidden-rank strategy games with pass-the-device play. [Demo](https://johnmorrisdotca.github.io/gunjin/).
 - [Karakuri](https://github.com/johnmorrisdotca/karakuri) (からくり): eight hyper-casual puzzle games, some of them physics: draw a shield, pull pins, cut ropes, slide blocks, pour tubes. [Demo](https://johnmorrisdotca.github.io/karakuri/).
 - [Houseki](https://github.com/johnmorrisdotca/houseki) (宝石): gem and stone matching puzzles: falling triplets, stone collapse, colour chains and gem swap. [Demo](https://johnmorrisdotca.github.io/houseki/).
-- [Kyogijo](https://github.com/johnmorrisdotca/kyogijo-stadiums) (競技場): sports fields, rinks, courts and ballparks drawn to scale as SVG, with each team and the score on them. [Demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/).
+- [Kyogijo Stadiums](https://github.com/johnmorrisdotca/kyogijo-stadiums) (競技場): sports fields, rinks, courts and ballparks drawn to scale as SVG, with each team and the score on them. [Demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/).
+- [Taisen Brackets](https://github.com/johnmorrisdotca/taisen-brackets) (対戦): a sport-agnostic tournament bracket, drawn as SVG, from a list of ties. [Demo](https://johnmorrisdotca.github.io/taisen-brackets/).
 
-**This package is Kyogijo.** The demos of all twenty-five share one header and footer, so each links the rest.
+**This package is Kyogijo Stadiums.** The demos of all twenty-six share one header and footer, so each links the rest.
 <!-- family:end -->
 
 ## Development

package/dist/annotate.js

@@ -10,7 +10,7 @@ import { textWidth } from "./text.js";
 import { textOn } from "./surfaces/surface.js";
 import { FEET_PER, SURFACE_UNITS, isUnit } from "./units.js";
 /** The margin each surface has when the options give none (the builders' own defaults), in feet. */
-export const DEFAULT_MARGIN = { nfl: 12, cfl: 12, ifaf: 12, nhl: 8, nba: 7, mlb: 14, soccer: 15, curling: 3, lacrosse: 16, rugby: 16, afl: 16, gaelic: 16, cricket: 9, fieldhockey: 16, handball: 10 };
+export const DEFAULT_MARGIN = { nfl: 12, cfl: 12, ifaf: 12, nhl: 8, nba: 7, mlb: 14, soccer: 15, curling: 3, swimming: 8.2, waterpolo: 9.8, diving: 8.2, artisticswimming: 9.8, lacrosse: 16, rugby: 16, afl: 16, gaelic: 16, cricket: 9, fieldhockey: 16, handball: 10 };
 const NONE = { svg: "", summaries: [], need: 0, reach: { top: 0, bottom: 0 } };
 /** The surface's wide frame view: the drawing's viewBox as the surface lies wide, which for a turned surface is found again from its turn. */
 export function wideView(surface) {

package/dist/athletics/describe.d.ts

@@ -0,0 +1,8 @@
+import type { Language, SurfaceOptions } from "../types.ts";
+/** The words of a race or a field event in a language. */
+export declare const raceName: (id: string, language: Language) => string;
+export declare const fieldEventName: (id: string, language: Language) => string;
+/** The sentence about the track, as a fragment: "an athletics track of 400 metres with 8 lanes...". */
+export declare function athleticsAbout(o: Pick<SurfaceOptions, "sport" | "league" | "athletics">, language: Language): string;
+/** The sentences that follow it: the infield, the events and the races marked, the close-up and the layout. Each starts after a gap. */
+export declare function athleticsSentences(o: Pick<SurfaceOptions, "sport" | "league" | "athletics" | "range">, language: Language): string;

package/dist/athletics/describe.js

@@ -0,0 +1,41 @@
+// What an athletics drawing says of itself: its sentence about the track, and what the options mark on it. Cheap (it reads the options, not the plan), so that a title and a description cost nothing.
+import { fill, KYOGIJO_STRINGS } from "../strings.js";
+import { fieldEventById, raceById } from "./events.js";
+import { athleticsLanes, athleticsLeague, eventsOf, racesOf } from "./plan.js";
+/** The words of a race or a field event in a language. */
+export const raceName = (id, language) => raceById(id)?.name[language] ?? id;
+export const fieldEventName = (id, language) => fieldEventById(id)?.name[language] ?? id;
+/** The sentence about the track, as a fragment: "an athletics track of 400 metres with 8 lanes...". */
+export function athleticsAbout(o, language) {
+    const words = KYOGIJO_STRINGS[language].athletics;
+    const league = athleticsLeague(o);
+    return fill(league.dimensions.banking === null ? words.track400 : words.track200, { lanes: athleticsLanes(o) });
+}
+/** The sentences that follow it: the infield, the events and the races marked, the close-up and the layout. Each starts after a gap. */
+export function athleticsSentences(o, language) {
+    const words = KYOGIJO_STRINGS[language].athletics;
+    const { gap } = KYOGIJO_STRINGS[language].said;
+    const sep = KYOGIJO_STRINGS[language].layers.listSep;
+    const style = o.athletics;
+    const league = athleticsLeague(o);
+    const indoor = league.dimensions.banking !== null;
+    const out = [];
+    if (style?.layout !== undefined)
+        return `${gap}${fill(words.layout, { event: fieldEventName(style.layout, language) })}`;
+    const infield = style?.infield ?? (indoor ? "none" : "pitch");
+    out.push(infield === "pitch" ? words.infieldPitch : infield === "grass" ? words.infieldGrass : words.infieldNone);
+    if (!indoor) {
+        const events = eventsOf(style);
+        if (events.length > 0)
+            out.push(fill(words.events, { list: events.map((e) => fieldEventName(e, language)).join(sep) }));
+    }
+    const races = racesOf(style, indoor);
+    if (races.length > 0)
+        out.push(fill(words.races, { list: races.map((r) => r.name[language]).join(sep) }));
+    const range = typeof o.range === "string" ? o.range : typeof o.range === "object" && o.range !== null && "name" in o.range ? o.range.name : undefined;
+    if (range === "start")
+        out.push(fill(words.start, { race: raceName(style?.start ?? "400m", language) }));
+    if (range === "finish")
+        out.push(words.finish);
+    return out.map((t) => `${gap}${t}`).join("");
+}

package/dist/athletics/events.d.ts

@@ -0,0 +1,17 @@
+import type { AthleticsFieldEvent, AthleticsRace, FieldEventInfo, RaceInfo } from "./types.ts";
+/**
+ * The races, in the order a menu lists them. `kind` says how the start is made: `straight` (the sprints and the sprint hurdles, on the finish straight), `stagger` (the lanes' staggers of Table
+ * 2.2.1.6a: `bends` half-turns in lanes), `curved` (a curved start line, the waterfall, for a race run without lanes) and `steeplechase` (the water jump's lap). The breakline (Rule 17.5.1) is the
+ * 800 m's and the 4 x 400 m's; the group starts (Rule 17.5.2) are those of the races over 1000 m.
+ */
+export declare const RACES: readonly RaceInfo[];
+/** The ids of the races. */
+export declare const RACE_IDS: readonly AthleticsRace[];
+/** A race by its id, or `undefined`. */
+export declare const raceById: (id: unknown) => RaceInfo | undefined;
+/** The field events, in the order a menu lists them: the jumps and then the throws. */
+export declare const FIELD_EVENTS: readonly FieldEventInfo[];
+/** The ids of the field events. */
+export declare const FIELD_EVENT_IDS: readonly AthleticsFieldEvent[];
+/** A field event by its id, or `undefined`. */
+export declare const fieldEventById: (id: unknown) => FieldEventInfo | undefined;

package/dist/athletics/events.js

@@ -0,0 +1,48 @@
+const race = (r) => Object.freeze(r);
+/**
+ * The races, in the order a menu lists them. `kind` says how the start is made: `straight` (the sprints and the sprint hurdles, on the finish straight), `stagger` (the lanes' staggers of Table
+ * 2.2.1.6a: `bends` half-turns in lanes), `curved` (a curved start line, the waterfall, for a race run without lanes) and `steeplechase` (the water jump's lap). The breakline (Rule 17.5.1) is the
+ * 800 m's and the 4 x 400 m's; the group starts (Rule 17.5.2) are those of the races over 1000 m.
+ */
+export const RACES = Object.freeze([
+    race({ id: "60m", distance: 60, kind: "straight", indoor: true, name: { en: "60 m", ja: "60m", fr: "60\u00a0m" } }),
+    race({ id: "60m-hurdles", distance: 60, kind: "straight", hurdles: true, indoor: true, name: { en: "60 m hurdles", ja: "60mハードル", fr: "60\u00a0m haies" } }),
+    race({ id: "100m", distance: 100, kind: "straight", name: { en: "100 m", ja: "100m", fr: "100\u00a0m" } }),
+    race({ id: "100m-hurdles", distance: 100, kind: "straight", hurdles: true, name: { en: "100 m hurdles", ja: "100mハードル", fr: "100\u00a0m haies" } }),
+    race({ id: "110m-hurdles", distance: 110, kind: "straight", hurdles: true, name: { en: "110 m hurdles", ja: "110mハードル", fr: "110\u00a0m haies" } }),
+    race({ id: "200m", distance: 200, kind: "stagger", bends: 1, name: { en: "200 m", ja: "200m", fr: "200\u00a0m" } }),
+    race({ id: "400m", distance: 400, kind: "stagger", bends: 2, name: { en: "400 m", ja: "400m", fr: "400\u00a0m" } }),
+    race({ id: "400m-hurdles", distance: 400, kind: "stagger", bends: 2, hurdles: true, name: { en: "400 m hurdles", ja: "400mハードル", fr: "400\u00a0m haies" } }),
+    race({ id: "800m", distance: 800, kind: "stagger", bends: 1, breakline: true, name: { en: "800 m", ja: "800m", fr: "800\u00a0m" } }),
+    race({ id: "1000m", distance: 1000, kind: "curved", group: true, name: { en: "1000 m", ja: "1000m", fr: "1000\u00a0m" } }),
+    race({ id: "1500m", distance: 1500, kind: "curved", name: { en: "1500 m", ja: "1500m", fr: "1500\u00a0m" } }),
+    race({ id: "mile", distance: 1609.344, kind: "curved", name: { en: "Mile", ja: "1マイル", fr: "Mile" } }),
+    race({ id: "2000m", distance: 2000, kind: "curved", group: true, name: { en: "2000 m", ja: "2000m", fr: "2000\u00a0m" } }),
+    race({ id: "3000m", distance: 3000, kind: "curved", group: true, name: { en: "3000 m", ja: "3000m", fr: "3000\u00a0m" } }),
+    race({ id: "5000m", distance: 5000, kind: "curved", group: true, name: { en: "5000 m", ja: "5000m", fr: "5000\u00a0m" } }),
+    race({ id: "10000m", distance: 10000, kind: "curved", group: true, name: { en: "10,000 m", ja: "10000m", fr: "10\u00a0000\u00a0m" } }),
+    race({ id: "2000m-steeplechase", distance: 2000, kind: "steeplechase", name: { en: "2000 m steeplechase", ja: "2000m障害物競走", fr: "2000\u00a0m steeple" } }),
+    race({ id: "3000m-steeplechase", distance: 3000, kind: "steeplechase", group: true, name: { en: "3000 m steeplechase", ja: "3000m障害物競走", fr: "3000\u00a0m steeple" } }),
+    race({ id: "4x100m", distance: 400, kind: "stagger", bends: 2, legs: [100, 100, 100, 100], name: { en: "4 x 100 m relay", ja: "4×100mリレー", fr: "Relais 4\u00a0×\u00a0100\u00a0m" } }),
+    race({ id: "4x400m", distance: 1600, kind: "stagger", bends: 3, breakline: true, legs: [400, 400, 400, 400], name: { en: "4 x 400 m relay", ja: "4×400mリレー", fr: "Relais 4\u00a0×\u00a0400\u00a0m" } }),
+]);
+/** The ids of the races. */
+export const RACE_IDS = Object.freeze(RACES.map((r) => r.id));
+/** A race by its id, or `undefined`. */
+export const raceById = (id) => RACES.find((r) => r.id === id);
+const field = (f) => Object.freeze(f);
+/** The field events, in the order a menu lists them: the jumps and then the throws. */
+export const FIELD_EVENTS = Object.freeze([
+    field({ id: "high-jump", name: { en: "High jump", ja: "走高跳", fr: "Saut en hauteur" } }),
+    field({ id: "pole-vault", name: { en: "Pole vault", ja: "棒高跳", fr: "Saut à la perche" } }),
+    field({ id: "long-jump", name: { en: "Long jump", ja: "走幅跳", fr: "Saut en longueur" } }),
+    field({ id: "triple-jump", name: { en: "Triple jump", ja: "三段跳", fr: "Triple saut" } }),
+    field({ id: "shot-put", name: { en: "Shot put", ja: "砲丸投", fr: "Lancer du poids" } }),
+    field({ id: "discus-throw", name: { en: "Discus throw", ja: "円盤投", fr: "Lancer du disque" } }),
+    field({ id: "hammer-throw", name: { en: "Hammer throw", ja: "ハンマー投", fr: "Lancer du marteau" } }),
+    field({ id: "javelin-throw", name: { en: "Javelin throw", ja: "やり投", fr: "Lancer du javelot" } }),
+]);
+/** The ids of the field events. */
+export const FIELD_EVENT_IDS = Object.freeze(FIELD_EVENTS.map((f) => f.id));
+/** A field event by its id, or `undefined`. */
+export const fieldEventById = (id) => FIELD_EVENTS.find((f) => f.id === id);