@johnmorrisdotca/kyogijo-stadiums 0.49.1 → 0.51.0

package/dist/circuits.style.d.ts

@@ -0,0 +1,5 @@
+/** The colours in light and in dark. */
+export declare const CIRCUIT_LIGHT = "--ky-ci-ground:#eceae3;--ky-ci-area:#dcd7cb;--ky-ci-area-edge:#bdb6a6;--ky-ci-building:#c2bbad;--ky-ci-building-edge:#7f786b;--ky-ci-track:#3a3f46;--ky-ci-edge:#ffffff;--ky-ci-halo:rgba(58,63,70,.16);--ky-ci-pit:#5d636b;--ky-ci-line:#ffffff;--ky-ci-check:#15181c;--ky-ci-arrow:#f2c230;--ky-ci-arrow-edge:#3a3f46;--ky-ci-badge:#14213d;--ky-ci-badge-ink:#ffffff;--ky-ci-leader:#14213d;--ky-ci-ink:#1f2320;--ky-ci-muted:#4b535c";
+export declare const CIRCUIT_DARK = "--ky-ci-ground:#10151b;--ky-ci-area:#1b232c;--ky-ci-area-edge:#334150;--ky-ci-building:#3a4756;--ky-ci-building-edge:#6f7f90;--ky-ci-track:#5d646e;--ky-ci-edge:#e6e9ed;--ky-ci-halo:rgba(230,233,237,.1);--ky-ci-pit:#7a838e;--ky-ci-line:#ffffff;--ky-ci-check:#0b0d10;--ky-ci-arrow:#f2c230;--ky-ci-arrow-edge:#10151b;--ky-ci-badge:#e9edf2;--ky-ci-badge-ink:#10151b;--ky-ci-leader:#c4ccd5;--ky-ci-ink:#eef1f4;--ky-ci-muted:#aab3bd";
+/** The rules of a circuit's drawing, and of the turn markers and the pit building of its 3D view (`.ky-turn`). */
+export declare const KYOGIJO_CIRCUIT_STYLE: string;

package/dist/circuits.style.js

