@johnmorrisdotca/kyogijo-stadiums 0.47.0 → 0.48.1

package/CHANGELOG.md

@@ -7,6 +7,45 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.48.1] - 2026-10-30
+
+### Changed
+
+- **The docs site is regrouped by task and by sport (SPX-297).** The contents has two views, *By task* (start, sports, venues and 3D, data on a surface, gallery, reference) and *By sport* (a guide and the pictures of each of thirteen sports, and the places), its groups open and shut, one page template with a short header, a 48 px search, contents and Copy buttons, in light and dark, phone first. The home page leads with a live picture for each sport and a still for each place (New York, Montreal, the Saddledome, the roof switch, the quality levels, Vancouver, Seattle, Tokyo and the Kodokan, tournament halls, judging) with the page of the demo that shows it, and the six tasks. The gallery's index has a group of live tiles for each sport and for the real venues (each with a Copy button for its code), a filter by name and a button for each group.
+- **The gallery's pages are light.** A picture is drawn from its own file when it comes within a screen or two of the reader, a few at a time, in the page's own stylesheet (so it follows light and dark with the device); the drawings' stylesheet is one cached file, `docs/drawings.css`, and not 197 KB in every page. The pages fall from 0.4 to 1.2 MB to 0.1 to 0.3 MB, and the code is beside each picture, not behind a button. Without script a picture is the image of its file.
+- **The README is a front door** (38 KB, from 64 KB): the hero, a showcase in rows (the picture in the middle of each of the first three turns, slowly; the others stand still), the first examples, and links. The rest of its examples are the new page `docs/examples.md` ("Recipes"), run by `pnpm test:readme` like the rest. The README's moving pictures show each frame twice as long (200 ms; the fly-through 520 ms), by changing only the frames' durations (`retimed` in `scripts/webp-animated.mjs`), so the files keep their size.
+- Twelve pictures that only the docs use moved from `docs/images` (the README's) to `docs/pictures`.
+
+### Fixed
+
+- **The pictures in the docs pages were not pictures on the site.** A page's image pointed at its file's page on GitHub, not at the file, so the docs site showed none of the screenshots of the 3D views. They are served from the site now, with a dark twin for the dark theme and their size in the tag, so a page does not move as they load.
+
+### Added
+
+- `docs/pictures/quality-{high,medium,low}-3d-desk-{light,dark}.webp`: Seattle's three venues held at each quality tier.
+- Tests: every address of the docs site before the regrouping is still a page; the home page and the gallery's index name only pages, headings and pictures that exist, draw their tiles when they come near, and filter; every control of the docs is 48 px; a picture of a page loads, light and dark; the contents' two views.
+
+### Cost
+
+- The package is unchanged (no change to `src/` but its version): `dist/` and the bundle and device budgets are as in 0.48.0. The docs site is bigger by its stills (8 MB of pictures served beside the pages, loaded when near) and smaller in its pages.
+- Japanese: the contents, the search and the buttons of the docs site have new words, checked by a reviewer; the pages' own words stay in English.
+
+## [0.48.0] - 2026-10-30
+
+### Added
+
+- **The Scotiabank Saddledome is its own drawing (SPX-646).** A round building under one roof that is a reverse hyperbolic paraboloid (`src/venue.saddle.ts`): the roof is a net of quads on the surface `z = z0 + k (a² − b²)` over the round plan (`saddleHeight`; 8, 10 or 16 cells to a side at `low`, `auto` and `high` detail, the plan mapped on a square grid so every cell is a fair quad), a beam 5 feet deep round its edge that overhangs the wall, leaning walls in `4 × cells` facets with a pier at every second one, the lines of the cladding and a few windows, and at each of the two high points a round stair tower and a square one. Every quad is shaded by its own normal, cut away from above and from the eye's side, and whole from the street, with the roof and the walls on or off. The roof's line runs 60 degrees from north (east-northeast to west-southwest), its low rim stands 78 feet over the ice and its high points 138, read from three photographs of the building taken from known places and from the outline's one bulge (`roof.saddle` in `scripts/venues.data.json`, with what each was read from; the photographs are looked at as evidence and not copied). The bowl is round (`bowl.round`) and its tiers rise 20 and 30 feet (`bowl.rises`) so that the low rim clears the top row (`SADDLE_CLEARANCE`, 8 feet). Side-by-side sheets against the photographs are in the release notes' hand-off, and the page [docs/venues.md](./docs/venues.md#the-scotiabank-saddledome) says what the drawing leaves out.
+- **How each rink's direction is known, looked at again for all thirty-two (SPX-645).** `pnpm venues:rink <date>` reads every sports, indoor and building-part feature OpenStreetMap maps within 260 metres of each arena (`data-sources/venues/2026-10-30/`), `pnpm venues` tests them against the first read (an ice inside a building that the venue does not hold is a failure) and writes the table of docs/venues.md with what the English Wikipedia articles and the Commons categories gave (`scripts/venues.rink.json`). Nothing new was found: only TD Garden, Xfinity Mobile Arena and PPG Paints Arena have their ice mapped (TD Garden's parquet floor mapped inside lies along it), the Bridgestone Arena's article says its floor has a north end (a point of the compass, not a heading), and the other arenas stay inferred or not known.
+- `RealVenueData.bowl`, `RealVenueData.roof.saddle`, `RealShell.saddle`, `Saddle`, `saddleHeight`, `saddleRoof`, `saddleWalls`, `saddleTowers`, `quadPlane`, `SADDLE_CELLS`, `EAVE`, `TOWERS`, `SADDLE_CLEARANCE`; the demo's venues page lists a saddle roof's measure under the roof.
+
+### Changed
+
+- The saddle roof of the Saddledome is no longer a band of flat pieces over a straight wall that rose 30 feet at the two ends of the rink: `SADDLE_RISE` and `saddleAt` are gone.
+
+### Cost
+
+- The package's script grows by 17.7 KB (5.7 KB gzipped) on the venues page and the district pages (the saddle builder 14.5 KB, 4.8 KB gzipped, the shell's hook and the data), and its data by 1.3 KB (0.5 KB gzipped); style by 1.1 KB. The venues page is 3,065 KB against a budget of 3,165, the districts 2,428 against 2,500. No dependency is added. The Saddledome in 3D with its roof and walls is 718 planes at `high` (against 546; 133 KB of drawing against 71), 413 at `auto` (322; 74 KB against 46) and 295 at `low` (187; 48 KB against 31), the other thirty-one venues as they were; every page stays inside its byte budget.
+
 ## [0.47.0] - 2026-10-30
 
 ### Added

