@johnmorrisdotca/kyogijo-stadiums 0.10.2 → 0.12.0

package/CHANGELOG.md

@@ -7,6 +7,25 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.12.0] - 2026-10-19
+
+### Added
+
+- **Tournament layouts** (`@johnmorrisdotca/kyogijo-stadiums/multi`): `drawMulti` lays several of the package's own surfaces out together for one large event, to scale, on one floor, as one SVG, with the barriers, the officials' chairs, a scoreboard hung over the middle, the boards along the edges and empty places for the event's own words and marks (on the mats themselves for judo and karate, as those sports print them). Thirteen presets, each with its rule and sources, from table tennis (four and eight areas), pickleball (2 x 2, 2 x 4, 4 x 4), curling (four sheets), judo (three and four areas), karate (six and eight), badminton (the least spacing, and the 4 m the BWF recommends at Grade 1 and 2) and tennis; each says whether it is a rulebook's spacing or an arrangement an event used. `multiLayout` gives the floor a layout needs, `multiFit` whether it fits a hall (a rectangle, an octagon, or a floor of which only the area is known) with five halls and ice pads whose floors are published, and `venue` and `stadium` set the layout in a hall with a real stadium round it at the same scale, reusing the package's stands and crowd. `multiTable` is the text alternative; light and dark, English and Japanese. A demo page, `halls.html`, picks a preset, sets it in a hall and switches the stadium on and off (linked from the demo's gallery section), and the docs gallery has a page for every preset. See [Tournament layouts](./docs/multi.md).
+- **Two more parks place a dugout or a bullpen, where their articles do:** `wrigley-field`'s home dugout (third base line) and `griffith-stadium`'s left-field bullpen (388 feet, 1956 to 1961). No generic dugout or bullpen is drawn for the others; `docs/ballparks.md` and `docs/references.md` list what was read and left out and why.
+
+### Changed
+
+- **Docs only:** `docs/situation.md` says plainly what is left undrawn for want of a source (the NHL's older creases, an Olympic hybrid sheet, Buffalo Memorial Auditorium's rink) and what would be needed; `docs/team-shape.md` says the lineup's `jersey` is a flat marker of our own and where full jerseys are drawn.
+
+## [0.11.0] - 2026-10-19
+
+### Added
+
+- **A ground with a running track offers the athletics stadium in the atlas:** `surfacesOf(place)` lists `{ sport: "athletics", ground }` for a ground whose `track` is set, and `surfaceOf(place, "athletics")` returns it; the six grounds Wikidata marks with a track are linked, no other place.
+- **A `<title>` on every point and line when the marks are written** (`marks: true`, `pointer: true`): a datum with no `title` of its own is named from its outcome, its team and its place in the data ("goal, home, 3"), so a delegated listener, a hover and a screen reader reach every mark. Nothing is added without `marks`, so a drawing nobody points at is the same string as ever. Heat cells stay without one (size budget; their numbers are in the layer's table).
+- **The IFAF's field is named and tested in the situation docs** (`docs/situation.md`): `sport: "ifaf"` takes a football situation on the NFL's 100-yard field, with four downs.
+
 ## [0.10.2] - 2026-10-14
 
 ### Fixed

package/README.md

@@ -129,6 +129,7 @@ console.log(svg.startsWith("<svg"), svg.includes("USA 3, Canada 2"));
 | `./parks`, `./grounds`, `./arenas`, `./atlas`, `./eras`, `./leagues`, `./events` | The ballparks, the grounds, the arenas, every place, the markings of a season, each league's rulebook, the special games. |
 | `./turn` | A surface as a 3D view that turns, with the net, basket, goal or posts standing on it. |
 | `./scene`, `./canvas`, `./d3`, `./plot`, `./geojson`, `./png` | The drawing as data; on a canvas; in a d3 selection; as an Observable Plot mark; as GeoJSON; as a PNG (the optional peer `@resvg/resvg-js`). |
+| `./multi` | `drawMulti`, `multiFit`: several surfaces laid out for one event, in a hall ([docs](./docs/multi.md), [demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/halls.html)). |
 | `./layouts` | `drawGrid` and `GRID_PRESETS`: small multiples with a title, a subtitle, a key and a credit line; the grounds behind a drawing or a grid. |
 | `./mount`, `./react`, `./element`, `./element/define` | Draw into a container; React props; the `<kyogijo-field>` element and its registration. |
 
@@ -616,39 +617,67 @@ Using Kyogijo Stadiums in something? Open an *Add my project* issue and we will
 ### The family
 
 <!-- family:start (made by scripts/family-readme.mjs from scripts/family-template.mjs; change those, not this) -->
-Kyogijo Stadiums is one of twenty-eight packages, each made for the same site, each at
-[github.com/johnmorrisdotca](https://github.com/johnmorrisdotca). The code of every one is MIT.
+Kyogijo Stadiums is one of thirty-two packages, each made for the same site, each at
+[github.com/johnmorrisdotca](https://github.com/johnmorrisdotca) or [github.com/spxis](https://github.com/spxis). The code of every one is MIT.
 
-- [Korokoro](https://github.com/johnmorrisdotca/korokoro) (コロコロ): dice, with notation, exact odds, real sounds and the dice of many games. [Demo](https://johnmorrisdotca.github.io/korokoro/).
-- [Kyuubu](https://github.com/johnmorrisdotca/kyuubu) (キューブ): a turning cube for the browser, 2×2 to 7×7, with record solves to replay. [Demo](https://johnmorrisdotca.github.io/kyuubu/).
-- [Hitotsu](https://github.com/johnmorrisdotca/hitotsu) (一つ): a colour-card shedding game for two to eight, with the house rules people play. [Demo](https://johnmorrisdotca.github.io/hitotsu/).
-- [Toranpu](https://github.com/johnmorrisdotca/toranpu) (トランプ): a deck of playing cards, card games with computer players, and solitaires. [Demo](https://johnmorrisdotca.github.io/toranpu/).
-- [Tane](https://github.com/johnmorrisdotca/tane) (種): seeded random numbers and daily seeds, the same in every browser and on every server. [Demo](https://johnmorrisdotca.github.io/tane/).
+**Games — board**
+
+- [Domino](https://github.com/johnmorrisdotca/domino) (ドミノ): dominoes and Mexican Train. [Demo](https://johnmorrisdotca.github.io/domino/).
+- [Gunjin](https://github.com/johnmorrisdotca/gunjin) (軍人): five hidden-rank strategy games with pass-the-device play. [Demo](https://johnmorrisdotca.github.io/gunjin/).
 - [Narabe](https://github.com/johnmorrisdotca/narabe) (並べ): one rules engine for abstract board games, from gomoku and Reversi to Go and checkers. [Demo](https://johnmorrisdotca.github.io/narabe/).
+- [Sugoroku](https://github.com/johnmorrisdotca/sugoroku) (双六): backgammon and its variants, with the doubling cube and match play. [Demo](https://johnmorrisdotca.github.io/sugoroku/).
 - [Tenka](https://github.com/johnmorrisdotca/tenka) (天下): world conquest for two to six, on a map of the real world. [Demo](https://johnmorrisdotca.github.io/tenka/).
-- [Kumimoji](https://github.com/johnmorrisdotca/kumimoji) (組み文字): a crossword tile race, in English and Japanese kana. [Demo](https://johnmorrisdotca.github.io/kumimoji/).
-- [Tsunagi](https://github.com/johnmorrisdotca/tsunagi) (繋ぎ): a line-joining logic puzzle whose every level has exactly one answer. [Demo](https://johnmorrisdotca.github.io/tsunagi/).
+
+**Games — cards & tiles**
+
+- [Hitotsu](https://github.com/johnmorrisdotca/hitotsu) (一つ): a colour-card shedding game for two to eight, with the house rules people play. [Demo](https://johnmorrisdotca.github.io/hitotsu/).
 - [Jarajara](https://github.com/johnmorrisdotca/jarajara) (ジャラジャラ): mahjong tiles drawn as SVG, stacked layouts, and the matching solitaire Awase. [Demo](https://johnmorrisdotca.github.io/jarajara/).
-- [Suido](https://github.com/johnmorrisdotca/suido) (水道): a pipe puzzle: turn the pieces until the water reaches every drain. [Demo](https://johnmorrisdotca.github.io/suido/).
-- [Domino](https://github.com/johnmorrisdotca/domino) (ドミノ): dominoes and Mexican Train. [Demo](https://johnmorrisdotca.github.io/domino/).
-- [Kotoba](https://github.com/johnmorrisdotca/kotoba) (言葉): word lists and word-game rules in English, French, German and Japanese. [Demo](https://johnmorrisdotca.github.io/kotoba/).
-- [Sugoroku](https://github.com/johnmorrisdotca/sugoroku) (双六): backgammon and its variants, with the doubling cube and match play. [Demo](https://johnmorrisdotca.github.io/sugoroku/).
+- [Kumimoji](https://github.com/johnmorrisdotca/kumimoji) (組み文字): a crossword tile race, in English and Japanese kana. [Demo](https://johnmorrisdotca.github.io/kumimoji/).
+- [Toranpu](https://github.com/johnmorrisdotca/toranpu) (トランプ): a deck of playing cards, card games with computer players, and solitaires. [Demo](https://johnmorrisdotca.github.io/toranpu/).
+
+**Games — puzzles**
+
+- [Houseki](https://github.com/johnmorrisdotca/houseki) (宝石): gem and stone matching puzzles: falling triplets, stone collapse, colour chains and gem swap. [Demo](https://johnmorrisdotca.github.io/houseki/).
+- [Jirai](https://github.com/johnmorrisdotca/jirai) (地雷): minesweeper on shaped grids with verified no-guess boards. [Demo](https://johnmorrisdotca.github.io/jirai/).
+- [Karakuri](https://github.com/johnmorrisdotca/karakuri) (からくり): eight hyper-casual puzzle games, some of them physics: draw a shield, pull pins, cut ropes, slide blocks, pour tubes. [Demo](https://johnmorrisdotca.github.io/karakuri/).
 - [Kazu](https://github.com/johnmorrisdotca/kazu) (数): grid number puzzles: Sudoku and its variants, Futoshiki and Skyscrapers. [Demo](https://johnmorrisdotca.github.io/kazu/).
+- [Kyuubu](https://github.com/johnmorrisdotca/kyuubu) (キューブ): a turning cube for the browser, 2×2 to 7×7, with record solves to replay. [Demo](https://johnmorrisdotca.github.io/kyuubu/).
 - [Meikyuu](https://github.com/johnmorrisdotca/meikyuu) (迷宮): mazes on squares, hexagons, triangles and circles, made from a seed and drawn through with a finger or the mouse. [Demo](https://johnmorrisdotca.github.io/meikyuu/).
+- [Suido](https://github.com/johnmorrisdotca/suido) (水道): a pipe puzzle: turn the pieces until the water reaches every drain. [Demo](https://johnmorrisdotca.github.io/suido/).
+- [Tobiishi](https://github.com/johnmorrisdotca/tobiishi) (飛び石): peg solitaire with nine boards and seeded solvable challenges. [Demo](https://johnmorrisdotca.github.io/tobiishi/).
+- [Tsunagi](https://github.com/johnmorrisdotca/tsunagi) (繋ぎ): a line-joining logic puzzle whose every level has exactly one answer. [Demo](https://johnmorrisdotca.github.io/tsunagi/).
+
+**Games — dice & random**
+
+- [Korokoro](https://github.com/johnmorrisdotca/korokoro) (コロコロ): dice, with notation, exact odds, real sounds and the dice of many games. [Demo](https://johnmorrisdotca.github.io/korokoro/).
+- [Tane](https://github.com/johnmorrisdotca/tane) (種): seeded random numbers and daily seeds, the same in every browser and on every server. [Demo](https://johnmorrisdotca.github.io/tane/).
+
+**Language**
+
+- [Bushu](https://github.com/johnmorrisdotca/bushu) (部首): find a kanji by the parts it is made of. [Demo](https://johnmorrisdotca.github.io/bushu/).
 - [Hikidashi](https://github.com/johnmorrisdotca/hikidashi) (引き出し): a drawer of small Japanese text tools: era dates, kanji numerals, readings and sentence difficulty. [Demo](https://johnmorrisdotca.github.io/hikidashi/).
+- [Kotoba](https://github.com/johnmorrisdotca/kotoba) (言葉): word lists and word-game rules in English, French, German and Japanese. [Demo](https://johnmorrisdotca.github.io/kotoba/).
+
+**Geography & data**
+
+- [address-plus](https://github.com/johnmorrisdotca/address-plus) (アドレスプラス): parse and format addresses in the United States, Canada, Japan, Australia, France, Germany and the United Kingdom. [Demo](https://johnmorrisdotca.github.io/address-plus/).
 - [Chizu](https://github.com/johnmorrisdotca/chizu) (地図): maps of the world and of countries' regions, in English and Japanese, with a quiz and callouts. [Demo](https://johnmorrisdotca.github.io/chizu/).
-- [Bushu](https://github.com/johnmorrisdotca/bushu) (部首): find a kanji by the parts it is made of. [Demo](https://johnmorrisdotca.github.io/bushu/).
-- [Tobiishi](https://github.com/johnmorrisdotca/tobiishi) (飛び石): peg solitaire with nine boards and seeded solvable challenges. [Demo](https://johnmorrisdotca.github.io/tobiishi/).
-- [Jirai](https://github.com/johnmorrisdotca/jirai) (地雷): minesweeper on shaped grids with verified no-guess boards. [Demo](https://johnmorrisdotca.github.io/jirai/).
-- [Gunjin](https://github.com/johnmorrisdotca/gunjin) (軍人): five hidden-rank strategy games with pass-the-device play. [Demo](https://johnmorrisdotca.github.io/gunjin/).
-- [Karakuri](https://github.com/johnmorrisdotca/karakuri) (からくり): eight hyper-casual puzzle games, some of them physics: draw a shield, pull pins, cut ropes, slide blocks, pour tubes. [Demo](https://johnmorrisdotca.github.io/karakuri/).
-- [Houseki](https://github.com/johnmorrisdotca/houseki) (宝石): gem and stone matching puzzles: falling triplets, stone collapse, colour chains and gem swap. [Demo](https://johnmorrisdotca.github.io/houseki/).
-- [Kyogijo Stadiums](https://github.com/johnmorrisdotca/kyogijo-stadiums) (競技場): sports fields, rinks, courts and ballparks drawn to scale as SVG, with each team and the score on them. [Demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/).
-- [Taisen Brackets](https://github.com/johnmorrisdotca/taisen-brackets) (対戦): a sport-agnostic tournament bracket, drawn as SVG, from a list of ties. [Demo](https://johnmorrisdotca.github.io/taisen-brackets/).
+- [Hata](https://github.com/johnmorrisdotca/hata) (旗): country and regional flags as SVG, at their true proportions and keyed by ISO code. [Demo](https://johnmorrisdotca.github.io/hata/).
+- [Kuni](https://github.com/johnmorrisdotca/kuni) (国): countries and their regions, with ISO codes and names in English and Japanese. [Demo](https://johnmorrisdotca.github.io/kuni/).
+
+**Sports**
+
 - [Dougu Sports](https://github.com/johnmorrisdotca/dougu-sports) (道具): sports emblems as SVG: trophies, medals, crests, and the ball and gear of every sport, with optional 3D turning. [Demo](https://johnmorrisdotca.github.io/dougu-sports/).
+- [Kyogijo Stadiums](https://github.com/johnmorrisdotca/kyogijo-stadiums) (競技場): sports fields, rinks, courts and ballparks drawn to scale as SVG, with each team and the score on them. [Demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/).
 - [Senshu Jerseys](https://github.com/johnmorrisdotca/senshu-jerseys) (選手): sports jerseys, sweaters, kits, caps, helmets and retired-number banners as SVG, front and back, with optional 2.5D turning. [Demo](https://johnmorrisdotca.github.io/senshu-jerseys/).
+- [Taisen Brackets](https://github.com/johnmorrisdotca/taisen-brackets) (対戦): a sport-agnostic tournament bracket, drawn as SVG, from a list of ties. [Demo](https://johnmorrisdotca.github.io/taisen-brackets/).
+
+**Developer tools**
+
+- [REST in Pieces](https://github.com/spxis/rest-in-pieces) (レスト・イン・ピーシーズ): seeded test data and REST APIs for frontend development, with latency and error drills. [Demo](https://spxis.github.io/rest-in-pieces/).
+
 
-**This package is Kyogijo Stadiums.** The demos of all twenty-eight share one header and footer, so each links the rest.
+**This package is Kyogijo Stadiums.** The demos of all thirty-two share one header and footer, so each links the rest.
 <!-- family:end -->
 
 ## Development

package/dist/atlas.d.ts

@@ -135,6 +135,9 @@ export type PlaceSurface = {
 } | {
     sport: "soccer";
     ground?: string;
+} | {
+    sport: "athletics";
+    ground?: string;
 } | {
     sport: "nhl" | "nba";
     arena?: string;
@@ -158,7 +161,8 @@ export type SurfaceSport = PlaceSurface["sport"];
 export declare const hallSurfaces: (place: Place) => readonly HallSurface[];
 /**
  * Every surface a place offers, the place's own first: a park's fence (`mlb` with the park) or a ground's pitch at its size (`soccer` with the ground), then one for each
- * sport a tenant plays that the package draws (a CFL field for BC Place, an NFL field for MetLife Stadium, the rugby league field for Stadium Australia), each once. A ground
+ * sport a tenant plays that the package draws (a CFL field for BC Place, an NFL field for MetLife Stadium, the rugby league field for Stadium Australia), each once, and the
+ * athletics stadium (`athletics` with the ground) of a ground whose `track` is set. A ground
  * offers no ballpark, since its fence is not known; a park that a soccer club has played in offers the pitch at the international size, since its length and width are not known.
  * @example
  * ```ts

package/dist/atlas.js

@@ -226,7 +226,8 @@ const hallOptions = (surface) => ({ sport: surface.sport, ...surface.options });
 export const hallSurfaces = (place) => (place.kind === "hall" ? (place.hall?.surfaces ?? []) : []);
 /**
  * Every surface a place offers, the place's own first: a park's fence (`mlb` with the park) or a ground's pitch at its size (`soccer` with the ground), then one for each
- * sport a tenant plays that the package draws (a CFL field for BC Place, an NFL field for MetLife Stadium, the rugby league field for Stadium Australia), each once. A ground
+ * sport a tenant plays that the package draws (a CFL field for BC Place, an NFL field for MetLife Stadium, the rugby league field for Stadium Australia), each once, and the
+ * athletics stadium (`athletics` with the ground) of a ground whose `track` is set. A ground
  * offers no ballpark, since its fence is not known; a park that a soccer club has played in offers the pitch at the international size, since its length and width are not known.
  * @example
  * ```ts
@@ -260,6 +261,9 @@ export function surfacesOf(place) {
             continue;
         out.push(surface);
     }
+    // A ground with a running track round its pitch (`track`) also offers the athletics stadium: the track and its field events round the ground's own pitch.
+    if (place.kind === "ground" && place.track === true && !out.some((have) => have.sport === "athletics"))
+        out.push({ sport: "athletics", ground: place.id });
     return out;
 }
 export function surfaceOf(place, sport) {

package/dist/layers.env.d.ts

@@ -42,6 +42,16 @@ export interface Env {
  * `data-index` (its place in the layer's data) and `data-zone` (the zone it lies in, from `zoneAt`'s rules). The place is in feet in the drawing's wide frame.
  */
 export declare function markAttrs(env: Env, id: unknown, index: number, at?: readonly [number, number], name?: string): string;
+/**
+ * The tooltip of a mark: the caller's own `title`, else (only when the layer writes `data-mark-id` and friends, for a listener that reads the mark's name)
+ * a short one made from what the datum says: its outcome, its team and its place in the data ("goal, home, 3"). Nothing is added when the marks are not
+ * written, so a drawing that nobody points at is the same text as ever.
+ */
+export declare function markTitle(env: Env, d: {
+    title?: unknown;
+    outcome?: unknown;
+    team?: unknown;
+}, index: number): string | undefined;
 /** What a layer made. */
 export interface Made {
     /** The elements of the layer, and its gradients as `defs`. */

package/dist/layers.env.js

@@ -40,6 +40,19 @@ export function markAttrs(env, id, index, at, name = "data-zone") {
     const zone = at === undefined ? undefined : env.zone(at[0], at[1]);
     return ` data-mark-id="${esc(given)}" data-index="${index}"${zone === undefined ? "" : ` ${name}="${esc(zone)}"`}`;
 }
+/**
+ * The tooltip of a mark: the caller's own `title`, else (only when the layer writes `data-mark-id` and friends, for a listener that reads the mark's name)
+ * a short one made from what the datum says: its outcome, its team and its place in the data ("goal, home, 3"). Nothing is added when the marks are not
+ * written, so a drawing that nobody points at is the same text as ever.
+ */
+export function markTitle(env, d, index) {
+    if (typeof d.title === "string" && d.title !== "")
+        return d.title;
+    if (!env.marks)
+        return undefined;
+    const word = (v) => (typeof v === "string" ? v.trim() : "");
+    return [word(d.outcome), word(d.team), String(index + 1)].filter((part) => part !== "").join(", ");
+}
 export const toArray = (value, what) => {
     if (!Array.isArray(value))
         throw new TypeError(`${what} needs data: a list of marks`);

package/dist/layers.js

@@ -11,7 +11,7 @@ import { FRAMES } from "./frames.js";
 import { KYOGIJO_HEAT_STYLE, KYOGIJO_TEAM_STYLE } from "./style.js";
 import { drawTeam, isTeamLayer, teamTables } from "./team.layers.js";
 import { drawHeat, drawLegend, heatTable } from "./heat.js";
-import { clamp01, envFor, isNum, markAttrs, newMade, opacityOf, own, place, toArray, unitOfLayer } from "./layers.env.js";
+import { clamp01, envFor, isNum, markAttrs, markTitle, newMade, opacityOf, own, place, toArray, unitOfLayer } from "./layers.env.js";
 import { safeClass } from "./common.js";
 import { esc, num } from "./format.js";
 import { curveBetween, curvePath, headPath, isPolygon, polylinePath, rampColour, shapePath, taperPath, wavePath, } from "./layers.marks.js";
@@ -144,12 +144,12 @@ function drawPoints(layer, env) {
         const logo = shape === "logo" ? safeLogo(d.logo) ?? (role === undefined ? undefined : safeLogo(style.logos?.[role]) ?? env.logos[role]) : undefined;
         if (logo !== undefined) {
             const side = w * 1.8;
-            out.push(titled("image", `${open} href="${esc(logo)}" x="${num(x - side / 2)}" y="${num(y - side / 2)}" width="${num(side)}" height="${num(side)}" preserveAspectRatio="xMidYMid meet"${env.back !== 0 ? ` transform="rotate(${num(env.back)} ${num(x)} ${num(y)})"` : ""}`, d.title));
+            out.push(titled("image", `${open} href="${esc(logo)}" x="${num(x - side / 2)}" y="${num(y - side / 2)}" width="${num(side)}" height="${num(side)}" preserveAspectRatio="xMidYMid meet"${env.back !== 0 ? ` transform="rotate(${num(env.back)} ${num(x)} ${num(y)})"` : ""}`, markTitle(env, d, i)));
         }
         else if (shape !== "logo" && isPolygon(shape))
-            out.push(titled("path", `${open} d="${shapePath(shape, x, y, w, env.turned)}"`, d.title));
+            out.push(titled("path", `${open} d="${shapePath(shape, x, y, w, env.turned)}"`, markTitle(env, d, i)));
         else
-            out.push(titled("circle", `${open} cx="${num(x)}" cy="${num(y)}" r="${num(w / 2)}"`, d.title));
+            out.push(titled("circle", `${open} cx="${num(x)}" cy="${num(y)}" r="${num(w / 2)}"`, markTitle(env, d, i)));
     });
     made.marks = out.join("");
     return made;
@@ -259,7 +259,8 @@ function drawLines(layer, env, index) {
                 gradient = `stroke:url(#${gid})`;
         }
         const headEl = head === "" ? "" : `<path class="${headKind === "open" ? "ky-ln" : "ky-ah"}" d="${head}"${headKind === "open" ? ` stroke-width="${num(w)}"` : ""}/>`;
-        const title = typeof d.title === "string" && d.title !== "" ? `<title>${esc(d.title)}</title>` : "";
+        const named = markTitle(env, d, i);
+        const title = named === undefined ? "" : `<title>${esc(named)}</title>`;
         const opacity = opacityOf(d.opacity);
         // Where it starts is its zone; where it ends is `data-zone-end`.
         const marks = env.marks ? markAttrs(env, d.id, i, first) + (env.zone(last[0], last[1]) === undefined ? "" : ` data-zone-end="${esc(env.zone(last[0], last[1]))}"`) : "";

package/dist/multi-entry.d.ts

@@ -0,0 +1,7 @@
+export { drawMulti, multiSetting, multiTable } from "./multi.draw.ts";
+export { MULTI_MAX, fitSentence, multiFit, multiLayout, needsSentence, specOf, venueOf } from "./multi.ts";
+export { MULTI_PRESETS, MULTI_PRESET_IDS, MULTI_SOURCES, MULTI_VENUES, multiPreset, multiSource, multiVenueById } from "./multi.data.ts";
+export { KYOGIJO_MULTI_STYLE } from "./multi.style.ts";
+export { MULTI_WORDS } from "./multi.words.ts";
+export type { MultiWords } from "./multi.words.ts";
+export type { MultiBasis, MultiCell, MultiEvent, MultiFit, MultiFloor, MultiLayout, MultiNeeds, MultiOptions, MultiParts, MultiSize, MultiSlot, MultiSpec, MultiSurface, MultiUnit, MultiVenue, MultiWord } from "./multi.types.ts";

package/dist/multi-entry.js

@@ -0,0 +1,8 @@
+// Tournament layouts: several of the package's surfaces laid out together for one large event, to scale, on one floor (tables, courts, sheets, a judo floor's contest areas in a row), with the barriers, the
+// officials' chairs, a scoreboard hung over the middle, the boards and the empty places for the event's own words and marks; the real configurations of events as presets, each with its rule; the halls whose
+// floors are published, and whether a layout fits one; and a real stadium round the floor at the same scale. `multiTable` is the text alternative.
+export { drawMulti, multiSetting, multiTable } from "./multi.draw.js";
+export { MULTI_MAX, fitSentence, multiFit, multiLayout, needsSentence, specOf, venueOf } from "./multi.js";
+export { MULTI_PRESETS, MULTI_PRESET_IDS, MULTI_SOURCES, MULTI_VENUES, multiPreset, multiSource, multiVenueById } from "./multi.data.js";
+export { KYOGIJO_MULTI_STYLE } from "./multi.style.js";
+export { MULTI_WORDS } from "./multi.words.js";

package/dist/multi.d.ts

@@ -0,0 +1,42 @@
+import type { MultiFit, MultiLayout, MultiNeeds, MultiOptions, MultiSpec, MultiVenue } from "./multi.types.ts";
+import type { Language } from "./types.ts";
+/** The most rows or columns a layout takes. */
+export declare const MULTI_MAX = 12;
+/** A number as a language writes it: thousands separated, two decimals at most (`3,234.5`). */
+export declare const multiNumber: (value: number, language?: Language) => string;
+/**
+ * The layout the options ask for: a preset or a layout of the caller's own, with the grid and the stagger it is given in place of its own.
+ * @throws Error for a preset that is not one, an option that is not a whole number or a share, or neither a preset nor a layout.
+ */
+export declare function specOf(o: Pick<MultiOptions, "preset" | "layout" | "rows" | "columns" | "stagger">): MultiSpec;
+/**
+ * A layout laid out: where each surface stands, the floor it needs and the empty places for the event's own words and marks, all in feet from the top left corner of the floor (and the floor's size
+ * and what the layout needs in metres).
+ * @example
+ * ```ts
+ * import { multiLayout } from "@johnmorrisdotca/kyogijo-stadiums/multi";
+ * const layout = multiLayout({ preset: "tabletennis-4" });
+ * console.log(layout.cells.length, layout.needs.length, layout.needs.width);
+ * // 4 28 14
+ * ```
+ */
+export declare function multiLayout(options?: Pick<MultiOptions, "preset" | "layout" | "rows" | "columns" | "stagger" | "language">): MultiLayout;
+/** A hall as the caller gives it, or a key of `MULTI_VENUES`. @throws Error for a key that is not one, a size that is not positive. */
+export declare function venueOf(venue: MultiOptions["venue"]): MultiVenue | undefined;
+/**
+ * Whether a layout fits a hall's floor. A floor that is a rectangle takes the layout as it is or turned a quarter; an octagon takes it if its corners are inside; a floor of which only the area is published
+ * can only be compared by area, and says so (`fits` is `null` when the area is enough, because the shape may still not take it).
+ * @example
+ * ```ts
+ * import { multiFit, multiLayout } from "@johnmorrisdotca/kyogijo-stadiums/multi";
+ * const four = multiFit(multiLayout({ preset: "curling-1x4" }), "nhl-ice-pad");
+ * const six = multiFit(multiLayout({ preset: "curling-1x4", columns: 6 }), "nhl-ice-pad");
+ * console.log(four.fits, four.turned, six.fits);
+ * // true true false
+ * ```
+ */
+export declare function multiFit(layout: MultiLayout, venue: MultiOptions["venue"]): MultiFit;
+/** The sentence that says how a layout sits in a hall, in a language. */
+export declare function fitSentence(fit: MultiFit, language?: Language): string;
+/** The size of a layout as words, in a language: `28 by 14 metres (392 square metres)`; along the layout first, then across it. */
+export declare const needsSentence: (needs: MultiNeeds, language?: Language) => string;

package/dist/multi.data.d.ts

@@ -0,0 +1,22 @@
+import { type LeagueSource } from "./leagues/sources.ts";
+import type { MultiSpec, MultiVenue } from "./multi.types.ts";
+/** The documents a layout's figures were read from, by id, beside the rulebooks of `LEAGUE_SOURCES` (a key of either names a source). */
+export declare const MULTI_SOURCES: Readonly<Record<string, Readonly<LeagueSource>>>;
+/** The source a key names, from `MULTI_SOURCES` or `LEAGUE_SOURCES`. */
+export declare const multiSource: (id: string) => Readonly<LeagueSource> | undefined;
+/**
+ * The halls whose floor is published, and the two ice pads an arena lays in winter. A venue with no length and width (only an area) is compared by area. The package does not hold the floors of
+ * halls it could not source: a layout for such a hall is set on a floor of the caller's own size.
+ */
+export declare const MULTI_VENUES: readonly MultiVenue[];
+/** The hall with a key, or `undefined`. */
+export declare const multiVenueById: (id: string | undefined) => MultiVenue | undefined;
+/**
+ * The presets: layouts of real configurations, each with its rule and, where one is named, the event and the hall. `rulebook` means the spacing is what a rulebook or a specification asks for; `event`
+ * means an event used the arrangement (read from reports and photographs, with no plan seen). The list is in the order of the sports of this package's own menu.
+ */
+export declare const MULTI_PRESETS: readonly MultiSpec[];
+/** The keys of `MULTI_PRESETS`, in order. */
+export declare const MULTI_PRESET_IDS: readonly string[];
+/** The preset with a key, or `undefined`. */
+export declare const multiPreset: (id: string | undefined) => MultiSpec | undefined;