@@ -0,0 +1,34 @@
+// The rules of a circuit's drawing and of what stands up in its 3D view, light and dark. The colours are custom properties (`--ky-ci-*`) a page can set; `:where` keeps their weight at nothing so that a page's own win. The
+// drawing follows the device and the page, and a `data-theme` of light or dark on it or on the page forces one. Nothing here is a team's, a race's or a sponsor's colour: asphalt, paint and paper.
+/** The colours in light and in dark. */
+export const CIRCUIT_LIGHT = "--ky-ci-ground:#eceae3;--ky-ci-area:#dcd7cb;--ky-ci-area-edge:#bdb6a6;--ky-ci-building:#c2bbad;--ky-ci-building-edge:#7f786b;--ky-ci-track:#3a3f46;--ky-ci-edge:#ffffff;--ky-ci-halo:rgba(58,63,70,.16);--ky-ci-pit:#5d636b;--ky-ci-line:#ffffff;--ky-ci-check:#15181c;--ky-ci-arrow:#f2c230;--ky-ci-arrow-edge:#3a3f46;--ky-ci-badge:#14213d;--ky-ci-badge-ink:#ffffff;--ky-ci-leader:#14213d;--ky-ci-ink:#1f2320;--ky-ci-muted:#4b535c";
+export const CIRCUIT_DARK = "--ky-ci-ground:#10151b;--ky-ci-area:#1b232c;--ky-ci-area-edge:#334150;--ky-ci-building:#3a4756;--ky-ci-building-edge:#6f7f90;--ky-ci-track:#5d646e;--ky-ci-edge:#e6e9ed;--ky-ci-halo:rgba(230,233,237,.1);--ky-ci-pit:#7a838e;--ky-ci-line:#ffffff;--ky-ci-check:#0b0d10;--ky-ci-arrow:#f2c230;--ky-ci-arrow-edge:#10151b;--ky-ci-badge:#e9edf2;--ky-ci-badge-ink:#10151b;--ky-ci-leader:#c4ccd5;--ky-ci-ink:#eef1f4;--ky-ci-muted:#aab3bd";
+/** The rules of a circuit's drawing, and of the turn markers and the pit building of its 3D view (`.ky-turn`). */
+export const KYOGIJO_CIRCUIT_STYLE = `
+:where(.ky-circuit,.ky-turn){${CIRCUIT_LIGHT}}
+@media (prefers-color-scheme:dark){:where(html:not([data-theme=light]) .ky-circuit:not([data-theme=light]),html:not([data-theme=light]) .ky-turn:not([data-theme=light])){${CIRCUIT_DARK}}}
+:where(html[data-theme=dark] .ky-circuit,.ky-circuit[data-theme=dark],html[data-theme=dark] .ky-turn,.ky-turn[data-theme=dark]){${CIRCUIT_DARK}}
+:where(.ky-circuit){--ky-font:system-ui,-apple-system,"Segoe UI","Hiragino Sans","Noto Sans JP",sans-serif;display:block;width:100%;height:auto;font-family:var(--ky-font)}
+.ky-circuit .ky-ci-ground{fill:var(--ky-ci-ground)}
+.ky-circuit .ky-ci-area{fill:var(--ky-ci-area);stroke:var(--ky-ci-area-edge);stroke-linejoin:round}
+.ky-circuit .ky-ci-building{fill:var(--ky-ci-building);stroke:var(--ky-ci-building-edge);stroke-linejoin:round}
+.ky-circuit .ky-ci-halo{fill:none;stroke:var(--ky-ci-halo);stroke-linejoin:round;stroke-linecap:round}
+.ky-circuit .ky-ci-edge{fill:none;stroke:var(--ky-ci-edge);stroke-linejoin:round;stroke-linecap:round}
+.ky-circuit .ky-ci-track{fill:none;stroke:var(--ky-ci-track);stroke-linejoin:round;stroke-linecap:round}
+.ky-circuit .ky-ci-pit{fill:none;stroke:var(--ky-ci-pit);stroke-linejoin:round;stroke-linecap:round}
+.ky-circuit .ky-ci-start{stroke:var(--ky-ci-line);stroke-linecap:butt}
+.ky-circuit .ky-ci-check-a{fill:var(--ky-ci-check)}
+.ky-circuit .ky-ci-check-b{fill:var(--ky-ci-line)}
+.ky-circuit .ky-ci-arrow{fill:var(--ky-ci-arrow);stroke:var(--ky-ci-arrow-edge);stroke-linejoin:round}
+.ky-circuit .ky-ci-leader{stroke:var(--ky-ci-leader);fill:none;stroke-linecap:round}
+.ky-circuit .ky-ci-badge,.ky-turn .u-ci-badge{fill:var(--ky-ci-badge);stroke:var(--ky-ci-ground)}
+.ky-circuit .ky-ci-badge-n,.ky-turn .u-ci-badge-n{fill:var(--ky-ci-badge-ink);font-family:var(--ky-font,system-ui,sans-serif);font-weight:800;text-anchor:middle;font-variant-numeric:tabular-nums}
+.ky-circuit .ky-ci-name{fill:var(--ky-ci-ink);font-family:var(--ky-font);font-weight:800}
+.ky-circuit .ky-ci-facts{fill:var(--ky-ci-muted);font-family:var(--ky-font);font-weight:700;font-variant-numeric:tabular-nums}
+.ky-circuit .ky-ci-north{fill:var(--ky-ci-ink);stroke:var(--ky-ci-ink);stroke-linejoin:round;stroke-linecap:round}
+.ky-circuit .ky-ci-north-n{fill:none;stroke:var(--ky-ci-ink);stroke-linejoin:round;stroke-linecap:round}
+.ky-circuit .ky-ci-scale{fill:none;stroke:var(--ky-ci-ink);stroke-linecap:butt}
+.ky-circuit .ky-ci-scale-fill{fill:var(--ky-ci-ink)}
+.ky-circuit .ky-ci-scale-text{fill:var(--ky-ci-ink);font-family:var(--ky-font);font-weight:700;font-variant-numeric:tabular-nums}
+.ky-circuit .ky-ci-credit{fill:var(--ky-ci-muted);font-family:var(--ky-font);font-weight:600}
+`.trim();

