@johnmorrisdotca/kyogijo-stadiums 0.44.2 → 0.45.1

package/dist/venue-data.js

@@ -0,0 +1,115 @@
+// The data of the venues a page shows, one file each, read when asked for. The drawing reads an arena, a park or a ground from a table (`heldArena`, `heldPark`, `heldGround`) that the full lists fill (`full.ts`, which every
+// entry but the lean district imports); a page that imports the lean district holds none until `loadVenueDataFor` has read the files of the venues it is about to draw. Nothing here holds a record: `arenas.index.ts`, `parks.index.ts`
+// and `grounds.index.ts` list every key with its names and the `import()` of its file, and the files are `arenas/<key>.data.ts` and so on, made by `pnpm arenas`, `pnpm parks` and `pnpm grounds`.
+import { registerArenas } from "./arenas.core.js";
+import { ARENA_INDEX } from "./arenas.index.js";
+import { registerGrounds } from "./grounds.core.js";
+import { GROUND_INDEX } from "./grounds.index.js";
+import { registerParks } from "./parks.core.js";
+import { PARK_INDEX } from "./parks.index.js";
+import { KODOKAN_NAME } from "./kodokan.js";
+import { STADIUMS, stadiumKind } from "./stadiums.js";
+/** The files read, by kind and key, each once: asking again gives the same promise, and one that failed (the network) is asked for again next time. */
+const kept = new Map();
+function read(kind, index, id, keep) {
+    const key = `${kind}:${id}`;
+    const found = kept.get(key);
+    if (found !== undefined)
+        return found;
+    const entry = Object.hasOwn(index, id) ? index[id] : undefined;
+    if (entry === undefined)
+        return Promise.reject(new Error(`no ${kind} ${JSON.stringify(id)}: the ${kind}s are ${Object.keys(index).join(", ")}`));
+    const promise = entry.load().then(keep);
+    kept.set(key, promise);
+    promise.catch(() => kept.delete(key));
+    return promise;
+}
+/**
+ * An arena by its key, read from its own file the first time and held for the drawing after: asking again gives the same promise. A key that is not an arena rejects, naming the keys there are.
+ * @example
+ * ```ts
+ * import { loadArena } from "@johnmorrisdotca/kyogijo-stadiums/venue-data";
+ * const arena = await loadArena("rogers-arena");
+ * console.log(arena.name, arena.city);
+ * // Rogers Arena Vancouver
+ * ```
+ */
+export const loadArena = (id) => read("arena", ARENA_INDEX, id, (m) => registerArenas([m.ARENA])[0]);
+/** A park by its key, read from its own file the first time and held for the drawing after (see `loadArena`). */
+export const loadPark = (id) => read("park", PARK_INDEX, id, (m) => registerParks([m.PARK])[0]);
+/** A ground by its key, read from its own file the first time and held for the drawing after (see `loadArena`). */
+export const loadGround = (id) => read("ground", GROUND_INDEX, id, (m) => registerGrounds([m.GROUND])[0]);
+/**
+ * The records the drawing of some venues of a district reads, by kind: an arena's own, a ballpark's park, a stadium's ground, and nothing for a hall (which carries its own names) or the Kodokan. The keys are a district's (`rogers-arena`,
+ * `bc-place:cfl`).
+ * @example
+ * ```ts
+ * import { venueDataKeysFor } from "@johnmorrisdotca/kyogijo-stadiums/venue-data";
+ * console.log(venueDataKeysFor(["rogers-arena", "bc-place:cfl", "t-mobile-park:mlb"]));
+ * // {
+ * //   arenas: [ 'rogers-arena' ],
+ * //   parks: [ 't-mobile-park' ],
+ * //   grounds: [ 'bc-place' ]
+ * // }
+ * ```
+ */
+export function venueDataKeysFor(venues) {
+    const keys = { arenas: [], parks: [], grounds: [] };
+    const add = (list, id) => {
+        if (id !== undefined && !list.includes(id))
+            list.push(id);
+    };
+    for (const venue of venues) {
+        const id = venue.split(":")[0];
+        const stadium = Object.hasOwn(STADIUMS, id) ? STADIUMS[id] : undefined;
+        if (stadium !== undefined) {
+            const kind = stadiumKind(stadium);
+            if (kind === "park")
+                add(keys.parks, stadium.park);
+            else if (kind === "stadium")
+                add(keys.grounds, stadium.ground);
+        }
+        else if (Object.hasOwn(ARENA_INDEX, id))
+            add(keys.arenas, id);
+    }
+    return keys;
+}
+/**
+ * The records of the venues a page is about to draw, each read from its own file and no other, and held for the drawing: what `planDistrict`, `drawDistrict` and `mountDistrictTurn` of the lean district read. Await it before the
+ * first call and again when the venues change; a venue whose records are held is not read twice.
+ * @example
+ * ```ts
+ * import { loadVenueDataFor, planDistrict } from "@johnmorrisdotca/kyogijo-stadiums/district-lean";
+ * const venues = ["bc-place:cfl", "rogers-arena"];
+ * await loadVenueDataFor(venues);
+ * console.log(planDistrict({ venues }).members.length);
+ * // 2
+ * ```
+ */
+export async function loadVenueDataFor(venues) {
+    const keys = venueDataKeysFor(venues);
+    await Promise.all([...keys.arenas.map(loadArena), ...keys.parks.map(loadPark), ...keys.grounds.map(loadGround)]);
+}
+const nameIn = (index, id, language) => (id !== undefined && Object.hasOwn(index, id) ? (language === "ja" ? index[id].nameJa : index[id].name) : undefined);
+/**
+ * The name of a venue of a district in a language, from the lists of names alone: no record is read, so a page can list every venue to choose from and read only the records of those chosen. It is the name `districtMember(key, language).name[language]` gives.
+ * `undefined` for a key that is not a venue of a district.
+ * @example
+ * ```ts
+ * import { venueName } from "@johnmorrisdotca/kyogijo-stadiums/venue-data";
+ * console.log(venueName("rogers-arena", "en"), venueName("bc-place:cfl", "ja"));
+ * // Rogers Arena BCプレイス
+ * ```
+ */
+export function venueName(key, language = "en") {
+    const id = key.split(":")[0];
+    if (id === "kodokan")
+        return KODOKAN_NAME[language];
+    const stadium = Object.hasOwn(STADIUMS, id) ? STADIUMS[id] : undefined;
+    if (stadium === undefined)
+        return nameIn(ARENA_INDEX, id, language);
+    const kind = stadiumKind(stadium);
+    if (kind === "hall")
+        return stadium.names === undefined ? undefined : stadium.names[language];
+    return kind === "park" ? nameIn(PARK_INDEX, stadium.park, language) : nameIn(GROUND_INDEX, stadium.ground, language);
+}

