@johnmorrisdotca/kyogijo-stadiums 0.28.0 → 0.31.0

package/dist/flythrough.words.js

@@ -2,13 +2,14 @@ export const FLYTHROUGH_WORDS = {
     en: {
         title: "Fly-through: {arena}",
         region: "fly-through",
-        about: "A fly-through from a map to {arena} in {place}: the map, the city, the arena in 3D, the way in over the stands and the rink seen from a seat. Play, pause, step back or forward and choose a stage with the buttons or the keys.",
+        about: "A fly-through from a map to {arena} in {place}: the map, the city, the arena in 3D, the way in over the stands, the rink seen from a seat and a short play on the ice. Play, pause, step back or forward and choose a stage with the buttons or the keys.",
         stage: {
             map: { name: "Map", text: "{arena} stands in {place}." },
             city: { name: "City", text: "The building of {arena} from above, as OpenStreetMap maps it." },
             arena: { name: "Arena", text: "{arena} in 3D, turning." },
             bowl: { name: "Bowl", text: "In over the stands, with the roof lifted away: a plausible bowl of {seats} seats in {tiers} tiers, not a seat map." },
             rink: { name: "Rink", text: "A view across the ice from the stands, turning; the place and the height of the seat are ours, not a real seat's." },
+            game: { name: "Game", text: "A short play made up for the picture, with five skaters and a goalie a side and a puck, moving on the ice. It is illustrative, not a real game's data." },
         },
         announce: "Stage {n} of {total}: {name}. {text}",
         play: "Play",
@@ -19,18 +20,20 @@ export const FLYTHROUGH_WORDS = {
         keys: "Space plays or pauses. Left and right arrows go back and forward a stage; the number keys choose a stage; Home starts again.",
         creditMap: "Map: Natural Earth (public domain), drawn with chizu. Building outline: (c) OpenStreetMap contributors, ODbL 1.0, openstreetmap.org/copyright.",
         creditPlain: "Building outline: (c) OpenStreetMap contributors, ODbL 1.0, openstreetmap.org/copyright.",
+        illustrative: "Illustrative play",
         still: "Each stage is shown as a still picture, because this device is set to reduce motion.",
     },
     ja: {
         title: "フライスルー：{arena}",
         region: "フライスルー",
-        about: "地図から{place}の{arena}まで進むフライスルーです。地図、都市、3Dのアリーナ、スタンドの上空から中へ入る場面、客席から見たリンクの順に見られます。ボタンまたはキーで、再生・一時停止、前後の場面への移動、場面の選択ができます。",
+        about: "地図から{place}の{arena}まで進むフライスルーです。地図、都市、3Dのアリーナ、スタンドの上空から中へ入る場面、客席から見たリンク、氷上の短い模擬プレーの順に見られます。ボタンまたはキーで、再生・一時停止、前後の場面への移動、場面の選択ができます。",
         stage: {
             map: { name: "地図", text: "{arena}は{place}にあります。" },
             city: { name: "都市", text: "{arena}の建物を真上から見たところです（OpenStreetMapの記録による）。" },
             arena: { name: "アリーナ", text: "{arena}を3Dで回転させて表示しています。" },
             bowl: { name: "客席", text: "屋根を取り払い、スタンドの上空から中へ入ります。{seats}席・{tiers}層の推定のスタンドで、実際の座席表ではありません。" },
             rink: { name: "リンク", text: "スタンドからリンクを見渡した眺めで、ゆっくり回転します。視点の位置と高さは仮のもので、実在の座席ではありません。" },
+            game: { name: "試合", text: "絵として作った短い模擬プレーです。両チーム各5人のスケーターとゴーリー、そしてパックが氷上を動きます。実際の試合のデータではありません。" },
         },
         announce: "場面{n}／{total}：{name}。{text}",
         play: "再生",
@@ -41,6 +44,7 @@ export const FLYTHROUGH_WORDS = {
         keys: "スペースキーで再生・一時停止。左右の矢印キーで前後の場面へ、数字キーで場面を選び、Homeキーで最初に戻ります。",
         creditMap: "地図：Natural Earth（パブリックドメイン）、chizuで描画。建物の輪郭：(c) OpenStreetMap contributors、ODbL 1.0、openstreetmap.org/copyright。",
         creditPlain: "建物の輪郭：(c) OpenStreetMap contributors、ODbL 1.0、openstreetmap.org/copyright。",
+        illustrative: "模擬プレー（イメージ）",
         still: "この端末は動きを減らす設定のため、各場面を静止画で表示しています。",
     },
 };

package/dist/index.d.ts

@@ -63,8 +63,8 @@ export { ERA_CURRENT, ERA_SOURCES, ERA_SPORTS, eraChanges, eraRange, eraStates,
 export type { EraChange, EraRules, EraRulesOf, EraSource, EraSpan, EraSport, FootballRules, MlbRules, NbaRules, NhlRules } from "./eras.ts";
 export { ARENA_IDS, ARENAS, arenaById, arenaByName, arenaByWikidata, arenaCourtIn, arenaNameIn, arenaOfficialName, arenaRinkIn, arenaSourceUrl, arenasByName } from "./arenas.ts";
 export type { Arena, ArenaCapacity, ArenaData, ArenaName, ArenaSize, ArenaSource } from "./arenas.ts";
-export { VENUE_ATTRIBUTION, VENUE_IDS, VENUES, arenaOfVenue, bowlInside, planVenue, venueBowl, venueById, venueByWikidata, venueOrientation, venueRink, venuesIn } from "./venues.ts";
-export type { RealVenue, RealVenueData, VenueBasis, VenueDivision, VenueOrientation, VenueOsm, VenuePlan, VenueRoof } from "./venues.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";
 export { GROUND_IDS, GROUNDS, groundById, groundByName, groundByWikidata, groundNameIn, groundOfficialName, groundSourceUrl, groundsByName, groundsHosting } from "./grounds.ts";
 export type { Ground, GroundCompetition, GroundData, GroundName, GroundSource, GroundTournament } from "./grounds.ts";
 export { AFL_GROUNDS, FAMILY_OF, LEAGUES, LEAGUE_SOURCES, VARIANTS, chooseLeague, hasHistory, leagueAt, leagueById, leagueChanges, leagueFigures, leagueIds, leagueSeason, leagueSize } from "./leagues.ts";

package/dist/index.js

@@ -39,7 +39,7 @@ export { PARKS, PARK_IDS, fenceFor, parkById, parkByName, parkByWikidata, parkNa
 export { officialName, plainName } from "./names.js";
 export { ERA_CURRENT, ERA_SOURCES, ERA_SPORTS, eraChanges, eraRange, eraStates, footballIn, rulesFor, seasonLabel } from "./eras.js";
 export { ARENA_IDS, ARENAS, arenaById, arenaByName, arenaByWikidata, arenaCourtIn, arenaNameIn, arenaOfficialName, arenaRinkIn, arenaSourceUrl, arenasByName } from "./arenas.js";
-export { VENUE_ATTRIBUTION, VENUE_IDS, VENUES, arenaOfVenue, bowlInside, planVenue, venueBowl, venueById, venueByWikidata, venueOrientation, venueRink, venuesIn } from "./venues.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";
 export { GROUND_IDS, GROUNDS, groundById, groundByName, groundByWikidata, groundNameIn, groundOfficialName, groundSourceUrl, groundsByName, groundsHosting } from "./grounds.js";
 export { AFL_GROUNDS, FAMILY_OF, LEAGUES, LEAGUE_SOURCES, VARIANTS, chooseLeague, hasHistory, leagueAt, leagueById, leagueChanges, leagueFigures, leagueIds, leagueSeason, leagueSize } from "./leagues.js";
 export { SURFACE_UNITS, UNITS, convertLength, isUnit } from "./units.js";

package/dist/stadiums-entry.d.ts

@@ -1,2 +1,2 @@
-export { VENUE_ATTRIBUTION, STADIUMS, STADIUM_IDS, groundOfStadium, planStadium, stadiumBowl, stadiumBowlInside, stadiumById, stadiumByWikidata, stadiumConfigOf, stadiumOrientation, stadiumSeats } from "./stadiums.ts";
-export type { RealStadium, RealStadiumData, StadiumBasis, StadiumConfigData, StadiumConfigId, StadiumOrientation, StadiumOsm, StadiumPlan, StadiumRoof } from "./stadiums.ts";
+export { VENUE_ATTRIBUTION, STADIUMS, STADIUM_IDS, groundOfStadium, planPark, planStadium, stadiumBowl, stadiumBowlInside, stadiumById, stadiumByWikidata, stadiumConfigOf, stadiumConfigs, stadiumFrameHeading, stadiumKind, stadiumNames, stadiumOrientation, stadiumSeats } from "./stadiums.ts";
+export type { ParkPlan, RealStadium, RealStadiumData, StadiumBasis, StadiumConfigData, StadiumConfigId, StadiumKind, StadiumOrientation, StadiumOsm, StadiumPlan, StadiumRoof } from "./stadiums.ts";

package/dist/stadiums-entry.js

@@ -1,2 +1,2 @@
-// The real stadiums: the outline of each stadium's building and the way its field lies (OpenStreetMap, ODbL 1.0) and a plausible bowl from the seats of each configuration, the bowls and the roof the sources give (Wikidata, Wikipedia).
-export { VENUE_ATTRIBUTION, STADIUMS, STADIUM_IDS, groundOfStadium, planStadium, stadiumBowl, stadiumBowlInside, stadiumById, stadiumByWikidata, stadiumConfigOf, stadiumOrientation, stadiumSeats } from "./stadiums.js";
+// The real stadiums and ballparks: the outline of each building and the way its field lies (OpenStreetMap, ODbL 1.0) and a plausible bowl from the seats of each configuration, the bowls and the roof the sources give (Wikidata, Wikipedia).
+export { VENUE_ATTRIBUTION, STADIUMS, STADIUM_IDS, groundOfStadium, planPark, planStadium, stadiumBowl, stadiumBowlInside, stadiumById, stadiumByWikidata, stadiumConfigOf, stadiumConfigs, stadiumFrameHeading, stadiumKind, stadiumNames, stadiumOrientation, stadiumSeats } from "./stadiums.js";

package/dist/stadiums.d.ts

@@ -1,16 +1,22 @@
-import { type Box, type Pt, type RealBowl } from "./crowd.ts";
+import { type Box, type CrowdStands, type Pt, type RealBowl } from "./crowd.ts";
+import { type ParkInput } from "./crowd.park.ts";
 import { type Ground } from "./grounds.ts";
 import { VENUE_ATTRIBUTION } from "./venues.ts";
 export { VENUE_ATTRIBUTION };
 /** How a fact is known: `documented` is what a source cited with it says; `plausible` is ours, for a bowl no source describes. */
 export type StadiumBasis = "documented" | "plausible";
-/** The configurations of a stadium: the field the seats are counted for. `cfl` is the football field of the Canadian league, `soccer` a soccer pitch. */
-export type StadiumConfigId = "cfl" | "soccer";
-/** The kinds of roof the stadiums have: `cable` is a cable-supported roof with an opening over the field that a retractable fabric closes; `fixed` a lid over the bowl. */
-export type StadiumRoof = "cable" | "fixed";
+/** The configurations of a stadium: the field the seats are counted for. `cfl` and `nfl` are the football fields of the two leagues, `soccer` a soccer pitch, `mlb` a baseball field. */
+export type StadiumConfigId = "cfl" | "nfl" | "soccer" | "mlb";
+/** What a stadium is: a `stadium` has a football field and a soccer pitch lying along its length, a `park` is a baseball park, whose frame is home plate's. */
+export type StadiumKind = "stadium" | "park";
+/**
+ * The kinds of roof: `cable` is a cable-supported roof with an opening over the field that a retractable fabric closes (BC Place's); `fixed` a lid over the bowl; `canopy` roofs over some of the stands that leave the field
+ * open (Lumen Field's); `panels` a retractable roof of sections high over a ballpark (T-Mobile Park's).
+ */
+export type StadiumRoof = "cable" | "fixed" | "canopy" | "panels";
 /** What one configuration of a stadium is: its sport and its seats, and where the figure was read. */
 export interface StadiumConfigData {
-    sport: "cfl" | "soccer";
+    sport: StadiumConfigId;
     /** The seats for this configuration: the infobox's figure for it, or Wikidata's. */
     seats: number;
     source: "wikidata" | "wikipedia";
@@ -19,45 +25,68 @@ export interface StadiumConfigData {
 }
 /** The facts of a stadium: the seats of each configuration, the number of bowls and the kind of roof, each with what a source says. No text of an article is kept. */
 export interface RealStadiumData {
-    /** The key: `bc-place`, the key of the stadium's ground in `GROUNDS`. */
+    /** The key: `bc-place`, the key of the stadium's ground in `GROUNDS` (or of its park in `PARKS`). */
     id: string;
+    kind?: StadiumKind;
     /** The Wikidata item of the stadium. */
     wikidata: string;
-    /** The key of the stadium's ground in `GROUNDS` (its name, its place, its pitch). */
-    ground: string;
+    /** The key of the stadium's ground in `GROUNDS` (its name, its place, its pitch): a stadium has one. */
+    ground?: string;
+    /** The key of a ballpark in `PARKS` (its name, its place, its fence): a park has one. */
+    park?: string;
+    /** Whose football field the first row stands round: the CFL's (the default) or the NFL's. */
+    gridiron?: "cfl" | "nfl";
     /** The English Wikipedia article the facts that are not Wikidata's were read from, at a revision. */
     en: {
         title: string;
         revision: number;
     };
-    configs: Record<StadiumConfigId, StadiumConfigData>;
+    configs: Partial<Record<StadiumConfigId, StadiumConfigData>>;
+    /** The seats of the whole bowl where it holds more than a configuration's (Lumen Field's soccer seats are fewer: the upper sections are closed): the bowl is fitted to these and a configuration opens its seats from the lowest bowl up. */
+    bowlSeats?: number;
+    /** Wikidata's own capacities (P1083), kept beside the figures used: they are often for another event or another year. */
+    wikidataSeats?: number[];
     tiers: {
-        /** The seating levels (bowls). */
-        count: 1 | 2 | 3;
+        /** The seating levels (bowls): a ballpark's four levels are drawn as a lower bowl, an upper bowl and the bleachers. */
+        count: 1 | 2 | 3 | 4;
         basis: StadiumBasis;
         /** The seats of the lowest bowl, where a source gives them: the lower tier's band holds this many whatever the configuration (the upper bowl is what is opened or closed for the others). */
         lowerSeats?: number;
+        /** A ballpark's seats by band, where the article gives them by level: the lower bowl, the upper bowl (the club, suite and view levels) and the bleachers. */
+        tierSeats?: {
+            lower: number;
+            upper: number;
+            bleachers: number;
+        };
         read: string;
     };
     roof: {
         kind: StadiumRoof;
         basis: StadiumBasis;
-        read: string; /** A cable roof's opening over the field, as the article gives it, in metres. */
+        read: string;
+        /** A cable roof's opening over the field, as the article gives it, in metres. */
         opening?: {
             length: number;
             width: number;
             unit: "m";
         };
+        /** A canopy's share of the seats it covers, as the article gives it. */
+        cover?: number;
+        /** A retractable roof's bottom and top above the field, in feet, as the article gives them. */
+        bottom?: number;
+        top?: number;
     };
 }
 /** What OpenStreetMap gave of a stadium: ODbL 1.0 data, "(c) OpenStreetMap contributors". */
 export interface StadiumOsm {
-    /** The element the outline is: `way/24705904`. */
+    /** The element the outline is: `way/24705904`, `relation/2305831`. */
     source: string;
     read: string;
     base: string;
     licence: "ODbL-1.0";
     attribution: string;
+    /** The building's height in metres, where OpenStreetMap maps one. */
+    height?: number;
     /** The roof OpenStreetMap maps over the building: its heights in metres (`height` to the top of the roof, `rise` of that the roof's own) and the opening in it as `[longitude, latitude]`. */
     roof?: {
         source: string;
@@ -69,16 +98,24 @@ export interface StadiumOsm {
             ring: [number, number][];
         };
     };
+    /** The canopies OpenStreetMap maps over some of the stands: each one's outline, the height of its top and how far it rises (metres). */
+    canopies?: {
+        source: string;
+        height: number;
+        rise: number;
+        ring: [number, number][];
+    }[];
     /** The building's outline as `[longitude, latitude]`, not repeating its first point. */
     ring: [number, number][];
     /**
-     * How the field lies, worked out when the data was made: the heading of its long side (degrees clockwise from north, 0 to under 180), how that is known (`opening`: from the roof's opening, which the article says is
-     * the field's size; `building`: from the long axis of the building's main hall, an inference; `none`: no direction, 90 is stood in), how much of a direction the building has (`strength`) and how much longer than
-     * wide the opening or the hall is (`elongation`), and the middle of the field as `[longitude, latitude]`.
+     * How the field lies, worked out when the data was made: the heading of its long side (degrees clockwise from north, 0 to under 180; for a ballpark, the heading from home plate out to centre field, 0 to under 360), how that
+     * is known (`opening`: from the roof's opening, which the article says is the field's size; `pitch`: from the pitches OpenStreetMap maps; `infield`: from the mapped infield, with the outline choosing which way is out to
+     * centre field; `building`: from the long axis of the building's main hall, an inference; `none`: no direction, 90 is stood in), how much of a direction the building has (`strength`) and how much longer than wide the
+     * opening, the pitch or the hall is (`elongation`), and the middle of the field as `[longitude, latitude]` (home plate for a ballpark).
      */
     axis: {
         heading: number;
-        basis: "opening" | "building" | "none";
+        basis: "opening" | "pitch" | "infield" | "building" | "none";
         strength: number;
         elongation: number;
         centre: [number, number];
@@ -88,10 +125,10 @@ export interface StadiumOsm {
 export interface RealStadium extends RealStadiumData {
     osm: StadiumOsm;
 }
-/** How the field lies in the building: its long side's heading, how that is known, and the way north points on the page (degrees clockwise from the top). */
+/** How the field lies in the building: its long side's heading (a ballpark's: home plate to centre field), how that is known, and the way north points on the page (degrees clockwise from the top). */
 export interface StadiumOrientation {
     heading: number;
-    basis: "opening" | "building" | "none";
+    basis: StadiumOsm["axis"]["basis"];
     north: number;
 }
 /** The stadiums by key. */
@@ -102,13 +139,24 @@ export declare const STADIUM_IDS: readonly string[];
 export declare const stadiumById: (id: string | undefined) => RealStadium | undefined;
 /** The stadium whose Wikidata item is `Q612227`, or `undefined`. */
 export declare const stadiumByWikidata: (wikidata: string | undefined) => RealStadium | undefined;
-/** The ground a stadium is (its name, place and pitch). */
+/** The kind of a stadium: a `stadium` unless it is a ballpark. */
+export declare const stadiumKind: (stadium: RealStadium) => StadiumKind;
+/** The configurations a stadium has, in the order of its data. */
+export declare const stadiumConfigs: (stadium: RealStadium) => StadiumConfigId[];
+/** The ground a stadium is (its name, place and pitch). Throws for a ballpark, which has a park. */
 export declare const groundOfStadium: (stadium: RealStadium) => Ground;
+/** The names a stadium goes by in both languages, of its ground or its park. */
+export declare function stadiumNames(stadium: RealStadium): {
+    en: string;
+    ja: string;
+};
+/** The heading the field's frame runs along, degrees clockwise from north: the long side's, and for a ballpark (whose frame has home plate at its origin, x to the right of the way out and y minus the way out) a quarter turn from the way out to centre field. */
+export declare const stadiumFrameHeading: (stadium: RealStadium) => number;
 /** How the field lies in a stadium's building (see `StadiumOsm.axis`). */
 export declare const stadiumOrientation: (stadium: RealStadium) => StadiumOrientation;
-/** The configuration a sport is: `cfl` or `soccer`, or `undefined` for a sport a stadium has no configuration for. */
+/** The configuration a sport is: `cfl`, `nfl`, `soccer` or `mlb`, or `undefined` for a sport a stadium has no configuration for. */
 export declare const stadiumConfigOf: (sport: string | undefined) => StadiumConfigId | undefined;
-/** The seats of a stadium for a configuration. */
+/** The seats of a stadium for a configuration (0 for one it has none of). */
 export declare const stadiumSeats: (stadium: RealStadium, config: StadiumConfigId) => number;
 /** The height of the first row above the field, in feet, the rise of a bowl's rows by the number of bowls (what the lowest, a middle and the upper rise, at most), and the rise of the walk between two bowls (a suite level): ours, no source gives them. */
 export declare const STADIUM_FIRST_HEIGHT = 5;
@@ -116,6 +164,8 @@ export declare const STADIUM_RISES: Readonly<Record<1 | 2 | 3, readonly number[]
 export declare const STADIUM_WALK_RISE = 24;
 /** The height a roof's rim stands over the top row, at the least, in feet. */
 export declare const STADIUM_CLEARANCE = 22;
+/** How far a canopy's low edge stands over the top row at the least, in feet: a bowl under a canopy is lowered to keep it. */
+export declare const CANOPY_CLEARANCE = 6;
 /** The plan of a stadium for a configuration: its building in the drawing's frame, the bowl fitted inside, and how it lies. */
 export interface StadiumPlan {
     stadium: RealStadium;
@@ -129,26 +179,28 @@ export interface StadiumPlan {
     opening: Pt[] | undefined;
     /** The stands for `layoutOf`: bowls, first row, ground, and the building and roof. */
     bowl: RealBowl;
-    /** The seats the bowls hold, by bowl, and in all: equal to the configuration's seats where the building has room (`fit` is `fits`). */
+    /** The seats the bowls hold, by bowl, and in all: equal to the bowl's seats where the building has room (`fit` is `fits`). */
     seats: {
         tier: string;
         seats: number;
     }[];
     total: number;
+    /** The seats open in this configuration: the configuration's own, counted from the lowest bowl up (the rest of a larger bowl is closed). */
+    open: number;
     /** The floor a seat takes in the plan, in square feet (one of `SEAT_AREAS`). */
     seatArea: number;
     fit: "fits" | "tight";
 }
 /**
  * The plan of a stadium's bowl for a configuration: the building's outline turned so that the field lies along x, a first row round a football field's footprint as a gridiron's stands have it, the largest bowl-shaped
- * outline that fits the building round the middle of the field, and between the two the bowls, the outer edge of each placed so that its band holds the share of the configuration's seats the sources give it, with a walk
- * between them. The bowl is the same building for football and soccer (the seats of the configuration differ, and the field).
+ * outline that fits the building round the middle of the field, and between the two the bowls, the outer edge of each placed so that its band holds the share of the seats the sources give it, with a walk
+ * between them. The bowl is the same building for every configuration (the seats of the configuration differ, and the field); where a bowl holds more seats than a configuration opens, the rest are closed.
  * @example
  * ```ts
  * import { planStadium, stadiumById } from "@johnmorrisdotca/kyogijo-stadiums/stadiums";
  * const plan = planStadium(stadiumById("bc-place")!, "soccer", { x: 0, y: 0, w: 344.5, h: 223.1 });
- * console.log(plan.orientation.basis, plan.seats.map((t) => t.tier).join(" "), plan.total);
- * // opening lower upper 52497
+ * console.log(plan.orientation.basis, plan.seats.map((t) => `${t.tier} ${t.seats}`).join(", "), plan.total);
+ * // opening lower 27695, upper 24802 52497
  * ```
  */
 export declare function planStadium(stadium: RealStadium, config: StadiumConfigId, box: Box): StadiumPlan;
@@ -156,3 +208,32 @@ export declare function planStadium(stadium: RealStadium, config: StadiumConfigI
 export declare const stadiumBowl: (stadium: RealStadium, config: StadiumConfigId, box: Box) => RealBowl;
 /** Whether the bowl lies inside the building: every corner of every bowl's outer edge is inside the footprint. */
 export declare function stadiumBowlInside(plan: StadiumPlan): boolean;
+/** The plan of a ballpark: its usual stands (`parkLayout`), the depth of each band set so that it holds the seats the article gives for its level, and the building, the way home plate faces and the roof round them. */
+export interface ParkPlan {
+    stadium: RealStadium;
+    config: StadiumConfigId;
+    orientation: StadiumOrientation;
+    /** The building's outline in feet, in the park's frame (home plate at its origin, x to the right of the way out to centre field, y minus the way out). */
+    footprint: Pt[];
+    /** The stands, with the building and the roof (`real`). */
+    stands: CrowdStands;
+    /** The depth of each band of stands the seats gave, in feet. */
+    depths: {
+        lower: number;
+        upper: number;
+        bleachers: number;
+    };
+    /** The seats each band holds, and in all, against the configuration's. */
+    seats: {
+        tier: string;
+        seats: number;
+    }[];
+    total: number;
+    /** Whether the stands hold the configuration's seats to within two percent. */
+    fit: "fits" | "tight";
+}
+/**
+ * The plan of a ballpark from what its stands are laid from (`input`: the park's fence, the backstop and the crowd): the usual stands with each band as deep as its seats need, the building's outline turned so that home
+ * plate faces where OpenStreetMap's infield and the outline say, and the roof: sections far over the field, closed over the stands and the field or resting over the east side where the article says they rest.
+ */
+export declare function planPark(stadium: RealStadium, input: ParkInput): ParkPlan;

package/dist/stadiums.data.js

@@ -5,7 +5,32 @@ export const STADIUM_DATA = [
         "ground": "bc-place",
         "en": { "title": "BC Place", "revision": 1372065649 },
         "configs": { "cfl": { "sport": "cfl", "seats": 54500, "source": "wikipedia", "read": "the infobox's first capacity, 54,500, which Wikidata's capacity (P1083) also gives; the article's stand for football of the CFL's club" }, "soccer": { "sport": "soccer", "seats": 52497, "source": "wikipedia", "read": "the infobox's capacity for the 2026 world cup of soccer, 52,497, 2,003 fewer than its first" } },
+        "wikidataSeats": [54500],
         "tiers": { "count": 2, "basis": "documented", "lowerSeats": 27695, "read": "the infobox's lower bowl of 27,695 seats, and the article's lower and upper bowls (the club that plays soccer there sold only the lower bowl)" },
         "roof": { "kind": "cable", "basis": "documented", "read": "the article: a retractable roof supported by cables, the largest of its kind, its opening 100 by 85 metres (the size of the field), the fabric retracting into a pod in the middle of the opening above the suspended video board", "opening": { "length": 100, "width": 85, "unit": "m" } },
     },
+    {
+        "id": "lumen-field",
+        "kind": "stadium",
+        "wikidata": "Q612736",
+        "ground": "lumen-field",
+        "gridiron": "nfl",
+        "en": { "title": "Lumen Field", "revision": 1373998493 },
+        "configs": { "nfl": { "sport": "nfl", "seats": 68740, "source": "wikipedia", "read": "the infobox's capacity for the NFL, 68,740 (expandable to 72,000 for special events)" }, "soccer": { "sport": "soccer", "seats": 37722, "source": "wikipedia", "read": "the infobox's capacity for MLS, 37,722, the upper and lower sections tarped off beyond it" } },
+        "bowlSeats": 68740,
+        "wikidataSeats": [67000, 72000],
+        "tiers": { "count": 3, "basis": "documented", "read": "the article names the lower concourse levels, the club and suite levels and the Summit levels above them" },
+        "roof": { "kind": "canopy", "basis": "documented", "cover": 0.7, "read": "the article: a roof of 200,000 square feet that covers 70 percent of the seats and leaves the field open, spanning 720 feet between concrete pylons at the north and south ends" },
+    },
+    {
+        "id": "t-mobile-park",
+        "kind": "park",
+        "wikidata": "Q1193117",
+        "park": "t-mobile-park",
+        "en": { "title": "T-Mobile Park", "revision": 1379419810 },
+        "configs": { "mlb": { "sport": "mlb", "seats": 47368, "source": "wikipedia", "read": "the infobox's capacity for baseball, 47,368" } },
+        "wikidataSeats": [47476],
+        "tiers": { "count": 4, "basis": "documented", "tierSeats": { "lower": 20521, "upper": 22075, "bleachers": 3666 }, "read": "the article's levels: the Main Level of 20,521 seats (most of the lower bowl), the Club Level of 4,123, the Suite Level of 2,050 and the View Level of 15,902, and two bleacher sections of 3,666" },
+        "roof": { "kind": "panels", "basis": "documented", "bottom": 217, "top": 269, "read": "the article: a retractable roof in four sections that does not fully enclose the ballpark, its bottom 217 feet and its top 269 feet above the field, resting over the railway tracks to the east when open" },
+    },
 ];