package/dist/circuits.turn.d.ts

@@ -0,0 +1,43 @@
+import type { CircuitOptions } from "./circuits.types.ts";
+import { type PresetTable } from "./turn.camera.ts";
+import { type KyogijoTurn } from "./turn.dom.ts";
+import { type TurnModel, type TurnSettings } from "./turn.model.ts";
+/**
+ * The four viewpoints of a circuit: straight down, the main camera high over the long side of the lap, the end-on view along it and the low corner. A lap is kilometres across and flat, so the eye is kept higher than
+ * a single surface's.
+ */
+export declare const CIRCUIT_PRESETS: PresetTable;
+/** The size of a turn's marker and the height of its post, in thousandths of the drawing's longer side (a marker, sized to be read: nothing of this size stands at a corner). */
+export declare const CIRCUIT_MARKER: Readonly<{
+    size: 30;
+    post: 22;
+}>;
+/** The most planes a circuit's 3D view may have: its markers (three planes each), its pit building and nothing else. A test holds every circuit to it. */
+export declare const CIRCUIT_PLANES_MAX = 120;
+/**
+ * A circuit as a 3D model: its drawing as the floor, the pit building standing on it at its mapped height, and a marker with each turn's number on a post over its bend. `settings.uprights: false` is the floor alone.
+ * A `TurnModel` like any other: `turnMarkupOf` and `mountCircuitTurn` make a view of it.
+ */
+export declare function buildCircuitTurn(options: CircuitOptions, settings?: TurnSettings): TurnModel;
+/**
+ * Mount a circuit as a 3D view in a container: the same view as `mountKyogijoTurn`'s, with the controls, the pointer, the keys and the auto-turn of every 3D view, over the circuit's drawing with its pit building and
+ * the turns' numbers standing up. Where the browser cannot turn it, the flat drawing is shown.
+ * @example
+ * ```ts no-run
+ * import { mountCircuitTurn } from "@johnmorrisdotca/kyogijo-stadiums/circuits";
+ * const view = mountCircuitTurn(document.querySelector("#lap")!, { circuit: "las-vegas" }, { preset: "corner" });
+ * view.set({ yaw: 40 });
+ * ```
+ */
+export declare function mountCircuitTurn(host: HTMLElement, options: CircuitOptions, settings?: TurnSettings): KyogijoTurn<CircuitOptions>;
+/**
+ * A circuit as the markup of a 3D view, still until a page's script makes it turn: pure, so a server can make it.
+ * @example
+ * ```ts
+ * import { circuitTurnMarkup } from "@johnmorrisdotca/kyogijo-stadiums/circuits";
+ * const html = circuitTurnMarkup({ circuit: "las-vegas" }, { preset: "broadcast" });
+ * console.log(html.includes('data-part="turn-17"'), html.includes("preserve-3d"));
+ * // true false
+ * ```
+ */
+export declare function circuitTurnMarkup(options: CircuitOptions, settings?: TurnSettings): string;

package/dist/circuits.turn.js

