@johnmorrisdotca/kyogijo-stadiums 0.50.0 → 0.52.0

package/CHANGELOG.md

@@ -7,6 +7,28 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.52.0] - 2026-11-03
+
+### Added
+
+- **A replay plays on the 3D view (KYOGIJO-STADIUMS-23)** ([the replay in 3D](./docs/replay.md#in-3d)): `view.replay(timeline, settings?)` on the handle of `mountKyogijoTurn` gives the same controller as `mount.replay`, and the rink can be turned, tipped and zoomed while the game plays. The players and officials stand up as discs that face the eye (the flat replay's circles, squares, triangles and numbers, turned up), and the ball or the puck, its trail, the passes, the shots and the goals stay on the floor. `stand: false` keeps the players flat. On the view, Space plays and pauses, comma and full stop step, and the arrow keys still turn it; on the replay's controls the arrows step. Nothing runs while it is paused, hidden or out of sight, the auto-turn and the replay share one animation frame, only what moves is written, and destroy leaves nothing; browser tests hold each of these. `replayTurnModel` is the pure model of a frame, and `<kyogijo-field turn>` with a `timeline` plays it on its 3D view.
+- **An example game (KYOGIJO-STADIUMS-25)** ([example games](./docs/example-games.md)): `examples/games/canada-japan.json`, a whole made-up game of Canada and Japan, three periods, shaped from a public NHL play-by-play with every team, player, place, time and the result changed. It is in the repository and on the demo's site, not in the npm package.
+- The demo: a section, "A game on the ice, in 3D", plays the example game in 3D or flat, with a button for each period, the score on the board as it goes, and the code with a Copy button; the arena at the top of the page has **Play a game**, which loads the game when it is first pressed and plays it on the arena's ice in front of its crowd.
+
+### Changed
+
+- The flat replay's page side is a painter and a driver that the 3D replay shares (`replay.dom.ts`); the flat replay behaves as before.
+
+## [0.51.0] - 2026-11-03
+
+### Added
+
+- **The catalogue: every venue the package draws, the ones being built and the ones wanted, in one list (KYOGIJO-STADIUMS-26)** ([the catalogue](./docs/catalogue.md)). Each venue has a kebab-case id (the package's own key where it has one), its names in English and Japanese, its city and country, its sports, its Wikidata item and its status. **Supported** (332): every real venue the package draws, made from its own data, 43 in their buildings (the real stadiums and the NHL's venues), 288 as a field, court, rink, park or floor only, and the Las Vegas Strip Circuit as a circuit (`CIRCUITS`'s id and names, `drawn: "circuit"`). **Working on** (10): the tennis show courts of KYOGIJO-STADIUMS-22. **Wanted** (132 new venues, and 69 venues drawn as a field whose building is wanted): every venue of the NBA, MLB, NFL, CFL and NHL this season is listed with its true status and its clubs (a shared stadium once, with both), then world soccer, cricket, rugby, Gaelic and Australian football, Japan's sumo and budō halls, Olympic stadiums and athletics, college football, baseball around the world, ovals and pools, great indoor halls, the circuits of Formula One's 2026 calendar and more great circuits (each waits for its track's data).
+- **The catalogue as an API: a JSON file and a typed entry.** `catalogue.json` is in the package (`@johnmorrisdotca/kyogijo-stadiums/catalogue.json`) and published with the demo at <https://johnmorrisdotca.github.io/kyogijo-stadiums/catalogue.json>, with a `schemaVersion`, the day its sources were read and the licence of its facts. `@johnmorrisdotca/kyogijo-stadiums/catalogue` exports the same data (`CATALOGUE`, `CATALOGUE_GROUPS`, `CATALOGUE_SPORTS`, `CATALOGUE_COUNTRIES`) with `catalogueById`, `catalogueByStatus`, `catalogueBySport`, `catalogueByGroup`, `catalogueWanted`, `catalogueCoverage` and the types; it draws nothing and imports none of the drawing.
+- **Every fact of a new venue is Wikidata's or a named Wikipedia revision's.** `pnpm catalogue:fetch` keeps the raw answers, dated, in `data-sources/catalogue/` (one request at a time, batches of 50, a User-Agent that names the package): the items, labels, coordinates, countries, capacities and places; the NFL's and the CFL's venues checked against the tables of the leagues' lists, and the circuits against the 2026 calendars of Formula One and MotoGP. `pnpm catalogue` makes `src/catalogue.data.ts`, `catalogue.json` and the docs' tables from them; a fact the sources do not give is left out, and `missing` says why. Every new Japanese name was checked by a reviewer.
+- **The demo's catalogue page** (`catalogue.html`, linked from the home page): the leagues' coverage ("NFL: 2 of 30 drawn in its building"), tabs for Supported, Working on and Wanted, sport and group chips, a search, a world map with a pin on each venue shown, and cards a page at a time with each venue's flag, status, clubs and a link to its drawing. In English and Japanese, light and dark, at a phone's width.
+- Tests: `src/catalogue.test.js` (every supported id is the package's own, every id and item once, every item in the raw answers, the coordinates and capacities the items', the names in both languages or their absence said, the JSON and the entry the same, every league's season complete, the docs' tables made from the data) and `e2e/catalogue.demo.mjs`.
+
 ## [0.50.0] - 2026-11-03
 
 ### Added

package/NOTICE.md

@@ -482,6 +482,17 @@ BC Place, Lumen Field, T-Mobile Park, Tokyo Dome, Korakuen Hall and Koshien Stad
 | Olympic Stadium | Q285467 | way/108505523 | Olympic Stadium (Montreal), 1382141337 |
 | Barclays Center | Q807966 | relation/8610205 | Barclays Center, 1380399342 |
 
+## The catalogue's sources
+
+The catalogue (`catalogue.json`, `src/catalogue.data.ts`, `docs/catalogue.md`) was read on 2026-11-03 (`pnpm catalogue:fetch`; the files are in `data-sources/catalogue/2026-11-03/`). Its venues' items, names in English and Japanese, coordinates, countries, capacities and places are Wikidata's (CC0). Which venues the NFL and the CFL play in this season, and which circuits the 2026 calendars of Formula One and MotoGP race at, were checked against the tables of these English Wikipedia articles (CC BY-SA 4.0), whose linked titles are kept as evidence and whose text is not copied; each new venue's English name is the title of its English article.
+
+| English article | Revision |
+| --- | --- |
+| List of current National Football League stadiums | 1382562348 |
+| List of Canadian Football League stadiums | 1383444131 |
+| 2026 Formula One World Championship | 1383447981 |
+| 2026 MotoGP World Championship | 1383460791 |
+
 ## The context's and the gates' sources
 
 Downtown Vancouver's buildings and streets (`VANCOUVER_CENTRE`, `src/osm.context.data.ts`) are OpenStreetMap's, ODbL 1.0, (c) OpenStreetMap contributors, made by `pnpm osm-context` from the same raw answer as the walkable mask (`data-sources/walk/2026-10-22/osm-vancouver.json`): each building's outline simplified to 60 centimetres with the height OpenStreetMap maps (else its levels at 3.2 metres, else 10 metres, which is ours) and each street as a line with a width; no name, id or tag is copied. It is kept in its own file, apart from every CC0 and CC BY-SA file and from the PLATEAU data of Tokyo.

package/README.md

@@ -36,7 +36,7 @@ Kyogijo Stadiums draws the places a game is played on, with the score of the gam
 
 ## The showcase
 
-Real buildings drawn in the outline OpenStreetMap maps for them, each with a plausible bowl of the seats, tiers and roof its sources give. In the first three rows the picture in the middle turns, slowly, and the others stand still; the last row is still.
+Real buildings drawn in the outline OpenStreetMap maps for them, each with a plausible bowl of the seats, tiers and roof its sources give. In the rows of arenas, of halls and of districts the picture in the middle turns, slowly, and the others stand still; the other rows are still.
 
 **Arenas and stadiums** ([real arenas](./docs/venues.md), [real stadiums](./docs/stadiums.md))
 
@@ -143,6 +143,34 @@ Real buildings drawn in the outline OpenStreetMap maps for them, each with a pla
 </tr>
 </table>
 
+**A game on the ice** ([the replay in 3D](./docs/replay.md#in-3d), [the example game](./docs/example-games.md))
+
+<table align="center">
+<tr>
+<td align="center" valign="top">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/replay-game-3d-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/replay-game-3d-desk-light.webp" alt="A made-up game of Canada and Japan replayed on the rink in 3D from the main camera: the players standing up as discs with their numbers, red circles and blue squares, the score hung over centre ice, and a shot's arrow and a whistle's cross on the ice." width="250">
+</picture>
+<br><em>A made-up game, replayed in 3D</em>
+</td>
+<td align="center" valign="top">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-game-3d-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-game-3d-desk-light.webp" alt="The same game on the ice of a real arena, in front of its crowd: the players standing as discs on the rink inside two tiers of seats." width="250">
+</picture>
+<br><em>The same game in an arena, in front of the crowd</em>
+</td>
+<td align="center" valign="top">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/replay-game-flat-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/replay-game-flat-desk-light.webp" alt="The same moment of the game flat: each side's flag and name at the end it defends, the score panel at centre ice, the players as circles and squares with their numbers, a goal's star at the net." width="250">
+</picture>
+<br><em>The same moment, flat</em>
+</td>
+</tr>
+</table>
+
 **Surfaces** ([the surfaces](./docs/surfaces.md), [score and layout](./docs/score.md))
 
 <table align="center">
@@ -212,11 +240,12 @@ console.log(svg.startsWith("<svg"), svg.includes("USA 3, Canada 2"));
 - **Forty-three surfaces, to scale**, each from its rulebook or its published distances, and each league's variants (48 of them): football fields, the NHL rink, the NBA court, soccer, baseball, curling, twelve net and racket sports, pools, athletics, skating, field sports, the budō, the MMA cage, rings and mats. [The surfaces](./docs/surfaces.md), [sources](./docs/sources.md).
 - **The score on the surface**: each team's name and logo on its side, the score in the middle, wide or tall, a compact badge for a list, the situation of a game. [Score and layout](./docs/score.md), [the situation](./docs/situation.md).
 - **Every ballpark and ground**: The 30 current MLB parks and 44 that MLB clubs have left, and the 12 home parks of Nippon Professional Baseball with eight other NPB grounds, each with its fence drawn from the distances published for it; 64 soccer grounds at their published sizes; 167 arenas. [Ballparks](./docs/ballparks.md), [grounds](./docs/grounds.md), [arenas](./docs/arenas.md).
+- **A catalogue of venues**: every venue drawn today, the ones being built and the ones wanted (every NBA, MLB, NFL, CFL and NHL venue of the season, world soccer, cricket, rugby, the Olympics, Formula One and more), with ids, names in English and Japanese and Wikidata items, as a [JSON file](https://johnmorrisdotca.github.io/kyogijo-stadiums/catalogue.json) and a typed entry. [The catalogue](./docs/catalogue.md).
 - **Real venues**: arenas and stadiums in the outline of their buildings, districts of several venues on one plan, the crowd in the stands and outside. [Ballparks](./docs/ballparks.md), [venues](./docs/venues.md), [districts](./docs/district.md).
 - **A 3D view** of any surface or venue that turns by mouse, touch or keys, with the roof and the walls to switch and a quality level for every device. [The 3D view](./docs/turn.md), [quality](./docs/quality.md).
 - **Circuits**: a famous race track as OpenStreetMap maps it, the Las Vegas Strip Circuit first, with its turns numbered and its pit building standing in 3D. [Circuits](./docs/circuits.md).
 - **Tournaments**: several surfaces on one floor, who judges where, boards laid over a surface. [Layouts](./docs/multi.md), [judging](./docs/judging.md), [boards](./docs/boards.md).
-- **Data on a surface**: points, heat maps, shot and pass charts, team shapes and a replay, in 48 providers' coordinate frames. [Layers](./docs/layers.md), [frames](./docs/frames.md), [replay](./docs/replay.md).
+- **Data on a surface**: points, heat maps, shot and pass charts, team shapes and a replay, flat or in 3D with the players standing on the ice, in 48 providers' coordinate frames. [Layers](./docs/layers.md), [frames](./docs/frames.md), [replay](./docs/replay.md), [an example game](./docs/example-games.md).
 - **Looks and flags**: eight named looks, a flag or crest on each half, trophies and crests from Dougu Sports, flags from Hata, light and dark. [Theming](./docs/theming.md), [the pageant](./docs/pageant.md).
 - **Four ways in**: a function that returns SVG text, a helper that draws into a container, a custom element, a frame for pages with no script; renderers for a canvas, d3, Observable Plot, GeoJSON and PNG. [Entry points](./docs/entry-points.md), [renderers](./docs/renderers.md).
 - **Accessible and small**: each drawing is an `img` with a title and a description, in English or Japanese; no dependencies, no network requests, nothing stored.