@johnmorrisdotca/kyogijo-stadiums 0.45.0 → 0.45.2

package/dist/grounds/stadio-nazionale-pnf.data.js

@@ -0,0 +1,28 @@
+export const GROUND = {
+    "id": "stadio-nazionale-pnf",
+    "wikidata": "Q642958",
+    "name": "Stadio Nazionale PNF",
+    "nameJa": "スタディオ・ナツィオナーレPNF",
+    "localName": "Stadio Nazionale del PNF",
+    "localLanguage": "it",
+    "aliases": [
+        { "name": "Stadio Nazionale PNF", "lang": "en", "kind": "wikipedia", "revision": 1372234262, "source": "en.wikipedia.org" },
+        { "name": "スタディオ・ナツィオナーレPNF", "lang": "ja", "kind": "wikipedia", "revision": 106032907, "source": "ja.wikipedia.org" },
+        { "name": "National Stadium, Rome", "lang": "en", "kind": "nickname", "source": "Wikidata Q642958 alias" }
+    ],
+    "city": "Rome",
+    "country": "IT",
+    "lat": 41.92722,
+    "lon": 12.47222,
+    "status": "past",
+    "from": 1911,
+    "to": 1953,
+    "capacity": 47300,
+    "pitchSize": "published",
+    "pitch": { "length": 105, "width": 68, "unit": "m" },
+    "en": { "title": "Stadio Nazionale PNF", "revision": 1372234262 },
+    "ja": { "title": "スタディオ・ナツィオナーレPNF", "revision": 106032907 },
+    "tournaments": [
+        { "competition": "world-cup", "year": 1934, "final": true }
+    ],
+};

package/dist/grounds/stadio-olimpico-rome.data.d.ts

@@ -0,0 +1,2 @@
+import type { GroundData } from "../grounds.core.ts";
+export declare const GROUND: GroundData;

package/dist/grounds/stadio-olimpico-rome.data.js

@@ -0,0 +1,34 @@
+export const GROUND = {
+    "id": "stadio-olimpico-rome",
+    "wikidata": "Q159884",
+    "track": true,
+    "trackSource": "Wikidata, property P641 (sport) lists athletics",
+    "name": "Stadio Olimpico",
+    "names": [
+        { "name": "Stadio dei Cipressi", "from": 1928, "to": 1953 },
+        { "name": "Stadio dei Centomila", "from": 1953, "to": 1960 }
+    ],
+    "nameJa": "スタディオ・オリンピコ・ディ・ローマ",
+    "localName": "Stadio Olimpico",
+    "localLanguage": "it",
+    "aliases": [
+        { "name": "Stadio Olimpico", "lang": "en", "kind": "wikipedia", "revision": 1376210332, "source": "en.wikipedia.org" },
+        { "name": "スタディオ・オリンピコ・ディ・ローマ", "lang": "ja", "kind": "wikipedia", "revision": 109745762, "source": "ja.wikipedia.org" },
+        { "name": "The Olimpico", "lang": "en", "kind": "nickname", "source": "en.wikipedia.org revision 1376210332" },
+        { "name": "スタディオ・オリンピコ", "lang": "ja", "kind": "nickname", "source": "ja.wikipedia.org revision 109745762" }
+    ],
+    "city": "Rome",
+    "country": "IT",
+    "lat": 41.93389,
+    "lon": 12.45472,
+    "status": "current",
+    "from": 1953,
+    "capacity": 70634,
+    "pitchSize": "published",
+    "pitch": { "length": 105, "width": 68, "unit": "m" },
+    "en": { "title": "Stadio Olimpico", "revision": 1376210332 },
+    "ja": { "title": "スタディオ・オリンピコ・ディ・ローマ", "revision": 109745762 },
+    "tournaments": [
+        { "competition": "world-cup", "year": 1990, "final": true }
+    ],
+};

package/dist/grounds/stadium-australia.data.d.ts

@@ -0,0 +1,2 @@
+import type { GroundData } from "../grounds.core.ts";
+export declare const GROUND: GroundData;

package/dist/grounds/stadium-australia.data.js

