@johnmorrisdotca/kyogijo-stadiums 0.43.0 → 0.44.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.44.0] - 2026-10-22
+
+### Added
+
+- **Seattle among its streets, buildings, water and trees, and Vancouver's water, green and trees** ([the district page](./docs/district.md#among-its-streets-buildings-water-and-trees-vancouver-and-seattle)): `context: contextFor(venues)` (new entry `@johnmorrisdotca/kyogijo-stadiums/cityctx`) puts a district in its city. Four areas in the format of downtown Vancouver's: Seattle's SoDo (Lumen Field and T-Mobile Park), Seattle Center (Climate Pledge Arena), the city view of all three, and `VANCOUVER_NATURE` beside `VANCOUVER_CENTRE`. The `streets` layer is the one `pnpm osm-context` makes (carriageways, viaducts, railways, sidewalks and paths with a width); new are `landCover` (water, green and wood, from the grid VoxCity, run locally with no account, makes from OpenStreetMap) and `trees` (the Cities' inventories and OpenStreetMap's tree nodes), and Seattle's buildings carry the City's measured heights (Building Outlines 2015 with USGS 3DEP ground levels). The water, green and trees lie flat on the floor under the streets and add no plane to the 3D view; the 130 biggest buildings stand as blocks. Each area is 12 to 150 KB of data (a third of that gzipped); a district that does not ask carries none. Every layer is credited in English and in Japanese, once, in the description. The raw answers are kept, dated, in `data-sources/cityctx/2026-10-22/`.
+- **The district page** has a Seattle Center preset beside Rogers Arena alone, surroundings on for the Seattle venues too, and the choice is "Surroundings: buildings, streets, water and trees" (it was "Surrounding buildings and streets"); `context=0` turns them off.
+- `pnpm cityctx:fetch`, `pnpm cityctx:vox` and `pnpm cityctx` make the data; the City of Seattle's 3D Buildings, VoxCity and Sat3DGen are in [the references](./docs/references.md) with what each may be used for.
+- **A floor chooser for the Kodokan's building** ([the district page](./docs/district.md#the-floors-of-the-building)): `floor: 0 to 8` (0 is the basement) shows one floor of the building: its plate picked out at its level, in 3D and on the plan, inside the see-through walls, with the floor's name over it; what is drawn on the other floors is left out. The floors are those of the Kodokan's own floor guide, which lists them from the 8th floor to the basement: the 8th the spectators' gallery (the great dojo's gallery, drawn), the 7th the great dojo, the 6th the school dojo (240 jō) and the international dojo (192 jō), the 5th the women's dojo (240 jō), the boys' dojo (114 jō) and a special dojo (no count given: drawn at 40 jō, ours), the 4th to the 2nd plain plates with what the guide lists, the 1st English Wikipedia's (the guide lists nothing), the basement under the ground. No plan of any floor is published: the rooms are the dojo builder's shape for their counts, laid out in rows and put where they stand farthest from the building's walls (ours, and said). The new `KODOKAN_FLOORS` has every floor's words in English and Japanese, `DistrictMember.parts` lets a venue be several surfaces (the rooms of a floor) and `DistrictMember.plate` the floor's plate. The demo's district page has a Kodokan floor choice (kept in the address as `floor=6`, `floor=b1`) and a table of the floors with the chosen one marked; a picture of the 6th floor in the docs.
+- **Every floor of the Kodokan is a slab with an edge**: the great dojo's floor and every storey of the building have a top and sides shaded by the way they face, 0.6 metres thick (ours: a floor and its beams) and never thinner than ten pixels at the page's own size or thicker than half a storey, so that from the side a floor is no longer a sheet a pixel thick. The other storeys are faint slabs, the one chosen picked out. The walls on the eye's side of the room are cleared at every turn and tilt, checked in steps of fifteen degrees at seven tilts and at yaw -121.5, pitch 84, zoom 0.83, and a picture from the side is in the docs.
+- A plate that other planes stand on is drawn under them (`Plane.under`), and a see-through wall of a tall building is placed by its foot when it is behind what stands in it and by its top when it is in front, so that a far wall is never painted over the rooms and a near one never under them.
+
+### Changed
+
+- A `ContextPlan` has `land` and `trees` beside `streets`, and `contextFloor` draws water, green and wood, the streets, the trees as dots and then the buildings; a layer whose credit is empty adds none to the description.
+- **The demo's browser tests run in Playwright's own image and in six jobs** (`demo (chromium-phone 1/1)`, `demo (chromium-desk 1/1)` and `demo (webkit-phone 1/4)` to `4/4`): installing the browsers with their system packages had taken 55 minutes of a 70-minute run, and WebKit, three times slower than Chromium, was a whole shard of its own. A whole run is about 16 minutes. `src/ci.test.js` holds the image's tag to the Playwright version of the lockfile. A desk's gallery is allowed 860 pixels instead of 820, which the Linux of the image sets 8 pixels over.
+
 ## [0.43.0] - 2026-10-22
 
 ### Fixed

package/NOTICE.md

@@ -49,7 +49,12 @@ picture or code of the sources is copied; each source is named here so that the
 | `stadiums`: each stadium's seats for each configuration, number of seating bowls, kind of roof and the size of its opening (`STADIUM_DATA`, `src/stadiums.data.ts`) | The item of Wikidata (the capacity P1083, the coordinates P625 and the labels in English and Japanese that name a hall) and the English Wikipedia article of each stadium, at the revision cited below, and the Japanese article of the three stadiums of Japan, at the revision cited in [NOTICE.ja.md](./NOTICE.ja.md#実在のスタジアム), in `data-sources/stadiums/2026-10-20/` as read; the facts are numbers and words of our own, with what was read in a few words (and, for a fact leaning on a sentence, the phrase the archive must hold) | Wikidata's data is CC0; the facts read from the articles are facts, with the articles credited here (CC BY-SA 4.0) |
 | `walk`: the ground a crowd outside a district's venues may stand on and what stops it (`WALK_DATA`, `src/walk.data.ts`): paths and sidewalks, plazas, squares, parks and platforms, and carriageways, cycle tracks, railways, water and buildings, as lines with a width and as rings | OpenStreetMap, through the Overpass API: every way and relation of the highways, buildings, railways, water, squares, parks and platforms within 350 metres of the district's venues, read on 2026-10-22, with the raw answer kept in `data-sources/walk/2026-10-22/`; laid flat in metres, simplified to 30 centimetres and written in quarter-metres, by the rules of `scripts/walk-rules.mjs` (no name, id or tag is copied) | ODbL 1.0, (c) OpenStreetMap contributors (https://www.openstreetmap.org/copyright): a derived database, kept in its own file and offered under the ODbL; a crowd or a drawing made from it is a produced work and carries the credit (`VENUE_ATTRIBUTION`) |
 | `plateau`: the buildings round Tokyo Dome City (`TOKYO_DOME_CITY`, `src/plateau.data.ts`): each building's roof-edge outline simplified to 0.6 metres on a half-metre grid, its height and, for a pitched LOD2 roof, the rise of the roof | Project PLATEAU, the Ministry of Land, Infrastructure, Transport and Tourism's (MLIT) 3D city model of Bunkyo ward, 2025 edition (product specification 5.0, CityGML, https://www.geospatial.jp/ckan/dataset/plateau-13105-bunkyo-ku-2025), read on 2026-10-22: the buildings within 500 metres of the middle of the district, with the raw fields kept in `data-sources/plateau/2026-10-22/` (`pnpm plateau:fetch`, `pnpm plateau`) | PLATEAU Site Policy (https://www.mlit.go.jp/plateau/site-policy/), clause 3: free use, commercial use included, compatible with CC BY 4.0 and the Public Data License 1.0; the source is credited and the data says it was edited and not made by MLIT (`PLATEAU_ATTRIBUTION`: "Project PLATEAU, Ministry of Land, Infrastructure, Transport and Tourism (MLIT), https://www.mlit.go.jp/plateau/ (3D city model of Bunkyo ward, 2025 edition), simplified and edited by Kyogijo Stadiums; not made by MLIT"); the copyright of a ward's data belongs to its local government. Kept in its own file, apart from the OpenStreetMap data (ODbL) and the CC0 files |
+| `cityctx`: the surroundings of the venues of Seattle (`SEATTLE_SODO`, `SEATTLE_CENTER`, `SEATTLE_CITY`) and the land cover and trees round Vancouver's (`VANCOUVER_NATURE`), in `src/cityctx.data.ts`: buildings (outline, height, for a pitched roof its rise), streets, railways, sidewalks and paths as lines with a width, water, green and wood outlines, and single trees | OpenStreetMap, through the Overpass API: the buildings (with their `height` and `building:levels`), the highways and railways, the tree nodes and rows within the radius of each area, read on 2026-10-22, the raw answers kept in `data-sources/cityctx/2026-10-22/` (`pnpm cityctx:fetch`, `pnpm cityctx:vox`, `pnpm cityctx`); laid flat in metres, simplified and put on a grid of half a metre (two metres for Seattle's city view) | OpenStreetMap's data is ODbL 1.0 (https://opendatacommons.org/licenses/odbl/1-0/), credited "(c) OpenStreetMap contributors, ODbL 1.0, openstreetmap.org/copyright"; the file is a derived database kept in its own file, apart from the CC0 files and from PLATEAU's data |
+| `cityctx`: Vancouver's trees | The City of Vancouver's open data, "Public trees" (place and diameter), read through the portal's API on 2026-10-22 and kept in `data-sources/cityctx/2026-10-22/` | The Open Government Licence - Vancouver (https://opendata.vancouver.ca/pages/licence/): free to use, with the City credited, in each layer, in English and in Japanese |
+| `cityctx`: the heights of Seattle's buildings and its trees | The City of Seattle's open data: "Building Outlines 2015" (the roof outlines the City's 3D building shells are made from; the roof apex elevation in feet, from which the height above the ground is worked out), "Combined Tree Point" (street and park trees: place and diameter), and the ground under each building from the USGS 3D Elevation Program (the National Map's `3DEPElevation` image service), read on 2026-10-22 and kept in `data-sources/cityctx/2026-10-22/` | The City of Seattle's Open Data Policy (V1.0, 1 February 2016: a dataset on its portal is made available without registration, licence requirement or restriction on its use, and a third party that publishes it identifies its source and version and what it changed); the City makes no warranty of the data's accuracy, and says so in each dataset (the credit says it too); the 3D shells' own item gives only that disclaimer, and the outlines are what its shells are made from; the USGS 3DEP elevation is a US Government work in the public domain, credited |
+| `cityctx`: the land cover (water, green, wood) of Vancouver and Seattle | The grid of land cover that VoxCity (https://github.com/kunifujiwara/VoxCity, version 1.7.0, run locally, with no Earth Engine or other account) makes from OpenStreetMap with `get_land_cover_grid(source="OpenStreetMap")`, kept as it was made in `data-sources/cityctx/2026-10-22/voxcity-*.json` and vectorized by `scripts/cityctx_vox.py` | VoxCity's code is MIT (not copied or shipped: only run at build time); the land cover is OpenStreetMap's data and so ODbL 1.0, credited "Land cover made with VoxCity (MIT) from OpenStreetMap" |
 | `district`: the Kodokan (`KODOKAN`, `src/kodokan.ts`, `src/kodokan.data.ts`): its building's outline (simplified to 0.3 metres), height (43.1 metres) and storeys (8), and where the main dojo's room lies in it | The building is Project PLATEAU's, as the `plateau` row above (the same credit, `PLATEAU_ATTRIBUTION`; the building's id in the file is in `src/kodokan.data.ts`); OpenStreetMap's way 170598646 (8 levels) was read on 2026-10-22 as a check that it is the same building, and nothing of it is copied. The main dojo is on the 7th floor with 420 mats, four contests at once, a gallery of about 900 on the 8th, in a building of eight floors and a basement: the Kodokan's own page (facilities), English Wikipedia (the article as last edited on 2026-04-20) and the IJF's article "Kodokan: an institution, a legendary place and a training venue", read on 2026-10-22; facts, no text copied | PLATEAU's terms as above for the building; facts for the rest. The shape of the floor, the room's place in the building, the wood (none) and the height of the 7th floor are ours, and the pages say so |
+| `district`: the Kodokan (`KODOKAN`, `src/kodokan.ts`, `src/kodokan.data.ts`): its building's outline (simplified to 0.3 metres), height (43.1 metres) and storeys (8), and where the main dojo's room lies in it | The building is Project PLATEAU's, as the `plateau` row above (the same credit, `PLATEAU_ATTRIBUTION`; the building's id in the file is in `src/kodokan.data.ts`); OpenStreetMap's way 170598646 (8 levels) was read on 2026-10-22 as a check that it is the same building, and nothing of it is copied. The main dojo is on the 7th floor with 420 mats, four contests at once, a gallery of about 900 on the 8th, in a building of eight floors and a basement: the Kodokan's own floor guide (the facilities page: the rooms of each floor from the 8th to the basement, with the count of jō of each dojo where it gives one), English Wikipedia (the article as last edited on 2026-04-20) and the IJF's article "Kodokan: an institution, a legendary place and a training venue", read on 2026-10-22; facts, no text copied | PLATEAU's terms as above for the building; facts for the rest. The shape of the floor, the room's place in the building, the wood (none) and the height of the 7th floor are ours, and the pages say so |
 | `atlas`: the clubs that played in each park, ground and arena (`tenants`: the club, its Wikidata item, its league, the years) | The occupants (P466) and home venues (P115) Wikidata lists for each place, with the start (P580) and end (P582) times of each statement, and the clubs' labels in English and Japanese, sports (P641) and leagues (P118), read with the Wikidata API and query service by `scripts/fetch-tenants.mjs` into `scripts/tenants.wikidata.json`; and the `tenants` line of the infobox of each place's English Wikipedia article, at the revision that `source.wikipedia` names for each club (155 articles, read on 2026-10-13) | Facts. Wikidata's data is CC0 (https://creativecommons.org/publicdomain/zero/1.0/), and the articles are CC BY-SA 4.0 as above; the names of clubs and the years are facts, no text, table or image of an article is used. Which clubs are tenants, and the league each is filed under, are our reading, in docs/atlas.md ("Tenants") |
 | `parks`: the walls, quirks, backstop, warning track, dugouts and extra points of a ballpark (`walls`, `quirks`, `backstop_ft`, `track_ft`, `dugouts`, `labels`) | The infobox and the text of the same English article of each park, at the same revision as its fence (the Japanese article for the heights of the walls of the parks of Japan): the height of the wall along a stretch of the fence and the seasons it stood, the hill, overhang, poles, bullpens, ivy and basket the text describes with figures, the infobox's backstop distance, the warning track's width, the sides of the dugouts, and the further distances the text gives (Wrigley Field's wells, Sportsman's Park's and Milwaukee County Stadium's markers). The stretch each figure covers and the angle of each extra point are our reading of the article's words | Facts. The articles are CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/); none of their text, tables or images is used |
 | `parks`: the coordinates of each ballpark (`lat`, `lon`) and the years it opened and closed (`opened`, `closed`) | The item's coordinate location (P625), its date of official opening or inception (P1619, P571) and of official closure or dissolution (P3999, P576), read with the Wikidata API by `scripts/fetch-park-coordinates.mjs` and checked by `scripts/check-parks.mjs` (ES CON Field's opening, 2023, is read from its article) | Wikidata's data is CC0 (https://creativecommons.org/publicdomain/zero/1.0/) |

