@johnmorrisdotca/kyogijo-stadiums 0.4.0 → 0.6.0

package/dist/grounds.data.js

@@ -298,6 +298,8 @@ export const GROUND_DATA = [
     {
         "id": "olympiastadion-munich",
         "wikidata": "Q131610",
+        "track": true,
+        "trackSource": "Wikidata, property P641 (sport) lists athletics",
         "name": "Munich Olympic Stadium",
         "nameJa": "ミュンヘン・オリンピアシュタディオン",
         "localName": "Olympiastadion München",
@@ -391,6 +393,8 @@ export const GROUND_DATA = [
     {
         "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 },
@@ -450,6 +454,8 @@ export const GROUND_DATA = [
     {
         "id": "stade-de-france",
         "wikidata": "Q13205",
+        "track": true,
+        "trackSource": "Wikidata, property P641 (sport) lists athletics",
         "name": "Stade de France",
         "nameJa": "スタッド・ド・フランス",
         "localName": "Stade de France",
@@ -476,6 +482,8 @@ export const GROUND_DATA = [
     {
         "id": "nissan-stadium-yokohama",
         "wikidata": "Q116601",
+        "track": true,
+        "trackSource": "Wikidata, property P641 (sport) lists athletics",
         "name": "Nissan Stadium",
         "names": [
             { "name": "International Stadium Yokohama", "from": 1998, "to": 2004 }
@@ -570,6 +578,8 @@ export const GROUND_DATA = [
     {
         "id": "luzhniki",
         "wikidata": "Q202163",
+        "track": true,
+        "trackSource": "Wikidata, property P641 (sport) lists athletics",
         "name": "Luzhniki Stadium",
         "names": [
             { "name": "Central Lenin Stadium", "from": 1956, "to": 1992 }
@@ -1092,6 +1102,8 @@ export const GROUND_DATA = [
     {
         "id": "dignity-health-sports-park",
         "wikidata": "Q200684",
+        "track": true,
+        "trackSource": "Wikidata, property P641 (sport) lists athletics",
         "name": "Dignity Health Sports Park",
         "names": [
             { "name": "Home Depot Center", "from": 2003, "to": 2013 },

package/dist/halls.d.ts

@@ -0,0 +1,65 @@
+import type { PlaceAlias } from "./names.ts";
+import type { BudoSport, DojoSpec, BudoStyle } from "./types.ts";
+/** What is known of a surface's layout. `documented`: the floor, its size and its contest areas are from a source (the dohyō of the Association's rules). `count`: a source gives the number of mats, and the shape is plausible. `generic`: no source gives the size or the layout, and a plausible one is drawn. */
+export type HallBasis = "documented" | "count" | "generic";
+/** One surface a hall offers: a floor of a sport, with the options that draw it. */
+export interface HallSurface {
+    /** The key within the hall: `main-dojo`. */
+    id: string;
+    name: {
+        en: string;
+        ja: string;
+    };
+    sport: BudoSport;
+    /** The options (beyond `sport`) that draw it. */
+    options: {
+        league?: string;
+        budo?: BudoStyle;
+        dojo?: DojoSpec;
+    };
+    basis: HallBasis;
+    /** The number of mats (jō) a source gives for the floor, where it gives one. */
+    mats?: number;
+    /** What is known and what is drawn, in a sentence each. */
+    note: {
+        en: string;
+        ja: string;
+    };
+}
+/** A hall as the data gives it. */
+export interface Hall {
+    id: string;
+    name: string;
+    nameJa: string;
+    readingJa?: string;
+    aliases: readonly PlaceAlias[];
+    city: string;
+    country: string;
+    lat: number;
+    lon: number;
+    wikidata: string;
+    /** The first year of the institution or the building (the Kodokan's is its founding, 1882). */
+    from: number;
+    /** What the first year is, in a phrase. */
+    fromWhat: {
+        en: string;
+        ja: string;
+    };
+    /** The most the hall seats or holds, where a source gives it, and which source. */
+    capacity?: {
+        value: number;
+        source: string;
+    };
+    /** The competitions and events it is known for. */
+    leagues: readonly string[];
+    surfaces: readonly HallSurface[];
+    /** Keys of `LEAGUE_SOURCES` that its facts were read from. */
+    sources: readonly string[];
+    /** What is known of the hall that no surface says, in a sentence. */
+    note: {
+        en: string;
+        ja: string;
+    };
+}
+/** The halls, in the order of their surfaces' fame: the Kodokan, the Budokan, the Kokugikan, the Butokuden and the Budokwai. */
+export declare const HALLS: readonly Hall[];

package/dist/halls.js

@@ -0,0 +1,122 @@
+/** The Kodokan's main dojo as drawn: a square floor of 420 jō's area, four contest areas, the seat of honour, the banner, the wood and the gallery, in the two looks the owner's photographs show. The years of both are unknown. */
+const KODOKAN_MAIN = {
+    mats: { width: 26.4, length: 26.4 },
+    surround: 1,
+    areas: { across: 2, down: 2 },
+    dais: true,
+    banner: true,
+    balcony: true,
+    kamiza: "north",
+    eras: [
+        { name: "earlier", nameJa: "以前", from: null, to: null, look: "green-orange", outline: true },
+        { name: "current", nameJa: "現在", from: null, to: null, look: "yellow-green" },
+    ],
+};
+const wp = (name, lang, source) => ({ name, lang, kind: "wikipedia", source });
+const official = (name, lang, source) => ({ name, lang, kind: "official", source });
+/** The halls, in the order of their surfaces' fame: the Kodokan, the Budokan, the Kokugikan, the Butokuden and the Budokwai. */
+export const HALLS = Object.freeze([
+    {
+        id: "kodokan",
+        name: "Kodokan",
+        nameJa: "講道館",
+        readingJa: "こうどうかん",
+        aliases: [official("Kodokan Judo Institute", "en", "kdkjudo.org"), wp("Kōdōkan", "en", "Wikidata Q1165384 label"), official("講道館国際柔道センター", "ja", "kdkjudo.org 施設のご案内")],
+        city: "Tokyo",
+        country: "JP",
+        lat: 35.708,
+        lon: 139.75344,
+        wikidata: "Q1165384",
+        from: 1882,
+        fromWhat: { en: "founded by Kanō Jigorō (the International Judo Center, the building the dojos are in, was completed in 1984)", ja: "嘉納治五郎が創設（道場のある講道館国際柔道センターは1984年に完成）" },
+        leagues: [],
+        surfaces: [
+            { id: "main-dojo", name: { en: "Main dojo, 7th floor", ja: "大道場（7階）" }, sport: "dojo", options: { dojo: KODOKAN_MAIN }, basis: "count", mats: 420, note: { en: "420 jō on the 7th floor, four contest areas at once, with a gallery on the 8th that seats about 900. Per the owner's photographs: four contest areas in two rows, pale yellow mats on green safety bands and a green border, on a wood surround, a raised seat of honour with a dark banner at the front wall, a gallery on all four sides. The shape of the floor is not documented: a square of 26.4 m, the area of 420 jō, is drawn so that four areas of 8 m fit.", ja: "7階に420畳、同時に4面の試合ができ、8階に約900人が座れる見学席があります。提供された写真では、試合場が2列に4面並び、淡い黄色の畳の外側を緑の安全地帯と緑の縁取りが囲んでいます。周囲は板張りで、正面の上座には一段高い台と濃い色の垂れ幕があり、四方に見学席があります。床の形は資料にないので、420畳の広さにあたる26.4m四方の床に、8m四方の試合場4面が収まるように描いています。" } },
+            { id: "main-dojo-earlier", name: { en: "Main dojo, 7th floor (earlier colours)", ja: "大道場（7階・以前の色）" }, sport: "dojo", options: { dojo: { ...KODOKAN_MAIN, era: "earlier" } }, basis: "count", mats: 420, note: { en: "The same room in the colours of the owner's older photograph: all green mats, the four contest areas outlined by red-orange border mats. No source gives the years of either look, so the eras carry none.", ja: "提供された古い写真の色で描いた同じ部屋です。畳はすべて緑で、4面の試合場それぞれを赤橙色の縁の畳が囲んでいます。どちらの色だった時期も資料にないので、年は記していません。" } },
+            { id: "school-dojo", name: { en: "Judo School dojo, 6th floor", ja: "学校道場（6階）" }, sport: "dojo", options: { dojo: { jo: 240, look: "green-beige" } }, basis: "count", mats: 240, note: { en: "240 jō on the 6th floor; the shape is plausible.", ja: "6階に240畳。形は推定です。" } },
+            { id: "international-dojo", name: { en: "International dojo, 6th floor", ja: "国際部道場（6階）" }, sport: "dojo", options: { dojo: { jo: 192, look: "green-beige" } }, basis: "count", mats: 192, note: { en: "192 jō on the 6th floor; the shape is plausible.", ja: "6階に192畳。形は推定です。" } },
+            { id: "womens-dojo", name: { en: "Women's dojo, 5th floor", ja: "女子部道場（5階）" }, sport: "dojo", options: { dojo: { jo: 240, look: "green-beige" } }, basis: "count", mats: 240, note: { en: "240 jō on the 5th floor; the shape is plausible.", ja: "5階に240畳。形は推定です。" } },
+            { id: "boys-dojo", name: { en: "Boys' dojo, 5th floor", ja: "少年部道場（5階）" }, sport: "dojo", options: { dojo: { jo: 114, look: "green-beige" } }, basis: "count", mats: 114, note: { en: "114 jō on the 5th floor; the shape is plausible.", ja: "5階に114畳。形は推定です。" } },
+        ],
+        sources: ["kodokan-facilities", "wikipedia-kodokan", "wikipedia-halls"],
+        note: { en: "The Kodokan moved to Kasuga, Bunkyō, in 1958. The Bunkyō ward's page counts the main dojo as 510 jō; the Kodokan's own page says 420, as English Wikipedia does (which also gives 1,206 mats in the five dojos, the sum of the five counts). The 5th floor also has a dojo for special techniques, with no count given, and it is not drawn.", ja: "講道館は1958年に文京区春日に移りました。文京区のページは大道場を510畳としていますが、講道館自身のページは420畳で、English Wikipediaも同じです（5つの道場の畳の合計は1,206畳としていて、これは5つの数の合計です）。5階には特殊技術のための道場もありますが、畳の数が示されていないので描いていません。" },
+    },
+    {
+        id: "nippon-budokan",
+        name: "Nippon Budokan",
+        nameJa: "日本武道館",
+        readingJa: "にっぽんぶどうかん",
+        aliases: [official("Budokan", "en", "Wikidata Q386246"), wp("Nippon Budōkan", "en", "Wikidata Q386246 label")],
+        city: "Tokyo",
+        country: "JP",
+        lat: 35.693333,
+        lon: 139.75,
+        wikidata: "Q386246",
+        from: 1964,
+        fromWhat: { en: "opened on 3 October 1964, the venue of the Olympic judo that month", ja: "1964年10月3日に開館、その月の東京オリンピックの柔道会場" },
+        capacity: { value: 14501, source: "budokan-overview" },
+        leagues: ["Olympic Games 1964", "Olympic Games 2020", "All Japan Judo Championships", "All Japan Karate Championships"],
+        surfaces: [
+            { id: "judo-games", name: { en: "Judo at the Olympic Games, two contest areas", ja: "オリンピックの柔道（試合場2面）" }, sport: "judo", options: { league: "ijf", budo: { hall: "budokan", areas: 2, platform: true, officials: true } }, basis: "generic", note: { en: "The arena is an octagon 55 m across the flats (2,513 m²). That the Games laid mats on a raised platform is reported; how many contest areas, and their colours, were not found: two areas of 10 m on a platform are drawn.", ja: "アリーナは対辺55mの正八角形（2,513㎡）です。大会で畳を台の上に敷いたことは報じられていますが、試合場の数と色は分かりませんでした。10mの試合場2面を台の上に描いています。" } },
+            { id: "judo-championships", name: { en: "All Japan Judo Championships, one contest area", ja: "全日本柔道選手権大会（試合場1面）" }, sport: "judo", options: { league: "ajjf", budo: { hall: "budokan" } }, basis: "generic", note: { en: "The Championships are held at the Budokan on 29 April. The layout of the mats is not documented: one contest area with the AJJF's red danger zone is drawn.", ja: "選手権は4月29日に日本武道館で開かれます。畳の配置は分からないので、全柔連の赤い危険地帯のある試合場1面を描いています。" } },
+            { id: "karate", name: { en: "Karate at the Olympic Games", ja: "オリンピックの空手道" }, sport: "karate", options: { league: "wkf-kumite", budo: { hall: "budokan", officials: true } }, basis: "generic", note: { en: "Karate was held at the Budokan at the 2020 Games. The number of competition areas was not found: one WKF kumite area is drawn in the middle of the arena.", ja: "2020年大会では空手道が日本武道館で行われました。試合場の数は分からないので、アリーナの中央に世界空手連盟の組手の試合場1面を描いています。" } },
+            { id: "kendo", name: { en: "Kendo, one shiai-jo", ja: "剣道（試合場1面）" }, sport: "kendo", options: { budo: { hall: "budokan", size: 11 } }, basis: "generic", note: { en: "Kendo's national championships are held at the Budokan. The size of the shiai-jo used was not found: one of 11 m, the greatest the regulations allow, is drawn in the middle of the arena.", ja: "剣道の全国大会は日本武道館で開かれます。使う試合場の大きさは分からないので、規則が認める最大の11m四方を中央に描いています。" } },
+        ],
+        sources: ["budokan-overview", "wikipedia-halls"],
+        note: { en: "The Budokan's own leaflet gives a maximum of 14,501 people; Wikidata and English Wikipedia give 14,471.", ja: "日本武道館のリーフレットは最大収容数を14,501人とし、WikidataとEnglish Wikipediaは14,471人としています。" },
+    },
+    {
+        id: "ryogoku-kokugikan",
+        name: "Ryōgoku Kokugikan",
+        nameJa: "両国国技館",
+        readingJa: "りょうごくこくぎかん",
+        aliases: [wp("Ryōgoku Kokugikan", "en", "Wikidata Q176821 label"), official("Kokugikan", "en", "Wikidata Q176821")],
+        city: "Tokyo",
+        country: "JP",
+        lat: 35.696944,
+        lon: 139.793333,
+        wikidata: "Q176821",
+        from: 1985,
+        fromWhat: { en: "opened on 9 January 1985", ja: "1985年1月9日に開館" },
+        capacity: { value: 11098, source: "wikipedia-halls" },
+        leagues: ["Grand Sumo Tournament"],
+        surfaces: [{ id: "dohyo", name: { en: "The dohyō", ja: "土俵" }, sport: "sumo", options: { budo: { tassels: true } }, basis: "documented", note: { en: "The clay square of 6.7 m and the ring of 4.55 m are the Association's own figures (Sumo Rules, Dohyō Regulations, Article 1); the Kokugikan holds the Tokyo tournaments in January, May and September, and its ring is movable.", ja: "一辺6.7mの土の正方形と直径4.55mの円は日本相撲協会の規則（相撲規則 土俵規定 第一条）の数値です。国技館では1月、5月、9月の東京場所が開かれ、土俵は移動式です。" } }],
+        sources: ["jsa-dohyo", "jsa-quiz", "wikipedia-halls"],
+        note: { en: "The Kokugikan seats 11,098 (Wikidata, English Wikipedia).", ja: "国技館の収容人数は11,098人です（Wikidata、English Wikipedia）。" },
+    },
+    {
+        id: "kyu-butokuden",
+        name: "Kyū Butokuden",
+        nameJa: "旧武徳殿",
+        readingJa: "きゅうぶとくでん",
+        aliases: [wp("Butokuden", "en", "Wikidata Q1017987 label"), official("Kyoto Butokuden", "en", "Wikidata Q1017987"), official("京都市武道センター旧武徳殿", "ja", "Wikidata Q1017987")],
+        city: "Kyoto",
+        country: "JP",
+        lat: 35.016389,
+        lon: 135.780833,
+        wikidata: "Q1017987",
+        from: 1899,
+        fromWhat: { en: "built as a hall for martial arts by the Dai Nippon Butokukai, designed by Matsumuro Shigemitsu; an Important Cultural Property since 1996", ja: "大日本武徳会が演武場として造営、設計は松室重光、1996年に国の重要文化財に指定" },
+        leagues: [],
+        surfaces: [{ id: "hall", name: { en: "The hall", ja: "旧武徳殿の床" }, sport: "dojo", options: { dojo: { jo: 100, look: "green-beige", kamiza: "north", shinzen: true, balcony: true } }, basis: "generic", note: { en: "The hall seats 1,200 and is part of the Kyoto Municipal Budo Center. The size of its floor and its mats were not found in a source: a floor of 100 jō is drawn as plausible.", ja: "旧武徳殿の座席は1,200席で、京都市武道センターの施設の一つです。床の大きさと畳の数は資料で確認できなかったので、100畳の床を推定して描いています。" } }],
+        sources: ["butokuden-ja"],
+        note: { en: "The hall was requisitioned after 1946 and used by the city's police school and art college, and is now a facility of the Kyoto Municipal Budo Center.", ja: "1946年以降は接収され、京都市警察学校や京都市立芸術大学が使い、今は京都市武道センターの施設です。" },
+    },
+    {
+        id: "budokwai",
+        name: "The Budokwai",
+        nameJa: "ブドクワイ",
+        aliases: [wp("Budokwai", "en", "Wikidata Q3646473 label")],
+        city: "London",
+        country: "GB",
+        lat: 51.4867,
+        lon: -0.180556,
+        wikidata: "Q3646473",
+        from: 1918,
+        fromWhat: { en: "opened on 26 January 1918 by Gunji Koizumi, at 15 Lower Grosvenor Place; at 4 Gilston Road since 1954", ja: "1918年1月26日に小泉軍治が開設（最初はロウアー・グロブナー・プレイス15番地）、1954年から現在のギルストン・ロード4番地" },
+        leagues: [],
+        surfaces: [{ id: "dojo", name: { en: "The dojo", ja: "道場" }, sport: "dojo", options: { dojo: { jo: 50, look: "green-beige" } }, basis: "generic", note: { en: "The size of the dojo and the number of its mats were not found in a source: a floor of 50 jō is drawn as plausible.", ja: "道場の大きさと畳の数は資料で確認できなかったので、50畳の床を推定して描いています。" } }],
+        sources: ["wikipedia-halls"],
+        note: { en: "A British martial arts club, read from English Wikipedia and Wikidata.", ja: "英国の武道クラブです。English WikipediaとWikidataによります。" },
+    },
+]);

package/dist/hardwood.d.ts

@@ -0,0 +1,31 @@
+import type { CourtStyle } from "./types.ts";
+/** The options of a hardwood floor, read: every part has its value. */
+export interface Hardwood {
+    seed: number;
+    /** True for the seams, ends, grain, soft shadows, table and benches; false for broad boards and one shadow. */
+    fine: boolean;
+    /** The width of a board, in feet. */
+    board: number;
+    stain: number;
+    sheen: number;
+    hoops: boolean;
+    bench: boolean;
+}
+/** The width of a drawing in pixels when the options say it (`480` or `"480px"`), else `undefined` (a percentage or an em says nothing of the screen). */
+export declare function pixelWidth(width: unknown): number | undefined;
+/** The width in pixels under which a drawing is a thumbnail, and its boards a blur: the `auto` detail is `plain` below it. */
+export declare const HARDWOOD_SMALL = 480;
+/** The hardwood the options ask for, or `undefined` for the usual clean floor. `simple` is the drawing's `detail: "simple"`; `width` its `width` option. */
+export declare function resolveHardwood(court: CourtStyle | undefined, simple: boolean, width: unknown): Hardwood | undefined;
+/** A small, fast generator (mulberry32): the same seed gives the same numbers on every machine. */
+export declare function generator(seed: number): () => number;
+/** The width of a tile, in feet: longer than any court of the package, so that the boards do not repeat along it. */
+export declare const TILE = 96;
+/** The two tiles of a floor and the size they are laid at: the tones and grain (under the paint) and the seams and ends (over it). */
+export declare function floorTiles(h: Hardwood): {
+    height: number;
+    under: string;
+    over: string;
+};
+/** The rules of the hardwood floor's classes, written into a drawing that has one (and in `KYOGIJO_STYLE`, for a page that supplies the stylesheet). */
+export declare const KYOGIJO_HARDWOOD_STYLE: string;

package/dist/hardwood.js

@@ -0,0 +1,157 @@
+// The realistic basketball floor (`court.hardwood`): the options read once, and the boards. A maple strip floor is laid in boards of one width that run the length of the
+// court, each row's boards ending at different places so that no two neighbours' ends line up; each board has a tone of its own and a little grain. All of it is made here
+// from a seed with a small generator of our own (no `Math.random`), so the same options give the same floor, and it is written as two tiles of a pattern (the tones and
+// grain under the paint, the seams and ends over it), so that the SVG holds a few shapes however large the court is. Written for this package from the way a strip floor
+// is laid; no photograph or other drawing was copied.
+import { el, num } from "./format.js";
+const finite = (value) => typeof value === "number" && Number.isFinite(value);
+const clamp = (value, low, high) => Math.min(high, Math.max(low, value));
+/** The width of a drawing in pixels when the options say it (`480` or `"480px"`), else `undefined` (a percentage or an em says nothing of the screen). */
+export function pixelWidth(width) {
+    if (finite(width))
+        return width > 0 ? width : undefined;
+    const match = typeof width === "string" ? /^\s*(\d+(?:\.\d+)?)(?:px)?\s*$/.exec(width) : null;
+    return match === null ? undefined : Number(match[1]);
+}
+/** The width in pixels under which a drawing is a thumbnail, and its boards a blur: the `auto` detail is `plain` below it. */
+export const HARDWOOD_SMALL = 480;
+/** The hardwood the options ask for, or `undefined` for the usual clean floor. `simple` is the drawing's `detail: "simple"`; `width` its `width` option. */
+export function resolveHardwood(court, simple, width) {
+    const given = court?.hardwood;
+    if (given === undefined || given === false)
+        return undefined;
+    const o = given === true ? {} : given;
+    const px = pixelWidth(width);
+    const fine = o.detail === "fine" || (o.detail !== "plain" && !simple && (px === undefined || px >= HARDWOOD_SMALL));
+    return {
+        seed: finite(o.seed) ? Math.trunc(o.seed) : 1,
+        fine,
+        board: clamp(finite(o.board) ? o.board : 2.25, 1.5, 6) / 12,
+        stain: clamp(finite(o.stain) ? o.stain : 0.82, 0.3, 1),
+        sheen: clamp(finite(o.sheen) ? o.sheen : 1, 0, 1.5),
+        hoops: o.hoops !== false,
+        bench: o.bench !== false && fine,
+    };
+}
+/** A small, fast generator (mulberry32): the same seed gives the same numbers on every machine. */
+export function generator(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a = (a + 0x6d2b79f5) >>> 0;
+        let t = a;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/** The width of a tile, in feet: longer than any court of the package, so that the boards do not repeat along it. */
+export const TILE = 96;
+const WARM = "#fff0c4";
+const DEEP = "#4a280b";
+const TONES = [
+    { colour: WARM, opacity: 0.19, upTo: 90 },
+    { colour: WARM, opacity: 0.1, upTo: 310 },
+    { colour: DEEP, opacity: 0.1, upTo: 520 },
+    { colour: DEEP, opacity: 0.2, upTo: 640 },
+];
+/** The least two ends of boards in neighbouring rows come to one another, in feet. */
+const APART = 1.2;
+/** True when an end at `x` is within `APART` of any end of the rows given, going round the tile. */
+const near = (x, rows) => rows.some((row) => row?.some((end) => {
+    const d = Math.abs(x - end) % TILE;
+    return Math.min(d, TILE - d) < APART;
+}) === true);
+/** An end moved on, a little at a time, until it is clear of the ends of the rows next to it (and of its own row's, `own`). */
+function clear(x, rows, own, least) {
+    let at = x;
+    for (let tries = 0; tries < 40 && (near(at, rows) || own.some((end) => Math.abs(at - end) < least)); tries += 1)
+        at += 0.6;
+    return at;
+}
+/**
+ * The rows of boards of a tile: for each row the places its boards end, going round the tile. A row's ends are at random distances apart, between `lengths`, and are
+ * moved on until none is within a foot of an end in the row above or the one above that, as boards are laid so that no joint lines up with a neighbour's.
+ */
+function rows(count, lengths, next) {
+    const [low, high] = lengths;
+    const made = [];
+    for (let r = 0; r < count; r += 1) {
+        // The rows next to it: the two above, and for the last rows the first ones, which lie under them when the tile repeats.
+        const above = [made[r - 1], made[r - 2], ...(r >= count - 2 ? made.slice(0, r === count - 1 ? 2 : 1) : [])];
+        const start = next() * high;
+        const ends = [clear(start, above, [], low)];
+        for (let at = ends[0] + low + next() * (high - low); at < start + TILE - low * 0.6; at += low + next() * (high - low)) {
+            const placed = clear(at, above, ends, low * 0.6);
+            ends.push(placed);
+            at = placed;
+        }
+        made.push(ends.map((end) => end % TILE).sort((x, y) => x - y));
+    }
+    return made;
+}
+/** A number for a path: one decimal, no leading zero's loss (`.5`), never `-0`. */
+const n1 = (value) => {
+    const text = (Math.round(value * 10) / 10).toString();
+    return text === "-0" ? "0" : text;
+};
+/** The pieces of one row's board between two ends, going round the tile: one piece, or two when the board crosses its edge. */
+function spans(from, to) {
+    return to > from ? [[from, to]] : [[from, TILE], [0, to]];
+}
+/** The two tiles of a floor and the size they are laid at: the tones and grain (under the paint) and the seams and ends (over it). */
+export function floorTiles(h) {
+    const next = generator(h.seed);
+    const pitch = h.fine ? h.board : h.board * 4;
+    const count = Math.max(4, Math.round(6 / pitch));
+    const height = count * pitch;
+    const ends = rows(count, h.fine ? [5, 12] : [10, 26], next);
+    // Each board's tone: a stroke across the whole width of its row, so that the rows meet with no gap.
+    const byTone = TONES.map(() => []);
+    ends.forEach((row, r) => {
+        const y = num((r + 0.5) * pitch);
+        for (let i = 0; i < row.length; i += 1) {
+            const pick = next() * 1000;
+            const tone = TONES.findIndex((t) => pick < t.upTo);
+            if (tone < 0)
+                continue;
+            for (const [a, b] of spans(row[i], row[(i + 1) % row.length]))
+                byTone[tone].push(`M${n1(a)} ${y}h${n1(b - a)}`);
+        }
+    });
+    let under = "";
+    TONES.forEach((tone, i) => {
+        if (byTone[i].length > 0)
+            under += el("path", { d: byTone[i].join(""), stroke: tone.colour, "stroke-opacity": tone.opacity, "stroke-width": num(pitch + 0.004), fill: "none" });
+    });
+    if (!h.fine)
+        return { height, under, over: "" };
+    // The grain: fine streaks along the boards, short and faint, a few of them bowed.
+    const grain = [];
+    for (let i = 0; i < 70; i += 1) {
+        const x = next() * TILE;
+        const y = (Math.floor(next() * count) + 0.15 + next() * 0.7) * pitch;
+        const length = 1.2 + next() * 5.5;
+        const bow = (next() - 0.5) * pitch * 0.5;
+        grain.push(i % 4 === 0 ? `M${n1(x)} ${num(y)}q${n1(length / 2)} ${num(bow)} ${n1(length)} 0` : `M${n1(x)} ${num(y)}h${n1(length)}`);
+    }
+    under += el("path", { d: grain.join(""), stroke: DEEP, "stroke-opacity": 0.2, "stroke-width": num(pitch * 0.09), fill: "none", "stroke-linecap": "round" });
+    // The seams between the boards and the butt joints where they end.
+    const seam = [];
+    for (let r = 0; r < count; r += 1)
+        seam.push(`M0 ${num(r * pitch)}H${TILE}`);
+    ends.forEach((row, r) => {
+        for (const x of row)
+            seam.push(`M${n1(x)} ${num(r * pitch)}v${num(pitch)}`);
+    });
+    const over = el("path", { d: seam.join(""), stroke: "#2a1506", "stroke-opacity": 0.3, "stroke-width": num(pitch * 0.17), fill: "none" });
+    return { height, under, over };
+}
+/** The rules of the hardwood floor's classes, written into a drawing that has one (and in `KYOGIJO_STYLE`, for a page that supplies the stylesheet). */
+export const KYOGIJO_HARDWOOD_STYLE = `
+.kyogijo .ky-hw-end-l{fill:var(--ky-hw-end-left,var(--ky-boards))}
+.kyogijo .ky-hw-end-r{fill:var(--ky-hw-end-right,var(--ky-boards))}
+.kyogijo .ky-hw-pad{fill:var(--ky-hw-pad,#2c333c);stroke:#fff;stroke-opacity:.2;stroke-width:.1}
+.kyogijo .ky-hw-arm{fill:var(--ky-hw-arm,#454d58);stroke:#fff;stroke-opacity:.15;stroke-width:.06}
+.kyogijo .ky-hw-glass{fill:#eef4f8;stroke:#7d8791;stroke-width:.06}
+.kyogijo .ky-hw-net{fill:none;stroke:#fff;stroke-opacity:.7}
+.kyogijo .ky-hw-furniture{fill:#7b838c;fill-opacity:.35;stroke:#7b838c;stroke-opacity:.35;stroke-width:.18;stroke-linejoin:round}`.trim();

package/dist/heat.js

@@ -7,7 +7,7 @@ import { FRAMES } from "./frames.js";
 import { resolveRamp, stepOf } from "./heat.colour.js";
 import { binGrid, contourRings, densityAt, densityGrid, gridValues, hexBins, hexCorners, massThresholds, needsValues, newBin, niceTicks, reduceBin, scottBandwidth, uniformEdges, } from "./heat.stats.js";
 import { buildZoneSet } from "./heat.zones.js";
-import { clamp01, isNum, newMade, opacityOf, place, placeBack, toArray, unitOfLayer } from "./layers.env.js";
+import { clamp01, isNum, markAttrs, newMade, opacityOf, place, placeBack, toArray, unitOfLayer } from "./layers.env.js";
 import { rampColour } from "./layers.marks.js";
 import { fill } from "./strings.js";
 import { textWidth } from "./text.js";
@@ -330,8 +330,8 @@ function formatter(percent, decimals) {
 }
 /** The legend's marks: a plate, the heading, the steps as a bar and the ticks. Laid out as the eye sees it, then placed on the surface and turned back when the surface is turned. */
 function legendMarks(env, spec) {
-    const box = env.shown;
-    const b = env.base;
+    const box = spec.region ?? env.shown;
+    const b = spec.region === undefined ? env.base : Math.max(box.w, box.h) * 0.013;
     const fs = b * 1.1;
     const barH = b * 1.3;
     const pad = b * 1;
@@ -483,7 +483,8 @@ export function drawHeat(layer, env, gid, known) {
         spec.levels.forEach((level, i) => {
             if (level.d === "")
                 return;
-            marks.push(spec.filled ? `<path class="ky-cf" style="fill:${fillOf(colours, i)}" fill-rule="evenodd" d="${level.d}"/>` : `<path class="ky-cl" style="stroke:${fillOf(colours, i)}" d="${level.d}"/>`);
+            const mark = env.marks ? ` data-mark-id="${i}" data-index="${i}"` : "";
+            marks.push(spec.filled ? `<path class="ky-cf" style="fill:${fillOf(colours, i)}" fill-rule="evenodd" d="${level.d}"${mark}/>` : `<path class="ky-cl" style="stroke:${fillOf(colours, i)}" d="${level.d}"${mark}/>`);
         });
         made.style = `--w:${num(env.base * (spec.filled ? 0.1 : 0.32))}`;
     }
@@ -491,20 +492,26 @@ export function drawHeat(layer, env, gid, known) {
         colours = coloursFor(layer, present);
         const step = (v) => stepOf(v, colours.domain, colours.steps);
         if (c.noun === "zones") {
-            for (const it of c.items) {
+            c.items.forEach((it, i) => {
                 const title = `<title>${esc(`${it.name ?? ""}${it.value === null ? "" : `: ${fmt(it.value)}`} (${it.n})`)}</title>`;
-                marks.push(`<path class="ky-zn" d="${it.d}" fill-rule="evenodd" style="fill:${it.value === null ? "none" : fillOf(colours, step(it.value))}">${title}</path>`);
-            }
+                const zone = it.id === undefined || !env.marks ? "" : ` data-mark-id="${esc(it.id)}" data-index="${i}" data-zone="${esc(it.id)}"`;
+                marks.push(`<path class="ky-zn" d="${it.d}" fill-rule="evenodd" style="fill:${it.value === null ? "none" : fillOf(colours, step(it.value))}"${zone}>${title}</path>`);
+            });
             made.style = `--w:${num(env.base * 0.12)}`;
         }
         else {
+            // Each cell is a path of its own, so that a listener can tell which one it was on; the cells of a colour share a group that holds the fill.
             const byStep = Array.from({ length: colours.steps }, () => []);
-            for (const it of c.items)
-                if (it.value !== null)
-                    byStep[step(it.value)].push(it.d);
+            const pointable = env.marks;
+            c.items.forEach((it, i) => {
+                if (it.value === null)
+                    return;
+                byStep[step(it.value)].push(pointable ? `<path d="${it.d}"${markAttrs(env, undefined, i, [it.cx, it.cy])}/>` : it.d);
+            });
             byStep.forEach((list, k) => {
-                if (list.length > 0)
-                    marks.push(`<path style="fill:${fillOf(colours, k)}" d="${list.join("")}"/>`);
+                if (list.length === 0)
+                    return;
+                marks.push(pointable ? `<g style="fill:${fillOf(colours, k)}">${list.join("")}</g>` : `<path style="fill:${fillOf(colours, k)}" d="${list.join("")}"/>`);
             });
         }
     }
@@ -518,6 +525,7 @@ export function drawHeat(layer, env, gid, known) {
             title: legend.title ?? c.stat,
             ticks: legend.ticks ?? 5,
             position: legend.position ?? (env.o.sport === "mlb" ? "bottom-right" : "bottom"),
+            region: legend.region,
             format: formatter(c.percent, undefined),
             at: contour === undefined || contour.levels.length > 6 ? undefined : contour.levels.map((l) => 100 * l.label),
         }));
@@ -566,7 +574,7 @@ export function drawLegend(layer, env, gid, known) {
     const title = typeof layer.name === "string" && layer.name.trim() !== "" ? layer.name.trim() : target?.stat ?? words.stat.custom;
     made.cls = "ky-hm";
     made.opacity = opacityOf(layer.opacity);
-    made.marks = legendMarks(env, { colours, title, ticks: layer.ticks ?? 5, position: layer.position ?? (env.o.sport === "mlb" ? "bottom-right" : "bottom"), format: formatter(percent, undefined) });
+    made.marks = legendMarks(env, { colours, title, ticks: layer.ticks ?? 5, position: layer.position ?? (env.o.sport === "mlb" ? "bottom-right" : "bottom"), region: layer.region, format: formatter(percent, undefined) });
     made.css = darkRules(colours, [gid]);
     made.title = fill(words.legendTitle, { name: title });
     made.text = fill(words.range, { min: formatter(percent, undefined)(colours.domain[0]), max: formatter(percent, undefined)(colours.domain[1]) });

package/dist/heat.types.d.ts

@@ -2,6 +2,7 @@ import type { HeatRamp } from "./heat.colour.ts";
 import type { HexOrientation, Reducer, StatisticName } from "./heat.stats.ts";
 import type { ZoneSetId } from "./heat.zones.ts";
 import type { LayerBase, MarkDatum } from "./layers.types.ts";
+import type { Box } from "./types.ts";
 export type { HeatRamp, HeatRampName } from "./heat.colour.ts";
 export type { HexOrientation, Reducer, StatisticName } from "./heat.stats.ts";
 export type { ZoneSetId } from "./heat.zones.ts";
@@ -33,6 +34,8 @@ export interface HeatLegend {
     ticks?: number;
     /** The opacity of the legend, 0 to 1. */
     opacity?: number;
+    /** Size and place the legend against this part of the surface, in feet in the drawing's frame (x along the surface, y across it), instead of the whole of what is shown: the half of a curling sheet that is drawn, say. */
+    region?: Box;
 }
 /** What the heat layers take beyond a layer's places. */
 export interface HeatBase extends LayerBase {
@@ -142,4 +145,6 @@ export interface LegendLayer extends Omit<LayerBase, "from" | "attacking" | "sur
     ticks?: number;
     /** The opacity of the legend, 0 to 1. */
     opacity?: number;
+    /** Size and place the legend against this part of the surface, as `HeatLegend.region` does. */
+    region?: Box;
 }

package/dist/heat.zones.d.ts

@@ -2,7 +2,7 @@ import type { Outline } from "./outline.ts";
 import type { KyogijoWords } from "./strings.ts";
 import type { Sport, SurfaceOptions } from "./types.ts";
 /** The zone sets. */
-export type ZoneSetId = "field-thirds" | "cricket-ground" | "soccer-positional" | "soccer-thirds" | "soccer-channels" | "soccer-18" | "nba-shot" | "nhl-slot" | "nhl-home-plate" | "baseball-spray" | "baseball-retrosheet" | "football-pass" | "curling-house" | "net-court";
+export type ZoneSetId = "field-thirds" | "cricket-ground" | "soccer-positional" | "soccer-thirds" | "soccer-channels" | "soccer-18" | "nba-shot" | "nhl-slot" | "nhl-home-plate" | "baseball-spray" | "baseball-retrosheet" | "football-pass" | "athletics-track" | "skating-track" | "budo-areas" | "curling-house" | "net-court" | "wall-court" | "roundnet-rings" | "pool-lanes" | "water-polo-areas" | "pool-thirds";
 type Pt = readonly [number, number];
 /** One zone: its shape on the surface and whether a point lies in it. */
 export interface ZoneShape {
@@ -30,7 +30,7 @@ export interface ZoneSet {
 }
 /** What a zone set needs to know about the drawing and the layer. */
 export interface ZoneContext {
-    o: Pick<SurfaceOptions, "sport" | "pitch" | "units"> & Partial<Pick<SurfaceOptions, "league" | "net" | "field">>;
+    o: Pick<SurfaceOptions, "sport" | "pitch" | "units"> & Partial<Pick<SurfaceOptions, "league" | "net" | "field" | "pool" | "athletics" | "skating" | "budo" | "dojo">>;
     outline: Outline;
     /** The way the team attacks as the surface is drawn wide: names the sides and counts the bands from the team's own end. `right` by default. */
     direction: "left" | "right";
@@ -49,6 +49,8 @@ export declare const ZONE_SETS: Readonly<Record<ZoneSetId, {
     source: string;
 }>>;
 export declare const ZONE_SET_IDS: readonly ZoneSetId[];
+/** The distance from home plate along a ray at `angle` (degrees, 0 straight out to centre field, negative to left) to the edge of the infield: the arc 95 feet round the pitcher's plate. */
+export declare function infieldReach(angle: number): number;
 /** The zones of a set on the surface the context describes. Throws for a set that is not for the surface's sport. */
 export declare function buildZoneSet(id: ZoneSetId, ctx: ZoneContext): ZoneSet;
 export {};