@@ -0,0 +1,31 @@
+export const GROUND = {
+    "id": "stadium-australia",
+    "wikidata": "Q295886",
+    "name": "Stadium Australia",
+    "names": [
+        { "name": "Sydney Olympic Stadium", "from": 1999, "to": 2001 },
+        { "name": "Telstra Stadium", "from": 2002, "to": 2007 },
+        { "name": "ANZ Stadium", "from": 2008, "to": 2020 },
+        { "name": "Sydney Olympic Stadium", "from": 2025, "to": 2025 }
+    ],
+    "nameJa": "スタジアム・オーストラリア",
+    "aliases": [
+        { "name": "Stadium Australia", "lang": "en", "kind": "wikipedia", "revision": 1377697688, "source": "en.wikipedia.org" },
+        { "name": "スタジアム・オーストラリア", "lang": "ja", "kind": "wikipedia", "revision": 109501020, "source": "ja.wikipedia.org" },
+        { "name": "Accor Stadium", "lang": "en", "kind": "sponsor", "from": 2020, "source": "en.wikipedia.org revision 1377697688" }
+    ],
+    "city": "Sydney",
+    "country": "AU",
+    "lat": -33.84722,
+    "lon": 151.06333,
+    "status": "current",
+    "from": 1999,
+    "capacity": 83000,
+    "pitchSize": "default",
+    "pitchNote": "The infobox gives 160 by 118 m, the oval, which is not a soccer pitch; not used.",
+    "en": { "title": "Stadium Australia", "revision": 1377697688 },
+    "ja": { "title": "スタジアム・オーストラリア", "revision": 109501020 },
+    "tournaments": [
+        { "competition": "womens-world-cup", "year": 2023, "final": true }
+    ],
+};

package/dist/grounds/stamford-bridge.data.d.ts

@@ -0,0 +1,2 @@
+import type { GroundData } from "../grounds.core.ts";
+export declare const GROUND: GroundData;

package/dist/grounds/stamford-bridge.data.js

@@ -0,0 +1,23 @@
+export const GROUND = {
+    "id": "stamford-bridge",
+    "wikidata": "Q171458",
+    "name": "Stamford Bridge",
+    "nameJa": "スタンフォード・ブリッジ",
+    "aliases": [
+        { "name": "Stamford Bridge (stadium)", "lang": "en", "kind": "wikipedia", "revision": 1380009353, "source": "en.wikipedia.org" },
+        { "name": "スタンフォード・ブリッジ", "lang": "ja", "kind": "wikipedia", "revision": 110730305, "source": "ja.wikipedia.org" },
+        { "name": "The Bridge", "lang": "en", "kind": "nickname", "source": "en.wikipedia.org revision 1380009353" }
+    ],
+    "city": "London",
+    "country": "GB",
+    "lat": 51.48167,
+    "lon": -0.19111,
+    "status": "current",
+    "from": 1877,
+    "capacity": 40044,
+    "pitchSize": "published",
+    "pitch": { "length": 112.64, "width": 73.82, "unit": "yd" },
+    "en": { "title": "Stamford Bridge (stadium)", "revision": 1380009353 },
+    "ja": { "title": "スタンフォード・ブリッジ", "revision": 110730305 },
+    "tournaments": [],
+};

package/dist/grounds/tianhe-stadium.data.d.ts

@@ -0,0 +1,2 @@
+import type { GroundData } from "../grounds.core.ts";
+export declare const GROUND: GroundData;

package/dist/grounds/tianhe-stadium.data.js

@@ -0,0 +1,29 @@
+export const GROUND = {
+    "id": "tianhe-stadium",
+    "wikidata": "Q929126",
+    "name": "Tianhe Stadium",
+    "nameJa": "天河体育中心体育場",
+    "readingJa": "てんがたいいくちゅうしんたいいくじょう",
+    "localName": "天河体育场",
+    "localLanguage": "zh",
+    "aliases": [
+        { "name": "Tianhe Stadium", "lang": "en", "kind": "wikipedia", "revision": 1372244015, "source": "en.wikipedia.org" },
+        { "name": "天河体育中心体育場", "lang": "ja", "kind": "wikipedia", "revision": 107400316, "source": "ja.wikipedia.org" },
+        { "name": "天河体育中心体育场", "lang": "zh", "kind": "official", "source": "en.wikipedia.org revision 1372244015" },
+        { "name": "天河体育场", "lang": "zh", "kind": "nickname", "source": "en.wikipedia.org revision 1372244015" }
+    ],
+    "city": "Guangzhou",
+    "country": "CN",
+    "lat": 23.14052,
+    "lon": 113.31934,
+    "status": "current",
+    "from": 1987,
+    "capacity": 54856,
+    "pitchSize": "published",
+    "pitch": { "length": 105, "width": 68, "unit": "m" },
+    "en": { "title": "Tianhe Stadium", "revision": 1372244015 },
+    "ja": { "title": "天河体育中心体育場", "revision": 107400316 },
+    "tournaments": [
+        { "competition": "womens-world-cup", "year": 1991, "final": true }
+    ],
+};