package/README.md

@@ -161,7 +161,7 @@ console.log(svg.startsWith("<svg"), svg.includes("USA 3, Canada 2"));
 | `./geometry`, `./frames`, `./layers`, `./charts`, `./replay` | The dimensions in any unit; the providers' frames; data layers; charts; tracking data played on a surface. |
 | `./athletics`, `./budo`, `./skating` | The athletics stadium, the budō (areas, dohyō, kyūdōjō, the dojo builder `drawDojo`, the 82 kimarite) and the skating rinks: plans, races and charts. |
 | `./parks`, `./grounds`, `./arenas`, `./atlas`, `./eras`, `./leagues`, `./events` | The ballparks, grounds, arenas, every place, a season's markings, each league's rulebook, the special games. |
-| `./venues`, `./stadiums`, `./district`, `./plateau` | Real arenas and stadiums in their buildings' outlines; districts on one plan, among PLATEAU's buildings. |
+| `./venues`, `./stadiums`, `./district`, `./plateau`, `./osm`, `./cityctx` | Real arenas and stadiums in their buildings' outlines; districts on one plan, among PLATEAU's buildings or the streets of Vancouver and Seattle. |
 | `./turn` | A surface as a 3D view that turns, with the net, basket, goal or posts standing on it. |
 | `./scene`, `./canvas`, `./d3`, `./plot`, `./geojson`, `./png` | The drawing as data, on a canvas, in d3, as an Observable Plot mark, as GeoJSON, as a PNG (the optional peer `@resvg/resvg-js`). |
 | `./multi`, `./judging`, `./layouts` | `drawMulti` (several surfaces for one event, [docs](./docs/multi.md), [demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/halls.html)); `drawJudging` (who judges where, [docs](./docs/judging.md)); `drawGrid` (small multiples, backgrounds). |