package/dist/venue.js

@@ -6,7 +6,7 @@ import { densityOf, resolveCrowd } from "./crowd.js";
 import { patterns } from "./crowd.draw.js";
 import { crowdStands } from "./draw.js";
 import { NHL } from "./geometry.js";
-import { groundById } from "./grounds.js";
+import { heldGround } from "./grounds.core.js";
 import { ARC_STEPS, clipAround, clipConvex, clipSegment, areaOf, pointList, raked, slopeOf, stripsOf, tidy } from "./venue.geom.js";
 import { APRON_RISE, apronPlanes, backEdges, backWall, concourseFloor, rimAt, suiteWall } from "./venue.fill.js";
 import { firstHit, realBuilding } from "./venue.real.js";
@@ -47,7 +47,7 @@ export function standsVenue(o, v, lift) {
 export function standsVenueOf(stands, crowd, o, v, lift) {
     const cut = v.detail ?? "auto";
     const fine = crowd.detail !== "plain" && o.detail !== "simple";
-    const density = densityOf(crowd, stands.seats, groundById(o.ground)?.capacity);
+    const density = densityOf(crowd, stands.seats, heldGround(o.ground)?.capacity);
     const tifo = { home: stands.sectors.some((s) => s.kind === "tifo-home"), away: stands.sectors.some((s) => s.kind === "tifo-away") };
     const pid = `${v.id}-v`;
     const defs = fine ? patterns(pid, crowd, density, tifo.home || tifo.away ? tifo : undefined, stands.real !== undefined, true, stands.rings.some((r) => r.closed === true) || stands.sectors.some((s) => s.kind === "closed")) : "";

package/dist/venues-entry.d.ts

@@ -1,2 +1,3 @@
+import "./full.ts";
 export { VENUE_ATTRIBUTION, VENUE_CONFERENCES, VENUE_DIVISIONS, VENUE_IDS, VENUES, arenaOfVenue, bowlInside, conferenceOf, planVenue, venueBowl, venueById, venueByWikidata, venueOrientation, venueRink, venuesIn, venuesInConference } from "./venues.ts";
 export type { RealVenue, RealVenueData, VenueBasis, VenueConference, VenueDivision, VenueOrientation, VenueOsm, VenuePlan, VenueRoof } from "./venues.ts";

package/dist/venues-entry.js

@@ -1,2 +1,3 @@
 // The real venues of the NHL's arenas: the outline of each building and the way its rink lies (OpenStreetMap, ODbL 1.0) and a plausible bowl from the seats, tiers and roof the sources give (Wikidata, Wikipedia).
+import "./full.js";
 export { VENUE_ATTRIBUTION, VENUE_CONFERENCES, VENUE_DIVISIONS, VENUE_IDS, VENUES, arenaOfVenue, bowlInside, conferenceOf, planVenue, venueBowl, venueById, venueByWikidata, venueOrientation, venueRink, venuesIn, venuesInConference } from "./venues.js";

package/dist/venues.d.ts

@@ -1,4 +1,4 @@
-import { type Arena, type ArenaSource } from "./arenas.ts";
+import { type Arena, type ArenaSource } from "./arenas.core.ts";
 import { type Box, type Pt, type RealBowl } from "./crowd.ts";
 import { VENUE_ATTRIBUTION } from "./venues.osm.data.ts";
 export { VENUE_ATTRIBUTION };

package/dist/venues.js

@@ -2,7 +2,7 @@
 // the sources give (Wikidata, CC0, and the English Wikipedia article each fact cites), fitted inside the outline. Level one is the building: its outline and orientation, as OpenStreetMap maps them. Level two is a plausible
 // bowl: a number of seats in the number of tiers the sources say, between the rink's boards and the building's wall, under the roof's kind. It stops there: no team's or ticket seller's seat map is read or copied, no
 // section or row is named, and no mark of a team or a league is drawn. The drawing is `drawKyogijo({ sport: "nhl", arena, crowd: { real: true } })` and, in 3D, the same options in `buildTurn` or `mountTurn`.
-import { arenaById, arenaRinkIn } from "./arenas.js";
+import { heldArena, arenaRinkIn } from "./arenas.core.js";
 import { NORTH_ROOM, aislesOf, areaOfOutline, outlinePoints } from "./crowd.js";
 import { NHL, FEET_PER_METRE } from "./geometry.js";
 import { boxOf, edgeDistance, inside, metresFrom, middleOf, northOn, turnedTo } from "./venues.geo.js";
@@ -29,7 +29,7 @@ export const conferenceOf = (division) => VENUE_CONFERENCES.western.includes(div
 export const venuesInConference = (conference) => VENUE_CONFERENCES[conference].flatMap((division) => venuesIn(division));
 /** The arena a venue is of. */
 export const arenaOfVenue = (venue) => {
-    const arena = arenaById(venue.id);
+    const arena = heldArena(venue.id);
     if (arena === undefined)
         throw new Error(`${venue.id} is not an arena`);
     return arena;
@@ -41,7 +41,7 @@ export const venueOrientation = (venue) => ({ heading: venue.osm.axis.heading, b
 // ---- The bowl. ----
 /** The rink's box as the drawing has it: the arena's own where its sources publish a size, else the NHL's. */
 export function venueRink(venue) {
-    const sized = arenaRinkIn(arenaById(venue.id));
+    const sized = arenaRinkIn(heldArena(venue.id));
     return { x: 0, y: 0, w: sized?.length ?? NHL.length, h: sized?.width ?? NHL.width };
 }
 /** How far the first row is from the boards at the sides and at the ends, and the bench side's extra, and the corner's radius: the NHL profile of `crowd.ts`, so that a real venue's first row is the usual one. */

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** The package's version: the same as package.json's, and a test holds them to each other. */
-export declare const VERSION = "0.44.2";
+export declare const VERSION = "0.45.1";

package/dist/version.js

@@ -1,2 +1,2 @@
 /** The package's version: the same as package.json's, and a test holds them to each other. */
-export const VERSION = "0.44.2";
+export const VERSION = "0.45.1";

package/dist/zones-entry.d.ts

@@ -1,2 +1,3 @@
+import "./full.ts";
 export { PARKS_WITHOUT_WALL_HEIGHTS, RULE_IDS, betweenHashes, homeRun, inCrease, inPaint, inPenaltyArea, inRedZone, inRestrictedArea, inSixYardBox, inSlot, isFair, isHomeRun, isThreePointer, onWarningTrack, overWall, wallHeightAt, zoneAt, zoneAtSurface, zoneName, zoneResolver } from "./rules.ts";
 export type { HomeRunOptions, HomeRunVerdict, PlaceLike, RuleId, ZoneAnswer, ZoneOptions } from "./rules.ts";

package/dist/zones-entry.js

@@ -1,2 +1,3 @@
 // The rulebook as code: where a point lies on a surface in the sport's own terms (the zone, the area in it, every other area that holds), and the yes-or-no questions a coach asks.
+import "./full.js";
 export { PARKS_WITHOUT_WALL_HEIGHTS, RULE_IDS, betweenHashes, homeRun, inCrease, inPaint, inPenaltyArea, inRedZone, inRestrictedArea, inSixYardBox, inSlot, isFair, isHomeRun, isThreePointer, onWarningTrack, overWall, wallHeightAt, zoneAt, zoneAtSurface, zoneName, zoneResolver } from "./rules.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnmorrisdotca/kyogijo-stadiums",
-  "version": "0.44.2",
+  "version": "0.45.1",
   "description": "Kyogijo Stadiums 競技場, 40 sports' surfaces as SVG, drawn to scale from the rulebooks: NFL, CFL and IFAF football fields, an NHL rink, an NBA court, MLB ballparks, soccer pitches, curling sheets, athletics stadiums, speed skating, short track and figure skating rinks, swimming pools, water polo fields, diving wells, artistic swimming areas, and the courts and fields of tennis, volleyball (indoor, beach and sitting), badminton, pickleball, table tennis, padel, squash, racquetball, sepak takraw, teqball, roundnet, netball, lacrosse, rugby, Australian football, Gaelic games, cricket, field hockey and handball, and the budo of judo, karate, kendo, sumo and kyudo with a dojo of tatami laid as real units, the MMA cage, with each team's name and logo on its side and the score in the middle, stands and a crowd, a pageant of flags, and a 3D view. Light and dark, accessible, a compact badge for lists, a helper for React and a custom element. Zero dependencies.",
   "keywords": [
     "sports",
@@ -67,7 +67,11 @@
   "type": "module",
   "sideEffects": [
     "./dist/element-define.js",
-    "./dist/frames.providers.js"
+    "./dist/frames.providers.js",
+    "./dist/full.js",
+    "./dist/arenas.js",
+    "./dist/parks.js",
+    "./dist/grounds.js"
   ],
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -158,6 +162,16 @@
       "import": "./dist/areas-entry.js",
       "default": "./dist/areas-entry.js"
     },
+    "./venue-data": {
+      "types": "./dist/venue-data-entry.d.ts",
+      "import": "./dist/venue-data-entry.js",
+      "default": "./dist/venue-data-entry.js"
+    },
+    "./district-lean": {
+      "types": "./dist/district-lean-entry.d.ts",
+      "import": "./dist/district-lean-entry.js",
+      "default": "./dist/district-lean-entry.js"
+    },
     "./osm": {
       "types": "./dist/osm-entry.d.ts",
       "import": "./dist/osm-entry.js",
@@ -341,7 +355,9 @@
     "names:fetch": "node scripts/fetch-names.mjs",
     "tenants": "node scripts/build-tenants.mjs",
     "tenants:fetch": "node scripts/fetch-tenants.mjs",
-    "parks:check": "node scripts/check-parks.mjs"
+    "parks:check": "node scripts/check-parks.mjs",
+    "bundles": "node scripts/bundle-report.mjs --markdown",
+    "bundles:budget": "node scripts/bundle-report.mjs --no-paint --budget --write scripts/bundle-budget.json"
   },
   "devDependencies": {
     "@eslint/js": "^9.0.0",