package/dist/grounds/tottenham-hotspur-stadium.data.d.ts

@@ -0,0 +1,2 @@
+import type { GroundData } from "../grounds.core.ts";
+export declare const GROUND: GroundData;

package/dist/grounds/tottenham-hotspur-stadium.data.js

@@ -0,0 +1,23 @@
+export const GROUND = {
+    "id": "tottenham-hotspur-stadium",
+    "wikidata": "Q55074091",
+    "name": "Tottenham Hotspur Stadium",
+    "nameJa": "トッテナム・ホットスパー・スタジアム",
+    "aliases": [
+        { "name": "Tottenham Hotspur Stadium", "lang": "en", "kind": "wikipedia", "revision": 1378659225, "source": "en.wikipedia.org" },
+        { "name": "トッテナム・ホットスパー・スタジアム", "lang": "ja", "kind": "wikipedia", "revision": 109835288, "source": "ja.wikipedia.org" },
+        { "name": "New White Hart Lane", "lang": "en", "kind": "nickname", "source": "en.wikipedia.org revision 1378659225" }
+    ],
+    "city": "London",
+    "country": "GB",
+    "lat": 51.60444,
+    "lon": -0.06639,
+    "status": "current",
+    "from": 2019,
+    "capacity": 62850,
+    "pitchSize": "published",
+    "pitch": { "length": 105, "width": 68, "unit": "m" },
+    "en": { "title": "Tottenham Hotspur Stadium", "revision": 1378659225 },
+    "ja": { "title": "トッテナム・ホットスパー・スタジアム", "revision": 109835288 },
+    "tournaments": [],
+};

package/dist/grounds/waldstadion-frankfurt.data.d.ts

@@ -0,0 +1,2 @@
+import type { GroundData } from "../grounds.core.ts";
+export declare const GROUND: GroundData;

package/dist/grounds/waldstadion-frankfurt.data.js

@@ -0,0 +1,38 @@
+export const GROUND = {
+    "id": "waldstadion-frankfurt",
+    "wikidata": "Q157273",
+    "name": "Deutsche Bank Park",
+    "names": [
+        { "name": "Waldstadion", "from": 1925, "to": 2005 },
+        { "name": "Commerzbank-Arena", "from": 2005, "to": 2020 },
+        { "name": "Neues Waldstadion", "from": 2005, "to": 2006 },
+        { "name": "FIFA World Cup Stadium Frankfurt", "from": 2006, "to": 2006 },
+        { "name": "FIFA Women's World Cup Stadium Frankfurt", "from": 2011, "to": 2011 }
+    ],
+    "nameJa": "ドイチェ・バンク・パルク",
+    "localName": "Deutsche Bank Park",
+    "localLanguage": "de",
+    "aliases": [
+        { "name": "Waldstadion (Frankfurt)", "lang": "en", "kind": "wikipedia", "revision": 1375755144, "source": "en.wikipedia.org" },
+        { "name": "ヴァルトシュタディオン", "lang": "ja", "kind": "wikipedia", "revision": 101381780, "source": "ja.wikipedia.org" },
+        { "name": "ドイチェ・バンク・パルク", "lang": "ja", "kind": "official", "source": "ja.wikipedia.org revision 101381780" },
+        { "name": "Waldstadion", "lang": "de", "kind": "nickname", "source": "Wikidata Q157273 P1448" },
+        { "name": "ヴァルトシュタディオン", "lang": "ja", "kind": "nickname", "source": "ja.wikipedia.org revision 101381780" }
+    ],
+    "city": "Frankfurt",
+    "country": "DE",
+    "lat": 50.06861,
+    "lon": 8.64528,
+    "status": "current",
+    "from": 1925,
+    "capacity": 60100,
+    "pitchSize": "published",
+    "pitch": { "length": 105, "width": 68, "unit": "m" },
+    "en": { "title": "Waldstadion (Frankfurt)", "revision": 1375755144 },
+    "ja": { "title": "ヴァルトシュタディオン", "revision": 101381780 },
+    "tournaments": [
+        { "competition": "world-cup", "year": 1974 },
+        { "competition": "world-cup", "year": 2006 },
+        { "competition": "womens-world-cup", "year": 2011, "final": true }
+    ],
+};