package/dist/cityctx-entry.d.ts

@@ -0,0 +1,3 @@
+export { CITYCTX_AREAS, SEATTLE_CENTER, SEATTLE_CITY, SEATTLE_SODO, VANCOUVER_NATURE } from "./cityctx.data.ts";
+export { CITYCTX_VENUES, contextFor } from "./cityctx.ts";
+export type { ContextArea } from "./context.ts";

package/dist/cityctx-entry.js

@@ -0,0 +1,3 @@
+// The surroundings of the venues of Vancouver and Seattle (streets, buildings, water, green, trees), as data a district takes in its `context` option, from OpenStreetMap (ODbL 1.0) and the Cities' open data, with their credits; `contextFor` says which go with some venues.
+export { CITYCTX_AREAS, SEATTLE_CENTER, SEATTLE_CITY, SEATTLE_SODO, VANCOUVER_NATURE } from "./cityctx.data.js";
+export { CITYCTX_VENUES, contextFor } from "./cityctx.js";

package/dist/cityctx.d.ts

@@ -0,0 +1,19 @@
+import type { ContextArea } from "./context.ts";
+/** The venues each area is drawn round, by their ids (the part of a district's key before the colon). */
+export declare const CITYCTX_VENUES: Readonly<{
+    vancouver: string[];
+    sodo: string[];
+    center: string[];
+}>;
+/**
+ * The areas of context that go with some venues, for a district's `context` option: downtown Vancouver's buildings and streets (`VANCOUVER_CENTRE`, of `./osm`) with its water, green and trees (`VANCOUVER_NATURE`) for BC Place and
+ * Rogers Arena; Seattle's SoDo for Lumen Field and T-Mobile Park, Seattle Center's for Climate Pledge Arena, and the city's own, with streets and the buildings that matter from far, for a district that holds venues of both (they are
+ * three kilometres apart, so the detail of either would be a speck). A venue of neither city has none.
+ * @example
+ * ```ts
+ * import { contextFor } from "@johnmorrisdotca/kyogijo-stadiums/cityctx";
+ * console.log(contextFor(["bc-place:cfl", "rogers-arena"]).map((area) => area.key));
+ * // [ 'vancouver', 'vancouver-nature' ]
+ * ```
+ */
+export declare function contextFor(venues: readonly string[]): ContextArea[];

package/dist/cityctx.data.d.ts

@@ -0,0 +1,11 @@
+import type { ContextArea } from "./context.ts";
+/** Vancouver: water, green and trees round BC Place and Rogers Arena: 0 buildings, 0 street lines, 28 land cover outlines and 1370 trees within 450 metres of the middle, read 2026-10-22. */
+export declare const VANCOUVER_NATURE: ContextArea;
+/** Seattle: SoDo, Lumen Field and T-Mobile Park: 230 buildings, 1134 street lines, 8 land cover outlines and 1385 trees within 650 metres of the middle, read 2026-10-22. */
+export declare const SEATTLE_SODO: ContextArea;
+/** Seattle: Seattle Center and Climate Pledge Arena: 449 buildings, 1340 street lines, 47 land cover outlines and 1400 trees within 550 metres of the middle, read 2026-10-22. */
+export declare const SEATTLE_CENTER: ContextArea;
+/** Seattle: the city between the three venues: 1300 buildings, 2392 street lines, 49 land cover outlines and 0 trees within 3000 metres of the middle, read 2026-10-22. */
+export declare const SEATTLE_CITY: ContextArea;
+/** Every area, by key. */
+export declare const CITYCTX_AREAS: Readonly<Record<string, ContextArea>>;