@@ -0,0 +1,119 @@
+// A circuit in 3D: the 3D view of `turn.ts` over the circuit's own drawing (`circuitDrawing`, its turns' badges left off the floor), with the pit building stood up at the height OpenStreetMap maps for it and each
+// turn's number on a post over its bend, turned to face the eye so that it is read from wherever the view is. Nothing is drawn a second way, and nothing moves by itself: the camera, the controls, the pointer, the
+// auto-turn (which waits for the reader and stops while the page is hidden or the view is out of sight) are every 3D view's. The model is a `TurnModel` of a few dozen planes; the floor is one SVG.
+import { circuitDrawing, circuitText } from "./circuits.draw.js";
+import { circuitOf } from "./circuits.js";
+import { CIRCUIT_WORDS } from "./circuits.words.js";
+import { blockPlanes, shellBlock } from "./context.js";
+import { hash, num } from "./format.js";
+import { FEET_PER_METRE as FT } from "./geometry.js";
+import { fill } from "./strings.core.js";
+import { TURN_PRESETS } from "./turn.camera.js";
+import { mountTurn } from "./turn.dom.js";
+import { plane, pole, thinnest } from "./turn.kit.js";
+import { turnMarkupOf } from "./turn.markup.js";
+import { WORLD_PX, openingView, sceneBox } from "./turn.model.js";
+import { planesOf } from "./uprights.js";
+/**
+ * The four viewpoints of a circuit: straight down, the main camera high over the long side of the lap, the end-on view along it and the low corner. A lap is kilometres across and flat, so the eye is kept higher than
+ * a single surface's.
+ */
+export const CIRCUIT_PRESETS = { overhead: TURN_PRESETS.overhead, broadcast: { yaw: 0, pitch: 58, zoom: 1 }, end: { yaw: -90, pitch: 62, zoom: 1 }, corner: { yaw: -35, pitch: 64, zoom: 1 } };
+/** The size of a turn's marker and the height of its post, in thousandths of the drawing's longer side (a marker, sized to be read: nothing of this size stands at a corner). */
+export const CIRCUIT_MARKER = Object.freeze({ size: 30, post: 22 });
+/** The most planes a circuit's 3D view may have: its markers (three planes each), its pit building and nothing else. A test holds every circuit to it. */
+export const CIRCUIT_PLANES_MAX = 120;
+/**
+ * A circuit as a 3D model: its drawing as the floor, the pit building standing on it at its mapped height, and a marker with each turn's number on a post over its bend. `settings.uprights: false` is the floor alone.
+ * A `TurnModel` like any other: `turnMarkupOf` and `mountCircuitTurn` make a view of it.
+ */
+export function buildCircuitTurn(options, settings = {}) {
+    const language = options.language === "ja" ? "ja" : "en";
+    // An unknown circuit throws here, naming the keys, before anything is drawn.
+    circuitOf(options.circuit);
+    const id = settings.id ?? (typeof options.id === "string" && options.id !== "" ? `${options.id}-turn` : `ky-turn-${hash(JSON.stringify([options, settings.preset]))}`);
+    const standUp = settings.uprights !== false;
+    // The floor: the drawing, its name left to the page and its turns' numbers standing up instead (on the floor too when nothing stands).
+    const drawn = circuitDrawing({ ...options, id: `${id}-floor`, label: false, turns: !standUp });
+    const plan = drawn.plan;
+    const { x: vx, y: vy, w: vw, h: vh } = drawn.viewBox;
+    const k = drawn.k;
+    const items = [];
+    if (standUp && plan.building !== undefined) {
+        const planes = blockPlanes(shellBlock("pit", plan.building.ring, plan.building.height, undefined), "pit-");
+        const [cx, cy] = plan.building.ring.reduce((s, p) => [s[0] + p[0] / plan.building.ring.length, s[1] + p[1] / plan.building.ring.length], [0, 0]);
+        items.push({ id: "pit-building", kind: "blocks", at: [cx, cy], height: plan.building.height, planes });
+    }
+    if (standUp) {
+        // Each turn's number on a post, over the badge's place beside the bend; the marker turns to face the eye and leans back to be read square on, and lies flat seen from above.
+        const size = CIRCUIT_MARKER.size * k;
+        const top = CIRCUIT_MARKER.post * k;
+        const marks = [];
+        for (const b of drawn.badges) {
+            const [x, y] = b.at;
+            const r = size / 2;
+            const svg = `<circle class="u-ci-badge" cx="${num(r)}" cy="${num(r)}" r="${num(r * 0.94)}" stroke-width="${num(r * 0.1)}"/><text class="u-ci-badge-n" x="${num(r)}" y="${num(r + r * 0.4)}" font-size="${num(r * (b.n >= 10 ? 1.05 : 1.25))}">${b.n}</text>`;
+            marks.push({ ...plane(`turn-${b.n}`, "sign", [x - r, y, top + size], [size, 0, 0], [0, 0, -size], svg), billboard: true, lean: true });
+            marks.push(...pole(`turn-${b.n}-post`, "pole", x, y, 0, top, thinnest(vw, vh), "u-pole"));
+        }
+        items.push({ id: "turns", kind: "flags", at: [(plan.box.x0 + plan.box.x1) / 2, (plan.box.y0 + plan.box.y1) / 2], height: top + size, planes: marks });
+    }
+    const area = plan.box;
+    const uprights = { items, lift: 0, thin: thinnest(vw, vh), area };
+    const planes = planesOf(uprights);
+    const scale = WORLD_PX / Math.max(vw, vh);
+    const centre = [(area.x0 + area.x1) / 2, (area.y0 + area.y1) / 2];
+    const w = CIRCUIT_WORDS[language];
+    const standing = !standUp ? "" : plan.building === undefined ? w.standingNoBuilding : fill(w.standing, { height: num(Math.round((plan.building.height / FT) * 10) / 10) });
+    const { title, description } = circuitText(plan, language, standing);
+    const surfaceLike = { sport: "circuit", language, ...(options.theme === undefined ? {} : { theme: options.theme }) };
+    return {
+        id,
+        language,
+        options: surfaceLike,
+        title,
+        description,
+        standing,
+        floor: drawn.svg,
+        viewBox: { x: vx, y: vy, w: vw, h: vh },
+        scale,
+        uprights,
+        defs: "",
+        crowdStyle: "",
+        venue: false,
+        look: undefined,
+        planes,
+        box: sceneBox(planes, area, 0, centre, scale),
+        centre,
+        view: openingView({ preset: "broadcast", ...settings }, CIRCUIT_PRESETS),
+        turnable: true,
+        presets: CIRCUIT_PRESETS,
+        flat: circuitDrawing(options).svg,
+    };
+}
+/**
+ * Mount a circuit as a 3D view in a container: the same view as `mountKyogijoTurn`'s, with the controls, the pointer, the keys and the auto-turn of every 3D view, over the circuit's drawing with its pit building and
+ * the turns' numbers standing up. Where the browser cannot turn it, the flat drawing is shown.
+ * @example
+ * ```ts no-run
+ * import { mountCircuitTurn } from "@johnmorrisdotca/kyogijo-stadiums/circuits";
+ * const view = mountCircuitTurn(document.querySelector("#lap")!, { circuit: "las-vegas" }, { preset: "corner" });
+ * view.set({ yaw: 40 });
+ * ```
+ */
+export function mountCircuitTurn(host, options, settings = {}) {
+    return mountTurn(host, options, settings, buildCircuitTurn);
+}
+/**
+ * A circuit as the markup of a 3D view, still until a page's script makes it turn: pure, so a server can make it.
+ * @example
+ * ```ts
+ * import { circuitTurnMarkup } from "@johnmorrisdotca/kyogijo-stadiums/circuits";
+ * const html = circuitTurnMarkup({ circuit: "las-vegas" }, { preset: "broadcast" });
+ * console.log(html.includes('data-part="turn-17"'), html.includes("preserve-3d"));
+ * // true false
+ * ```
+ */
+export function circuitTurnMarkup(options, settings = {}) {
+    return turnMarkupOf(buildCircuitTurn(options, settings), settings);
+}