package/dist/grounds/wankdorf.data.d.ts

@@ -0,0 +1,2 @@
+import type { GroundData } from "../grounds.core.ts";
+export declare const GROUND: GroundData;

package/dist/grounds/wankdorf.data.js

@@ -0,0 +1,25 @@
+export const GROUND = {
+    "id": "wankdorf",
+    "wikidata": "Q676004",
+    "name": "Wankdorf Stadium",
+    "nameJa": "シュタディオン・ヴァンクドルフ",
+    "localName": "Wankdorfstadion",
+    "localLanguage": "de",
+    "aliases": [
+        { "name": "Wankdorf Stadium", "lang": "en", "kind": "wikipedia", "revision": 1372250401, "source": "en.wikipedia.org" },
+        { "name": "シュタディオン・ヴァンクドルフ (1925年)", "lang": "ja", "kind": "wikipedia", "revision": 107529969, "source": "ja.wikipedia.org" }
+    ],
+    "city": "Bern",
+    "country": "CH",
+    "lat": 46.96278,
+    "lon": 7.465,
+    "status": "past",
+    "from": 1925,
+    "to": 2001,
+    "pitchSize": "default",
+    "en": { "title": "Wankdorf Stadium", "revision": 1372250401 },
+    "ja": { "title": "シュタディオン・ヴァンクドルフ (1925年)", "revision": 107529969 },
+    "tournaments": [
+        { "competition": "world-cup", "year": 1954, "final": true }
+    ],
+};

package/dist/grounds/wembley-1923.data.d.ts

@@ -0,0 +1,2 @@
+import type { GroundData } from "../grounds.core.ts";
+export declare const GROUND: GroundData;

package/dist/grounds/wembley-1923.data.js

@@ -0,0 +1,28 @@
+export const GROUND = {
+    "id": "wembley-1923",
+    "wikidata": "Q43279",
+    "name": "Wembley Stadium (1923)",
+    "nameJa": "旧ウェンブリー・スタジアム",
+    "readingJa": "きゅうウェンブリー・スタジアム",
+    "aliases": [
+        { "name": "Wembley Stadium (1923)", "lang": "en", "kind": "wikipedia", "revision": 1374252171, "source": "en.wikipedia.org" },
+        { "name": "ウェンブリー・スタジアム (1923)", "lang": "ja", "kind": "wikipedia", "revision": 110336995, "source": "ja.wikipedia.org" },
+        { "name": "Empire Stadium", "lang": "en", "kind": "former", "source": "en.wikipedia.org revision 1374252171" },
+        { "name": "British Empire Exhibition Stadium", "lang": "en", "kind": "former", "source": "en.wikipedia.org revision 1374252171" },
+        { "name": "Old Wembley", "lang": "en", "kind": "nickname", "source": "en.wikipedia.org revision 1374252171" }
+    ],
+    "city": "London",
+    "country": "GB",
+    "lat": 51.55556,
+    "lon": -0.27972,
+    "status": "past",
+    "from": 1923,
+    "to": 2000,
+    "capacity": 82000,
+    "pitchSize": "default",
+    "en": { "title": "Wembley Stadium (1923)", "revision": 1374252171 },
+    "ja": { "title": "ウェンブリー・スタジアム (1923)", "revision": 110336995 },
+    "tournaments": [
+        { "competition": "world-cup", "year": 1966, "final": true }
+    ],
+};

package/dist/grounds/wembley.data.d.ts

@@ -0,0 +1,2 @@
+import type { GroundData } from "../grounds.core.ts";
+export declare const GROUND: GroundData;

package/dist/grounds/wembley.data.js

