@johnmorrisdotca/kyogijo-stadiums 0.0.0-stage → 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,204 @@
+# Changelog
+
+All notable changes to this project are written here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses
+[Semantic Versioning](https://semver.org/).
+
+
+## [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
+
+Previously `@johnmorrisdotca/kyogijo`; renamed in 0.4.0 to `@johnmorrisdotca/kyogijo-stadiums`.
+
+### Added
+
+- **`roadToFinal`: the road to a tournament's final** (`@johnmorrisdotca/kyogijo-stadiums/charts`, [docs/charts.md](./docs/charts.md#the-road-to-the-final)). The two finalists as large round marks with their names; down the middle the rounds, the last at the top, on a dotted road; on each finalist's side its matches, each as the round mark of both teams with the score between them in large type and FT, AET or the shoot-out under it; and the group stage as a row of small marks, three-letter codes and scores at the foot. A finalist is a `Team` with a `path` of `{ round, opponent, score, decidedBy, pens, homeFirst, note }` and an optional `group`; a round is a key with words in English and Japanese (`round-of-32` to `semi-final`) or any key named in `labels`, so a play-off series (`4-2`) draws as well as a knockout. `final` writes the final's score between the large marks and quiets the loser; `winner` makes the side that won each match brighter; `codes`, `endnote`, `groupLabel`, `theme`, `language` and `style: "none"` as in the other drawings. Four sizes: `card` (1080 by 1350), `square` (1080 by 1080), `wide` (1200 by 675, the finalists at the two ends) and `phone` (390 wide, as tall as the rounds need), listed in `ROAD_SIZES`. It gives back a chart's shape without layers: `options`, `title`, `summary`, `totals` (each finalist's record, the rounds, the champion), `draw(extra)` and `table()`, a row for every match. The SVG is `role="img"` with a title and a description, reads in the scene and every renderer, goes in a `drawGrid`, and has ids of its own; a team with no flag or logo is drawn as its initials on its colour. New: `KYOGIJO_ROAD_STYLE`, the types `RoadChart`, `RoadFinalist`, `RoadMatch`, `RoadGroupMatch`, `RoadFinal`, `RoadOptions`, `RoadScore`, `RoadDecided`, `RoadSize`, `RoadSizeInfo`, `RoadRecord` and `RoadTotals`, and the `road` words of `KYOGIJO_STRINGS` (`en` and `ja`; a custom set of words must give them).
+- **A round team mark in a score** ([docs/score.md](./docs/score.md#round-marks)). `mark: "round"` on a team, or `markShape: "round"` on the score, draws its flag or logo clipped to a circle with a thin ring, on each side of the surface (the end zones of a pitch, the halves of a court), in the badge and in the strip of a compact card; where the words are turned (along the ends of a wide pitch, in a tall drawing) the mark is turned back and stays upright. A round mark with no logo is the team's initials on its colour; `markFit: "contain"` shows a crest whole on a plain disc. Off by default, and a drawing without it is the same text as before. New: `Team.mark`, `Team.markFit`, `ScoreOptions.markShape`, the type `TeamMark` and `KYOGIJO_MARK_STYLE` (`--ky-mark-ring`, `--ky-mark-edge`, `--ky-mark-plain`); a drawing writes the rules in only when it has a round mark.
+- The demo has a "Road to the final" section with made-up nations (sixteen that do not exist, each with a simple flag drawn in code in `demo/road-data.js`), a play-off series, and the round mark on a pitch, in English and Japanese; the docs gallery has the same drawings, each made from the code beside it.
+
+### Changed
+
+- **Breaking: the package is now `@johnmorrisdotca/kyogijo-stadiums`** (it was `@johnmorrisdotca/kyogijo`, whose last version is 0.3.0). The code is the same, and so are the names in it: `drawKyogijo`, `mountKyogijo`, `<kyogijo-field>` and the `kyogijo` class are unchanged, and the product is still Kyogijo (競技場). What changes is where it is installed and imported from: `npm install @johnmorrisdotca/kyogijo-stadiums`, `import { drawKyogijo } from "@johnmorrisdotca/kyogijo-stadiums"`, and the same for every entry (`/charts`, `/replay`, `/layouts` and the rest) and for the CDNs (`https://cdn.jsdelivr.net/npm/@johnmorrisdotca/kyogijo-stadiums@0/+esm`). The repository is now `github.com/johnmorrisdotca/kyogijo-stadiums` and the demo `johnmorrisdotca.github.io/kyogijo-stadiums/` (the old repository address redirects; the old demo address does not). The demo keeps its choices of language and theme on the device under `kyogijo-stadiums.page.lang` and `kyogijo-stadiums.theme` (they were `kyogijo.`), so each visitor is asked once more. The family's template (`scripts/family-template.mjs`, version 2026-10-14) names the package `kyogijo-stadiums` in the footer and in every package's list of the family.
+- **The demo's Ballparks section is short, with filters, and there is a Soccer grounds section like it.** All 94 park cards in one grid made a section 2,200 px tall on a desk and 6,000 px on a phone. It now opens on the MLB parks in use today (30), as two rows of eight on a desk and one row that scrolls sideways on a phone (a row keeps the section to one screen, and the next card shows at the edge to say it scrolls), with "Show all 30 parks" under them: 640 px on a desk and 580 px on a phone. Above the cards are the league (All, MLB, NPB), whether a park is in use (All, Today, Past), the era (a decade, for the past parks), a search that reads every name a park has had, in English and in Japanese (`placesBy`: `Camden Yards`, `甲子園`, `ヤンキースタジアム`; the filters are off while it is typed, so it reaches every park), a count line in a polite live region (`30 of 94 parks`) and a reset. The grounds have the same: the grounds of the World Cup finals open (28 of 64), with group (finals, 2026, clubs), country and search, and the section is no taller. The filters are in the address under their own names (`parkleague`, `parkstatus`, `parkera`, `parkq`, `parkall`; `groundgroup`, `groundcountry`, `groundq`, `groundall`), written only when they are not the default. The build draws the default view of both sections into the HTML, so they are whole with scripts off and move nothing when the script takes over; the e2e tests hold that (a layout shift of 0 with the sections in view) and cover the filters, both searches, show all, the address, the phone and the desk. The package is unchanged.
+- **The demo's Every sport and The soccer pitch sections are short too, with chips.** The sport gallery was 4,451 px tall on a desk and 11,941 px on a phone, and the pitches section 3,236 px and 8,455 px, because every card drew tall. They now open on the first cards, wide, in boxes of one shape: two rows of three on a desk and one row that scrolls sideways on a phone with the next card peeking (738 and 458 px for the sports, 755 and 509 px for the pitches), with chips for the family of sport (Football codes, Hockey, Basketball, Baseball, Soccer, Curling, Net sports, Field sports) or the kind of pitch (Presets, Small-sided, Futsal, Famous grounds, Layouts, Mowing and goals; the mowing cards joined the pitches, with 5- and 9-a-side), a count that a screen reader hears, "Show all", and the chips in the address (`galleryfamily`, `galleryall`, `pitchesgroup`, `pitchesall`), English and Japanese. The first view is drawn into the page, and the cards a desk does not show first are boxes that the script draws when the grid comes near the screen, so the page does not carry a drawing of every card and nothing moves when one arrives (the same for the Ballparks and Soccer grounds).
+- **Breaking: soccer, rugby (union and league), Australian football, Gaelic games, field hockey, handball and cricket now put the home team first (left) by default; pass `homeSide: "right"` for the old layout** ([docs/score.md](./docs/score.md#which-side-the-home-team-is-on)). The default was the North American "away at home" for every sport, which reversed a soccer score against "Home 2-1 Away". NFL, CFL, IFAF, NHL, NBA, MLB, curling, the net sports and lacrosse (except the `world-men`, `world-women` and `world-box` leagues, which are home first) keep the home team on the right. An explicit `homeSide` always wins. The badge, the compact strip, the order of the teams in the title and the description (`Calvara 1, Aurelia 2`, in Japanese too) and of a shoot-out in the status (`Final · 2-4 pens`) follow the side. New: `homeSideFor(sport, league?)`, and the `HOME_FIRST` and `HOME_FIRST_LEAGUES` tables behind it. `abbreviate()` now says that its guess is not a country code (Spain gives `SPA`, FIFA's is `ESP`): pass each national team's `abbr`.
+
+### Fixed
+
+- **The demo's first paint is whole.** The stage was a thin bar and every panel an empty box until the script ran, then the page jumped (a layout shift of 0.5). The build now draws the playground's first view into the HTML: the default rink, every English word, and the controls in their first state, so the page reads and shows its drawing with scripts off, and the script takes over the nodes that are there. The stage keeps its box from the first byte (its shape, by the drawing's width over its height), and an address that asks for another sport, size or way round has its box, rows and pressed choices set by a small inline script before anything is drawn, so the drawing swaps in place; a page opened in Japanese (the address, a kept choice or the browser) is held back, invisible but laid out, and shown in Japanese rather than English first. The docs, the gallery and the API reference have their header, footer and search words in the HTML too, and set `lang` before paint. The layout shift on load is 0 at every address and width tried (0.003 at most, for a past season whose notes are drawn by the script), and the e2e tests hold it under 0.05. The package is unchanged.
+
+## [0.3.0] - 2026-10-14
+
+### Added
+
+- **Names for every park and ground** ([docs/ballparks.md](./docs/ballparks.md#names), [docs/grounds.md](./docs/grounds.md#names), [docs/references.md](./docs/references.md#names)). Each of the 94 ballparks and 64 grounds has `name`, the everyday name in English (the one English sports media use, with the current sponsor's where that is what people say); `nameJa`, the everyday name in Japanese (every place has one: the 74 ballparks of the United States and Canada, which a Japanese drawing used to name in English, now have the title of their Japanese article); `readingJa`, its reading in kana wherever it has kanji; `localName` and `localLanguage`, the everyday name in the language of the place; and `aliases`, `{ name, lang, kind, from?, to?, source?, revision?, reading? }`: 720 names, each with where it was read, of the kinds `wikipedia` (every article that was cited, English and Japanese, with its revision, so that no citation is lost), `official`, `sponsor`, `former` (with the years a source gives) and `nickname`. The evidence is Wikidata's labels, aliases and properties official name, nickname and name (CC0), read politely by `pnpm names:fetch` into `scripts/names.wikidata.json`, and the infobox and first paragraph of the articles each place cites; a name with no source stops the build. A ground's `names` (the names it had in some years) are as before.
+- **Lookups by name**: `parkByName` and `parksByName` (`/parks`), `groundByName` and `groundsByName` (`/grounds`), and `placeByName` and `placesByName` (`/atlas`) find a place by any of its names, in English, in Japanese or in the language of the place, best match first (the everyday names, then the official, cited and sponsors' names, then the former names and the nicknames). The comparison, `plainName`, ignores case, accents, spaces and punctuation, full-width and half-width, hiragana and katakana, the long vowel mark (`ヤンキー・スタジアム` is `ヤンキースタジアム`), the old and new forms of ヂ, ヅ and ヴ, and a leading `The`. The atlas search (`placesBy({ text })`) reads the aliases and the readings too. `officialName`, `parkOfficialName` and `groundOfficialName` give the name a place officially has when it is not the everyday one.
+- A drawing says the official name in its description when it is not the name it uses: `Its official name is Hanshin Koshien Stadium.`, `正式名称は阪神甲子園球場です。` (`said.officially` in `KYOGIJO_STRINGS`), in the year of the drawing where the official name is dated.
+- The demo's Atlas detail panel lists the official name and the other names (`atlasOfficial`, `atlasAlso`), and its search finds them.
+
+### Changed
+
+- **Breaking: `name` is the everyday name, no longer the title of the article that was cited** (that title is an alias with kind `wikipedia`). Seven English names changed: `hanshin-koshien-stadium` is `Koshien Stadium` (was `Hanshin Koshien Stadium`), `mazda-stadium-hiroshima` `Mazda Stadium` (was `Mazda Zoom-Zoom Stadium Hiroshima`), `rakuten-mobile-park-miyagi` `Rakuten Mobile Saikyo Park Miyagi` (was `Rakuten Mobile Park Miyagi`, the name until 2025), `globe-life-park-in-arlington` `Choctaw Stadium` (as its article is titled now), `olympiastadion-munich` `Munich Olympic Stadium`, `olympiastadion-berlin` `Berlin Olympic Stadium`, and `groupama-stadium` `Groupama Stadium` (was `Parc Olympique Lyonnais`). `nrg-stadium` stays `Reliant Stadium`: its article says it was renamed back from `NRG Stadium` on 1 August 2026, and `NRG Stadium` (2014 to 2026) is a dated name and a `sponsor` alias.
+- **Breaking: `nameJa` is the everyday name in Japanese**, as Japanese media say it where the Japanese article says which. Thirteen changed: `甲子園球場` (was `阪神甲子園球場`), `神宮球場` (was `明治神宮野球場`), `マツダスタジアム`, `エスコンフィールド北海道`, `楽天モバイル 最強パーク宮城`, `日産スタジアム` (was `横浜国際総合競技場`), `マラカナン`, `エスタディオ・モヌメンタル`, `ドイチェ・バンク・パルク`, `グルパマ・スタジアム`, `サン・シーロ`, `エティハド・スタジアム` and `カシマサッカースタジアム`; the old names are aliases (`official` or `wikipedia`). `ParkData.nameJa` and `Place.nameJa` are no longer optional: code that builds a `ParkData` or a `Place` of its own must give one.
+- **Breaking: `Ground.nameLocal` is now `localName`**, and it is the everyday name in the language of the place (`San Siro` for the Meazza, `Maracanã`, `La Bombonera`, `Лужники`, `日産スタジアム`), not the name of the local article (the official ones are aliases). The parks of Japan, Montreal's two, and every ground outside the English-speaking world have `localName` and `localLanguage` too.
+- **Breaking: the SVG written by `drawKyogijo` changes.** The English drawing of 15 grounds and 13 ballparks differs from 0.2.0's (the name, or the sentence that says the official name), and so does the Japanese drawing of every sport wherever it uses a word the native read of the Japanese settled (see below); every drawing's `data-version` reads `0.3.0`, which also changes the ids that are made from it. A stored copy of an old drawing, or a snapshot test of one, needs to be made again.
+- **A native read of every Japanese string**, one terminology for the whole package: `ペナルティー` with the long vowel, as the JFA writes it (`ペナルティーエリア`, `ペナルティーアーク`, `ペナルティーマーク`, `ペナルティースポット`), `ウイング`, `本塁` for home plate (was `ホームベース`), `ゴーリー` for the goaltender, `国際標準` for the FIFA pitch, `BCプレイス`, `ゲーリック・ゲームズ`, `中堅正面` for dead centre, `ゴール裏` for behind the goal line, `フェアゾーン` and `ファウルゾーン`, `ゲームごとのスコア`; ranges are written with `〜` (was the full-width tilde `～`), and a size gives its unit once, `105×68m` (was `105m×68m`). English output is unchanged.
+- The drawings that changed on purpose: the English drawing of 15 grounds and 13 ballparks (the name, or the sentence that says the official name) and the Japanese drawing of 8 grounds and 84 ballparks (the 74 of the United States and Canada, named in katakana now instead of in English, and 10 of Japan); a test holds every other drawing, in English and in Japanese, to the bytes it had.
+- The demo's help text for the sport selector names all 20 sports, in English and in Japanese (it listed 14).
+- The demo's Japanese status choices read as the status the drawing prints (`試合終了（延長）`, `試合終了（SO）`, `試合終了（延長戦）`, `試合終了（PK戦）`), and its Japanese page titles and labels follow the same terminology.
+
+### Fixed
+
+- **Spoken times in Japanese read as the time of day.** A replay's length and an event's time were said as `0:12` and `1:12`, which a Japanese reader takes for a clock; they are `12秒` and `1分12秒` now (`replaySpoken`, and the new strings `replay.spokenSeconds`, `replay.spokenMinutes` and `replay.spokenHours`, which a custom set of words must give). English still says `0:12`.
+- **A convex hull's area unit was `平方m` in Japanese.** The unit is a word of the language now, `平方メートル`, `平方フィート` and `平方ヤード` (`team.squareUnits`, `team.squareOther`; `team.hullItem` takes the whole unit, `{unit}`, not `square {unit}`). English reads as it did.
+
+## [0.2.0] - 2026-10-14
+
+### Added
+
+- **Layouts: small multiples** (`@johnmorrisdotca/kyogijo/layouts`, [docs/layouts.md](./docs/layouts.md)). `drawGrid(cells, { columns, gap, title, subtitle, endnote, legend, width, height, preset, background, language, theme })` puts many drawings in one SVG, as mplsoccer's `grid` does for pitches: one per park, per period or per player, under a shared title and subtitle, over a credit line, with a key they share. A cell is the options of `drawKyogijo`, a drawing's SVG, a chart, or `{ drawing, label }`. Every drawing keeps its own title and description and gets ids of its own (the same drawing may appear twice, and each rule scoped to an id follows it); the group has a title and a description made from them; the base stylesheet is written once. `preset` fits a social card (`card`, 1200 by 675), a square post (`square`, 1080 by 1080) or a phone (`phone`, 390 wide, one column, as tall as the drawings need); the columns are the number that makes the drawings largest. The scene and every renderer read a grid like any drawing. English and Japanese words for the group's title and description, and a test of every sport, every preset, ids, bounds and renderers.
+- **Backgrounds** (`background` in the options of a drawing, and of a grid). A pattern drawn in SVG, with no image and no random number (`felt`, `grass`, `wood`, `ice`, `paper`, `grid`, `dots`), in the drawing's own ink at a low opacity so that it follows light and dark, laid on the apron under the surface; a colour under it; and a photograph (`image`, held to the rules of a team's `logo`, `imageOpacity`, `imageFit`) as an `<image>` between the two. Without a background a drawing is byte for byte as before. The canvas renderer cuts a photograph that fills the ground (`slice`) at its edges.
+- **Runnable gallery examples.** Every picture of the gallery has a link to download the drawing as an SVG file and an "Open in a page" link to one HTML file, made when the site is built, that shows the picture, runs the snippet against the package on jsDelivr (`@johnmorrisdotca/kyogijo@<major>/+esm`, with the entries imported as `<major>/charts/+esm` and so on) and keeps the build's picture when the published package has no such feature. No third-party sandbox is used, and the page says that jsDelivr serves only published versions. A test runs every page's script against the source. A gallery page of layouts and backgrounds.
+- **Lacrosse, rugby, Australian football, Gaelic games, cricket, field hockey and handball** (`sport: "lacrosse"`, `"rugby"`, `"afl"`, `"gaelic"`, `"cricket"`, `"fieldhockey"`, `"handball"`, [docs/field-sports.md](./docs/field-sports.md)). Each surface to scale from its own current rulebook, every figure cited, rule by rule, in docs/sources.md: World Lacrosse's men's and women's fields and box floor (2025 to 2028), the NCAA's men's and women's fields, the PLL's field (its 2024 book, the newest found) and the NLL's floor; World Rugby's Law 1 (2026), the NRL's (2023) and the IRL's (2024) playing fields; the AFL's Law 3 (2026), as an oval cut at its ends, with six named grounds at the length and width the AFL's venue pages print; the GAA's Rule 1 for football and hurling (2026); the pitch, creases and wickets of the Laws of Cricket (4th Edition 2026) in a ground with a boundary of your own and the ICC's 30-yard circle (October 2026); the FIH's pitch (March 2026) and the IHF's court (1 July 2025). 7 sports, 7 lacrosse leagues, 3 rugby, 2 Gaelic, 3 cricket (`LEAGUES`), the option `field` (`length`, `width`, `inGoal`, `ground`, `boundary`, `circle`: a size within the range each rulebook allows, an error that says the range when it is outside), `FIELD_SPORTS`, `fieldPlan` and `AFL_GROUNDS`.
+- **The field sports' scores**: Australian football's `goals` and `behinds` written `10.12 (72)` and Gaelic games' `goals` and `points` written `2-14 (20)`, the total worked out; a cricket board of runs for wickets, overs and each innings (`wickets`, `overs`, `innings`, the status `innings-2`), with the sentences for each in the description.
+- Ranges for the field sports (`in-goal`, `twenty-two`, `twenty`, `crease`, `forward-fifty`, `centre-square`, `large-rectangle`, `pitch`, `circle`, `twenty-three`, `goal-area`, with `RangeInfo.leagues` for a range that only some leagues mark), the zone sets `field-thirds` and `cricket-ground`, the frames `lacrosse`, `rugby`, `afl`, `gaelic`, `cricket`, `fieldhockey` and `handball` (the centre of the surface as the origin), landmarks, features (`FEATURES.rugby` and the others), the goal styles for lacrosse, field hockey and handball, `KYOGIJO_FIELDS_STYLE` (the colours of a handball floor and a hockey pitch), a gallery page and English and Japanese words for all of it. The other 13 surfaces' drawings are the same text as before.
+- **Walls and quirks of a ballpark** (`walls`, `quirks`, `parkWallsIn`, `parkQuirksIn`, `Park.walls`, `Park.quirks`, [docs/ballparks.md](./docs/ballparks.md)). `walls: true` draws a band outside each stretch of a park's fence whose width and shade (four, light and dark, `KYOGIJO_WALLS_STYLE`) say how high it stands, from the height its article gives (35 parks, 24 of MLB and 11 of Japan: the Green Monster 37 feet 2 inches, the Little Green Monster, the Crawford Boxes, Oracle Park's 24 foot right field wall, the Baggie, Wrigley Field's ivy walls), for the season `year` names; `walls: { legend: true, labels: true }` adds a key and each wall's name and height, in feet or metres, in English or Japanese, and the description lists them. `quirks: true` draws Tal's Hill (2000 to 2016), the Polo Grounds' and Tiger Stadium's overhangs, Pesky's Pole, the Tiger Stadium flagpole, the Polo Grounds' bullpens, Wrigley Field's ivy and basket, the distance to the backstop (43 parks) and the sides of four parks' dugouts; `quirks: { only, labels }` chooses and names them. The element reads `walls` and `quirks`. The data is `walls`, `quirks`, `labels`, `track_ft`, `backstop_ft` and `dugouts` in `scripts/parks.data.json`, each at the revision the park already cites; the angles each stretch covers are our reading of the article's words (docs/references.md), a park whose article gives no figure keeps its drawing, and without the options every park's drawing is byte for byte what it was (a test holds the hash of 90).
+- **More points of a fence, and a warning track.** Wrigley Field's two wells (9 points, not 5), Sportsman's Park's twelve markers (not 6) and Milwaukee County Stadium's nine (not 7) are read from their articles' text, each with its label in `Park.labels`; PNC Park's warning track is its published 18 feet and not the rule of thumb of 15. These four parks' drawings change; the other 90 do not.
+- **Display ranges and zoom** (`range`, `RANGES`, [docs/ranges.md](./docs/ranges.md)). A drawing cropped to a named part of any of the thirteen surfaces, as sportypy's `display_range` and hockey_rink's partial rinks do, in one option: a rink's `offensive-zone`, `defensive-zone`, `neutral-zone` and `half`; a court's `half-court` and `paint`; a football field's `red-zone`, `between-the-20s`, `end-zone`, `field-of-play`, `own-half` and `opponent-half`; a pitch's `half`, `final-third`, `defensive-third`, `middle-third` and `penalty-area`; a ballpark's `infield` and `outfield`; a net sport's `half-court`; a curling sheet's `sheet`, `half` and `house` (which `sheet.show` and `sheet.end` keep saying); at the end `{ name, end }` asks for, or a box `{ x0, x1, y0, y1 }` in the drawing's frame, in `units` or in any registered frame. The view is cut with a small margin and the orientation is kept; data and heat layers are cut to the range and sized, laid out and binned against it, with the legend inside; `axes`, `landmarks` and `direction` stand against what is shown, on the apron beyond the cut; a score's panel is moved inside the range or, for one too small to hold it, becomes the strip under the drawing, and a team's name is written only where its place is shown. The description says what is shown, in English and Japanese, and the root carries `data-range`. `<kyogijo-field>` reads `range` and `range-end`. Without `range` the drawing is byte for byte what it was, and a test holds every named range of every sport, wide and tall, with data, annotations and a score.
+- **Special games** (`host`, `placement` and `event` in the options, `@johnmorrisdotca/kyogijo/events`, [docs/special-games.md](./docs/special-games.md)). One surface set inside another, to scale: the host (a ballpark of `PARKS`, a soccer ground or pitch, a football field, or a plain deck) drawn as it is alone, and the drawing's own surface set inside it through one transform, so that its lines, its team banners, its score and its data `layers` are the inner surface's, in its own frame. `EVENTS` holds 18 games in the order they were played, each with its day, its venue, its host, where the surface stood and its sources: the NHL's Winter Classics of 2009, 2010, 2017, 2018, 2019, 2022 and 2023, the Stadium Series of 2014 at Dodger Stadium and Yankee Stadium, the Heritage Classics of 2003, 2011, 2014, 2016, 2019 and 2023, the 2011 Carrier Classic on USS Carl Vinson, and MLB's London Series of 2019 and 2023 with their published fences. Where a source gives the rink's place (Wrigley Field 2009, Fenway Park 2023) it is used and cited; where none does the place is a convention (`midfield`, `infield`, `diamond`, `deck`, worked out by `conventionPlacement`) and each game says so. `eventOptions(id)` draws a game, `eventFit(id)` says whether its surface lies inside the host or how much of it lies beyond, and a drawing of a game says so in its description, in English and Japanese. A drawing with no host is the same string as before.
+- **Renderers** ([docs/renderers.md](./docs/renderers.md)). The drawing as plain data and on other targets, from the code that writes the SVG, with no second drawing and no dependency added: `sceneOf` (`@johnmorrisdotca/kyogijo/scene`) lists every shape in paint order with its colours worked out for light or dark, its matrix, clips, gradients and patterns, and `sceneToSvg` writes it as an SVG that needs no stylesheet; `drawToCanvas(ctx, drawing, { width, theme })` (`/canvas`) paints it on a browser's, an `OffscreenCanvas`'s or a Node canvas's context with the context typed by what is called; `appendSurface(selection, drawing, x, y)` and `surfaceDomain` (`/d3`) put it in a d3 selection by the caller's linear scales; `surfaceMark` and `surfaceScales` (`/plot`) make an Observable Plot mark and its scales; `sceneToGeoJSON(drawing, { frame })` (`/geojson`) writes each shape as an RFC 7946 feature in feet or a provider's frame; `toPNG(drawing, { width })` (`/png`) draws a PNG in Node through the optional peer `@resvg/resvg-js`, loaded when called, with an error that says what to install. The SVG tree gives every drawing back byte for byte (`parseSvg`, `writeSvg`), the style was compared with Chromium's `getComputedStyle` and the canvas with the browser's own drawing of the SVG (`e2e/renderers.demo.mjs`), and the sizes of the code are held to budgets.
+- **Tennis, volleyball, badminton, pickleball and table tennis** (`sport: "tennis"`, `"volleyball"`, `"badminton"`, `"pickleball"`, `"tabletennis"`, [docs/courts.md](./docs/courts.md)). Each court to scale from its own rulebook, every figure cited in docs/sources.md: the ITF's Rules of Tennis (2026; the court, the service lines 21 feet from the net, the centre mark, the net posts 3 feet outside the doubles court, the singles sticks on request), the FIVB's Official Volleyball Rules and Official Beach Volleyball Rules (2025-2028; the centre line, the attack line 3 m from its axis, the front zones, the antennae, the free zone, the attack line's extension and the posts 1 m out for the FIVB's competitions; beach volleyball is `league: "fivb-beach"`), the BWF's Laws of Badminton (as amended 26 April 2025, with Diagram A), USA Pickleball's rulebook (2026; the non-volley zones and centerlines) and the ITTF's Laws of Table Tennis (the 2026 statutes; the table and the net). They lie wide; `orientation: "portrait"` lays them tall. `net.look` picks a named look (tennis `hard-blue`, `hard-green`, `clay`, `grass`; volleyball `wood`, `blue`, `sand`; badminton, pickleball and table tennis their own), `net.free` the free zone (`official`, `least`, `none`) and `net.sticks` the tennis singles sticks.
+- **A score for the net sports**: each team's `sets` (tennis: its games; pickleball and table tennis: each game's points), `tiebreaks` and `points` in tennis, `serving`; a board of sets and games over the net and a badge with the server's ball; the statuses `set-3`, `game-2`, `tiebreak`, `match-tiebreak`, `retired` and `walkover`; and the server, each set and the game in the description. The board's heads follow each rulebook's word: sets for tennis and volleyball, games for badminton, pickleball and table tennis.
+- The leagues `itf`, `fivb`, `fivb-beach`, `bwf`, `usap` and `ittf`, the sources for each, the frames `tennis`, `volleyball`, `badminton`, `pickleball` and `tabletennis` (the centre of the net as the origin), the zone set `net-court` (the front court and the back court on each side of the net), `TENNIS`, `VOLLEYBALL`, `BEACH_VOLLEYBALL`, `BADMINTON`, `PICKLEBALL` and `TABLE_TENNIS` in `/geometry`, `netOf` in `/leagues`, English and Japanese words for all of it, and a gallery page.
+- **Styling** ([docs/theming.md](./docs/theming.md)). `look` (the root says `data-palette`, as `data-look` is a net court's) paints a whole drawing in one of seven named palettes (`grass`, `night`, `chalkboard`, `blueprint`, `print`, `broadcast`, `high-contrast`, in `LOOKS`), light and dark, for every sport, as custom properties at no weight; a test holds every painted line of every look, mode and sport to 3:1 against what it is painted on, and the words to 4.5:1 against the apron. `featureColors` colours a part by name (`FEATURES[sport]` lists them: 12 for football, 17 for the rink, 18 for the court, 13 for the ballpark, 14 for the pitch, 15 for the sheet, 8 for each net sport). `lineWidth` (a scale or an absolute width), `lineDash` and `lineOpacity` for the painted lines. `goals` now styles a hockey net, a basketball basket and a football field's posts as it did a soccer goal, and `goalMarkup` takes a function of your own that draws the goals. `stripePattern` mows football fields and ballparks (and adds `circles` for every grass surface, and `rings` and `fan` for a ballpark). Nothing changes in a drawing that uses none of them: a snapshot of 122 drawings proves it. Ideas from sportypy (colours by named feature), ggsoccer (line widths, types and alpha, goal styles and a goal function) and mplsoccer (stripes), credited in docs/references.md; no code is used.
+- **Annotations** ([docs/annotations.md](./docs/annotations.md)). `direction` draws an arrow for the end each team attacks (by the sport's rule for the period, with `changedAfter` for a case no rule settles); `axes` draws ticks and numbers along the edges, in the drawing's own numbers or in any registered frame of the sport; `landmarks` names the parts of every surface, in English and Japanese, with a leader to each. They follow a surface turned a quarter with every word upright, make the margin as wide as they need, and are said in the description. A test holds the arrows, the words and the anchors, for every surface wide and tall and with either end attacked, and the soccer penalty arc outside its box in every provider's numbers. The `look`, `line-width`, `line-dash`, `line-opacity` and `landmarks` attributes of `<kyogijo-field>`.
+- **Curling** (`sport: "curling"`, [docs/curling.md](./docs/curling.md)). A sheet to scale from R1 of World Curling's Rules of Curling (1 September 2026) and Rule 3 of Curling Canada's Rules of Curling for General Play (2022 to 2026): a house at each end, the tee, back, hog and centre lines, the hacks and, in World Curling's, the hack and courtesy lines; tall by default, with the far house at the top. `league` is `wcf` (the default, in metres) or `curling-canada` (feet); `sheet` sets the length and the width within the rules' range, the colours of the rings, the ice's pebble, the shaded free guard zone and a part of the sheet (`half`, `house`).
+- **A curling score**: each team's `ends` and `hammer`, a board on the ice (the ends down a tall sheet, across a wide one) and a badge with the hammer, the statuses `end-6` and `extra-end`, and the ends and the hammer in the description.
+- **`curlingStones` and `curlingScore`** (`@johnmorrisdotca/kyogijo/charts`): the stones of an end on the house, judged by the rules (out of play, in the house, counting, the shot rock, a blank end), with the zone set `curling-house`, the frame `curling` (feet from the button) and the stone's size (`STONE_DIAMETER`, from 36 inches round).
+- The league `curling-canada`, the sources `wcf-rules` and `curling-canada-rules`, English and Japanese words for all of it, and a gallery page.
+- **Team shape** ([docs/team-shape.md](./docs/team-shape.md)). Seven new kinds of data layer for team analysis, each drawn on any surface in its feet or a provider's frame, cut to the surface's outline, in the layer colours of the page (light and dark), with a title, a description, a tooltip for each mark and, with `layerTable(layers, { surface })`, a table of its numbers: `network` (a pass network: a node for each player at the average place of the passes he made and received, sized by touches, a link for each pair sized and shaded by passes, `minPasses`, `directed`, labels), `formation` (a labelled mark for each position of a named formation, with a lineup's numbers and names on them), `voronoi` (space control: each player's cell in his team's colour, each team's share of the surface counted on a grid kept to the surface), `delaunay` (the triangulation of each team's players or of all), `hull` (the convex hull of each team, with its area), `flow` (the mean direction of the movements that start in each cell of a grid, as arrows of the mean length or of one length shaded by steadiness) and `sonar` (direction roses of counts or mean lengths, for all, each player, each cell of a grid or each zone of a zone set). `passNetwork(passes, options)` in the charts entry makes the network with a key, totals and two tables. `FORMATIONS` holds 21 formations in the frames of their sports (soccer 4-4-2, 4-3-3, 4-2-3-1, 4-1-4-1, 3-5-2, 3-4-3, 5-3-2, 5-4-1, 4-3-2-1 and the diamond; hockey five on five and a 1-3-1 power play; basketball five out, four out and one in, and 1-4 high; football's I formation, shotgun, 4-3 and 3-4; baseball's standard defence and an infield shift), with the names of the positions in English and Japanese (conventional: the Laws of the Game name only the goalkeeper) and `los`, `attacking`, `names` and `labels` options; a formation of your own is plain data. The geometry is written for this package with no dependency and exported from the layers entry: `convexHull` (monotone chain), `delaunay` (Bowyer and Watson with ghost triangles for the hull) and `voronoiCells`, held by tests on random points, lattices, points on one circle, collinear, repeated, one, two and no points, and points of huge, tiny and far-off scale. Budgets held by tests: a Voronoi diagram of 22 players under 12 kB, a pass network of 600 passes under 16 kB in under 100 ms, a triangulation of 1,000 points in under 600 ms, a flow field of 5,000 movements under 20 kB in under 150 ms. Ideas from mplsoccer (MIT), credited in docs/references.md; no code of it is used. The gallery has an entry for each, the comparison table a row for them, and docs/sources.md says what its formations rest on.
+- **Replay** (`@johnmorrisdotca/kyogijo/replay`, [docs/replay.md](./docs/replay.md)). Tracking data played on any surface: a timeline of frames (`{ t, objects: [{ id, team, x, y, label?, number? }] }`, in any registered frame) and events at times (pass, shot, goal, whistle). Pure functions: `interpolate` (straight, or a Catmull-Rom curve through the frames with `smooth`), `trails`, `possession` (when the data says), `activeEvents` and `drawFrame(options, timeline, t)`, a deterministic SVG string built on the data layers (the home team as circles, the away team as squares, shirt numbers, the ball with its trail, passes and shots as arrows, a goal as a star), with a description that does not change with the time. `createReplay` is the clock as a state machine with no page in it (play, pause, seek, step, speed 0.25 to 4, loop, the events that went by). `mountKyogijo(...).replay(timeline)` and `<kyogijo-field>.timeline` play it with controls under the drawing (play and pause, step back and on, speed, loop, a position slider and the time), the keyboard (space, the arrow keys, shift and the arrows, Home and End), and only the marks that move moved on `requestAnimationFrame`, never the surface. `prefers-reduced-motion` is followed: nothing plays by itself and play steps instead; a hidden page pauses; a live region says each goal, shot, pass and whistle as it passes; every control is named in English and Japanese. `update()` keeps the replay. A score that changes through `update()` now swells and settles once (a fade only, with reduced motion). The demo has a Replay section with a made-up, seeded play on the rink and on the pitch, the gallery has a frame of each, and 22 players and a ball for 60 seconds at 25 frames a second are held to a time and size budget.
+- **A docs site** at `/docs/` of the demo site, made by `pnpm site` from `docs/*.md`: 31 pages in groups, a search box over every title and heading, the pages before and after, a copy button on every block of code, light and dark, phone width, and the contents in Japanese. The README keeps the pitch, the first minute, one example per area and the family block, and is about 37,000 characters instead of 64,000; its reference sections moved to [docs/](./docs/README.md) (getting started, surfaces, score and layout, soccer, ballparks, units, coordinate frames, accessibility, limits, entry points, architecture).
+- **A gallery** in the docs site: every surface, league variant, season, park and ground sample, layer kind, heat layer and chart, each drawn by the build from the code shown beside it, with a copy button. A test runs every snippet.
+- **How it compares** ([docs/compare.md](./docs/compare.md)): a table against sportypy, sportyR, `@sportsdataverse/sporty`, hockey_rink, mplsoccer, ggsoccer, GeomMLBStadiums, gavinr's spring-training parks and thestadi.com, from each README.
+- **Coordinate frames and surface units as tables made from the code** (`pnpm docs:make`), with the same spot drawn in each of the 16 frames side by side.
+- Every `ts` example of the README and of every docs page is run, and what it prints is held to its comment lines.
+- **Ready-made charts** (`@johnmorrisdotca/kyogijo/charts`, [docs/charts.md](./docs/charts.md)). One call each makes the layers and the drawing options for a chart, so a good chart takes one line and every layer can still be changed: `nbaShotChart` (made and missed shots and the six shot zones coloured by field-goal percentage, diverging from the league's), `nhlShotMap` (goals and shots sized by expected goals, `fold` to put both ends on one, slot zones or hexagons), `mlbSprayChart` (balls in play on the park of their season, past parks included, a mark for each hit type, balls beyond the fence drawn beyond it, spray zones by the side the batter bats from, Retrosheet codes as well as Statcast's `hc_x` and `hc_y`), `nflPassChart` (destinations by outcome and air yards, the line of scrimmage, the pass grid's completion percentages) and `soccerShotMap` with `goalMouth()` / `soccerGoalMouth` (shots sized by expected goals on the pitch or its half, a view of the goal frame with where each shot crossed the goal line, xG totals). Each chart has a key, a legend, a title and description for every layer and a table; the drawings are deterministic, held by fingerprints and size budgets; its words are in English and Japanese; every example on the page is run by a test. The tables of layers and heat layers now name the unit of a frame's own numbers (tenths of a foot for the NBA's) and not the drawing's. The demo has a Charts section.
+- **Heat layers.** Five new kinds of data layer: `heatmap` (a binned statistic on a grid over the surface), `hexbin`, `zones` (named zones with aggregated values and labels), `contour` (a Gaussian kernel density, Scott's rule by default, drawn as filled bands or lines) and `legend`. Statistics are `count`, `sum`, `mean`, `median`, `max`, `min`, `percent`, `rate` (a field-goal percentage from made and missed) or a function, with `normalize`, `minCount`, a `domain`, a diverging `center` and cell or zone labels. Cells, hexagons and bands are cut to the surface's outline. Ten zone sets, each cited in docs/sources.md: soccer positional zones (juego de posición), thirds, channels and the 18 zones; the NBA's shot zones; the NHL's slot and home plate; baseball's spray zones and Retrosheet's sectors; football's pass grid. Five built-in colour ramps (`ember`, `ocean`, `mono`, `balance`, `tide`) with a light and a dark set, checked against every surface's colour; custom stops. Each layer has a title, a description that names its hottest cells or zones and, with `layerTable(layers, { surface })`, a table of its numbers. A 50 by 30 grid is held under 30 kB on every sport and 10,000 marks make a density in under 500 ms. The `/layers` entry exports the numbers (`binGrid`, `hexBins`, `densityGrid`, `contourRings` and more), `ZONE_SETS` and `buildZoneSet`. The demo's Data section shows a rink heat map, an NBA shot-zone chart with field-goal percentages, a soccer positional heat map and a density contour.
+- **Past ballparks.** `PARKS` grows by 44 past parks, and every park carries its Wikidata item (`wikidata`, `parkByWikidata`). A past park has the seasons it was used (`from`, `to`) and, where an article dates earlier fences, `periods`, chosen by the new `year` option (`parkPointsIn`).
+- **Units.** `SURFACE_UNITS` names the unit each rulebook states its figures in; `convertLength`, `lengthsIn`, `dimensionsOf`, `surfaceSize` and `fenceIn` give every dimension in feet, inches, yards, metres, centimetres or millimetres; the `units` option says what the lengths of a drawing's options (`margin`, `fence`) are in.
+- **Coordinate frames** (`@johnmorrisdotca/kyogijo/frames`). `toSurface`, `fromSurface` and `convert` put a provider's points on a surface and move them between providers, with `units`, `anchors`, `limits` and `attacking`; the frames of the NHL API, HockeyTech, NBA stats, NFL tracking data, MLBAM and Retrosheet's hit locations; `registerFrame` and `piecewise` for the frames of other sports.
+- **Soccer.** `sport: "soccer"` draws a pitch from Law 1 of the IFAB Laws of the Game at any size (`pitch`), with presets (international, UEFA, MLS, NCAA, the Laws' least and most, the FA's 9-, 7- and 5-a-side, FIFA's futsal), half pitches, six mowing patterns, four goal styles, corner flags, teams in their penalty areas and a score with extra time and penalties (`Team.penalties`, `final-aet`, `final-pens`). Ten data providers (`SOCCER_PROVIDERS`) as frames, a pitch drawn in a provider's own coordinates (`pitchType`) with an empty `ky-data` group for raw data, and `rescale` between any two, landmark to landmark.
+- **Data layers** (`layers` in the options; `drawLayers`, `layerTable` and the `@johnmorrisdotca/kyogijo/layers` entry). Points (seven shapes and team logos), lines, arrows (curved, wavy, open or filled heads, comet lines that fade along their length) and text over any surface, in the surface's feet, any unit or a provider's frame, cut to the boards, the fence or the court's lines with a clip path for each drawing, upright when the surface lies tall. Size by value, colour by value, team or outcome, filled and hollow outcomes (`OUTCOMES`), new colour properties (`--ky-layer`, `--ky-layer-home`, `--ky-layer-away`, `--ky-layer-edge`, `--ky-layer-hollow`, `--ky-layer-ink`, `--ky-layer-halo`) that follow a score drawing's teams. A title and a description for each layer, a tooltip for each mark and an HTML table of the data. 1,000 points add about 60 kB; 10,000 are drawn in about 20 ms. The demo has a Data section with a shot map, a pass map and a spray chart made from seeded, made-up data.
+- **Surfaces through the years** (`@johnmorrisdotca/kyogijo/eras`). `year` draws a surface as its league's rules marked it in a season, for the NHL, the NBA, the NFL, the CFL and baseball: the NHL's centre red line, goal lines, blue lines and trapezoid, the NBA's lane, three-point line and restricted area, the NFL's hash marks and goal posts, the CFL's end zones, hash marks and goal posts (and the field planned for 2027), the baseball pitcher's box and plate, batter's boxes and home plate. `rulesFor`, `eraChanges`, `eraStates`, `eraRange`, `seasonLabel` and `footballIn`; each change has the season it began in, a sentence in English and Japanese and its sources, and a marking no source covers is listed in `gaps` rather than guessed. The demo has a season slider.
+- **Famous soccer grounds.** `GROUNDS` (`@johnmorrisdotca/kyogijo/grounds`) has 64 grounds: the venue of every men's World Cup final from 1930 to 2022 and the 2026 final, all 16 venues of 2026, the venue of every Women's World Cup final, and well-known club grounds (both Wembleys, the Maracanã, Camp Nou, the Bernabéu, San Siro, Old Trafford, Anfield, Signal Iduna Park, the Allianz Arena, La Bombonera, Hampden Park, Celtic Park, the Estádio da Luz, the Parc des Princes, Saitama Stadium 2002, Nissan Stadium, the Seoul World Cup Stadium and more). Each has its city, country, Wikidata item and coordinates, the names it had with their years, its name in the place's language and in Japanese, its opening and closing years, capacity, the World Cups it staged, the pitch's length and width where its English Wikipedia article publishes them (42 of 64; the others are drawn at 105 by 68 m and marked `pitchSize: "default"`), and the article and revision each was read from. `drawKyogijo({ sport: "soccer", ground: "maracana", year })` draws the pitch at the ground's size under its name for the year; `groundById`, `groundByWikidata`, `groundNameIn`, `groundsHosting`, `groundSourceUrl`. `pnpm grounds` builds the data and docs/grounds.md; `pnpm grounds:check` asks Wikidata again. The demo has a ground picker.
+- **A stadium atlas** (`@johnmorrisdotca/kyogijo/atlas`). `PLACES` joins the 94 ballparks and 64 soccer grounds into one list with where each stands (`lat`, `lon`, Wikidata's P625), its country and city, its sport, leagues, whether it is in use today or of the past, and the years it was in use; `placesBy({ sport, kind, league, country, status, year, text })`, `placeById`, `atlasFacets` and `surfaceOf`. Every park now has its coordinates and the years it opened and closed (`pnpm parks:coordinates` fetches them, `pnpm parks:check` compares them with Wikidata). The demo has an Atlas: a chizu world map with a marker on every place (a circle for today, a diamond for the past), filters, a year slider, a list and the chosen place's surface beside the map; docs/atlas.md has a picture of the map, made by `pnpm site`.
+- **League variants** (`@johnmorrisdotca/kyogijo/leagues`). `league` draws a surface as one league's rulebook marks it, with `sport` naming the family: basketball (the WNBA, FIBA, NCAA men and women, NFHS, the G League), hockey (the IIHF, NCAA men and women, AHL, ECHL, OHL, WHL, QMJHL, USHL, PWHL), football (the NCAA, NFHS 11, 9, 8 and 6 players, Texas six-man, the Indoor Football League) and baseball and softball (MiLB, NCAA, NFHS, Little League and its Intermediate division, three PONY divisions, NCAA and NFHS softball, USA Softball fast and slow pitch, WBSC slow pitch). Each league has its figures in its own unit, its name in English and Japanese, its sources with edition and address (`LEAGUES`, `VARIANTS`, `LEAGUE_SOURCES`, `leagueFigures`), and the changes a source dates (`leagueChanges`, `leagueAt`): the WNBA lane (2004), the NCAA restricted-area arc, the IIHF blue line and goalkeepers' trapezoid, the AHL blue lines (2005-06) and the NCAA men's trapezoid (2026-27). Score mode, themes, orientation, badges, `year` and data layers work on every league. The demo has a league picker; docs/variants.md lists every figure and docs/references.md what could not be cited.
+
+### Changed
+
+- **Breaking: the park status `"historic"` is now `"past"`.** `Park["status"]` is `"current" | "secondary" | "past"`, as for the grounds and the atlas; the six NPB parks that read `"historic"` read `"past"` (the type and the value in `PARKS`). Code that compares `park.status === "historic"` must compare with `"past"`.
+- **Breaking: `Sport` and `SPORTS` grow from 6 to 20 sports.** The type was `"nfl" | "cfl" | "ifaf" | "nhl" | "nba" | "mlb"`; it now also has `"soccer"`, `"curling"`, the net sports (`"tennis"`, `"volleyball"`, `"badminton"`, `"pickleball"`, `"tabletennis"`) and the field sports (`"lacrosse"`, `"rugby"`, `"afl"`, `"gaelic"`, `"cricket"`, `"fieldhockey"`, `"handball"`). A TypeScript `switch` over `Sport` that is checked to be exhaustive must add a case for each, and code that loops over `SPORTS` now meets all twenty.
+- **Breaking: the NHL trapezoid is 22 feet wide at the goal line, not 18.** `NHL.trapezoid.atGoalLine` was 18 feet; Rule 1.8 has 22 feet, the figure since 2014-15, when the trapezoid was widened by 2 feet each side (18 feet from 2005-06 to 2013-14, which `rulesFor("nhl", year)` and a drawing with `year` still give). The rink is drawn with the wider trapezoid by default.
+- **Breaking: the NHL's hash marks are 5 feet 7 inches apart, not 5 feet 11 inches.** The marks beside an end-zone circle were drawn 5 feet 11 inches apart, which added the lines' width to a gap it does not enter; Rule 1.9 says 5 feet 7 inches (`NHL.hashApart`). The AHL, ECHL, OHL, WHL and PWHL, which share the NHL's Rule 1, change with it. docs/sources.md also records where the NHL's Rule 1.8 (a 22-foot trapezoid at the goal line, drawn) and Rule 27.8 (18 feet) disagree.
+- **Breaking: MLB bases are 18 inches square, not 15.** `MLB.baseSize` was 15 inches; Rule 2.03 of the Official Baseball Rules has 18 inches from the 2023 season. The size is now a marking in `rulesFor("mlb", year)` (`baseSize`, 15 inches before 2023, 18 from 2023, with `eraChanges("mlb")` listing it), so the field is drawn with 18-inch bases by default and 15-inch ones for a season before 2023.
+- **Breaking: the SVG written by `drawKyogijo` changes.** Every NHL drawing (the trapezoid and the hash marks) and every MLB drawing (the bases) differs from 0.1.0's, so a stored copy of an old drawing, or a snapshot test of one, needs to be made again. Every drawing's stylesheet is also about 2 kB larger.
+
+### Fixed
+
+- **NHL hash marks were 3 feet apart before 2014-15.** The rulebook of 2012-13 (Rule 1.9) says "three feet (3') apart", and the NHL and NHLPA release of 6 October 2014 moves them to 5 feet 7 inches for 2014-15. `rulesFor("nhl", year).rules.hashApart` is 3 feet through 2013-14 and 5 feet 7 inches after, `eraChanges("nhl")` lists both (`nhl.hashApart.2012`, `nhl.hashApart.2014`) and a rink drawn for an earlier season has the marks 3 feet apart. Seasons before 2012-13 are cited by no rulebook read, so they keep 3 feet and `gaps` names `hashApart`. The AHL, ECHL, OHL, WHL and PWHL are unchanged: no page read dates a change of their marks.
+- **docs/sources.md cited the wrong baseball rule for home plate.** Home plate is Official Baseball Rules 2.02 (Home Base) in the 2024 edition; 2.03 is The Bases. The 90-foot square is 2.01, not 2.01 and 2.02.
+
+## [0.1.0] - 2026-10-13
+
+### Added
+
+- **Six surfaces drawn to scale as SVG**: the NFL, CFL and IFAF football fields, the NHL rink, the NBA court and the baseball field, each from its rulebook or federation diagram, with every figure cited in docs/sources.md.
+- **Score mode.** `drawKyogijo`, `drawScore` and `drawBadge` put each team's name and logo on its side (the end zones, the ends of the ice, the halves of the court, the dugouts) and the score in the middle, with the competition, the status, the date and an emphasis on the winner. Sizes `full`, `compact` and `badge`.
+- **Wide, tall or fit the box.** `orientation: "landscape" | "portrait" | "auto"`: portrait turns the surface a quarter with every word upright and the teams top and bottom; `auto` follows `aspect`, and `mountKyogijo` watches the container and draws again when its shape changes.
+- **Every ballpark.** `PARKS` has the 30 MLB parks, the 12 NPB home parks and eight other NPB grounds, each fence drawn from the distances published for it, with the article and revision each was read from. `park` and `fence` options; names in English and Japanese.
+- **Theming.** Every colour is a custom property in a light and a dark set, `colors` sets them from code, and a court has its own look (`court`) with five to start from in `COURT_THEMES`.
+- **Four ways in.** The function, `mountKyogijo` for a container, the `<kyogijo-field>` custom element with parts, and a frame (`embed.html`) for a page that runs no script; `@johnmorrisdotca/kyogijo/react` for React, which does not import it.
+- **Accessible.** Each drawing is an `img` with a title and a description in English or Japanese.
+- **The demo** with every sport and every park, wide and tall, light and dark, badges, compact cards, court looks, a live score, snippets for the four ways in, and the API reference.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 John Morris
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.