package/dist/circuits.types.d.ts

@@ -0,0 +1,121 @@
+import type { LonLat } from "./venues.geo.ts";
+import type { Language } from "./types.ts";
+/** Whether a source says a fact (`documented`) or it is ours (`plausible`). */
+export type CircuitBasis = "documented" | "plausible";
+/** One fact, the source it was read from and in what words. */
+export interface CircuitFact<T> {
+    value: T;
+    basis: CircuitBasis;
+    /** Where it was read: `wikidata` (CC0), `wikipedia` (the article and revision of the record, CC BY-SA 4.0, in our own words) or `openstreetmap` (ODbL); missing for one of ours. */
+    source?: "wikidata" | "wikipedia" | "openstreetmap";
+    /** What was read, in our own words. */
+    read: string;
+}
+/** A circuit's facts: `scripts/circuits.data.json`, checked against the raw answers by `pnpm circuits`. */
+export interface CircuitData {
+    /** The key: kebab case. */
+    id: string;
+    /** The Wikidata item. */
+    wikidata: string;
+    /** The articles and the revisions read. */
+    en: {
+        title: string;
+        revision: number;
+    };
+    ja: {
+        title: string;
+        revision: number;
+    };
+    /** The circuit's name: Wikidata's labels. */
+    names: {
+        en: string;
+        ja: string;
+    };
+    /** The country, as its two-letter code (Wikidata's P17). */
+    country: string;
+    /** The day it opened, `yyyy-mm-dd`. */
+    opened: CircuitFact<string>;
+    /** The length of a lap, in metres, as published. */
+    length: CircuitFact<number>;
+    /** How many corners (turns) the lap has, as published. */
+    corners: CircuitFact<number>;
+    /** Which way the cars go round, seen from above. */
+    direction: CircuitFact<"clockwise" | "counterclockwise">;
+    /** The width of the track the ribbon is drawn at, in metres. */
+    width: CircuitFact<number>;
+    /** The width of the pit lane, in metres. */
+    pitLaneWidth: CircuitFact<number>;
+    /** Where the turns' numbers come from. */
+    turnNumbers: Omit<CircuitFact<never>, "value">;
+    /** Where the pit building comes from. */
+    pitBuilding: Omit<CircuitFact<never>, "value">;
+}
+/** A point of OpenStreetMap's that the drawing places: a turn, the start, the finish. */
+export interface CircuitOsmPoint {
+    /** The node, `node/<id>`. */
+    source: string;
+    at: LonLat;
+}
+/** What OpenStreetMap maps of a circuit (ODbL 1.0): `src/circuits.osm.data.ts`, apart from every other file. */
+export interface CircuitOsm {
+    /** The relation of the circuit, `relation/<id>`. */
+    source: string;
+    /** The day the answer was read, and the base of the data it was read from. */
+    read: string;
+    base: string;
+    licence: "ODbL-1.0";
+    attribution: string;
+    /** The lap: the relation's ways in the order and the direction it runs, joined into one ring, from the start, simplified to `tolerance` metres; longitude and latitude to six decimals. The first point is not repeated. */
+    lap: LonLat[];
+    /** How many points the lap had before it was simplified, and the tolerance it was simplified to, in metres. */
+    points: number;
+    tolerance: number;
+    /** The pit lane, as a line in the way it is driven. */
+    pitLane: {
+        source: string;
+        line: LonLat[];
+    };
+    /** The ground of the circuit (the area its owner holds: the paddock), as a ring. */
+    area: {
+        source: string;
+        ring: LonLat[];
+    };
+    /** The turns, in the order of the lap, each where OpenStreetMap puts its number. */
+    turns: (CircuitOsmPoint & {
+        n: number;
+    })[];
+    start: CircuitOsmPoint;
+    finish: CircuitOsmPoint;
+    /** The pit building beside the pit lane: its outline, its height in metres and its levels, as mapped. */
+    pitBuilding?: {
+        source: string;
+        ring: LonLat[];
+        height: number;
+        levels?: number;
+    };
+}
+/** A circuit: its facts and what OpenStreetMap maps of it. */
+export interface Circuit extends CircuitData {
+    osm: CircuitOsm;
+}
+/** The options of a circuit's drawing. */
+export interface CircuitOptions {
+    /** The circuit's key: `las-vegas`. */
+    circuit: string;
+    /** `en` (the default) or `ja`. */
+    language?: Language;
+    /** `light` or `dark` forces a theme; left out, the drawing follows the page and the device. */
+    theme?: "light" | "dark";
+    /** The name and the line of facts in the top corner: `true` (the default) or `false`. */
+    label?: boolean;
+    /** The turns' numbers: `true` (the default) or `false`. */
+    turns?: boolean;
+    /** The arrows that show which way the lap runs: `true` (the default) or `false`. */
+    arrows?: boolean;
+    /** The prefix of the ids inside the drawing, for a page with more than one; a hash of the options when missing. */
+    id?: string;
+    /** More classes on the root. */
+    className?: string;
+    /** `none` leaves the stylesheet out, for a page that puts `KYOGIJO_CIRCUIT_STYLE` in once. */
+    css?: "none";
+}