@@ -0,0 +1,25 @@
+export const GROUND = {
+    "id": "wembley",
+    "wikidata": "Q128468",
+    "name": "Wembley Stadium",
+    "nameJa": "ウェンブリー・スタジアム",
+    "aliases": [
+        { "name": "Wembley Stadium", "lang": "en", "kind": "wikipedia", "revision": 1379930582, "source": "en.wikipedia.org" },
+        { "name": "ウェンブリー・スタジアム", "lang": "ja", "kind": "wikipedia", "revision": 110350755, "source": "ja.wikipedia.org" },
+        { "name": "Wembley Stadium connected by EE", "lang": "en", "kind": "sponsor", "source": "en.wikipedia.org revision 1379930582" },
+        { "name": "The Home of Football", "lang": "en", "kind": "nickname", "source": "en.wikipedia.org revision 1379930582" },
+        { "name": "New Wembley", "lang": "en", "kind": "nickname", "source": "en.wikipedia.org revision 1379930582" }
+    ],
+    "city": "London",
+    "country": "GB",
+    "lat": 51.55556,
+    "lon": -0.27944,
+    "status": "current",
+    "from": 2007,
+    "capacity": 90000,
+    "pitchSize": "published",
+    "pitch": { "length": 115, "width": 74, "unit": "yd" },
+    "en": { "title": "Wembley Stadium", "revision": 1379930582 },
+    "ja": { "title": "ウェンブリー・スタジアム", "revision": 110350755 },
+    "tournaments": [],
+};

package/dist/grounds.core.d.ts

@@ -0,0 +1,108 @@
+import { type PlaceAlias } from "./names.ts";
+import type { Language } from "./types.ts";
+/** Where a ground's facts were read: an article of Wikipedia at a revision. */
+export interface GroundSource {
+    title: string;
+    revision: number;
+}
+/** The competitions a ground can have staged: the men's World Cup and the Women's. */
+export type GroundCompetition = "world-cup" | "womens-world-cup";
+/** A tournament a ground staged matches of. */
+export interface GroundTournament {
+    competition: GroundCompetition;
+    year: number;
+    /** The final was played here. */
+    final?: true;
+}
+/** A name a ground had for some years, first to last. */
+export interface GroundName {
+    name: string;
+    from: number;
+    to: number;
+}
+/** A soccer ground as the data gives it: the pitch is the size the article publishes, in the unit it publishes it in. */
+export interface GroundData {
+    /** The key: `maracana`. */
+    id: string;
+    /** The Wikidata item of the ground (`Q155174`), the key to join a ground to other data. */
+    wikidata: string;
+    /** The everyday name in English, the one English sports media use (`Reliant Stadium`, `San Siro`); the title of the English article is one of the `aliases`. */
+    name: string;
+    /**
+     * Names the ground had for some years, in order of time: where two share a year the later one is the name at the end of it,
+     * and an entry further down overrides one above it. A year in none of them has `name`.
+     */
+    names?: GroundName[];
+    /** The everyday name in Japanese (`日産スタジアム`, `マラカナン`), as Japanese media say it. */
+    nameJa: string;
+    /** The reading of `nameJa` in kana, given wherever `nameJa` has kanji (`にっさんスタジアム`). */
+    readingJa?: string;
+    /** The everyday name in the language of the place (`San Siro`, `Maracanã`, `日産スタジアム`); the grounds of English-speaking places have none. */
+    localName?: string;
+    /** The language of `localName`: `es`, `pt`, `de`, `ja`, ... */
+    localLanguage?: string;
+    /** Every other name, each with where it was read: the cited articles' titles (`wikipedia`, with the revision), the `official` name when it is not the everyday one, `sponsor` and `former` names with their years, `nickname`s. */
+    aliases?: PlaceAlias[];
+    city: string;
+    /** ISO 3166-1 alpha-2: `BR`. */
+    country: string;
+    /** Wikidata's coordinates of the ground (P625), in degrees. */
+    lat: number;
+    lon: number;
+    /** `current` stands and is open, `past` has been closed or pulled down. */
+    status: "current" | "past";
+    /** The year it opened, and for a past ground the year it closed. */
+    from?: number;
+    to?: number;
+    /** True where Wikidata lists athletics among the ground's sports (property P641): a running track lies round the pitch, which `drawKyogijo({ sport: "athletics", ground })` draws. Absent for a ground Wikidata says nothing of, which may still have one. */
+    track?: boolean;
+    /** Where `track` was read. */
+    trackSource?: string;
+    /** The first capacity the article's infobox gives, when it gives a number. */
+    capacity?: number;
+    /** `published` when the article gives the pitch's length and width, `default` when it does not: the ground is then drawn at the international 105 by 68 m. */
+    pitchSize: "published" | "default";
+    /** The published pitch, in the unit it was published in. */
+    pitch?: {
+        length: number;
+        width: number;
+        unit: "m" | "yd";
+    };
+    /** Why a size the article gives is not used, or what the article gives instead. */
+    pitchNote?: string;
+    note?: string;
+    /** The English article the facts were read from. */
+    en: GroundSource;
+    /** The Japanese article the name in Japanese was read from. */
+    ja: GroundSource;
+    /** The World Cups it staged matches of, among the grounds of this list. */
+    tournaments: GroundTournament[];
+}
+/** A ground, with its pitch in metres: the published size, or the international 105 by 68 m of a ground that has none. */
+export interface Ground extends Omit<GroundData, "pitch"> {
+    /** The pitch, goal line to goal line and touchline to touchline, in metres to the centimetre. */
+    pitch: {
+        length: number;
+        width: number;
+    };
+    /** The unit the article published the size in; `m` for a ground at the default size. */
+    pitchUnit: "m" | "yd";
+}
+/** Hold grounds for the drawing, under their keys (the pitch put into metres): a later one with a key replaces the earlier. Returns the grounds as held, in the order given. */
+export declare function registerGrounds(list: readonly GroundData[]): Ground[];
+/** The ground held under a key, or `undefined`: what the drawing reads when it is given a ground. */
+export declare const heldGround: (id: string | undefined) => Ground | undefined;
+/** The name a ground officially has in a language, when it is not the everyday name (`Parc Olympique Lyonnais` for `Groupama Stadium`), in the year given or today; else `undefined`. */
+export declare function groundOfficialName(ground: Ground, language?: Language, year?: number): string | undefined;
+/**
+ * A ground's name in a year: the name it had then, or its everyday name, in English. In Japanese there is one name for every year.
+ * @example
+ * ```ts
+ * import { GROUNDS, groundNameIn } from "@johnmorrisdotca/kyogijo-stadiums/grounds";
+ * console.log(groundNameIn(GROUNDS["soccer-city"], 2010), "/", groundNameIn(GROUNDS["soccer-city"], 2012));
+ * // Soccer City / FNB Stadium
+ * ```
+ */
+export declare function groundNameIn(ground: Ground, year?: number, language?: Language): string;
+/** The address of the revision of an article that a ground's facts were read from. */
+export declare function groundSourceUrl(source: GroundSource, language?: "en" | "ja"): string;