package/NOTICE.md

@@ -423,6 +423,8 @@ The Japanese Wikipedia articles read for the names, with their revisions, are li
 
 The thirty-two arenas of the NHL, read on 2026-10-20 (`pnpm venues:fetch <date> <division>`; the files are in `data-sources/venues/2026-10-20/`: `osm-<arena>.json` as Overpass returned them, and `wikidata-<division>.json` and `wikipedia-<division>.json`). The outline of a building is OpenStreetMap's, ODbL 1.0, (c) OpenStreetMap contributors, and lives in `src/venues.osm.data.ts` alone. The seats, the tiers and the roof are in `src/venues.data.ts`, with what each cites. No seat map of a team, a ticket seller or a venue is read or copied, and no mark of a team or a league is drawn.
 
+How each rink lies was looked at again on 2026-10-30 (`pnpm venues:rink 2026-10-30`; `data-sources/venues/2026-10-30/osm-evidence-<arena>.json`, as Overpass returned them: ODbL 1.0, (c) OpenStreetMap contributors, and used only to test whether an ice or a court is mapped inside a building; nothing of them is in a drawing). The English Wikipedia articles and the file descriptions of Wikimedia Commons were read for a stated direction, and nothing was copied from them. The Scotiabank Saddledome's roof lies as three photographs on Wikimedia Commons show it, taken from known places, each CC BY-SA 4.0 and looked at as evidence only (never copied, kept or shown by the package): "Scotiabank Saddledome, southeast view 20240819 1" and "Scotiabank Saddledome, southwest view 20240819 1" (by DXR) and "Scotiabank Saddledome from Calgary Tower, Calgary, Alberta, 2025-07-14" (by Chris Woodrich), as their file pages credit them. What each gave is a bearing and a height, in numbers of our own (`roof.saddle` in `scripts/venues.data.json`).
+
 <!-- venues-notice -->
 | Arena | Wikidata item | OpenStreetMap element | English article and revision |
 | --- | --- | --- | --- |