package/dist/circuits.types.js

@@ -0,0 +1 @@
+export {};

package/dist/circuits.words.d.ts

@@ -0,0 +1,47 @@
+import type { Language } from "./types.ts";
+/** What a circuit's pictures say. */
+export interface CircuitWords {
+    /** The title: the circuit's name. */
+    title: string;
+    /** The line under the name: the length and the number of turns. */
+    facts: string;
+    /** The description, sentence by sentence. */
+    lap: string;
+    counterclockwise: string;
+    clockwise: string;
+    turns: string;
+    pit: string;
+    building: string;
+    width: string;
+    /** What stands up in the 3D view. */
+    standing: string;
+    standingNoBuilding: string;
+    /** The credit of the data. */
+    credit: string;
+    /** A turn's number, for a screen reader. */
+    turn: string;
+    /** The scale bar's unit. */
+    metres: string;
+    /** The north arrow's name, for a screen reader. */
+    northArrow: string;
+    /** The table: its caption and its heads. */
+    table: {
+        caption: string;
+        fact: string;
+        value: string;
+        basis: string;
+        documented: string;
+        plausible: string;
+        length: string;
+        measured: string;
+        corners: string;
+        direction: string;
+        opened: string;
+        width: string;
+        pitLaneWidth: string;
+        wikidata: string;
+        counterclockwise: string;
+        clockwise: string;
+    };
+}
+export declare const CIRCUIT_WORDS: Readonly<Record<Language, CircuitWords>>;

