@johnmorrisdotca/kyogijo-stadiums 0.18.1 → 0.20.0

package/CHANGELOG.md

@@ -7,6 +7,32 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.20.0] - 2026-10-20
+
+### Added
+
+- **The MMA cage** (`sport: "mma"`, [the combat sports page](./docs/combat.md)): an eight-sided fenced area on its platform, to scale, from the Nevada Rules of Unarmed Combat (5.010 3) and the IMMAF's rules for amateur competition: 20 to 32 feet across the flats (`budo.size`, 30 feet drawn and 25 feet the smaller cage), a platform of at most 4 feet (`budo.height`) with steps up at each gate, a fence of 5 to 7 feet (`budo.fence`, 6 feet drawn), eight padded posts, two gates opposite each other and a canvas over foam, with a grey, a black and a blue look in light and dark. The leagues are `nruc` and `immaf`; `RANGES.mma` has `cage`, `gate` and `half`; the parts are named for `landmarks` and the features for `featureColors`, in English and Japanese. The cage is named for what it is, an eight-sided cage: no promotion's name or mark is used. It is a sport of the package (40 now), with `SPORTS`, a unit of feet, no home side, a badge glyph, a crowd profile and its sources in `LEAGUE_SOURCES` (the figure of the rule, the figure that is typical and the figure that is ours are told apart).
+- **The cage in 3D** (`buildTurn({ sport: "mma" })`): the platform is a solid block (four sides to the floor of the hall and a top that is the drawing's own canvas, lifted), the fence is wire mesh on each of its eight flats with a pad along the top and the foot so that the canvas stays in sight, and gives way to an eye that has it in front of the cage, the posts are solid, the gates are frames of padded rails, and the steps are three blocks each. Tests hold the order the parts are drawn in from every side, the size of the view as it turns and the scene inside its box at every angle.
+- **The demo** has the cage in its sport picker, with the looks, the cage's width (30 or 25 feet, `cagesize` in the address), the score of a bout and the 3D view; the docs have a page for it and a gallery of its own.
+
+## [0.19.0] - 2026-10-20
+
+### Added
+
+- **A broadcast view of a judging assignment** (`view: "broadcast"`). The mat large and prominent as a television would show it, 16:9, with the officials superimposed on a board at its side: the package's own score panel drawn for officials (the same dark rounded plate, the mat's name where a score panel has the competition, column heads, a row for each seat with its number on the round badge the seats wear, the name on a coloured chip, the ID where a score would be, and the style at the foot). The board lies beside the contest area and never over it (a test holds the board clear of the mat's picture and of the middle of the contest area for kata and shiai, a bench close up, six long names, and every width), the seat badges stay on the seats, and the whole picture scales evenly: no text is stretched (a test: every font size is in proportion at twice the width). A mat takes a `line` (`Round 2`, `Pool B`, at most 60 characters) shown before the style at the board's foot. `drawJudging` draws it in 2D; `mountJudgingBroadcast` mounts the 3D view from the Broadcast camera with the board laid over it (a share of the view's width so it scales with it, under the view where that is narrower than 640 px, and never taking the pointer); `judgingBoard` is the board alone for a page of your own. Light and dark, English and Japanese. The demo opens it with `?view=broadcast` (3D) or `?view=broadcast&dim=2d`.
+- **Printing the plan-and-chart layout** (`judgingPrint`, `judgingPrintSheets`, `judgingPrintStyle`, `JUDGING_PAPER`). One mat to a page on A4 or US letter, portrait or landscape, in the light colours, the picture scaled evenly to the page and anchored at its top; `judgingPrint` is a whole HTML document that opens as the pages on a grey desk and prints as they are (Save as PDF for a file). The demo has a "Print or save as PDF" button with a choice of paper (`?paper=letter`).
+- `JudgingDrawing.boards` (where each mat's board, the part of the mat shown and the middle of the contest area are), `matLine`, `KYOGIJO_JUDGING_BOARD_STYLE`, `KYOGIJO_JUDGING_BROADCAST_STYLE`, `BOARD_BASE`, `BROADCAST_RATIO`, `boardFoot`.
+
+### Fixed
+
+- **A box with the picture's words no longer pops up over the mat.** A `<title>` that is a direct child of the root `<svg>` is the browser's tooltip for the whole drawing, so resting the pointer on the 2D plan showed "Judging assignments: Kata, 5 judges, 2 mats" in a box on top of the mat, and on a score on a surface "Mexico 11, USA 10, Final" over its top left. A judging picture now keeps its title and description in a `<defs>` (the picture is still named by them: `aria-labelledby` points at them), and the demo's pages move the title of every drawing they show into a `<defs>` the same way (`demo/quiet.js`); a surface's own markup is unchanged byte for byte, so a page that wants no tooltip does the same with its drawings.
+
+- **Chart lines stay inside their rows in a wide face.** The chart's name and ID lines were fitted to an estimate of the face's width, and in a wider face (Verdana on Windows, DejaVu Sans on Linux, where the demo's browser test of 0.18.1 failed) the last words of a long name crossed the row's right edge by a few pixels. The chart now fits its lines to 94 % of the room, and a browser test sets the board and the chart in Verdana and DejaVu Sans.
+
+### Changed
+
+- The plan view of a judging assignment moved its title and description into a `<defs>` (see above); everything else it draws is as it was. The plan's drawing code is in `judging.plan.ts` and the words in `judging.text.ts`, shared by both views.
+
 ## [0.18.1] - 2026-10-20
 
 ### Changed

package/NOTICE.md

@@ -35,6 +35,7 @@ picture or code of the sources is copied; each source is named here so that the
 | `leagues`: the skating rinks | The International Skating Union's Sports Rules - Speed Skating (Special Regulations and Technical Rules, Rules 203 to 206, 226 to 228 and 253 to 257, and "H. Track", effective 12 June 2026), Special Regulations and Technical Rules Short Track Speed Skating (Rule 280 and the diagram of the tracks, 2024) and Sports Rules - Figure Skating (Rule 342, effective 12 June 2026) | Facts; no text or drawing copied |
 | `leagues` and `halls`: the budō surfaces | The International Judo Federation's Sport and Organisation Rules (version of 21 January 2026, 8.7, Article 9, B1.8; and the June 2020 version, 18.1) and its Kata Commission's Tournament Handbook (2024) and Criteria for the Evaluation (January 2025); the All Japan Judo Federation's 大会運営ガイドブック2023; the World Karate Federation's Kumite and Kata Competition Rules (2026); the International Kendo Federation's Regulations of Kendo Shiai and Shinpan (Article 2 and Figure 1); the Japan Sumo Association's 相撲規則 土俵規定 第一条 and 大相撲クイズ, as the Sasakawa Sports Foundation and ozumo.jp quote them; the All Nippon Kyudo Federation's 弓道競技運営要領 (2016) and the National Sports Festival 2015's rules for kinteki and enteki; the tatami sizes of English and Japanese Wikipedia; the Kodokan's 施設のご案内, the Nippon Budokan's 日本武道館建物等概要 (October 2021), and English and Japanese Wikipedia and Wikidata on the five halls and the kimarite | Facts |
 | `frames`: the soccer providers' coordinates | StatsBomb's Open Data Events specification (Appendix 2), the Wyscout and Impect glossaries, the Metrica Sports and SkillCorner open-data READMEs; for Opta, Tracab and Second Spectrum, whose specifications are not public, the figures of mplsoccer, ggsoccer, kloppy and floodlight (docs/sources.md) | Facts; no text, table or code copied |
+| `leagues`: the MMA cage | The Nevada Rules of Unarmed Combat (NRUC 5.010, the file of 20 November 2024), Oregon Administrative Rule 230-070-0025, the IMMAF's Unified Rules for amateur, junior and senior competition (January 2021), and the English Wikipedia articles "Mixed martial arts cage" (revision 1377260922) and "Mixed martial arts" (revision 1381048799), for the sizes that are typical | Facts, CC BY-SA 4.0 for the Wikipedia text read |
 | `parks`: the fence of each ballpark, current and past, and the seasons of a past park | The distances (and, for a park whose fence moved, the years an article dates them) published in the English and Japanese Wikipedia article of each park, at the revision cited below; the seasons a club played there from the same article's list of tenants | Facts. The articles are CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/); none of their text, tables or images is used, and the angles between the distances are our own reading |
 | `parks`: the Wikidata item of each ballpark (`wikidata`) | The item (`Q49136`) that each cited article is linked to, read with the MediaWiki API (`pageprops`, `wikibase_item`) and checked against the item's label | Wikidata's data is CC0 (https://creativecommons.org/publicdomain/zero/1.0/) |
 | `parks` and `grounds`: the names (`name`, `nameJa`, `readingJa`, `localName`, `aliases`) | The names are facts. Each alias says where it was read (`source`): the title of the English or Japanese Wikipedia article a place cites (with its revision), a name the infobox or the opening text of the same revision gives (a former or sponsor's name with the years it dates, a nickname, the name in Japanese and its reading), or Wikidata's labels, aliases and properties "official name" (P1448), "nickname" (P1449), "name" (P2561), "short name" (P1813), read with the Wikidata API by `scripts/fetch-names.mjs` into `scripts/names.wikidata.json` | Facts; Wikidata's data is CC0 (https://creativecommons.org/publicdomain/zero/1.0/), and the articles are CC BY-SA 4.0 as above, none of their text copied. Which name is the everyday one is our reading, in docs/references.md ("Names") |

package/README.md

@@ -1,7 +1,7 @@
 <h1 align="center">Kyogijo Stadiums <sub>競技場</sub></h1>
 
 <p align="center"><strong>Sports surfaces as SVG, drawn to scale, with the score on them.</strong><br>
-The NFL, CFL and IFAF football fields, the NHL rink, the NBA court, the soccer pitch and futsal court, the baseball field of every MLB ballpark, current and past, and every NPB home park, the rink and court of 167 NHL, NBA, WNBA and PWHL arenas, and the surfaces of curling, athletics, speed, short track and figure skating, swimming, water polo, diving, artistic swimming, 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, handball, judo, karate, kendo, sumo, kyūdō and a dojo of tatami, thirty-nine sports in all, each drawn from its rulebook or its published distances, with each team's name and logo on its side and the score in the middle, a lineup and the situation of the game on them, with stands and a crowd, a pageant of flags and a 3D view. Wide or tall, light or dark, a badge for a list, a helper for React, a custom element and a frame for a page that runs no script. One function, no dependencies.</p>
+The surfaces of forty sports, from football and curling to the budō and the MMA cage, each drawn from its rulebook or its published distances, with each team's name and logo on its side and the score in the middle, a lineup and the situation of the game on them, with stands and a crowd, a pageant of flags and a 3D view. Wide or tall, light or dark, a badge for a list, a helper for React, a custom element and a frame for a page that runs no script. One function, no dependencies.</p>
 
 <p align="center">
   <a href="https://github.com/johnmorrisdotca/kyogijo-stadiums/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/johnmorrisdotca/kyogijo-stadiums/actions/workflows/ci.yml/badge.svg"></a>
@@ -20,14 +20,14 @@ The NFL, CFL and IFAF football fields, the NHL rink, the NBA court, the soccer p
 <td align="center" valign="top">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-desk-light.webp" alt="The demo on a desk, in English: the heading Kyogijo Stadiums with the language chooser, the Docs and API reference links, five cloth patches and the Help switch, and an NHL rink drawn wide on an ice-blue background of faint skate marks and rink lines, with a made-up game on it, the USA and its flag on the left, Canada and its flag on the right, and a panel of the score 3 to 2, Final/OT, in the middle. The controls on the right list the sports, from the NFL and the NHL to handball, and then the layout and the teams." width="640">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-desk-light.webp" alt="The demo on a desk, in English: the heading, the language chooser and links, and an NHL rink drawn wide on an ice-blue background with a made-up game on it, the USA on the left, Canada on the right and the score 3 to 2, Final/OT, in the middle. The controls on the right list the sports, the layout and the teams." width="640">
 </picture>
 <br><em>The demo on a desk: a rink, with the teams on their sides and the score in the middle.</em>
 </td>
 <td align="center" valign="top">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-phone-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-phone-light.webp" alt="The demo on a phone: the heading Kyogijo Stadiums over the page's controls, and under them, on a background of floodlight beams, a football field turned a quarter to stand tall, Mexico's green end zone at the top and the USA's navy end zone at the bottom, each with its flag and name written across it, the yard numbers upright, and a score panel at midfield reading 27 to 24, Final." width="240">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/hero-phone-light.webp" alt="The demo on a phone: the heading and controls, and under them, on a background of floodlight beams, a football field standing tall, Mexico's green end zone at the top and the USA's navy one at the bottom, each with its flag and name, and a score panel at midfield reading 27 to 24, Final." width="240">
 </picture>
 <br><em>On a phone the same surface stands tall, the words still upright.</em>
 </td>
@@ -65,27 +65,27 @@ console.log(svg.startsWith("<svg"), svg.includes("USA 3, Canada 2"));
 
 ## Who it is for
 
-- **A results page or a stats site** that has the score of a game and wants a picture of where it was played: the teams, the score, the round and the date, with the winner clear.
+- **A results page or a stats site** that has a game's score and wants a picture of where it was played.
 - **A list of games** that needs a compact strip for each, small enough for a phone.
-- **Anyone drawing a rink, a field, a court or a ballpark** for a poster, a diagram or a lesson, who wants the dimensions right and the colours their own.
+- **Anyone drawing a rink, field, court or ballpark** for a poster or a lesson, with the dimensions right and the colours their own.
 - **A site that uses a framework or none**: the drawing is a string, so it works from a server, a build step, a framework, a custom element or a frame.
 
 ## Features
 
-- **Thirty-nine surfaces, to scale.** The NFL, CFL and IFAF fields, the NHL rink, the NBA court, the soccer pitch and futsal court, the baseball field, the curling sheet, the courts of twelve net and racket sports, the pools, the athletics stadium, the skating rinks, the fields of seven field sports, and the budō. Every figure is cited in [sources](./docs/sources.md). [The surfaces](./docs/surfaces.md).
+- **Forty surfaces, to scale.** The NFL, CFL and IFAF fields, the NHL rink, the NBA court, the soccer pitch and futsal court, the baseball field, the curling sheet, twelve net and racket sports, the pools, the athletics stadium, the skating rinks, seven field sports, the budō and the MMA cage. Every figure is cited in [sources](./docs/sources.md). [The surfaces](./docs/surfaces.md).
 - **Each league's rulebook.** `league: "fiba"` draws a court as FIBA marks it: 48 variants, from the WNBA, the NCAA and the IIHF to Little League, PONY, softball, Curling Canada, FIVB's beach volleyball, rugby league and the NLL's box lacrosse, each cited. [League variants](./docs/variants.md).
 - **A realistic basketball floor.** `court: { hardwood: true }` draws maple boards that run the length of the court with staggered ends, grain, stained keys, the baskets and stanchions with soft shadows, a coaching box and benches, and a satin sheen, in every league and renderer. The clean floor stays the default. [Hardwood](./docs/hardwood.md).
 - **The stands and the crowd.** `crowd: true` draws the seating round any surface that has spectators: a bowl, two sides, a horseshoe, courtside rows or a ballpark's grandstands, with the people as seeded heads and shoulders in the home colours and the empty seats showing (`density`, or `attendance` over `capacity`). [The crowd](./docs/crowd.md).
 - **Curling, from the rule books.** A sheet from World Curling's and Curling Canada's rules, tall by default, with the board and the hammer in a score, `curlingStones` for the stones of an end, scored by the rules, `show: "folded"` for the whole sheet with both houses enlarged beside it, and a heat map and statistics for many ends. [Curling](./docs/curling.md).
 - **Net, racket and court sports, from their rulebooks.** The ITF's, FIVB's (indoor, beach, sitting), BWF's, USA Pickleball's and ITTF's courts and table, the padel, squash, racquetball, sepak takraw, teqball, roundnet and netball courts, each in its look (hard court, clay, grass, wood, sand), with a board of sets and games. [Net, racket and court sports](./docs/courts.md).
-- **Swimming, water polo, diving and artistic swimming, from World Aquatics' regulations.** The competition pool of 50 or 25 m with its lanes, ropes, blocks and touch panels; the water polo field; the diving well; the artistic swimming area; several pools in a natatorium. A race's lanes carry names, flags, places, times and splits, with a replay (`raceTimeline`) and a `splitsChart`. [Pools](./docs/pools.md).
+- **Swimming, water polo, diving and artistic swimming, from World Aquatics' regulations.** The 50 or 25 m pool with its lanes, ropes, blocks and touch panels; the water polo field; the diving well; the artistic swimming area; several pools in a natatorium. A race's lanes carry names, flags, places, times and splits, with a replay and a `splitsChart`. [Pools](./docs/pools.md).
 - **Lacrosse, rugby, Australian football, Gaelic games, cricket, field hockey and handball, from their rulebooks.** The fields and floors of World Lacrosse, World Rugby, the NRL, the AFL, the GAA, the FIH and the IHF, and a cricket ground with a boundary of your own. A score is goals and behinds, goals and points or a board of runs, wickets and overs. [Field sports](./docs/field-sports.md).
 - **The athletics stadium, from World Athletics' rules.** The 400 m track with its lanes and staggers worked out from the running lines, curved and relay starts, hurdles, the steeplechase, every field event, a close-up of each start, the covered 200 m track, and lane draws, results, a race replay and the marks of throws and jumps. [The athletics stadium](./docs/athletics.md).
 - **The skating rinks, from the ISU's rules.** The 400 m speed skating track with its lanes, blocks and the lines of every race worked out lane by lane; the short track's oval; the figure skating rink of 60 by 30 m with its judges' seats; and pairs, results, a race replay and the elements of a programme on the ice. [The skating rinks](./docs/skating.md).
-- **The budō, from the federations' rules.** The IJF's and the All Japan Judo Federation's judo areas, the WKF's karate areas, the kendo shiai-jo, the sumo dohyō, the kyūdōjō, and **a dojo builder**: a floor of tatami laid as real units, in jō or metres, with its walls, doors, windows and shrine. Five famous halls are on the atlas, and the scores are judo's ippon, waza-ari and shido, karate's and kendo's points and sumo's kimarite. [The budō](./docs/budo.md).
+- **The budō, from the federations' rules.** The IJF's and the All Japan Judo Federation's judo areas, the WKF's karate areas, the kendo shiai-jo, the sumo dohyō, the kyūdōjō, and **a dojo builder**: a floor of tatami laid as real units, in jō or metres, with its walls, doors, windows and shrine. Scores are judo's ippon, waza-ari and shido, karate's and kendo's points and sumo's kimarite. [The budō](./docs/budo.md).
 - **Soccer, to the Laws.** A pitch from Law 1 of the IFAB Laws of the Game of any size, with presets (international, UEFA, MLS, NCAA, the FA's 9-, 7- and 5-a-side, FIFA's futsal), half pitches, five mowing patterns, four goal styles, penalties and extra time in a score. [Soccer](./docs/soccer.md).
 - **Every ballpark.** The 30 current MLB parks and 44 that MLB clubs have left, and the 12 home parks of Nippon Professional Baseball with eight other NPB grounds, each with its fence drawn from the distances published for it, as it stood in a season. [Ballparks](./docs/ballparks.md).
-- **Soccer grounds, arenas and an atlas.** 64 soccer grounds, each pitch at its published size, and 167 NHL, NBA, WNBA and PWHL arenas (`drawKyogijo({ sport: "nhl", arena: "boston-garden" })`), and every park, ground, arena and budō hall (330 places) on a map, by sport, league, country and year, each found by any of its names. [The grounds](./docs/grounds.md), [the arenas](./docs/arenas.md), [the atlas](./docs/atlas.md), [names](./docs/ballparks.md#names).
+- **Soccer grounds, arenas and an atlas.** 64 soccer grounds at their published sizes, 167 NHL, NBA, WNBA and PWHL arenas (`drawKyogijo({ sport: "nhl", arena: "boston-garden" })`), and every park, ground, arena and budō hall (330 places) on a map, found by any of its names. [The grounds](./docs/grounds.md), [the arenas](./docs/arenas.md), [the atlas](./docs/atlas.md), [names](./docs/ballparks.md#names).
 - **Walls and quirks.** How high the fence stands, stretch by stretch and season by season (the Green Monster at 37 feet 2 inches), drawn as a band outside the fence whose width and shade say the height, with a key (`walls`); and Tal's Hill, Wrigley Field's ivy and basket, poles, bullpens and dugouts (`quirks`), each from the park's article, none guessed: [ballparks](./docs/ballparks.md).
 - **Special games.** A surface set inside another, to scale: an NHL rink on a ballpark's infield or a football stadium's field, a college basketball court on the deck of a carrier, a baseball field laid over a London stadium's pitch. 18 games, each with its day, its venue and its sources. [Special games](./docs/special-games.md).
 - **Surfaces through the years.** `year: 1975` draws a surface as its league's rules marked it that season, each change cited. [Surfaces through the years](./docs/eras.md).
@@ -104,7 +104,7 @@ console.log(svg.startsWith("<svg"), svg.includes("USA 3, Canada 2"));
 - **Tournament layouts.** Several surfaces laid out together for one large event, to scale, on one floor, as one SVG: thirteen presets from table tennis, pickleball, curling, judo, karate, badminton and tennis, each with its rule and sources, whether it fits a hall, and a real stadium round it. [Tournament layouts](./docs/multi.md).
 - **Judging assignments.** Who judges where. [Judging](./docs/judging.md).
 - **Replay.** Tracking data played on any surface: the players with their numbers, the ball and its trail, and the passes, shots and goals as they happen, with controls, the keyboard and a live region, steps for a reader who prefers reduced motion, and a pause when the page is hidden. [Replay](./docs/replay.md).
-- **A 3D view.** Any surface as a floor that turns by mouse, touch, wheel or keys, with four viewpoints (overhead, broadcast, end-on, low corner), and what the rulebook stands on it at its height (nets, baskets, rink boards and glass, goals, a ballpark's fence, the walls of padel and squash, a pool's blocks, a table tennis area's surrounds); and the venue round it (raked stands, roofs on request, a dojo's walls and gallery). Plain DOM and CSS. [The 3D view](./docs/turn.md).
+- **A 3D view.** Any surface as a floor that turns by mouse, touch, wheel or keys, with four viewpoints (overhead, broadcast, end-on, low corner), and what the rulebook stands on it at its height (nets, baskets, rink boards and glass, goals, a ballpark's fence, a pool's blocks, a table tennis area's surrounds) and the venue round it (raked stands, roofs, a dojo's walls). Plain DOM and CSS. [The 3D view](./docs/turn.md).
 - **Renderers.** The same drawing as plain data (a scene), on a canvas (a browser's or a Node canvas), in a d3 selection, as a mark of an Observable Plot, as GeoJSON and as a PNG in Node, each an entry of its own that imports nothing from outside the package. [Renderers](./docs/renderers.md).
 - **Units and frames.** Each surface in its rulebook's unit and any other, and 48 coordinate frames (ten soccer providers, the NHL API, HockeyTech, NBA stats, NFL tracking, MLBAM, Retrosheet, and a place from the net, the centre or the middle of the water of each other surface) to move a provider's points onto a surface. [Units](./docs/units.md), [coordinate frames](./docs/frames.md).
 - **A compact badge and a compact card.** One strip for a list, or the surface with that strip under it.
@@ -119,7 +119,7 @@ console.log(svg.startsWith("<svg"), svg.includes("USA 3, Canada 2"));
 | Part | What it is |
 | --- | --- |
 | `drawKyogijo`, `drawSurface`, `drawScore`, `drawBadge` | The drawing, as a string of SVG. |
-| `SPORTS`, `PARKS`, `PARK_IDS`, `COURT_THEMES` | The thirty-nine sports, the 94 ballparks, the court looks. |
+| `SPORTS`, `PARKS`, `PARK_IDS`, `COURT_THEMES` | The forty sports, the 94 ballparks, the court looks. |
 | `SOCCER_PITCHES`, `SOCCER_PROVIDERS`, `rescale`, `soccerSpec` | The soccer pitches, the data providers' coordinate systems and the map between them. |
 | `GROUNDS`, `groundById` | The 64 soccer grounds, each pitch at its own size. |
 | `EVENTS`, `eventOptions` | The 18 special games: a rink in a ballpark, a court on a carrier's deck, with `host` and `placement` in the options. |
@@ -132,7 +132,7 @@ console.log(svg.startsWith("<svg"), svg.includes("USA 3, Canada 2"));
 | `./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)). |
-| `./judging` | `drawJudging`: who judges where ([docs](./docs/judging.md)). |
+| `./judging` | `drawJudging`, `judgingBoard`, `mountJudgingBroadcast`, `judgingPrint`: who judges where, as a plan, on a broadcast board or on paper ([docs](./docs/judging.md)). |
 | `./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. |
 
@@ -183,7 +183,7 @@ console.log(svg.includes("Cup Final, Game 7"), svg.includes("Final/OT"));
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/football-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/football-desk-light.webp" alt="A football field drawn wide on a background of floodlight beams: Mexico's green end zone on the left with its flag and its name written along it, the USA's navy end zone on the right with its flag, the yard lines, hash marks and upright and upside-down yard numbers between them, and the score panel at midfield reading 27 to 24, Final, Championship Game." width="720">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/football-desk-light.webp" alt="A football field drawn wide on a background of floodlight beams: Mexico's green end zone on the left with its flag and name, the USA's navy one on the right, the yard lines and numbers between them, and the score panel at midfield reading 27 to 24, Final, Championship Game." width="720">
 </picture>
 <br><em>A football field: the end zones in the teams' colours, the score at midfield.</em>
 </p>
@@ -228,12 +228,12 @@ console.log(box(wide), box(tall));
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/tall-phone-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/tall-phone-light.webp" alt="A hockey rink standing tall on a phone, on an ice-blue background, the same game as on the desk: the USA's flag and name in the upper zone, Canada's in the lower, each reading upright, the score panel between them over the centre line." width="240">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/tall-phone-light.webp" alt="A hockey rink standing tall on a phone, on ice blue: the USA's flag and name in the upper zone, Canada's in the lower, each upright, the score panel between them." width="240">
 </picture>
 <br><em>The same game tall: the teams top and bottom, every word upright.</em>
 </p>
 
-[The surfaces](./docs/surfaces.md) lists the thirty-nine, with their sizes and what is drawn; [score and layout](./docs/score.md) has the options of a score, a strip and a compact card.
+[The surfaces](./docs/surfaces.md) lists the forty, with their sizes and what is drawn; [score and layout](./docs/score.md) has the options of a score, a strip and a compact card.
 
 ### A league's rulebook
 
@@ -263,7 +263,7 @@ console.log(svg.includes("甲子園球場のグラウンド"), svg.includes("阪
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/ballpark-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/ballpark-desk-light.webp" alt="The baseball field of Hanshin Koshien Stadium on a royal purple background, with the outfield fence drawn through its published distances, 95 metres at the lines and 118 metres in the alleys and the middle, with mown arcs on the grass, the warning track, the infield dirt, and a red and a navy panel in the foul ground at the bottom for the teams' dugouts, each with its country's flag, Japan's and the USA's." width="640">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/ballpark-desk-light.webp" alt="The baseball field of Hanshin Koshien Stadium on a royal purple background: the outfield fence at its published distances, 95 metres at the lines and 118 in the alleys, the infield dirt, and a red and a navy dugout panel with Japan's and the USA's flags." width="640">
 </picture>
 <br><em>A ballpark's fence, drawn through the distances its article publishes.</em>
 </p>
@@ -368,7 +368,7 @@ console.log(items.map((item) => item.kind).join(), html.includes("preserve-3d"))
 // net,netposts,antennae false
 ```
 
-The flat drawing is the floor, turned by a drag, a swipe, the keys or four viewpoints, with what the rulebook stands on it at its height; each part is a flat rectangle placed by one `matrix3d`, so there is no 3D context for a phone to lose. In the element it is `<kyogijo-field sport="nhl" turn turn-view="broadcast">`. [The 3D view](./docs/turn.md).
+The flat drawing is the floor, turned by a drag, a swipe, the keys or four viewpoints, with what the rulebook stands on it at its height; each part is one `matrix3d`, so there is no 3D context for a phone to lose. In the element: `<kyogijo-field sport="nhl" turn turn-view="broadcast">`. [The 3D view](./docs/turn.md).
 
 <p align="center">
 <picture>
@@ -496,7 +496,7 @@ console.log(svg.includes('viewBox="0 0 1200 675"'), svg.includes("Three ballpark
 
 ### Several surfaces on one floor
 
-`drawMulti` lays the package's own surfaces out together for one large event, to scale, on one floor, with the officials' chairs and boards, and places for the event's words and marks (`sample: true` fills them with an invented event; [tournament layouts](./docs/multi.md)). Thirteen presets with their rules and sources; `multiFit` says whether a layout fits a hall, `stadium: true` sets it inside real stands, and `mountMultiTurn` turns the floor in 3D.
+`drawMulti` lays the package's own surfaces out together for one large event, to scale, on one floor, with the officials' chairs and boards, and places for the event's words and marks (`sample: true` fills them with an invented event; [tournament layouts](./docs/multi.md)). Thirteen presets; `multiFit` says whether a layout fits a hall, `stadium: true` sets it inside real stands, and `mountMultiTurn` turns it in 3D.
 
 ```ts
 import { drawMulti, multiLayout } from "@johnmorrisdotca/kyogijo-stadiums/multi";
@@ -555,15 +555,32 @@ The [demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/halls.html) turns
 <br><em>Judges, in 3D.</em>
 </p>
 
+The broadcast view puts the mat large, with the officials on a board at its side; `judgingPrint` prints one mat to an A4 or US letter page.
+
+<p align="center">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judging-broadcast-3d-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judging-broadcast-3d-desk-light.webp" alt="A kata mat in 3D from the Broadcast camera, with a dark board at its side listing each judge's number, name and ID." width="640">
+</picture>
+<br><em>The broadcast view.</em>
+</p>
+
+<p align="center">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judging-print-a4-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judging-print-a4-desk-light.webp" alt="An A4 page with the plan of one kata mat and the chart of its five judges under it." width="640">
+</picture>
+<br><em>One mat to an A4 page.</em>
+</p>
 
 ### A table tennis area
 
-A table is drawn in the ITTF's playing area, 14 m by 7 m (`net.area` for Masters and wheelchair events), with dark surrounds and the umpires' chairs ([courts](./docs/courts.md#the-table-tennis-playing-area)).
+A table in the ITTF's playing area, 14 m by 7 m, with surrounds and chairs ([courts](./docs/courts.md#the-table-tennis-playing-area)).
 
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/tabletennis-area-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/tabletennis-area-desk-light.webp" alt="A table tennis table in its 14 m by 7 m playing area, with dark surrounds, chairs and table for the umpires" width="660">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/tabletennis-area-desk-light.webp" alt="A table tennis table in its playing area, with surrounds and the umpires' chairs" width="660">
 </picture>
 <br><em>The table in its playing area.</em>
 </p>
@@ -571,7 +588,7 @@ A table is drawn in the ITTF's playing area, 14 m by 7 m (`net.area` for Masters
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/tabletennis-area-3d-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/tabletennis-area-3d-desk-light.webp" alt="The same area in 3D: the surrounds round the floor, the table on its legs" width="660">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/tabletennis-area-3d-desk-light.webp" alt="The same table area in 3D, from a low corner" width="660">
 </picture>
 <br><em>The same area in 3D.</em>
 </p>
@@ -583,7 +600,7 @@ A table is drawn in the ITTF's playing area, 14 m by 7 m (`net.area` for Masters
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judo-kata-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judo-kata-desk-light.webp" alt="The IJF's kata area with the five judges' seats above it and the coach's chair below" width="660">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judo-kata-desk-light.webp" alt="The IJF's kata area with the judges' seats above and the coach's chair below" width="660">
 </picture>
 <br><em>The kata area, its judges and the coach's chair.</em>
 </p>
@@ -591,11 +608,31 @@ A table is drawn in the ITTF's playing area, 14 m by 7 m (`net.area` for Masters
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judo-kata-tapes-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judo-kata-tapes-desk-light.webp" alt="Three short white tapes 3 m apart across the middle of a kata area" width="660">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judo-kata-tapes-desk-light.webp" alt="Three short white tapes across the middle of a kata area" width="660">
 </picture>
 <br><em>Close up: the centre tape and the two starting tapes.</em>
 </p>
 
+### An MMA cage
+
+[The combat sports page](./docs/combat.md).
+
+<p align="center">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/mma-cage-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/mma-cage-desk-light.webp" alt="An MMA cage from above, with a score" width="660">
+</picture>
+<br><em>With a score.</em>
+</p>
+
+<p align="center">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/mma-cage-3d-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/mma-cage-3d-desk-light.webp" alt="The cage in 3D: a mesh fence on a solid platform" width="660">
+</picture>
+<br><em>The cage in 3D.</em>
+</p>
+
 ### The element in a page
 
 ```html
@@ -669,7 +706,7 @@ Nothing is branded. The drawing is coloured by custom properties on its `svg`, w
 
 ## Limits
 
-Each is held by a test: thirty-nine sports, ten soccer pitches and ten providers, 94 ballparks, 64 grounds, six units, forty-eight frames, a drawing of under 22 kB. The table, made from the code, is [limits](./docs/limits.md).
+Each is held by a test: forty sports, ten soccer pitches and ten providers, 94 ballparks, 64 grounds, six units, forty-eight frames, a drawing of under 22 kB. The table, made from the code, is [limits](./docs/limits.md).
 
 ## Accessibility
 
@@ -692,8 +729,7 @@ English and Japanese: the title, the description and the standard statuses of a
 Not here yet, and each welcome as an [issue](https://github.com/johnmorrisdotca/kyogijo-stadiums/issues):
 
 - **More surfaces**: the FIBA and college courts, the international rink, rugby pitches, a stadium's seating, soccer's beach and street formats.
-- **Wall heights and quirks** in a ballpark: the Green Monster, Tal's Hill, the walls of Japan's parks.
-- **More parks of the past**: the grounds of the 19th century, and the parks whose articles give no distances yet (the Kingdome, Joe Robbie Stadium, the Los Angeles Coliseum), when they do.
+- **More parks of the past**: the 19th-century grounds, and the parks whose articles give no distances yet (the Kingdome, Joe Robbie Stadium).
 - **More charts on data layers**: a formation chart, a pass sonar chart and a Voronoi chart of their own (the layers exist; see [team shape](./docs/team-shape.md)).
 - **Football in a different standard**: the college and high-school hash marks.
 
@@ -703,8 +739,6 @@ Left out on purpose: statistics, rosters and schedules. Kyogijo Stadiums draws t
 
 The drawing is plain functions over plain data with no DOM and no dependency. The dimensions are in one file, the ballparks are generated from a reviewed list, and each surface is a function that returns its markup and the places the teams and the score go. Every entry point stands apart, so that importing the geometry, the parks or the grounds loads nothing else. The files and what each is for are in [architecture](./docs/architecture.md).
 
-Tests sit beside the code. `scripts/` builds the demo and the docs site, checks the packed package and the README's examples, and takes the README's pictures; `demo/` is the page and the frame; `e2e/` plays the demo and the docs in a real browser.
-
 ## The name
 
 *Kyogijo* (競技場, kyōgijō, きょうぎじょう) is Japanese for a sports ground: the place a contest is held. "Stadiums" is added in English, so that the name says what it draws; in Japanese the name stays 競技場. It is written with 競技, "contest" or "competition", and 場, "place", and said in five beats, *kyo-u-gi-jo-u*. In Japanese it is the general word for a place where sport is played, a stadium or a ground; the package uses it as a name for every surface it draws, the field, the rink, the court and the diamond. The long vowels are written without a macron in the package's name, as in the other packages of the family.

package/dist/budo/cage.d.ts

@@ -0,0 +1,46 @@
+import type { MmaFigures } from "../leagues/combat.ts";
+import { type MBox, type MMark, type Parts } from "./parts.ts";
+/** One gate of the cage: the flat it is in, the two ends of its opening, and the way it opens (outward). */
+export interface CageGate {
+    side: "north" | "south";
+    /** The number of the flat it is in, counted from the first corner. */
+    flat: number;
+    from: readonly [number, number];
+    to: readonly [number, number];
+}
+/** What a cage plan is. */
+export interface CageLayout {
+    parts: Parts;
+    /** The platform, which is the surface's own box: the cage's canvas and the apron round it. */
+    platform: MBox;
+    extent: MBox;
+    centre: [number, number];
+    /** The cage's width across the flats, and the distance from its middle to a post. */
+    width: number;
+    apothem: number;
+    corner: number;
+    /** The posts, one at each corner of the cage, as points on the platform. */
+    posts: [number, number][];
+    /** The gates, and the steps (the boxes outside the platform's edge, where a gate faces). */
+    gates: CageGate[];
+    steps: MBox[];
+    /** The height of the platform over the floor of the building and of the fence over the canvas, in metres. */
+    height: number;
+    fence: number;
+    marks: MMark[];
+    ranges: Record<string, MBox>;
+}
+/** The width the options ask for, held to 20 feet to 32 feet. */
+export declare const cageWidth: (asked: number | undefined, fig: MmaFigures) => number;
+/** The platform's height the options ask for, held to 0 to 4 feet. */
+export declare const cageHeight: (asked: number | undefined, fig: MmaFigures) => number;
+/** The fence's height the options ask for, held to 5 feet to 7 feet. */
+export declare const fenceHeight: (asked: number | undefined, fig: MmaFigures) => number;
+/** The plan of the cage the options ask for. */
+export declare function cageParts(fig: MmaFigures, o: {
+    width: number;
+    height: number;
+    fence: number;
+    gates: boolean;
+    steps: boolean;
+}): CageLayout;

package/dist/budo/cage.js

@@ -0,0 +1,91 @@
+// An MMA cage (a fenced area): the platform it stands on with its steps, the canvas inside the fence, the eight-sided fence with its two gates and its padded posts, from the rules a commission or the IMMAF
+// writes for a fenced area (the Nevada Rules of Unarmed Combat 5.010 3, the IMMAF's Unified Rules for amateur competition). The cage is named for what it is, an eight-sided cage: no promotion's own name is used.
+// In metres, the origin at the top left of the platform, north at the top. Nothing here draws SVG.
+import { arc, line } from "../fields.kit.js";
+import { discArea, rectArea, within } from "./kit.js";
+import { emptyParts, grow, union } from "./parts.js";
+import { num } from "../format.js";
+/** The width the options ask for, held to 20 feet to 32 feet. */
+export const cageWidth = (asked, fig) => (asked === undefined ? fig.width.drawn : within(asked, fig.width.min, fig.width.max, "The cage's width", "NRUC 5.010 3(a) and the IMMAF's rules"));
+/** The platform's height the options ask for, held to 0 to 4 feet. */
+export const cageHeight = (asked, fig) => (asked === undefined ? fig.platform.height.drawn : within(asked, fig.platform.height.min, fig.platform.height.max, "The cage's platform", "NRUC 5.010 3(c)"));
+/** The fence's height the options ask for, held to 5 feet to 7 feet. */
+export const fenceHeight = (asked, fig) => (asked === undefined ? fig.fence.drawn : within(asked, fig.fence.min, fig.fence.max, "The cage's fence", "NRUC 5.010 3(d)"));
+const rd = (v) => Math.round(v * 1000) / 1000;
+/** The plan of the cage the options ask for. */
+export function cageParts(fig, o) {
+    const a = o.width / 2;
+    const corner = a / Math.cos(Math.PI / fig.sides);
+    const side = o.width + 2 * fig.apron;
+    const c = side / 2;
+    const platform = { x0: 0, y0: 0, x1: side, y1: side };
+    const parts = emptyParts();
+    // The corners of the cage: the flats face the four sides of the platform and the four diagonals, and the first corner lies a sixteenth of a turn clockwise of north.
+    const step = (2 * Math.PI) / fig.sides;
+    const start = -Math.PI / 2 + step / 2;
+    const posts = Array.from({ length: fig.sides }, (_, i) => [rd(c + corner * Math.cos(start + i * step)), rd(c + corner * Math.sin(start + i * step))]);
+    parts.areas.push(rectArea("platform", "platform", "ky-bud-platform", platform));
+    parts.areas.push({ id: "canvas", feature: "canvas", cls: "ky-bud-t1", d: `M${posts.map(([x, y]) => `${num(x)} ${num(y)}`).join("L")}Z` });
+    // The steps, one at each gate: three treads, outside the platform's edge.
+    const steps = [];
+    const s = fig.platform.steps;
+    const gateSides = ["north", "south"];
+    if (o.steps && o.gates) {
+        for (const side_ of gateSides) {
+            const depth = s.treads * s.tread;
+            const b = side_ === "north" ? { x0: c - s.width / 2, y0: -depth, x1: c + s.width / 2, y1: 0 } : { x0: c - s.width / 2, y0: side, x1: c + s.width / 2, y1: side + depth };
+            steps.push(b);
+            for (let t = 0; t < s.treads; t += 1) {
+                const y0 = side_ === "north" ? -depth + t * s.tread : side + t * s.tread;
+                parts.areas.push(rectArea(`step-${side_}-${t + 1}`, "steps", "ky-bud-step", { x0: b.x0, y0, x1: b.x1, y1: y0 + s.tread }));
+            }
+        }
+    }
+    // The fence is one line along each flat; where a gate is, the line stops at its opening and the gate's swing is drawn dashed, outward.
+    const gates = [];
+    const g = fig.gates.width;
+    const gateAt = (i) => (o.gates ? (i === 7 ? "north" : i === 3 ? "south" : undefined) : undefined);
+    // Flat i runs from corner i to corner i+1; the flat that faces north is the last (corner 7 to corner 0), the one that faces south is 3.
+    for (let i = 0; i < fig.sides; i += 1) {
+        const p = posts[i];
+        const q = posts[(i + 1) % fig.sides];
+        const gate = gateAt(i);
+        if (gate === undefined) {
+            parts.shapes.push(line(`fence-${i + 1}`, "fence", p[0], p[1], q[0], q[1], { w: 0.1, cls: "ky-bud-ink", least: 0.1 }));
+            continue;
+        }
+        // Along the flat, from p to q, the opening lies in the middle.
+        const len = Math.hypot(q[0] - p[0], q[1] - p[1]);
+        const ux = (q[0] - p[0]) / len;
+        const uy = (q[1] - p[1]) / len;
+        const m = [(p[0] + q[0]) / 2, (p[1] + q[1]) / 2];
+        const from = [rd(m[0] - (ux * g) / 2), rd(m[1] - (uy * g) / 2)];
+        const to = [rd(m[0] + (ux * g) / 2), rd(m[1] + (uy * g) / 2)];
+        gates.push({ side: gate, flat: i, from, to });
+        parts.shapes.push(line(`fence-${i + 1}a`, "fence", p[0], p[1], from[0], from[1], { w: 0.1, cls: "ky-bud-ink", least: 0.1 }), line(`fence-${i + 1}b`, "fence", to[0], to[1], q[0], q[1], { w: 0.1, cls: "ky-bud-ink", least: 0.1 }));
+        // The gate opens outward, about the end of the opening that lies on the right of the north gate and on the left of the south one (the cage is the same turned half a turn).
+        const hinge = to;
+        parts.shapes.push(arc(`gate-${gate}`, "gates", hinge[0], hinge[1], g, gate === "north" ? 180 : 0, gate === "north" ? 270 : 90, { w: 0.04, dash: [0.14, 0.1], cls: "ky-bud-ink", least: 0.04 }));
+    }
+    gates.sort((x, y) => (x.side === "north" ? -1 : 1) - (y.side === "north" ? -1 : 1));
+    // The posts, padded, drawn over the fence.
+    posts.forEach(([x, y], i) => parts.areas.push(discArea(`post-${i + 1}`, "posts", "ky-bud-pad", x, y, fig.post.pad / 2)));
+    const extent = grow(union([platform, ...steps]), 0.6);
+    const north = gates.find((x) => x.side === "north");
+    const ranges = {
+        cage: { x0: c - a - 0.3, y0: c - a - 0.3, x1: c + a + 0.3, y1: c + a + 0.3 },
+    };
+    if (north !== undefined)
+        ranges.gate = { x0: c - 2.4, y0: -0.5 - s.treads * s.tread, x1: c + 2.4, y1: c - a + 2 };
+    const marks = [
+        { id: "cage-canvas", x: c - a * 0.35, y: c + a * 0.25, side: "bottom" },
+        { id: "cage-fence", x: c + a, y: c + a * 0.35, side: "bottom" },
+        { id: "cage-post", x: posts[1][0], y: posts[1][1], side: "top" },
+        { id: "cage-platform", x: side * 0.04, y: side * 0.1, side: "top" },
+    ];
+    if (north !== undefined)
+        marks.push({ id: "cage-gate", x: (north.from[0] + north.to[0]) / 2, y: north.from[1] + 0.2, side: "top" });
+    if (steps.length > 0)
+        marks.push({ id: "cage-steps", x: c, y: side + s.treads * s.tread * 0.5, side: "bottom" });
+    return { parts, platform, extent, centre: [c, c], width: o.width, apothem: a, corner, posts, gates, steps, height: o.height, fence: o.fence, marks, ranges };
+}

package/dist/budo/describe.js

@@ -35,6 +35,11 @@ export function budoAbout(o, language, plan = budoPlan(o)) {
         const bare = !L.parts.areas.some((a) => a.id === "tawara");
         return fill(bare ? words.sumoBare : words.sumo, { platform: trim(fig.platform), height: cm(L.height), circle: trim(fig.circle), count: fig.tawara.count });
     }
+    if (plan.mma !== undefined) {
+        const L = plan.mma;
+        const platform = L.height > 0.0005 ? fill(words.mmaPlatform, { height: cm(L.height) }) : words.mmaFloor;
+        return fill(words.mma, { width: trim(L.width), feet: trim(L.width / 0.3048), fence: cm(L.fence), platform });
+    }
     if (plan.kyudo !== undefined) {
         const L = plan.kyudo;
         const fig = plan.figures;
@@ -67,6 +72,12 @@ export function budoSentences(o, language, plan = budoPlan(o)) {
         out.push(words.karateOfficials);
     if (plan.sumo !== undefined && plan.areas.some((a) => a.feature === "tassels"))
         out.push(words.tassels);
+    if (plan.mma !== undefined) {
+        if (plan.mma.gates.length > 0)
+            out.push(words.mmaGates);
+        if (plan.mma.steps.length > 0)
+            out.push(words.mmaSteps);
+    }
     if (plan.dojo !== undefined) {
         const L = plan.dojo;
         out.push(fill(words.dojoKamiza, { side: words.sides[L.kamiza] }));

package/dist/budo/looks.js

@@ -14,6 +14,8 @@ function pair(light, k = 0.34) {
     }
     return { light, dark };
 }
+/** A look whose dark platform is a lighter one than the plain dimming makes, so that it stands out from the dark floor of the hall under it. */
+const lifted = (p, floor) => ({ light: p.light, dark: { ...p.dark, floor } });
 const FLOOR = "#c9a26a";
 const WALLS = "#d8d0bd";
 const COMMON = { apron: "#d6d3cb", free: "#e8e4d8", floor: FLOOR, boards: WALLS };
@@ -44,6 +46,12 @@ export const BUDO_LOOKS = Object.freeze({
         blond: pair({ ...COMMON, surface: "#e0bf8a", alt: "#d3b27c", red: "#b32a2f", floor: "#e0bf8a", free: "#ece4d3" }),
     },
     sumo: { clay: pair({ ...COMMON, surface: "#b0794a", alt: "#a06c40", red: "#b32a2f", dirt: "#b0794a", sand: "#e8dcc2", straw: "#c8a45c" }) },
+    // The cage's canvas, over the platform's dark deck: a grey canvas (the default), black, and blue. Ours: no rule paints a cage.
+    mma: {
+        grey: lifted(pair({ ...COMMON, surface: "#8d949b", alt: "#6f767d", red: "#b32a2f", floor: "#43484e" }), "#444a52"),
+        black: lifted(pair({ ...COMMON, surface: "#2b2e33", alt: "#1f2226", red: "#b32a2f", floor: "#24272b" }), "#3b3f45"),
+        blue: lifted(pair({ ...COMMON, surface: "#3a68ad", alt: "#2b528d", red: "#b32a2f", floor: "#2c3440" }), "#3a4452"),
+    },
     kyudo: { wood: pair({ ...COMMON, surface: "#9db57d", alt: "#d8cfb0", red: "#b32a2f", floor: "#b98c58", dirt: "#c9ad7a" }) },
 });
 /** The names of a sport's looks, the default first. */

package/dist/budo/plan.d.ts

@@ -7,9 +7,10 @@ import { type KarateLayout } from "./karate.ts";
 import { type KendoLayout } from "./kendo.ts";
 import { type KyudoLayout } from "./kyudo.ts";
 import { boxD } from "./kit.ts";
+import { type CageLayout } from "./cage.ts";
 import { type MBox, type MMark, type MRange } from "./parts.ts";
 import { type SumoLayout } from "./sumo.ts";
-import type { BudoKind } from "./types.ts";
+import type { BudoKind, CombatKind } from "./types.ts";
 export type { MBox, MMark, MRange };
 /** The apothem of the Nippon Budokan's arena, an octagon 55 m across the flats (the Budokan's leaflet). */
 export declare const BUDOKAN_ARENA = 27.5;
@@ -48,11 +49,18 @@ export interface BudoPlan {
     sumo?: SumoLayout;
     kyudo?: KyudoLayout;
     dojo?: DojoLayout;
+    mma?: CageLayout;
 }
 /** The sports of the budō family. */
 export declare const BUDO_SPORTS: readonly BudoKind[];
 /** True for a sport of the budō family. */
-export declare const isBudoSport: (sport: string) => sport is BudoKind;
+export declare const isBudoSport: (sport: string) => sport is Exclude<BudoKind, CombatKind>;
+/** The combat sports the engine of the budō also draws: the MMA cage. */
+export declare const COMBAT_SPORTS: readonly CombatKind[];
+/** True for a combat sport (the MMA cage). */
+export declare const isCombatSport: (sport: string) => sport is CombatKind;
+/** True for a sport this engine draws: a sport of the budō or a combat sport. */
+export declare const isMatSport: (sport: string) => sport is BudoKind;
 /** The league a set of options asks for: a rulebook's, else the sport's own. */
 export declare function budoLeague(o: Pick<SurfaceOptions, "sport" | "league" | "budo" | "dojo">): BudoLeague;
 /** The octagon of the Budokan's arena as a path, centred on (cx, cy). */

package/dist/budo/plan.js

@@ -1,11 +1,13 @@
 import { chooseLeague } from "../leagues.js";
 import { BUDO_LEAGUES, DOJO_LEAGUES, JUDO_LEAGUES, KARATE_LEAGUES, KENDO_LEAGUES, KYUDO_LEAGUES, SUMO_LEAGUES } from "../leagues/budo.js";
+import { MMA_LEAGUES } from "../leagues/combat.js";
 import { dojoLayout, dojoLeague, dojoSpecOf } from "./dojo.js";
 import { contestOf, gridOf, judoParts, matOf, safetyOf, snapTo } from "./judo.js";
 import { karateParts } from "./karate.js";
 import { kendoParts, kendoSide } from "./kendo.js";
 import { kyudoParts, shootersOf } from "./kyudo.js";
 import { boxD } from "./kit.js";
+import { cageHeight, cageParts, cageWidth, fenceHeight } from "./cage.js";
 import { emptyParts, grow, union } from "./parts.js";
 import { dohyoHeight, sumoParts } from "./sumo.js";
 import { lookOf } from "./looks.js";
@@ -16,7 +18,13 @@ const isBudoLeague = (l) => typeof l === "object" && l !== null && BUDO_LEAGUES.
 export const BUDO_SPORTS = Object.freeze(["judo", "karate", "kendo", "sumo", "kyudo", "dojo"]);
 /** True for a sport of the budō family. */
 export const isBudoSport = (sport) => BUDO_SPORTS.includes(sport);
-const OWN = { judo: JUDO_LEAGUES, karate: KARATE_LEAGUES, kendo: KENDO_LEAGUES, sumo: SUMO_LEAGUES, kyudo: KYUDO_LEAGUES, dojo: DOJO_LEAGUES };
+/** The combat sports the engine of the budō also draws: the MMA cage. */
+export const COMBAT_SPORTS = Object.freeze(["mma"]);
+/** True for a combat sport (the MMA cage). */
+export const isCombatSport = (sport) => COMBAT_SPORTS.includes(sport);
+/** True for a sport this engine draws: a sport of the budō or a combat sport. */
+export const isMatSport = (sport) => isBudoSport(sport) || isCombatSport(sport);
+const OWN = { judo: JUDO_LEAGUES, karate: KARATE_LEAGUES, kendo: KENDO_LEAGUES, sumo: SUMO_LEAGUES, kyudo: KYUDO_LEAGUES, dojo: DOJO_LEAGUES, mma: MMA_LEAGUES };
 /** What `budo.style` asks of a judo area: true for a kata area, false for a contest area, undefined for neither said. @throws TypeError for a value that is not `shiai` or `kata`. */
 function kataOf(style) {
     if (style === undefined)
@@ -118,6 +126,12 @@ export function budoPlan(o) {
             const ranges = { shajo: L.shajo, yamichi: L.yamichi, azuchi: grow(L.azuchi, 0.8) };
             return finish({ box: L.range, extent: L.extent, areas: L.parts.areas, shapes: L.parts.shapes, lineWidth: 0.05, ranges, marks: L.marks, centre: { x: (L.shajo.x0 + L.shajo.x1) / 2, y: (L.shajo.y0 + L.shajo.y1) / 2, r: 1.5 }, kyudo: L });
         }
+        case "mma": {
+            const f = fig;
+            const L = cageParts(f, { width: cageWidth(style.size, f), height: cageHeight(style.height, f), fence: fenceHeight(style.fence, f), gates: flag(style.gates, true, "budo.gates"), steps: flag(style.steps, true, "budo.steps") });
+            const ranges = { ...L.ranges, half: halves(L.platform) };
+            return finish({ box: L.platform, extent: L.extent, areas: L.parts.areas, shapes: L.parts.shapes, lineWidth: f.post.diameter, ranges, marks: L.marks, centre: { x: L.centre[0], y: L.centre[1], r: L.apothem * 0.35 }, mma: L });
+        }
         default: {
             const L = dojoLayout(o.dojo ?? {}, dojoLeague(league.id));
             const f = L.floor;