package/dist/grounds.core.js

@@ -0,0 +1,51 @@
+import { officialName } from "./names.js";
+const METRES_PER_YARD = 0.9144;
+const centimetres = (metres) => Math.round(metres * 100) / 100;
+const toGround = (data) => {
+    const { pitch, ...rest } = data;
+    if (pitch === undefined)
+        return { ...rest, pitch: { length: 105, width: 68 }, pitchUnit: "m" };
+    const k = pitch.unit === "yd" ? METRES_PER_YARD : 1;
+    return { ...rest, pitch: { length: centimetres(pitch.length * k), width: centimetres(pitch.width * k) }, pitchUnit: pitch.unit };
+};
+/** The grounds held for the drawing: the ones registered, by key. The full list (`grounds.ts`) registers every ground; `loadGround` (`venue-data.ts`) registers one. */
+const HELD = new Map();
+/** Hold grounds for the drawing, under their keys (the pitch put into metres): a later one with a key replaces the earlier. Returns the grounds as held, in the order given. */
+export function registerGrounds(list) {
+    return list.map((data) => {
+        const ground = toGround(data);
+        HELD.set(ground.id, ground);
+        return ground;
+    });
+}
+/** The ground held under a key, or `undefined`: what the drawing reads when it is given a ground. */
+export const heldGround = (id) => (id === undefined ? undefined : HELD.get(id));
+/** The name a ground officially has in a language, when it is not the everyday name (`Parc Olympique Lyonnais` for `Groupama Stadium`), in the year given or today; else `undefined`. */
+export function groundOfficialName(ground, language = "en", year) {
+    const shown = groundNameIn(ground, year, language);
+    // A name the ground had for some years (the one FIFA gave it for a World Cup) is not followed by what it is officially today.
+    if (year !== undefined && Number.isFinite(year) && language === "en" && shown !== ground.name)
+        return undefined;
+    return officialName(ground, language, shown, Number.isFinite(year) ? year : undefined);
+}
+/**
+ * A ground's name in a year: the name it had then, or its everyday name, in English. In Japanese there is one name for every year.
+ * @example
+ * ```ts
+ * import { GROUNDS, groundNameIn } from "@johnmorrisdotca/kyogijo-stadiums/grounds";
+ * console.log(groundNameIn(GROUNDS["soccer-city"], 2010), "/", groundNameIn(GROUNDS["soccer-city"], 2012));
+ * // Soccer City / FNB Stadium
+ * ```
+ */
+export function groundNameIn(ground, year, language = "en") {
+    if (language === "ja")
+        return ground.nameJa;
+    if (year === undefined || !Number.isFinite(year))
+        return ground.name;
+    const periods = (ground.names ?? []).filter((period) => period.from <= year && year <= period.to);
+    return periods.length === 0 ? ground.name : periods[periods.length - 1].name;
+}
+/** The address of the revision of an article that a ground's facts were read from. */
+export function groundSourceUrl(source, language = "en") {
+    return `https://${language}.wikipedia.org/w/index.php?title=${encodeURIComponent(source.title.replace(/ /g, "_"))}&oldid=${source.revision}`;
+}