package/dist/circuits.words.js

@@ -0,0 +1,38 @@
+export const CIRCUIT_WORDS = Object.freeze({
+    en: {
+        title: "{name}",
+        facts: "{km} km · {turns} turns",
+        lap: "A plan of {name}: a lap of {km} km, drawn on the ways OpenStreetMap maps for it (the line measures {measured} km).",
+        counterclockwise: "The lap runs counterclockwise, as the arrows show.",
+        clockwise: "The lap runs clockwise, as the arrows show.",
+        turns: "Its {turns} turns are numbered where OpenStreetMap numbers them, and the start and finish lines are drawn across the track.",
+        pit: "The pit lane runs beside the start.",
+        building: "The pit building stands beside the pit lane.",
+        width: "The track is drawn {width} m wide, which is ours: no source gives it.",
+        standing: "In 3D the pit building stands {height} m high, and each turn's number stands on a post.",
+        standingNoBuilding: "In 3D each turn's number stands on a post.",
+        credit: "Map data: {credit}.",
+        turn: "Turn {n}",
+        metres: "m",
+        northArrow: "North",
+        table: { caption: "{name}: the facts and where they come from", fact: "Fact", value: "Value", basis: "Basis", documented: "documented", plausible: "ours (plausible)", length: "Length of a lap", measured: "Length of the drawn line", corners: "Turns", direction: "Direction", opened: "Opened", width: "Track width drawn", pitLaneWidth: "Pit lane width drawn", wikidata: "Wikidata", counterclockwise: "counterclockwise", clockwise: "clockwise" },
+    },
+    ja: {
+        title: "{name}",
+        facts: "全長{km} km・{turns}コーナー",
+        lap: "{name}の平面図。1周{km} kmのコースを、OpenStreetMapに登録された道路に沿って描いています（描いた線の長さは{measured} km）。",
+        counterclockwise: "矢印のとおり、コースは反時計回りです。",
+        clockwise: "矢印のとおり、コースは時計回りです。",
+        turns: "{turns}か所のコーナーには、OpenStreetMapと同じ番号を同じ位置に記し、スタートラインとフィニッシュラインはコースを横切る線で描いています。",
+        pit: "ピットレーンはスタート地点の脇を通ります。",
+        building: "ピットビルはピットレーンの脇に建っています。",
+        width: "コース幅は{width} mで描いています。この値は独自のもので、出典はありません。",
+        standing: "3D表示では、ピットビルは高さ{height} mで建ち、各コーナーの番号はポールの上に掲げられます。",
+        standingNoBuilding: "3D表示では、各コーナーの番号はポールの上に掲げられます。",
+        credit: "地図データ：{credit}。",
+        turn: "ターン{n}",
+        metres: "m",
+        northArrow: "北",
+        table: { caption: "{name}：データとその出典", fact: "項目", value: "値", basis: "根拠", documented: "出典あり", plausible: "独自の値（妥当な推定）", length: "1周の長さ", measured: "描いた線の長さ", corners: "コーナー数", direction: "走行方向", opened: "開業", width: "描いたコース幅", pitLaneWidth: "描いたピットレーン幅", wikidata: "Wikidata", counterclockwise: "反時計回り", clockwise: "時計回り" },
+    },
+});

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnmorrisdotca/kyogijo-stadiums",
-  "version": "0.49.1",
+  "version": "0.51.0",
   "description": "Kyogijo Stadiums 競技場, 40 sports' surfaces as SVG, drawn to scale from the rulebooks: NFL, CFL and IFAF football fields, an NHL rink, an NBA court, MLB ballparks, soccer pitches, curling sheets, athletics stadiums, speed skating, short track and figure skating rinks, swimming pools, water polo fields, diving wells, artistic swimming areas, and the courts and fields of tennis, volleyball (indoor, beach and sitting), badminton, pickleball, table tennis, padel, squash, racquetball, sepak takraw, teqball, roundnet, netball, lacrosse, rugby, Australian football, Gaelic games, cricket, field hockey and handball, and the budo of judo, karate, kendo, sumo and kyudo with a dojo of tatami laid as real units, the MMA cage, with each team's name and logo on its side and the score in the middle, stands and a crowd, a pageant of flags, and a 3D view. Light and dark, accessible, a compact badge for lists, a helper for React and a custom element. Zero dependencies.",
   "keywords": [
     "sports",
@@ -287,11 +287,22 @@
       "import": "./dist/turn-entry.js",
       "default": "./dist/turn-entry.js"
     },
