@johnmorrisdotca/kyogijo-stadiums 0.57.0 → 0.59.0

package/dist/context.d.ts

@@ -1,6 +1,7 @@
 import { type LonLat } from "./venues.geo.ts";
 import { type Plane, type Upright } from "./turn.kit.ts";
 import type { Pt } from "./crowd.ts";
+import { type ContextLandmark, type PlacedLandmark } from "./landmarks.ts";
 /** One layer of an area's data: its rows, and where they came from and under what terms, since a layer has a source of its own (buildings from PLATEAU; trees and land cover from another). */
 export interface ContextLayer {
     /** What it was made from: the dataset and its page. */
@@ -44,6 +45,11 @@ export interface ContextArea {
         trees?: ContextLayer;
         landCover?: ContextLayer;
     };
+    /** The most of this area's buildings the 3D view raises, when that is fewer than the tier's count (`CONTEXT_BLOCKS` at its best): a city of big, many-sided buildings (the casinos of the Las Vegas Strip) raises fewer, to stay within the
+     * district's budget of planes. Missing: the tier's count. */
+    blocks?: number;
+    /** The area's famous landmarks, each drawn by a shape of its own and named (`landmarks.ts`): the Sphere, the High Roller and the Fountains of Bellagio round the Las Vegas Strip Circuit. Missing: none. */
+    landmarks?: readonly ContextLandmark[];
 }
 /** One building as the district holds it: its outline in feet in the district's frame (x to the right, y down the page), its height and the rise of its roof in feet. */
 export interface ContextBlock {
@@ -91,6 +97,10 @@ export interface ContextPlan {
     trees?: ContextTree[];
     /** The buildings of the model that are a venue (the Dome's own parts), left out: the venue draws them. */
     owned: number;
+    /** The landmarks of the areas in the frame, each with its own shape; missing when the areas have none. */
+    landmarks?: PlacedLandmark[];
+    /** The most buildings the areas let the 3D view raise (the least of their `blocks`); missing when none sets it. */
+    most?: number;
     /** The credits of the areas used, in each language. */
     attribution: {
         en: string[];
@@ -172,6 +182,6 @@ export declare function slabPlanes(ring: readonly Pt[], level: number, thickness
     side: string;
 }, look: "chosen" | "faint" | "plain"): Plane[];
 /** The blocks of the 3D view: the `most` buildings that matter most (the tallest and widest, by height times the side of their ground), each a few planes, in the order the plan lists them. */
-export declare function contextUprights(plan: ContextPlan, most?: number): Upright[];
+export declare function contextUprights(plan: ContextPlan, asked?: number): Upright[];
 /** The building a raised venue stands in as a block: its outline in feet, its height, `xray` the middle of what is seen through its walls (none for a solid one). */
 export declare function shellBlock(key: string, ring: readonly Pt[], height: number, xray: Pt | undefined): ContextBlock;

package/dist/context.js

@@ -6,6 +6,7 @@ import { FEET_PER_METRE } from "./geometry.js";
 import { boxOf, hullOf, inside, metresFrom } from "./venues.geo.js";
 import { n, shy, wall } from "./turn.kit.js";
 import { pointList, raked } from "./venue.geom.js";
+import { landmarksFloor, ownedByLandmark, placeLandmarks, underLandmark } from "./landmarks.js";
 /** How many buildings are raised as blocks in the 3D view (the biggest and the tallest of those on the plan): the rest are the floor's own, flat. Every block is a few elements of the page. */
 export const CONTEXT_BLOCKS = 130;
 /** Feet of the plan's frame beyond the venues' buildings that a district with context shows, so that the streets round them are in it: 150 metres. */
@@ -79,6 +80,7 @@ export function placeContext(areas, origin, turn, frame, venues) {
     let owned = 0;
     const hulls = venues.map((v) => hullOf([...v.footprint]));
     const [fx0, fy0, fx1, fy1] = [frame.x, frame.y, frame.x + frame.w, frame.y + frame.h];
+    const landmarks = placeLandmarks(areas, origin, turn, frame);
     for (const area of areas) {
         const [east, north] = metresFrom(origin, [area.origin])[0];
         (area.layers.buildings?.rows ?? []).forEach((row, index) => {
@@ -96,6 +98,11 @@ export function placeContext(areas, origin, turn, frame, venues) {
                 owned += 1;
                 return;
             }
+            // A building that is a landmark's own (the Sphere's, drawn as a dome) is left out too.
+            if (ownedByLandmark(landmarks, ring)) {
+                owned += 1;
+                return;
+            }
             blocks.push({ id: `${area.key}-${index}`, ring, height: b.height * FEET_PER_METRE, rise: b.rise * FEET_PER_METRE, area: Math.abs(signedArea(ring)), ghost: holds, whole: box.x0 >= fx0 && box.x1 <= fx1 && box.y0 >= fy0 && box.y1 <= fy1 });
         });
     }
@@ -147,7 +154,8 @@ export function placeContext(areas, origin, turn, frame, venues) {
     // An empty credit (a layer whose credit another layer of the area has said) adds nothing.
     const layers = areas.flatMap((a) => Object.values(a.layers));
     const credits = (language) => [...new Set(layers.map((l) => l.attribution[language]).filter((text) => text !== ""))];
-    return { blocks, streets, land, trees, owned, attribution: { en: credits("en"), ja: credits("ja") } };
+    const most = areas.reduce((least, a) => (a.blocks === undefined ? least : Math.min(least, a.blocks)), Infinity);
+    return { blocks, streets, land, trees, owned, ...(landmarks.length === 0 ? {} : { landmarks }), ...(Number.isFinite(most) ? { most } : {}), attribution: { en: credits("en"), ja: credits("ja") } };
 }
 /** A share of the trees, spread evenly over the lot: every tree at 1, none at 0, and at 0.5 every other. The same trees every time, so that a view drawn again at a tier keeps the ones it kept. */
 export function thinTrees(trees, share) {
@@ -209,12 +217,12 @@ export function treesFloor(trees) {
 export function contextFloor(plan) {
     const under = `${landFloor(plan.land ?? [])}${streetsFloor(plan.streets ?? [])}${treesFloor(plan.trees ?? [])}`;
     if (plan.blocks.length === 0)
-        return under;
+        return `${under}${landmarksFloor(plan.landmarks ?? [])}`;
     const paths = [[], [], [], [], []];
     for (const b of plan.blocks)
         paths[b.ghost ? 4 : toneOf(b.height)].push(`M${b.ring.map(([x, y]) => `${num(x)} ${num(y)}`).join("L")}Z`);
     const classes = ["ky-dist-b0", "ky-dist-b1", "ky-dist-b2", "ky-dist-b3", "ky-dist-ghost"];
-    return `${under}<g class="ky-dist-context" aria-hidden="true">${paths.map((d, i) => (d.length === 0 ? "" : `<path class="ky-dist-block ${classes[i]}" d="${d.join("")}"/>`)).join("")}</g>`;
+    return `${under}<g class="ky-dist-context" aria-hidden="true">${paths.map((d, i) => (d.length === 0 ? "" : `<path class="ky-dist-block ${classes[i]}" d="${d.join("")}"/>`)).join("")}</g>${landmarksFloor(plan.landmarks ?? [])}`;
 }
 // ---- The blocks of the 3D view. ----
 /** How much a building matters to the view: tall and wide first. */
@@ -368,8 +376,14 @@ export function slabPlanes(ring, level, thickness, ids, look) {
     return planes;
 }
 /** The blocks of the 3D view: the `most` buildings that matter most (the tallest and widest, by height times the side of their ground), each a few planes, in the order the plan lists them. */
-export function contextUprights(plan, most = CONTEXT_BLOCKS) {
+export function contextUprights(plan, asked = CONTEXT_BLOCKS) {
+    const most = Math.min(asked, plan.most ?? Infinity);
     const wanted = new Set(plan.blocks.filter((b) => b.whole).sort((a, b) => weight(b) - weight(a) || (a.id < b.id ? -1 : 1)).slice(0, Math.max(0, most)).map((b) => b.id));
+    // The buildings of a named landmark stand whatever the count (at a tier that raises any).
+    if (most > 0)
+        for (const b of plan.blocks)
+            if (b.whole && underLandmark(plan.landmarks ?? [], b.ring))
+                wanted.add(b.id);
     const items = [];
     for (const b of plan.blocks) {
         if (!wanted.has(b.id))

package/dist/crowd.d.ts

@@ -70,6 +70,14 @@ export interface CrowdStands {
     stadium?: "purpose" | "nfl" | "cfl";
     /** The playing surface, in the wide frame. */
     box: Box;
+    /**
+     * The floor round the playing surface, where the surface draws more than its box (a court's run-off, a track's sprint straight, runways and pits): its bounding box and its outline as points, in the wide frame.
+     * The first row of seats clears all of it by `FLOOR_CLEAR`, and the opening is centred on its box. Missing for a real venue's stands and a ballpark's, which are laid out from their own data.
+     */
+    floor?: {
+        box: Box;
+        points: Pt[];
+    };
     rings: StandRing[];
     /** Boxes where the stands are left out (the open end of a horseshoe, the ends of two sides). */
     covers: [x0: number, y0: number, x1: number, y1: number][];
@@ -310,10 +318,20 @@ export interface LayoutInput {
     };
     /** A real venue's stands in place of the sport's usual tiers (see `venueBowl`). */
     real?: RealBowl;
+    /**
+     * Everything the surface draws round its playing area, in the wide frame: the bounding box (the surface's own view with no margin) and, where the floor is not that rectangle (an athletics track, an oval
+     * ground), its outline as points. The opening of the stands is centred on it and clears it. Without it the floor is the box.
+     */
+    floor?: {
+        box: Box;
+        points?: readonly (readonly [number, number])[];
+    };
     /** The ballpark's fence as points on the field, for a ballpark (see `parkLayout`). */
     fence?: readonly Pt[];
     /** The foul lines' length at the poles and the backstop's distance, for a ballpark. */
     backstop?: number;
 }
+/** The room kept between the floor (everything the surface draws round its playing area) and the first row of seats, in feet. */
+export declare const FLOOR_CLEAR = 2;
 /** The layout of a sport's stands round its surface: rings, covers, sectors and gaps. For a ballpark see `parkLayout`. */
 export declare function layoutOf(input: LayoutInput): CrowdStands;

package/dist/crowd.js

@@ -330,6 +330,62 @@ function offsets(p, box, stadium) {
     const side = g.side + (f.width - box.h) / 2;
     return { left: end, right: end, top: side, bottom: side + g.bench };
 }
+/** The room kept between the floor (everything the surface draws round its playing area) and the first row of seats, in feet. */
+export const FLOOR_CLEAR = 2;
+/** A point inside a rounded rectangle or an ellipse of half sizes `hx`, `hy` about the origin, with `clear` to spare. */
+function insideOpening(ax, ay, hx, hy, r, oval, clear) {
+    const [w, h] = [hx - clear, hy - clear];
+    if (w <= 0 || h <= 0)
+        return false;
+    if (oval)
+        return sq(ax / w) + sq(ay / h) <= 1 + 1e-9;
+    const rr = Math.max(0, Math.min(r, hx, hy) - clear);
+    if (ax > w + 1e-9 || ay > h + 1e-9)
+        return false;
+    const kx = ax - (w - rr);
+    const ky = ay - (h - rr);
+    return kx <= 0 || ky <= 0 || sq(kx) + sq(ky) <= sq(rr) + 1e-9;
+}
+/** The first row's opening round a floor, centred on it (the bench room shared by both sides): the sport's distances, or the floor's own shape where they do not clear it, grown alike until its whole outline clears by `FLOOR_CLEAR`. */
+function openingOf(input) {
+    const { off, corner, oval, box } = input;
+    const floor = input.floor?.box ?? box;
+    const cx = floor.x + floor.w / 2;
+    const cy = floor.y + floor.h / 2;
+    let hx = Math.max(cx - box.x, box.x + box.w - cx) + (off.left + off.right) / 2;
+    let hy = Math.max(cy - box.y, box.y + box.h - cy) + (off.top + off.bottom) / 2;
+    // A floor the sport's distances do not clear (table tennis): the floor's own shape.
+    if (Math.min(hx - floor.w / 2, hy - floor.h / 2) < FLOOR_CLEAR) {
+        hx = floor.w / 2 + FLOOR_CLEAR;
+        hy = floor.h / 2 + FLOOR_CLEAR;
+    }
+    const given = input.floor?.points;
+    const points = given !== undefined && given.length > 0
+        ? given.map(([x, y]) => [x, y])
+        : oval
+            ? Array.from({ length: 64 }, (_, i) => [cx + (floor.w / 2) * Math.cos((i * Math.PI) / 32), cy + (floor.h / 2) * Math.sin((i * Math.PI) / 32)])
+            : [[floor.x, floor.y], [floor.x + floor.w, floor.y], [floor.x + floor.w, floor.y + floor.h], [floor.x, floor.y + floor.h]];
+    // A sampled curve: a little to spare.
+    const clear = FLOOR_CLEAR + (given !== undefined || oval ? 0.5 : 0);
+    const fits = (d) => points.every(([x, y]) => insideOpening(Math.abs(x - cx), Math.abs(y - cy), hx + d, hy + d, corner, oval, clear));
+    if (!fits(0)) {
+        let lo = 0;
+        let hi = 4;
+        while (!fits(hi) && hi < 4096)
+            hi *= 2;
+        for (let i = 0; i < 40; i += 1) {
+            const mid = (lo + hi) / 2;
+            if (fits(mid))
+                hi = mid;
+            else
+                lo = mid;
+        }
+        hx += hi;
+        hy += hi;
+    }
+    const round = (v) => Math.round(v * 1e6) / 1e6;
+    return { off: { left: round(box.x - (cx - hx)), right: round(cx + hx - box.x - box.w), top: round(box.y - (cy - hy)), bottom: round(cy + hy - box.y - box.h) }, cx, cy, floor, points };
+}
 /** The layout of a sport's stands round its surface: rings, covers, sectors and gaps. For a ballpark see `parkLayout`. */
 export function layoutOf(input) {
     const { sport, box } = input;
@@ -342,15 +398,16 @@ export function layoutOf(input) {
     const stadium = sport === "soccer" && input.real === undefined ? host ?? "purpose" : undefined;
     const p = stadium === "nfl" || stadium === "cfl" ? { ...PROFILES[stadium], shape: base.shape, away: base.away } : base;
     const shape = input.real !== undefined ? "bowl" : crowd.shape ?? p.shape;
-    const off = input.real?.off ?? offsets(base, box, stadium ?? "purpose");
-    const cx = box.x + box.w / 2;
-    const cy = box.y + box.h / 2;
+    const fit = input.real === undefined ? openingOf({ off: offsets(base, box, stadium ?? "purpose"), corner: p.corner, oval: base.oval === true, box, floor: input.floor }) : undefined;
+    const off = input.real?.off ?? fit?.off ?? offsets(base, box, stadium ?? "purpose");
+    const cx = fit?.cx ?? box.x + box.w / 2;
+    const cy = fit?.cy ?? box.y + box.h / 2;
     const rings = input.real === undefined ? [] : input.real.rings.map((ring) => ({ ...ring }));
     const reachOf = input.real === undefined ? { left: 0, right: 0, top: 0, bottom: 0 } : { ...input.real.reach };
     for (const t of input.real === undefined ? p.tiers : []) {
         const at = (k) => {
             if (base.oval === true)
-                return { kind: "ellipse", cx, cy, rx: box.w / 2 + (off.left + off.right) / 2 + k, ry: box.h / 2 + (off.top + off.bottom) / 2 + k };
+                return { kind: "ellipse", cx, cy, rx: (box.w + off.left + off.right) / 2 + k, ry: (box.h + off.top + off.bottom) / 2 + k };
             return { kind: "rrect", x0: box.x - off.left - k, y0: box.y - off.top - k, x1: box.x + box.w + off.right + k, y1: box.y + box.h + off.bottom + k, r: p.corner + k };
         };
         const region = at(t.to);
@@ -379,17 +436,18 @@ export function layoutOf(input) {
     const covers = [];
     const x0 = box.x - off.left;
     const x1 = box.x + box.w + off.right;
-    const yTop = last === undefined ? box.y : box.y - reachOf.top - 4;
-    const yBot = last === undefined ? box.y + box.h : box.y + box.h + reachOf.bottom + 4;
+    // The covers reach past the roof's shade (9 feet beyond the upper tier) too.
+    const yTop = last === undefined ? box.y : box.y - reachOf.top - 10;
+    const yBot = last === undefined ? box.y + box.h : box.y + box.h + reachOf.bottom + 10;
     if (shape === "horseshoe") {
         // The open end: everything beyond the surface's end line and the gap that is kept clear.
         if (crowd.open === "left")
-            covers.push([box.x - reachOf.left - 4, yTop, x0 + p.corner * 0.5, yBot]);
+            covers.push([box.x - reachOf.left - 10, yTop, x0 + p.corner * 0.5, yBot]);
         else
-            covers.push([x1 - p.corner * 0.5, yTop, box.x + box.w + reachOf.right + 4, yBot]);
+            covers.push([x1 - p.corner * 0.5, yTop, box.x + box.w + reachOf.right + 10, yBot]);
     }
     else if (shape === "sides") {
-        covers.push([box.x - reachOf.left - 4, yTop, x0 + p.corner * 0.5, yBot], [x1 - p.corner * 0.5, yTop, box.x + box.w + reachOf.right + 4, yBot]);
+        covers.push([box.x - reachOf.left - 10, yTop, x0 + p.corner * 0.5, yBot], [x1 - p.corner * 0.5, yTop, box.x + box.w + reachOf.right + 10, yBot]);
     }
     const concourses = [];
     rings.forEach((ring, i) => {
@@ -398,6 +456,8 @@ export function layoutOf(input) {
             concourses.push({ region: ring.hole, hole: before.region });
     });
     const stands = { sport, shape, box, rings, covers, concourses, sectors: [], gaps: [], reach: reachOf, seats: rings.reduce((n, r) => n + r.seats, 0) };
+    if (fit !== undefined)
+        stands.floor = { box: fit.floor, points: fit.points };
     if (input.real !== undefined)
         stands.real = input.real.shell;
     if (input.real?.closedSectors !== undefined)
@@ -490,21 +550,31 @@ export function layoutOf(input) {
             }
         }
         if (crowd.gaps && shape !== "grandstand") {
-            const bottom = box.y + box.h;
-            const mid = box.x + box.w / 2;
+            // Nothing on the floor: the benches stand between the floor and the first row.
+            const edge = box.y + box.h + off.bottom;
+            const floorEdge = Math.max(box.y + box.h, fit === undefined ? -Infinity : fit.floor.y + fit.floor.h);
+            const mid = cx;
             // A tunnel through the lower stands at the middle of the bench side, the camera platform above them, and the benches in the gap.
-            stands.gaps.push({ kind: "tunnel", box: [mid - 6, bottom + off.bottom - 1, mid + 6, bottom + off.bottom + lowerRing.to + 1] });
+            stands.gaps.push({ kind: "tunnel", box: [mid - 6, edge, mid + 6, edge + lowerRing.to + 1] });
             const media = rings[rings.length - 1];
             if (media !== undefined && media.tier === "upper")
-                stands.gaps.push({ kind: "camera", box: [mid - 22, bottom + off.bottom + media.from + 3, mid + 22, bottom + off.bottom + media.from + 13] });
-            if (off.bottom - off.top >= 4 || sport === "soccer" || sport === "nfl" || sport === "cfl" || sport === "ifaf" || sport === "rugby" || sport === "gaelic") {
+                stands.gaps.push({ kind: "camera", box: [mid - 22, edge + media.from + 3, mid + 22, edge + media.from + 13] });
+            if (base.bench >= 4 || sport === "soccer" || sport === "nfl" || sport === "cfl" || sport === "ifaf" || sport === "rugby" || sport === "gaelic") {
                 const benchLen = Math.min(34, box.w * 0.12);
-                for (const s of [-1, 1]) {
-                    const bx = mid + s * (box.w * 0.1 + benchLen / 2 + 4);
-                    stands.gaps.push({ kind: "bench", box: [bx - benchLen / 2, bottom + 2.5, bx + benchLen / 2, bottom + 2.5 + Math.min(5, off.bottom * 0.3)] });
+                const depth = Math.min(5, off.bottom * 0.3);
+                if (floorEdge + 2.5 + depth <= edge - 1) {
+                    for (const s of [-1, 1]) {
+                        const bx = box.x + box.w / 2 + s * (box.w * 0.1 + benchLen / 2 + 4);
+                        stands.gaps.push({ kind: "bench", box: [bx - benchLen / 2, floorEdge + 2.5, bx + benchLen / 2, floorEdge + 2.5 + depth] });
+                    }
                 }
             }
-            stands.gaps.push({ kind: "media", box: [mid - 55, bottom + off.bottom + 2, mid + 55, bottom + off.bottom + 6] });
+            // The media's desks: along the straight of that side only.
+            const hole = lowerRing.hole;
+            const straight = hole?.kind === "rrect" ? (hole.x1 - hole.x0) / 2 - Math.min(hole.r, (hole.x1 - hole.x0) / 2, (hole.y1 - hole.y0) / 2) : 55;
+            const half = Math.min(55, straight);
+            if (half >= 8)
+                stands.gaps.push({ kind: "media", box: [mid - half, edge + 2, mid + half, edge + 6] });
         }
     }
     return stands;

package/dist/district-entry.d.ts

@@ -1,4 +1,5 @@
 import "./full.ts";
 import "./venues.all.ts";
 import "./walk.full.ts";
+import "./circuits.held.ts";
 export * from "./district.api.ts";

package/dist/district-entry.js

@@ -5,4 +5,6 @@ import "./full.js";
 import "./venues.all.js";
 // The walkable ground of every district, for the crowd outside, as the district has always had it (the lean district reads one when `loadOutside` is asked to).
 import "./walk.full.js";
+// Every circuit, as a district's `circuit` option asks for one (the lean district reads them when `loadCircuits` is asked to).
+import "./circuits.held.js";
 export * from "./district.api.js";

package/dist/district.api.d.ts

@@ -1,8 +1,15 @@
-export { DISTRICT_IDS, DISTRICT_MARGIN, DISTRICT_MODES, KYOGIJO_DISTRICT_STYLE, describeDistrict, districtId, districtMember, districtRing, drawDistrict, isDistrictId, metresText, planDistrict, scaleOf, unknownVenues } from "./district.ts";
-export type { DistrictMember, DistrictMode, DistrictOptions, DistrictPart, DistrictPlaced, DistrictPlan, DistrictVenueInput, PlacedPart } from "./district.ts";
+export { DISTRICT_IDS, DISTRICT_MARGIN, DISTRICT_MODES, KYOGIJO_DISTRICT_STYLE, circuitPointIn, describeDistrict, districtId, districtMember, districtRing, drawDistrict, isDistrictId, metresText, planDistrict, scaleOf, unknownVenues } from "./district.ts";
+export type { DistrictCircuit, DistrictMember, DistrictMode, DistrictOptions, DistrictPart, DistrictPlaced, DistrictPlan, DistrictVenueInput, PlacedPart } from "./district.ts";
 export { buildDistrictTurn, districtPresets, districtTurnMarkup, mountDistrictTurn } from "./district.turn.ts";
 export type { DistrictTurnSettings } from "./district.turn.ts";
 export type { ContextArea } from "./context.ts";
+export { CIRCUIT_INDEX, loadCircuits } from "./circuits.index.ts";
+export { circuitsHeld } from "./district.circuit.ts";
+export { drawDistrictRace, mountDistrictRace } from "./district.race.ts";
+export type { DistrictRaceDrawOptions, DistrictRaceOptions, DistrictRaceSettings } from "./district.race.ts";
+export type { KyogijoRace, RaceState } from "./circuits.race.dom.ts";
+export { LANDMARK_SHAPES } from "./landmarks.ts";
+export type { ContextLandmark, LandmarkShape, PlacedLandmark } from "./landmarks.ts";
 export { KODOKAN, KODOKAN_DOJO, KODOKAN_FLOOR_HEIGHT, KODOKAN_FLOOR_IDS, KODOKAN_FLOORS, KODOKAN_ROOM_HEIGHT, kodokanLevel, kodokanMember } from "./kodokan.ts";
 export type { KodokanFloor, KodokanRoom } from "./kodokan.ts";
 export { VENUE_ATTRIBUTION } from "./venues.ts";

package/dist/district.api.js

@@ -1,6 +1,12 @@
 // A district: several real venues of one city on one plan at their real relative positions and orientations (OpenStreetMap, ODbL 1.0), in 2D and in 3D, tight round neighbours or at the real distances of a city.
-export { DISTRICT_IDS, DISTRICT_MARGIN, DISTRICT_MODES, KYOGIJO_DISTRICT_STYLE, describeDistrict, districtId, districtMember, districtRing, drawDistrict, isDistrictId, metresText, planDistrict, scaleOf, unknownVenues } from "./district.js";
+export { DISTRICT_IDS, DISTRICT_MARGIN, DISTRICT_MODES, KYOGIJO_DISTRICT_STYLE, circuitPointIn, describeDistrict, districtId, districtMember, districtRing, drawDistrict, isDistrictId, metresText, planDistrict, scaleOf, unknownVenues } from "./district.js";
 export { buildDistrictTurn, districtPresets, districtTurnMarkup, mountDistrictTurn } from "./district.turn.js";
+// A race circuit on the same ground (`circuit`: the district entry has every circuit, the lean district reads them with `loadCircuits`), and the famous landmarks an area of context has round it.
+export { CIRCUIT_INDEX, loadCircuits } from "./circuits.index.js";
+export { circuitsHeld } from "./district.circuit.js";
+// A race on that circuit, among the venues and the city (the circuits' race, made-up cars or a feed's): drawn at a moment, or played in a page flat or in 3D.
+export { drawDistrictRace, mountDistrictRace } from "./district.race.js";
+export { LANDMARK_SHAPES } from "./landmarks.js";
 export { KODOKAN, KODOKAN_DOJO, KODOKAN_FLOOR_HEIGHT, KODOKAN_FLOOR_IDS, KODOKAN_FLOORS, KODOKAN_ROOM_HEIGHT, kodokanLevel, kodokanMember } from "./kodokan.js";
 export { VENUE_ATTRIBUTION } from "./venues.js";
 export { mountDistrict } from "./district.dom.js";

package/dist/district.circuit.d.ts

@@ -0,0 +1,34 @@
+import type { CircuitDrawing } from "./circuits.draw.ts";
+import type { carRadius, carsMarkup } from "./circuits.race.draw.ts";
+import type { mountRaceIn } from "./circuits.race.dom.ts";
+import type { raceAt } from "./circuits.race.moment.ts";
+import type { simulateRace } from "./circuits.race.ts";
+import type { RaceWords } from "./circuits.race.words.ts";
+import type { CircuitPlan } from "./circuits.ts";
+import type { Circuit, CircuitOptions } from "./circuits.types.ts";
+import type { CircuitWords } from "./circuits.words.ts";
+import type { Language } from "./types.ts";
+import type { Upright } from "./turn.kit.ts";
+/** The circuits' code a district uses. */
+export interface CircuitSupport {
+    circuitOf: (id: string) => Circuit;
+    circuitPlan: (circuit: Circuit) => CircuitPlan;
+    circuitDrawing: (options: CircuitOptions) => CircuitDrawing;
+    circuitUprights: (drawn: CircuitDrawing, thin: number) => Upright[];
+    words: Readonly<Record<Language, CircuitWords>>;
+    /** A race on the circuit (`mountDistrictRace`, `drawDistrictRace`): the simulation, its moments, its cars' markup and its view in a page. */
+    race: {
+        simulateRace: typeof simulateRace;
+        raceAt: typeof raceAt;
+        carsMarkup: typeof carsMarkup;
+        carRadius: typeof carRadius;
+        mountRaceIn: typeof mountRaceIn;
+        words: Readonly<Record<Language, RaceWords>>;
+    };
+}
+/** Fill the table: `circuits.held.ts` does it when it is imported. */
+export declare function holdCircuits(support: CircuitSupport): void;
+/** The circuits' code, or an error that says how to have it. */
+export declare function circuitSupport(): CircuitSupport;
+/** Whether the circuits are held (the district entry, or the lean district after `loadCircuits()`). */
+export declare const circuitsHeld: () => boolean;

package/dist/district.circuit.js

@@ -0,0 +1,13 @@
+let held;
+/** Fill the table: `circuits.held.ts` does it when it is imported. */
+export function holdCircuits(support) {
+    held = support;
+}
+/** The circuits' code, or an error that says how to have it. */
+export function circuitSupport() {
+    if (held === undefined)
+        throw new Error("a district with a circuit needs the circuits: the district entry has them, and the lean district reads them with `await loadCircuits()` first");
+    return held;
+}
+/** Whether the circuits are held (the district entry, or the lean district after `loadCircuits()`). */
+export const circuitsHeld = () => held !== undefined;

package/dist/district.d.ts

@@ -3,6 +3,8 @@ import { type StadiumConfigId } from "./stadiums.ts";
 import type { OutsideOptions } from "./outside.ts";
 import type { Pt } from "./crowd.ts";
 import type { Language, SurfaceOptions } from "./types.ts";
+import type { CircuitPlan } from "./circuits.ts";
+import type { CircuitOptions } from "./circuits.types.ts";
 /** How a district is fitted: `neighbours` tight round venues that stand close together, `city` at the real distances between venues that are kilometres apart. */
 export type DistrictMode = "neighbours" | "city";
 export declare const DISTRICT_MODES: readonly DistrictMode[];
@@ -13,8 +15,13 @@ export type DistrictVenueInput = string | {
 };
 /** What can be asked of a district. */
 export interface DistrictOptions {
-    /** The venues, by key: any key of `VENUES` (the arenas) and `STADIUMS` (the stadiums); at least one. */
+    /** The venues, by key: any key of `VENUES` (the arenas) and `STADIUMS` (the stadiums); at least one, unless the district has a `circuit`. */
     venues: readonly DistrictVenueInput[];
+    /**
+     * A race circuit laid on the same ground (a key of `CIRCUIT_IDS`: `las-vegas`): its lap, pit lane, ground and pit building where OpenStreetMap maps them, under the venues, turned as it lies; in 3D its pit building and its turns'
+     * numbers stand up and a lap that crosses itself stands its pass over on a bridge, as in the circuit's own view. Missing: no circuit.
+     */
+    circuit?: string;
     /** `neighbours` (the default) or `city`. */
     mode?: DistrictMode;
     /** How far the plan is turned, in degrees clockwise: 0 (the default) has north at the top; `"auto"` turns it so that the district's long way lies across the page. */
@@ -171,6 +178,19 @@ export interface DistrictGate {
     angle: number;
     basis: "documented" | "plausible";
 }
+/** A circuit placed in a district: its own plan (feet round its own middle, its long side along x), and where that middle is put and how far the plan is turned to lie as it does in the world. */
+export interface DistrictCircuit {
+    plan: CircuitPlan;
+    /** Where the circuit's own origin (the middle of its plan) is in the district's frame, in feet. */
+    at: Pt;
+    /** The degrees the circuit's plan is turned clockwise to lie in the district (its heading less a quarter turn, and the map's turn). */
+    angle: number;
+    /** The outline of everything it draws on the ground (its plan's box), and of its pit building, in the district's frame. */
+    footprint: Pt[];
+    building?: Pt[];
+}
+/** A point of a circuit's own plan (feet, `circuitPlan`) where the district puts it: for a page that draws something on the lap (a race's cars) in a district's frame. */
+export declare function circuitPointIn(placed: Pick<DistrictCircuit, "at" | "angle">, p: Pt): Pt;
 /** What a district is: its venues placed, the box that fits them, and how the map lies. */
 export interface DistrictPlan {
     options: DistrictOptions;
@@ -197,8 +217,10 @@ export interface DistrictPlan {
         b: string;
         metres: number;
     }[];
-    /** The `[longitude, latitude]` the plan's metres are measured from: the middle of the venues' surfaces. */
+    /** The `[longitude, latitude]` the plan's metres are measured from: the middle of the venues' surfaces (and of the circuit's plan, where there is one). */
     origin: readonly [number, number];
+    /** The circuit on the ground, where the options name one. */
+    circuit?: DistrictCircuit;
 }
 /** The margin round the buildings, as a share of the longer side of the district: tight for neighbours, wide for a city's grid and names. */
 export declare const DISTRICT_MARGIN: Readonly<Record<DistrictMode, number>>;
@@ -217,7 +239,7 @@ export declare const OUTSIDE_ROOM = 160;
  */
 export declare function planDistrict(options: DistrictOptions): DistrictPlan;
 /** The colours and the type of a district's drawing, light and dark. Defaults sit in `:where()`, so a page's own rule wins. */
-export declare const KYOGIJO_DISTRICT_STYLE = "\n:where(.ky-district){--ky-dist-ground:#e1e4da;--ky-dist-grid:rgba(40,46,42,.16);--ky-dist-ink:#1f2320;--ky-dist-halo:rgba(255,255,255,.9);--ky-dist-people:#c2410c;--ky-dist-b0:#d1d4cb;--ky-dist-b1:#c3c7be;--ky-dist-b2:#b2b7ae;--ky-dist-b3:#9ea49b;--ky-dist-bline:rgba(40,46,42,.28);--ky-dist-road:#cbcfc4;--ky-dist-deck:#bdc2b7;--ky-dist-walk:#eef0e8;--ky-dist-rail:#8b9288;--ky-dist-gate:#1f5fa8;--ky-dist-water:#c7d5dc;--ky-dist-green:#d2dcc4;--ky-dist-wood:#c3d0b6;--ky-dist-tree:#b3c2a3;--ky-dist-floor:#2f6db0}\n@media (prefers-color-scheme:dark){:where(html:not([data-theme=light]) .ky-district:not([data-theme=light])){--ky-dist-ground:#1b2025;--ky-dist-grid:rgba(220,226,220,.16);--ky-dist-ink:#e8ece8;--ky-dist-halo:rgba(14,18,16,.85);--ky-dist-people:#fbbf24;--ky-dist-b0:#262c31;--ky-dist-b1:#2e353b;--ky-dist-b2:#394148;--ky-dist-b3:#474f57;--ky-dist-bline:rgba(220,226,220,.22);--ky-dist-road:#2b3239;--ky-dist-deck:#353d45;--ky-dist-walk:#242b31;--ky-dist-rail:#5b646c;--ky-dist-gate:#7fb2ee;--ky-dist-water:#1c2d3b;--ky-dist-green:#202d26;--ky-dist-wood:#1c2b23;--ky-dist-tree:#2e4337;--ky-dist-floor:#7fb0e8}}\n:where(html[data-theme=dark] .ky-district,.ky-district[data-theme=dark]){--ky-dist-ground:#1b2025;--ky-dist-grid:rgba(220,226,220,.16);--ky-dist-ink:#e8ece8;--ky-dist-halo:rgba(14,18,16,.85);--ky-dist-people:#fbbf24;--ky-dist-b0:#262c31;--ky-dist-b1:#2e353b;--ky-dist-b2:#394148;--ky-dist-b3:#474f57;--ky-dist-bline:rgba(220,226,220,.22);--ky-dist-road:#2b3239;--ky-dist-deck:#353d45;--ky-dist-walk:#242b31;--ky-dist-rail:#5b646c;--ky-dist-gate:#7fb2ee;--ky-dist-water:#1c2d3b;--ky-dist-green:#202d26;--ky-dist-wood:#1c2b23;--ky-dist-tree:#2e4337;--ky-dist-floor:#7fb0e8}\n.ky-district .ky-dist-ground{fill:var(--ky-dist-ground)}\n.ky-district .ky-dist-grid{fill:none;stroke:var(--ky-dist-grid);stroke-width:1}\n.ky-district .ky-dist-block{stroke:var(--ky-dist-bline);stroke-width:.5;stroke-linejoin:round}\n.ky-district .ky-dist-b0{fill:var(--ky-dist-b0)}\n.ky-district .ky-dist-b1{fill:var(--ky-dist-b1)}\n.ky-district .ky-dist-b2{fill:var(--ky-dist-b2)}\n.ky-district .ky-dist-b3{fill:var(--ky-dist-b3)}\n.ky-district .ky-dist-street{stroke-linejoin:round;stroke-linecap:butt}\n.ky-district .ky-dist-street-0{stroke:var(--ky-dist-road)}\n.ky-district .ky-dist-street-1{stroke:var(--ky-dist-deck)}\n.ky-district .ky-dist-street-2{stroke:var(--ky-dist-rail);stroke-dasharray:6 3}\n.ky-district .ky-dist-street-3{stroke:var(--ky-dist-walk)}\n.ky-district .ky-dist-land{stroke:none}\n.ky-district .ky-dist-water{fill:var(--ky-dist-water)}\n.ky-district .ky-dist-green{fill:var(--ky-dist-green)}\n.ky-district .ky-dist-wood{fill:var(--ky-dist-wood)}\n.ky-district .ky-dist-tree{fill:none;stroke:var(--ky-dist-tree);stroke-linecap:round}\n.ky-district .ky-dist-gate rect{fill:var(--ky-dist-gate);stroke:var(--ky-dist-gate);stroke-width:2.4}\n.ky-district .ky-dist-gate-plausible rect{fill:var(--ky-dist-ground);fill-opacity:.85}\n.ky-district .ky-dist-gate-queue{fill:none;stroke:var(--ky-dist-gate);stroke-width:3;stroke-dasharray:9 7}\n.ky-district .ky-dist-ghost{fill:var(--ky-dist-b1);fill-opacity:.35}\n.ky-district .ky-dist-floor{stroke:var(--ky-dist-floor);stroke-width:2}\n.ky-district .ky-dist-ink{fill:none;stroke:var(--ky-dist-ink);stroke-linecap:round;stroke-linejoin:round}\n.ky-district .ky-dist-text{fill:var(--ky-dist-ink);font-family:var(--ky-font,system-ui,-apple-system,\"Segoe UI\",\"Hiragino Sans\",\"Noto Sans JP\",sans-serif);font-weight:600;paint-order:stroke;stroke:var(--ky-dist-halo);stroke-linejoin:round}";
+export declare const KYOGIJO_DISTRICT_STYLE = "\n:where(.ky-district){--ky-dist-ground:#e1e4da;--ky-dist-grid:rgba(40,46,42,.16);--ky-dist-ink:#1f2320;--ky-dist-halo:rgba(255,255,255,.9);--ky-dist-people:#c2410c;--ky-dist-b0:#d1d4cb;--ky-dist-b1:#c3c7be;--ky-dist-b2:#b2b7ae;--ky-dist-b3:#9ea49b;--ky-dist-bline:rgba(40,46,42,.28);--ky-dist-road:#cbcfc4;--ky-dist-deck:#bdc2b7;--ky-dist-walk:#eef0e8;--ky-dist-rail:#8b9288;--ky-dist-gate:#1f5fa8;--ky-dist-water:#c7d5dc;--ky-dist-green:#d2dcc4;--ky-dist-wood:#c3d0b6;--ky-dist-tree:#b3c2a3;--ky-dist-floor:#2f6db0}\n@media (prefers-color-scheme:dark){:where(html:not([data-theme=light]) .ky-district:not([data-theme=light])){--ky-dist-ground:#1b2025;--ky-dist-grid:rgba(220,226,220,.16);--ky-dist-ink:#e8ece8;--ky-dist-halo:rgba(14,18,16,.85);--ky-dist-people:#fbbf24;--ky-dist-b0:#262c31;--ky-dist-b1:#2e353b;--ky-dist-b2:#394148;--ky-dist-b3:#474f57;--ky-dist-bline:rgba(220,226,220,.22);--ky-dist-road:#2b3239;--ky-dist-deck:#353d45;--ky-dist-walk:#242b31;--ky-dist-rail:#5b646c;--ky-dist-gate:#7fb2ee;--ky-dist-water:#1c2d3b;--ky-dist-green:#202d26;--ky-dist-wood:#1c2b23;--ky-dist-tree:#2e4337;--ky-dist-floor:#7fb0e8}}\n:where(html[data-theme=dark] .ky-district,.ky-district[data-theme=dark]){--ky-dist-ground:#1b2025;--ky-dist-grid:rgba(220,226,220,.16);--ky-dist-ink:#e8ece8;--ky-dist-halo:rgba(14,18,16,.85);--ky-dist-people:#fbbf24;--ky-dist-b0:#262c31;--ky-dist-b1:#2e353b;--ky-dist-b2:#394148;--ky-dist-b3:#474f57;--ky-dist-bline:rgba(220,226,220,.22);--ky-dist-road:#2b3239;--ky-dist-deck:#353d45;--ky-dist-walk:#242b31;--ky-dist-rail:#5b646c;--ky-dist-gate:#7fb2ee;--ky-dist-water:#1c2d3b;--ky-dist-green:#202d26;--ky-dist-wood:#1c2b23;--ky-dist-tree:#2e4337;--ky-dist-floor:#7fb0e8}\n.ky-district .ky-dist-ground{fill:var(--ky-dist-ground)}\n.ky-district .ky-dist-grid{fill:none;stroke:var(--ky-dist-grid);stroke-width:1}\n.ky-district .ky-dist-block{stroke:var(--ky-dist-bline);stroke-width:.5;stroke-linejoin:round}\n.ky-district .ky-dist-b0{fill:var(--ky-dist-b0)}\n.ky-district .ky-dist-b1{fill:var(--ky-dist-b1)}\n.ky-district .ky-dist-b2{fill:var(--ky-dist-b2)}\n.ky-district .ky-dist-b3{fill:var(--ky-dist-b3)}\n.ky-district .ky-dist-street{stroke-linejoin:round;stroke-linecap:butt}\n.ky-district .ky-dist-street-0{stroke:var(--ky-dist-road)}\n.ky-district .ky-dist-street-1{stroke:var(--ky-dist-deck)}\n.ky-district .ky-dist-street-2{stroke:var(--ky-dist-rail);stroke-dasharray:6 3}\n.ky-district .ky-dist-street-3{stroke:var(--ky-dist-walk)}\n.ky-district .ky-dist-land{stroke:none}\n.ky-district .ky-dist-water{fill:var(--ky-dist-water)}\n.ky-district .ky-dist-green{fill:var(--ky-dist-green)}\n.ky-district .ky-dist-wood{fill:var(--ky-dist-wood)}\n.ky-district .ky-dist-tree{fill:none;stroke:var(--ky-dist-tree);stroke-linecap:round}\n.ky-district .ky-dist-jet{fill:none;stroke:var(--ky-dist-halo);stroke-linecap:round}\n.ky-district .ky-dist-gate rect{fill:var(--ky-dist-gate);stroke:var(--ky-dist-gate);stroke-width:2.4}\n.ky-district .ky-dist-gate-plausible rect{fill:var(--ky-dist-ground);fill-opacity:.85}\n.ky-district .ky-dist-gate-queue{fill:none;stroke:var(--ky-dist-gate);stroke-width:3;stroke-dasharray:9 7}\n.ky-district .ky-dist-ghost{fill:var(--ky-dist-b1);fill-opacity:.35}\n.ky-district .ky-dist-floor{stroke:var(--ky-dist-floor);stroke-width:2}\n.ky-district .ky-dist-ink{fill:none;stroke:var(--ky-dist-ink);stroke-linecap:round;stroke-linejoin:round}\n.ky-district .ky-dist-text{fill:var(--ky-dist-ink);font-family:var(--ky-font,system-ui,-apple-system,\"Segoe UI\",\"Hiragino Sans\",\"Noto Sans JP\",sans-serif);font-weight:600;paint-order:stroke;stroke:var(--ky-dist-halo);stroke-linejoin:round}";
 /**
  * A venue's drawing as a part of the district's: its root made a nested `svg` that keeps the class, the sport and the colours the drawing's stylesheet reads, its box laid in its own frame (so that the group's turn
  * and shift put it in place), and its title, description, apron, arrow and stylesheet taken out (the stylesheet is given back in `styles`).
@@ -263,5 +285,7 @@ export declare function drawMember(member: DistrictMember, options: DistrictOpti
  * ```
  */
 export declare function drawDistrict(options: DistrictOptions, plan?: DistrictPlan, drawing?: (member: DistrictMember, index: number, part: number) => string): string;
+/** The options a district's circuit is drawn from: the circuit's own drawing in the district's language and theme, without its frame, and for the floor of the 3D view without its turns' numbers (they stand up). */
+export declare function circuitInDistrict(options: DistrictOptions, id: string, floor: boolean): CircuitOptions;
 /** The venues a district was asked for that the package has no key for: none when it can be drawn. */
 export declare const unknownVenues: (venues: readonly DistrictVenueInput[]) => string[];