package/dist/grounds.d.ts

@@ -1,93 +1,6 @@
-import { type PlaceAlias } from "./names.ts";
-import type { Language } from "./types.ts";
-/** Where a ground's facts were read: an article of Wikipedia at a revision. */
-export interface GroundSource {
-    title: string;
-    revision: number;
-}
-/** The competitions a ground can have staged: the men's World Cup and the Women's. */
-export type GroundCompetition = "world-cup" | "womens-world-cup";
-/** A tournament a ground staged matches of. */
-export interface GroundTournament {
-    competition: GroundCompetition;
-    year: number;
-    /** The final was played here. */
-    final?: true;
-}
-/** A name a ground had for some years, first to last. */
-export interface GroundName {
-    name: string;
-    from: number;
-    to: number;
-}
-/** A soccer ground as the data gives it: the pitch is the size the article publishes, in the unit it publishes it in. */
-export interface GroundData {
-    /** The key: `maracana`. */
-    id: string;
-    /** The Wikidata item of the ground (`Q155174`), the key to join a ground to other data. */
-    wikidata: string;
-    /** The everyday name in English, the one English sports media use (`Reliant Stadium`, `San Siro`); the title of the English article is one of the `aliases`. */
-    name: string;
-    /**
-     * Names the ground had for some years, in order of time: where two share a year the later one is the name at the end of it,
-     * and an entry further down overrides one above it. A year in none of them has `name`.
-     */
-    names?: GroundName[];
-    /** The everyday name in Japanese (`日産スタジアム`, `マラカナン`), as Japanese media say it. */
-    nameJa: string;
-    /** The reading of `nameJa` in kana, given wherever `nameJa` has kanji (`にっさんスタジアム`). */
-    readingJa?: string;
-    /** The everyday name in the language of the place (`San Siro`, `Maracanã`, `日産スタジアム`); the grounds of English-speaking places have none. */
-    localName?: string;
-    /** The language of `localName`: `es`, `pt`, `de`, `ja`, ... */
-    localLanguage?: string;
-    /** Every other name, each with where it was read: the cited articles' titles (`wikipedia`, with the revision), the `official` name when it is not the everyday one, `sponsor` and `former` names with their years, `nickname`s. */
-    aliases?: PlaceAlias[];
-    city: string;
-    /** ISO 3166-1 alpha-2: `BR`. */
-    country: string;
-    /** Wikidata's coordinates of the ground (P625), in degrees. */
-    lat: number;
-    lon: number;
-    /** `current` stands and is open, `past` has been closed or pulled down. */
-    status: "current" | "past";
-    /** The year it opened, and for a past ground the year it closed. */
-    from?: number;
-    to?: number;
-    /** True where Wikidata lists athletics among the ground's sports (property P641): a running track lies round the pitch, which `drawKyogijo({ sport: "athletics", ground })` draws. Absent for a ground Wikidata says nothing of, which may still have one. */
-    track?: boolean;
-    /** Where `track` was read. */
-    trackSource?: string;
-    /** The first capacity the article's infobox gives, when it gives a number. */
-    capacity?: number;
-    /** `published` when the article gives the pitch's length and width, `default` when it does not: the ground is then drawn at the international 105 by 68 m. */
-    pitchSize: "published" | "default";
-    /** The published pitch, in the unit it was published in. */
-    pitch?: {
-        length: number;
-        width: number;
-        unit: "m" | "yd";
-    };
-    /** Why a size the article gives is not used, or what the article gives instead. */
-    pitchNote?: string;
-    note?: string;
-    /** The English article the facts were read from. */
-    en: GroundSource;
-    /** The Japanese article the name in Japanese was read from. */
-    ja: GroundSource;
-    /** The World Cups it staged matches of, among the grounds of this list. */
-    tournaments: GroundTournament[];
-}
-/** A ground, with its pitch in metres: the published size, or the international 105 by 68 m of a ground that has none. */
-export interface Ground extends Omit<GroundData, "pitch"> {
-    /** The pitch, goal line to goal line and touchline to touchline, in metres to the centimetre. */
-    pitch: {
-        length: number;
-        width: number;
-    };
-    /** The unit the article published the size in; `m` for a ground at the default size. */
-    pitchUnit: "m" | "yd";
-}
+import { groundNameIn, groundOfficialName, groundSourceUrl, type Ground, type GroundCompetition } from "./grounds.core.ts";
+export type { Ground, GroundCompetition, GroundData, GroundName, GroundSource, GroundTournament } from "./grounds.core.ts";
+export { groundNameIn, groundOfficialName, groundSourceUrl };
 /**
  * Every ground by its key: the venues of the men's World Cup finals and of the 2026 tournament, of the Women's World Cup finals,
  * and well-known club grounds, each with its pitch at its own size where the English article publishes one.
@@ -118,21 +31,7 @@ export declare const groundById: (id: string | undefined) => Ground | undefined;
 export declare const groundsByName: (name: string | undefined) => Ground[];
 /** The ground a name belongs to (see `groundsByName`; the best match when several answer to it), or `undefined`. */
 export declare const groundByName: (name: string | undefined) => Ground | undefined;