+    "./circuits": {
+      "types": "./dist/circuits-entry.d.ts",
+      "import": "./dist/circuits-entry.js",
+      "default": "./dist/circuits-entry.js"
+    },
     "./flythrough": {
       "types": "./dist/flythrough-entry.d.ts",
       "import": "./dist/flythrough-entry.js",
       "default": "./dist/flythrough-entry.js"
     },
+    "./catalogue": {
+      "types": "./dist/catalogue-entry.d.ts",
+      "import": "./dist/catalogue-entry.js",
+      "default": "./dist/catalogue-entry.js"
+    },
+    "./catalogue.json": "./catalogue.json",
     "./element/define": {
       "types": "./dist/element-define.d.ts",
       "import": "./dist/element-define.js",
@@ -303,7 +314,8 @@
     "README.md",
     "LICENSE",
     "NOTICE.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "catalogue.json"
   ],
   "engines": {
     "node": ">=22"
@@ -345,7 +357,11 @@
     "venues:rink": "node scripts/fetch-rink-evidence.mjs",
     "stadiums": "node scripts/build-stadiums.mjs",
     "stadiums:fetch": "node scripts/fetch-stadiums.mjs",
+    "catalogue": "node scripts/build-catalogue.mjs",
+    "catalogue:fetch": "node scripts/fetch-catalogue.mjs",
     "walk": "node scripts/build-walk.mjs",
+    "circuits": "node scripts/build-circuits.mjs",
+    "circuits:fetch": "node scripts/fetch-circuits.mjs",
     "osm-context": "node scripts/build-osm-context.mjs",
     "cityctx": "node scripts/build-cityctx.mjs",
     "cityctx:fetch": "node scripts/fetch-cityctx.mjs",