-/** The name a ground officially has in a language, when it is not the everyday name (`Parc Olympique Lyonnais` for `Groupama Stadium`), in the year given or today; else `undefined`. */
-export declare function groundOfficialName(ground: Ground, language?: Language, year?: number): string | undefined;
 /** The ground whose Wikidata item is `Q155174`, or `undefined`. */
 export declare const groundByWikidata: (wikidata: string | undefined) => Ground | undefined;
-/**
- * A ground's name in a year: the name it had then, or its everyday name, in English. In Japanese there is one name for every year.
- * @example
- * ```ts
- * import { GROUNDS, groundNameIn } from "@johnmorrisdotca/kyogijo-stadiums/grounds";
- * console.log(groundNameIn(GROUNDS["soccer-city"], 2010), "/", groundNameIn(GROUNDS["soccer-city"], 2012));
- * // Soccer City / FNB Stadium
- * ```
- */
-export declare function groundNameIn(ground: Ground, year?: number, language?: Language): string;
 /** The grounds of this list that staged matches of a World Cup, in the order of `GROUND_IDS`. */
 export declare const groundsHosting: (competition: GroundCompetition, year: number) => Ground[];
-/** The address of the revision of an article that a ground's facts were read from. */
-export declare function groundSourceUrl(source: GroundSource, language?: "en" | "ja"): string;

package/dist/grounds.data.d.ts

@@ -1,2 +1,2 @@
-import type { GroundData } from "./grounds.ts";
+import type { GroundData } from "./grounds.core.ts";
 export declare const GROUND_DATA: GroundData[];

package/dist/grounds.index.d.ts

@@ -0,0 +1,8 @@
+import type { GroundData } from "./grounds.core.ts";
+export declare const GROUND_INDEX: Readonly<Record<string, {
+    readonly name: string;
+    readonly nameJa: string;
+    readonly load: () => Promise<{
+        readonly GROUND: GroundData;
+    }>;
+}>>;