@johnmorrisdotca/kyogijo-stadiums 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -7,6 +7,27 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.17.0] - 2026-10-20
+
+### Added
+
+- **Judging assignments** (`@johnmorrisdotca/kyogijo-stadiums/judging`: `drawJudging`, `judgingChart`, `judgingTable`, `judgingDrawing`, `mountJudgingTurn`, `judgingTurnMarkup`, `buildJudgingTurn`). Who judges where at a judo tournament: `{ style: "kata", mats: [{ label, officials: [{ seat, name, id }] }] }` gives one SVG for a tablet read live: for each of 1 to 6 mats the judo kata area with a badge at each of the five judges' seats (the seats are the plan's own, 1.25 m apart, the central judge at the centre), the name and the ID in a card in the seat where they fit, and beside the plan (landscape) or under it (portrait) a chart of seat, role, name and ID whose rows grow until every name (up to 120 characters) and ID (up to 64) is whole; a seat with nobody in it says so. A name fits a seat only at a type no smaller than 1.2 % of the picture's width; the cards of a mat share one size; `chart` is `auto` (drawn when a name does not fit, the plan first being given the room the chart would take), `always` or `never`; `mat` draws one mat alone (a tab); `focus: "bench"` shows the judges' bench close up so that the names are as large as they can be. In 3D the judges' table and chairs stand on the judo floor, a name card stands on the table in front of each judge and turns to face the eye, and the mat's name is on a sign over it (`focus: "bench"` fits and turns the view about the bench; the chart goes beside it). Light and dark, English and Japanese, a title and a description that name every seat, and `judgingTable` as a table. The numbering of the seats (1 to 5 from the left of the plan, the central judge 3), the cards, the chart and the heights in 3D are ours: no rule gives them. Data stays with the caller: nothing is fetched, stored or sent; every text is made safe and held to its length. Docs: [judging assignments](./docs/judging.md) and [a gallery](https://johnmorrisdotca.github.io/kyogijo-stadiums/docs/gallery-judging.html). Demo: <https://johnmorrisdotca.github.io/kyogijo-stadiums/judging.html> (a tab for each mat, editable names and IDs kept in its address). Shiai (a referee and judges by the IJF's refereeing positions) is the next release.
+
+### Changed
+
+- `TurnModel` has an optional `lens`, a lens of the model's own used when the settings give none (a view of several benches at once has a longer one); the helpers `box` and `rect` moved from `multi.turn.ts` to `turn.kit.ts`; the 3D view's stylesheet carries the colours and rules of a judging assignment's cards (`--ky-ju-*`, `u-card*`, `u-sign*`, `u-bench*`); `UprightKind` has `judges` and `PartKind` has `card` and `sign`.
+
+## [0.16.1] - 2026-10-20
+
+### Added
+
+- **Sample content for a tournament layout** (`drawMulti({ sample: true })`, or `sample: { event, year, city }`). The places for the event's words and marks are filled as an event would dress them: an invented event name, year and city on the floor and the boards ("Kyogijo Open 2026 · Osaka", in Japanese `競技場杯 2026 · 大阪`) and, in each logo place, a simple emblem of the package's own (a ring with a star, a diamond or waves), in place of the dashed empty places. Nothing real is named or drawn: no event, brand, federation, sponsor or league (a test holds every preset in both languages to that). Off by default, so a layout is still drawn as it is configured; with `slots: false` nothing is drawn. The 3D view carries it on its floor. New `MultiSample` and `MultiWords.sample`.
+
+### Changed
+
+- **The demo's tournament layouts page and every picture of a layout are dressed with sample content.** `halls.html` has a "Sample event content" box, on by default (`sample=0` in its address turns it off and brings the empty places back); the README's and the docs' pictures of layouts (three judo areas, four table tennis areas, the same four in 3D, the gallery) show the invented event, and one picture shows the empty places with a caption (what an organiser configures): `docs/images/multi-judo-empty-*`, `ONLY=multi-judo-empty` takes it. The README gives up some prose to stay under its size budget.
+- **Docs only:** the gallery's table tennis text gives the surrounds' range (50 to 100 cm) of the ITTF Statutes 2026.
+
 ## [0.16.0] - 2026-10-20
 
 ### Added

package/README.md

@@ -75,16 +75,16 @@ console.log(svg.startsWith("<svg"), svg.includes("USA 3, Canada 2"));
 - **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).
 - **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, the visitors at an end and the empty seats showing (`density`, or `attendance` over `capacity`). Blocks at small sizes. [The crowd](./docs/crowd.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, touch panels and flags; the water polo field; the diving well with its springboards and platforms; 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 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).
 - **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 starting and finishing lines of every race worked out lane by lane; the short track's oval of 111.12 m; 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 (no four corners meet), in jō or metres, with the walls, doors, windows, shrine and kamiza. 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 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).
 - **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 (the Polo Grounds, Ebbets Field, the Astrodome and more), 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; a past park whose fence moved is drawn as it stood in a season. [Ballparks](./docs/ballparks.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).
 - **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).
@@ -94,16 +94,17 @@ console.log(svg.startsWith("<svg"), svg.includes("USA 3, Canada 2"));
 - **Lineups.** A `lineup` layer places a team's players by position code (`GK`, `CB`, `HK`, `C`) with no coordinates: it reads where each stands from a formation (36 of them, in 13 sports), draws a disc or a jersey with the shirt number and the name under it, a captain's C and a flag, and puts the visitors at the other end. [Lineups](./docs/team-shape.md#lineups).
 - **A pageant.** Each team's flag or crest laid large over its half of the surface: `pageant: "carpet"` (a flag at its own ratio with a border) or `"stage"` (a crest on a round disc with a gold ring), an emblem or a trophy in the centre circle, the score in the middle or in the strip, with an entrance in CSS for readers who have not asked for less motion. [The pageant](./docs/pageant.md).
 - **Trophies, medals, balls and crests, by id.** `useEmblems(renderEmblem)` plugs in the sister package [Dougu Sports](https://johnmorrisdotca.github.io/dougu-sports/) in one line, and an id goes wherever a logo, a flag or a mark is taken: `logo: "crest:shield"`, `pageant: { emblem: "trophy:hockey-cup" }`, `"ball:puck"`. Kyogijo bundles no emblem and keeps zero dependencies. [Emblems](./docs/emblems.md).
-- **Country flags, by code.** `useFlags(render)` plugs in the sister package [Hata](https://github.com/johnmorrisdotca/hata) through a small adapter, and a team's `flag: "CA"` is its flag: round in a round mark, at its own proportions on a banner, a badge or a carpet. The same adapter serves [Taisen Brackets](https://github.com/johnmorrisdotca/taisen-brackets). Kyogijo bundles no flag and keeps zero dependencies. [Flags](./docs/flags.md).
+- **Country flags, by code.** `useFlags(render)` plugs in the sister package [Hata](https://github.com/johnmorrisdotca/hata) through a small adapter, and a team's `flag: "CA"` is its flag: round in a round mark, at its own proportions on a banner, a badge or a carpet. Kyogijo bundles no flag and keeps zero dependencies. [Flags](./docs/flags.md).
 - **Zoom to a part of a surface.** `range: "offensive-zone"` crops a drawing to a rink's zone, a half court, the paint, the red zone, a soccer half, third or penalty area, the infield, a curling house, or a box of your own in any frame, with its data, heat, labels and score following. [Display ranges](./docs/ranges.md).
 - **Wide, tall or fit the box.** Every surface lies wide or tall: tall turns it a quarter, keeps every word upright and puts the teams top and bottom. With `orientation: "auto"` the browser helpers follow the box.
-- **Where a point lies, by the rules, and a click as a place.** `zoneAt("nhl", [69, 22], { frame: "nhl-api" })` names the zone and the area in it from the surface's own figures, with `isThreePointer`, `inSlot`, `isFair`, `isHomeRun` and the like; `clientPointToField(svg, x, y, { provider })` is a pointer's place in any of the frames, with the zone. `marks: true` writes `data-mark-id` and `data-zone` on every mark of a layer. [Zones](./docs/zones.md), [pointing](./docs/pointer.md).
-- **Goals, the strike zone and the stumps, end-on.** A goal mouth for hockey, soccer, handball, water polo, lacrosse and field hockey with the shots laid on it and its zones (the top shelf, the five-hole, the corners), the catcher's view of the strike zone with its pitches numbered, and the wicket from the bowler's end with its line and length zones. [Targets](./docs/targets.md).
+- **Where a point lies, by the rules, and a click as a place.** `zoneAt("nhl", [69, 22], { frame: "nhl-api" })` names the zone and the area in it from the surface's own figures, with `isThreePointer`, `inSlot`, `isFair`, `isHomeRun` and the like; `clientPointToField(svg, x, y, { provider })` is a pointer's place in any of the frames, with the zone. [Zones](./docs/zones.md), [pointing](./docs/pointer.md).
+- **Goals, the strike zone and the stumps, end-on.** A goal mouth for six sports with the shots laid on it and its zones, the catcher's view of the strike zone with its pitches numbered, and the wicket from the bowler's end with its line and length zones. [Targets](./docs/targets.md).
 - **Data on the surface.** Points, lines, arrows, text, heat maps, hexagons, zone charts and density contours over any surface, in its feet or a data provider's frame, cut to its outline, with a table for each layer; ready-made shot and pass charts. [Data layers](./docs/layers.md), [charts](./docs/charts.md).
 - **Small multiples and backgrounds.** `drawGrid` puts many drawings in one SVG, under a title and a subtitle, over a credit line, with a key they share, in a size for a social card, a square post or a phone; `background` lays a quiet pattern (felt, grass, wood, ice, paper, a grid, dots) or a photograph behind a drawing or a grid. [Layouts and backgrounds](./docs/layouts.md).
 - **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 over the same SVG. [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, 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).
 - **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.
@@ -131,6 +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)). |
 | `./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. |
 
@@ -366,12 +368,12 @@ 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 (overhead, broadcast, end-on, low corner), and what the rulebook stands on the surface is built up 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; where 3D is not drawn the flat drawing stays. 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 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).
 
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-volleyball-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-volleyball-desk-light.webp" alt="A volleyball court from behind an end line under a spotlight, turned in the demo: the net at 2.43 metres on its posts with the red and white antennae, and under it the buttons for the four viewpoints, turning, raising, zooming and resetting." width="640">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-volleyball-desk-light.webp" alt="A volleyball court from behind an end line, turned in the demo: the net at 2.43 metres on its posts with the antennae, and the viewpoint buttons under it." width="640">
 </picture>
 <br><em>A volleyball net at its rulebook height, with its posts and antennae.</em>
 </p>
@@ -379,7 +381,7 @@ The flat drawing is the floor, turned by a drag, a swipe, the keys or four viewp
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-rink-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-rink-desk-light.webp" alt="An ice rink from a low corner on an ice-blue background, turned in the demo: the boards with their glass round the ice, a goal at each end, and the score on the ice." width="640">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-rink-desk-light.webp" alt="An ice rink from a low corner: the boards and glass round the ice, a goal at each end, and the score on the ice." width="640">
 </picture>
 <br><em>A rink with its boards, glass and goals.</em>
 </p>
@@ -387,7 +389,7 @@ The flat drawing is the floor, turned by a drag, a swipe, the keys or four viewp
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-court-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-court-desk-light.webp" alt="A basketball court from the main camera in a warm glow, turned in the demo: a basket on its backboard and padded stanchion at each end of the floor." width="640">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/turn-court-desk-light.webp" alt="A basketball court from the main camera: a basket on its backboard and padded stanchion at each end." width="640">
 </picture>
 <br><em>A court with a basket at each end, the rim at 10 feet.</em>
 </p>
@@ -465,7 +467,7 @@ console.log(svg.includes("3 shots"), svg.includes("By outcome: goal 1, shot 1, b
 // true true
 ```
 
-Zoom to a part of the surface with `range`: the data, the heat and the labels follow the crop ([display ranges](./docs/ranges.md)).
+Zoom to a part with `range`: the data follows the crop ([display ranges](./docs/ranges.md)).
 
 ```ts
 import { drawKyogijo } from "@johnmorrisdotca/kyogijo-stadiums";
@@ -475,7 +477,7 @@ console.log(zone.includes('data-range="offensive-zone"'), zone.includes("Shows o
 // true true
 ```
 
-Lines, arrows, text, heat maps, hexagons, zones and contours are in [data layers](./docs/layers.md); a shot chart, a shot map, a spray chart, a pass chart and a soccer shot map are one call each in [charts](./docs/charts.md). Pass networks, formations, lineups (a team's players placed by position code, as discs or jerseys), Voronoi cells, Delaunay triangles, hulls, flow fields and sonars are layers too: [team shape](./docs/team-shape.md). Every kind is drawn, with its code, in the [gallery](https://johnmorrisdotca.github.io/kyogijo-stadiums/docs/gallery.html).
+Lines, arrows, text, heat maps, hexagons, zones and contours are in [data layers](./docs/layers.md); shot, spray and pass charts are one call each in [charts](./docs/charts.md); pass networks, formations, lineups, Voronoi cells and flow fields are layers too ([team shape](./docs/team-shape.md)).
 
 ### Small multiples on a card
 
@@ -494,12 +496,12 @@ 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, the boards and empty places for the event's words and marks ([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 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.
 
 ```ts
 import { drawMulti, multiLayout } from "@johnmorrisdotca/kyogijo-stadiums/multi";
 
-const svg = drawMulti({ preset: "judo-1x3" });
+const svg = drawMulti({ preset: "judo-1x3", sample: true });
 const layout = multiLayout({ preset: "judo-1x3" });
 console.log(svg.startsWith("<svg"), layout.cells.length);
 // true 3
@@ -510,15 +512,15 @@ console.log(layout.needs.length, layout.needs.width);
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/multi-judo-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/multi-judo-desk-light.webp" alt="Three judo contest areas in a row on one red floor of mats, each numbered, with dashed empty places for the event's name and logos and a board along each edge." width="640">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/multi-judo-desk-light.webp" alt="Three judo contest areas in a row on one red floor of mats, dressed with a sample event's name, simple emblems and boards." width="640">
 </picture>
-<br><em>Three judo contest areas on one floor of mats: 47 by 19 metres.</em>
+<br><em>Three judo contest areas on one floor of mats: 47 by 19 metres, with sample content.</em>
 </p>
 
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/multi-tabletennis-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/multi-tabletennis-desk-light.webp" alt="Four table tennis areas in two rows of two on one blue floor, numbered Table 1 to Table 4, with a scoreboard hung over the middle and boards along the edges." width="640">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/multi-tabletennis-desk-light.webp" alt="Four table tennis areas in two rows of two on one blue floor, with sample words and emblems, a hung scoreboard and boards." width="640">
 </picture>
 <br><em>Four table tennis areas under one scoreboard.</em>
 </p>
@@ -526,12 +528,33 @@ console.log(layout.needs.length, layout.needs.width);
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/multi-tabletennis-3d-desk-dark.webp">
-<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/multi-tabletennis-3d-desk-light.webp" alt="Four table tennis areas in 3D from a low corner: tables on legs, a surround round each, a hung scoreboard, and the 3D view's controls." width="640">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/multi-tabletennis-3d-desk-light.webp" alt="Four table tennis areas in 3D: tables on legs, a surround round each, a hung scoreboard." width="640">
 </picture>
 <br><em>The same four in 3D.</em>
 </p>
 
-The [demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/halls.html) picks a preset, sets it in a hall, switches the stadium on and off, and turns it in 3D.
+<p align="center">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/multi-judo-empty-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/multi-judo-empty-desk-light.webp" alt="The three judo areas with the places for the event's words and marks left empty and dashed." width="640">
+</picture>
+<br><em>Without `sample`: the empty places an organiser fills.</em>
+</p>
+
+The [demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/halls.html) turns it in 3D.
+
+### Who judges where
+
+`drawJudging` puts each judo mat's officials by seat in the picture and in a chart ([judging](./docs/judging.md)).
+
+<p align="center">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judging-3d-desk-dark.webp">
+<img src="https://raw.githubusercontent.com/johnmorrisdotca/kyogijo-stadiums/main/docs/images/judging-3d-desk-light.webp" alt="A kata area's judges' table in 3D, with a name card before each judge." width="640">
+</picture>
+<br><em>Judges in 3D.</em>
+</p>
+
 
 ### A table tennis area
 

package/dist/judging-entry.d.ts

@@ -0,0 +1,12 @@
+export { drawJudging, judgingChart, judgingDrawing, judgingTable, judgingText } from "./judging.draw.ts";
+export { JUDGING_HEIGHTS, JUDGING_PRESETS, buildJudgingTurn, judgingTurnMarkup, mountJudgingTurn } from "./judging.turn.ts";
+export { JUDGING_LEAGUE, JUDGING_MATS_MAX, JUDGING_SEATS, JUDGING_SEAT_COUNT, JUDGING_STYLES } from "./judging.data.ts";
+export { JUDGING_LIMITS, judgingPlan, judgingSetting, matLabel, seatOf, seatsOf } from "./judging.ts";
+export { fitCard, fitChart, fitSeats, wrapText } from "./judging.fit.ts";
+export { KYOGIJO_JUDGING_STYLE } from "./judging.style.ts";
+export { JUDGING_WORDS } from "./judging.words.ts";
+export type { JudgingWords } from "./judging.words.ts";
+export type { JudgingAssignment, JudgingMat, JudgingOfficial, JudgingOptions, JudgingResolved, JudgingSeat, JudgingStyle } from "./judging.types.ts";
+export type { JudgingDrawing } from "./judging.draw.ts";
+export type { JudgingPlan, JudgingSetting } from "./judging.ts";
+export type { CardAsk, CardFit } from "./judging.fit.ts";

package/dist/judging-entry.js

@@ -0,0 +1,8 @@
+// A judging assignment: the officials of each mat area of a judo tournament, by seat, with their names and IDs, in the seat where they fit and in a chart where they do not; in 2D and in 3D.
+export { drawJudging, judgingChart, judgingDrawing, judgingTable, judgingText } from "./judging.draw.js";
+export { JUDGING_HEIGHTS, JUDGING_PRESETS, buildJudgingTurn, judgingTurnMarkup, mountJudgingTurn } from "./judging.turn.js";
+export { JUDGING_LEAGUE, JUDGING_MATS_MAX, JUDGING_SEATS, JUDGING_SEAT_COUNT, JUDGING_STYLES } from "./judging.data.js";
+export { JUDGING_LIMITS, judgingPlan, judgingSetting, matLabel, seatOf, seatsOf } from "./judging.js";
+export { fitCard, fitChart, fitSeats, wrapText } from "./judging.fit.js";
+export { KYOGIJO_JUDGING_STYLE } from "./judging.style.js";
+export { JUDGING_WORDS } from "./judging.words.js";

package/dist/judging.card.d.ts

@@ -0,0 +1,21 @@
+import type { CardFit } from "./judging.fit.ts";
+/** The class names a card is drawn with. */
+export interface CardClasses {
+    card: string;
+    name: string;
+    id: string;
+    badge: string;
+    badgeEmpty: string;
+    n: string;
+}
+/** The classes of the plan. */
+export declare const PLAN_CARD: CardClasses;
+/** The classes of the 3D view's planes. */
+export declare const TURN_CARD: CardClasses;
+/** The round badge of a seat's number, centred at (cx, cy); hollow when nobody is in the seat. */
+export declare function badge(cls: CardClasses, cx: number, cy: number, r: number, n: number, assigned: boolean): string;
+/**
+ * A card with a name and an ID, `w` by `h` with its top left at (x, y): the text centred in the space under the badge, which straddles the card's top edge, and the badge itself. `fit` is what `fitCard` made of the
+ * name and the ID for the space inside `pad` and under `r`.
+ */
+export declare function card(cls: CardClasses, fit: CardFit, n: number, x: number, y: number, w: number, h: number, pad: number, r: number, round: number): string;

package/dist/judging.card.js

@@ -0,0 +1,34 @@
+// The name card of a seat and the badge of its number, as markup: the same drawing in the plan (in the picture's units, `ky-ju-*` classes) and in the 3D view (in feet, `u-card*` classes), so that a seat reads the same
+// in both. Nothing here decides whether a name fits: `judging.fit.ts` does, and a card is drawn only for a name that does.
+import { el, esc } from "./format.js";
+import { LINE_HEIGHT } from "./text.js";
+/** The classes of the plan. */
+export const PLAN_CARD = { card: "ky-ju-card", name: "ky-ju-card-name", id: "ky-ju-card-id", badge: "ky-ju-badge", badgeEmpty: "ky-ju-badge ky-ju-badge-empty", n: "ky-ju-badge-n" };
+/** The classes of the 3D view's planes. */
+export const TURN_CARD = { card: "u-card", name: "u-card-name", id: "u-card-id", badge: "u-card-badge", badgeEmpty: "u-card-badge u-card-badge-empty", n: "u-card-n" };
+/** The round badge of a seat's number, centred at (cx, cy); hollow when nobody is in the seat. */
+export function badge(cls, cx, cy, r, n, assigned) {
+    return el("circle", { class: assigned ? cls.badge : cls.badgeEmpty, cx, cy, r }) + el("text", { class: cls.n, x: cx, y: cy + r * 0.36, "font-size": r * 1.05 }, String(n));
+}
+/**
+ * A card with a name and an ID, `w` by `h` with its top left at (x, y): the text centred in the space under the badge, which straddles the card's top edge, and the badge itself. `fit` is what `fitCard` made of the
+ * name and the ID for the space inside `pad` and under `r`.
+ */
+export function card(cls, fit, n, x, y, w, h, pad, r, round) {
+    const cx = x + w / 2;
+    const room = h - 2 * pad - r;
+    let out = el("rect", { class: cls.card, x, y, width: w, height: h, rx: round });
+    let cy = y + pad + r + Math.max(0, (room - fit.height) / 2);
+    for (const line of fit.name) {
+        out += el("text", { class: cls.name, x: cx, y: cy + fit.nameSize * 0.88, "font-size": fit.nameSize }, esc(line));
+        cy += fit.nameSize * LINE_HEIGHT;
+    }
+    if (fit.id.length > 0) {
+        cy += fit.name.length > 0 ? fit.nameSize * 0.28 : 0;
+        for (const line of fit.id) {
+            out += el("text", { class: cls.id, x: cx, y: cy + fit.idSize * 0.88, "font-size": fit.idSize }, esc(line));
+            cy += fit.idSize * LINE_HEIGHT;
+        }
+    }
+    return out + badge(cls, cx, y, r, n, true);
+}

package/dist/judging.d.ts

@@ -0,0 +1,55 @@
+import { type BudoPlan, type MBox } from "./budo/plan.ts";
+import type { JudgingMat, JudgingOptions, JudgingResolved, JudgingSeat, JudgingStyle } from "./judging.types.ts";
+import type { Language } from "./types.ts";
+/** The longest name, ID and mat label that are taken, in characters. */
+export declare const JUDGING_LIMITS: Readonly<{
+    name: 120;
+    id: 64;
+    label: 40;
+}>;
+/** The seats of a style. @throws TypeError for a style that is not one. */
+export declare function seatsOf(style: unknown): readonly JudgingSeat[];
+/**
+ * The seat a name stands for: its number (`3`, `"3"`), its key (`"judge-3"`, `"Judge 3"`) or `"central"`.
+ * @throws RangeError for a seat the style does not have, naming the seats it has.
+ */
+export declare function seatOf(style: JudgingStyle, seat: unknown): JudgingSeat;
+/** The label of a mat: the caller's, held to its length, else the language's `Mat {n}`. */
+export declare function matLabel(mat: JudgingMat, n: number, language: Language): string;
+/** What `drawJudging` and the 3D view work from: the options held to what they may be, and every mat with all of its seats. */
+export interface JudgingSetting {
+    style: JudgingStyle;
+    language: Language;
+    /** The mats to draw (all of them, or the one `mat` names), each with every seat of the style. */
+    mats: JudgingResolved[];
+    /** How many mats the assignment has altogether. */
+    total: number;
+    chart: "auto" | "always" | "never";
+    orientation: "landscape" | "portrait";
+    focus: "mat" | "bench";
+    width: number;
+}
+/**
+ * Hold the options to what they may be and put each official in a seat.
+ * @throws TypeError for an option of the wrong kind, RangeError for a number of mats outside 1 to 6, a mat that does not exist, a seat the style does not have, a seat named twice on one mat or a text that is too long.
+ */
+export declare function judgingSetting(options: JudgingOptions): JudgingSetting;
+/** Where the seats are on one mat's plan, in metres from the top left of the tatami, and the plan they are on. */
+export interface JudgingPlan {
+    plan: BudoPlan;
+    /** The chair of each seat, in seat order, and the judges' table behind them. */
+    chairs: MBox[];
+    table: MBox;
+    /** The distance between two seats. */
+    pitch: number;
+    /** The whole picture of a mat (the free zone, the table, the seats, the coach's chair) and the judges' bench close up. */
+    extent: MBox;
+    bench: MBox;
+}
+/**
+ * The judges' bench close up: the seats and the table with a little round them and a few rows of mats in front, from the seats of one mat or of several side by side. `matTop` is where the mats start (the top of the first
+ * contest area), so that the picture shows how the bench sits at the mat's edge; `front` instead says how far in front of the table the picture reaches, in metres (the 3D view, which turns, wants as little of the floor as will do).
+ */
+export declare function benchOf(chairs: readonly MBox[], table: MBox, pitch: number, matTop: number, front?: number): MBox;
+/** The plan of one mat of a style, with its seats: the package's own judo area, so that the seats named are the seats drawn. */
+export declare function judgingPlan(style: JudgingStyle): JudgingPlan;

package/dist/judging.data.d.ts

@@ -0,0 +1,14 @@
+import type { JudgingSeat, JudgingStyle } from "./judging.types.ts";
+/** How many officials a style seats. */
+export declare const JUDGING_SEAT_COUNT: Readonly<Record<JudgingStyle, number>>;
+/** The seats of every style, in the order they are drawn. */
+export declare const JUDGING_SEATS: Readonly<Record<JudgingStyle, readonly JudgingSeat[]>>;
+/** The styles that can be asked for. */
+export declare const JUDGING_STYLES: readonly JudgingStyle[];
+/** The league each style is drawn in (`drawKyogijo`'s `league`), and the sources its seats are read from (keys of `LEAGUE_SOURCES`). */
+export declare const JUDGING_LEAGUE: Readonly<Record<JudgingStyle, {
+    league: string;
+    sources: readonly string[];
+}>>;
+/** The most mat areas an assignment names: the plan's own limit for areas side by side. */
+export declare const JUDGING_MATS_MAX = 6;

package/dist/judging.data.js

@@ -0,0 +1,24 @@
+// The seats of each judging style, as the rulebook has them. A kata area is judged by five judges on the shomen side, 1.25 m apart, the central judge at the centre of the area, and no referee (IJF Sport and
+// Organisation Rules of 21 January 2026, B1.8 and the judges' article; the Kata Commission's Tournament Handbook 2024). The rules do not number the judges: the numbers here are ours, from the left as the plan lies
+// with the shomen at the top (so the central judge is 3), and are said so in the docs. The positions are the plan's own (`budoPlan`), so that what is drawn and what is named cannot differ.
+import { IJF_KATA } from "./leagues/budo.js";
+/** How many officials a style seats. */
+export const JUDGING_SEAT_COUNT = Object.freeze({ kata: IJF_KATA.panel?.count ?? 5 });
+/** The seats of a kata area: five judges, the middle one the central judge. */
+function kata() {
+    const count = JUDGING_SEAT_COUNT.kata;
+    const middle = Math.ceil(count / 2);
+    return Array.from({ length: count }, (_, i) => {
+        const n = i + 1;
+        const central = n === middle;
+        return { id: `judge-${n}`, n, role: central ? "central" : "judge", label: { en: central ? `Judge ${n}, central` : `Judge ${n}`, ja: central ? `審判員${n}（中央）` : `審判員${n}` } };
+    });
+}
+/** The seats of every style, in the order they are drawn. */
+export const JUDGING_SEATS = Object.freeze({ kata: Object.freeze(kata()) });
+/** The styles that can be asked for. */
+export const JUDGING_STYLES = Object.freeze(["kata"]);
+/** The league each style is drawn in (`drawKyogijo`'s `league`), and the sources its seats are read from (keys of `LEAGUE_SOURCES`). */
+export const JUDGING_LEAGUE = Object.freeze({ kata: { league: "ijf-kata", sources: ["ijf-sor", "ijf-kata-handbook", "ijf-kata-criteria"] } });
+/** The most mat areas an assignment names: the plan's own limit for areas side by side. */
+export const JUDGING_MATS_MAX = 6;

package/dist/judging.draw.d.ts

@@ -0,0 +1,66 @@
+import { type JudgingSetting } from "./judging.ts";
+import type { JudgingOptions } from "./judging.types.ts";
+/** What a drawing of an assignment is, and what was worked out to make it. */
+export interface JudgingDrawing {
+    svg: string;
+    /** The picture's width and height in its own units (its viewBox). */
+    width: number;
+    height: number;
+    /** Whether the chart is drawn. */
+    chart: boolean;
+    /** For every seat of every mat drawn: whether its name and ID are in the seat. A seat with nobody in it fits. */
+    cards: {
+        mat: number;
+        seat: string;
+        fits: boolean;
+    }[];
+    title: string;
+    description: string;
+}
+/** The title and the description of an assignment: each mat with each seat and who is in it. */
+export declare function judgingText(setting: JudgingSetting, options: Pick<JudgingOptions, "title" | "description">, chart: boolean): {
+    title: string;
+    description: string;
+};
+/** The picture of an assignment and what was worked out to make it. `mode` `chart` is the chart alone (for beside a 3D view). */
+export declare function judgingDrawing(options: JudgingOptions, mode?: "full" | "chart"): JudgingDrawing;
+/**
+ * A judging assignment as one SVG string: for each mat, the judo area with a badge at each judge's seat and, where the name and ID fit in the seat, a card with both, and beside it the chart of seat, name and ID, whose rows
+ * grow to hold every name whole. `style` is the style the areas are judged in (`kata`: five judges); `mats` the mat areas, each with its `label` (`Mat 1`, `Mat 2` when missing) and its `officials`, each a `seat`, a `name`
+ * and an `id`. `mat` draws one mat alone (a tab); `chart` is `auto`, `always` or `never`; `focus: "bench"` shows the judges' bench close up so that the names in the seats are as large as they can be. Light and dark follow the
+ * page; `judgingTable` is the same thing as a table.
+ * @example
+ * ```ts
+ * import { drawJudging } from "@johnmorrisdotca/kyogijo-stadiums/judging";
+ * const svg = drawJudging({
+ *   style: "kata",
+ *   mats: [{ label: "Mat 1", officials: [{ seat: 1, name: "Aiko Mori", id: "J-1042" }, { seat: "central", name: "Daniel Okafor", id: "J-0377" }] }],
+ * });
+ * console.log(svg.startsWith("<svg"), svg.includes("Aiko Mori"), svg.includes("J-1042"));
+ * // true true true
+ * ```
+ */
+export declare function drawJudging(options: JudgingOptions): string;
+/**
+ * The chart of an assignment alone: for each mat its seats in order, each with its number, its role, its name and, under the name, its ID, in rows that grow so that no name or ID is cut. For a page that draws
+ * the 3D view of the mat and puts the chart beside it.
+ * @example
+ * ```ts
+ * import { judgingChart } from "@johnmorrisdotca/kyogijo-stadiums/judging";
+ * const svg = judgingChart({ style: "kata", mats: [{ officials: [{ seat: 1, name: "Aiko Mori", id: "J-1042" }] }] });
+ * console.log(svg.includes("ky-ju-chart-row"), svg.includes("Not assigned"));
+ * // true true
+ * ```
+ */
+export declare function judgingChart(options: JudgingOptions): string;
+/**
+ * The same thing as the picture, as a table: each mat, each seat and who sits in it, with the ID. For a reader who cannot see the drawing, and for a page that wants the data.
+ * @example
+ * ```ts
+ * import { judgingTable } from "@johnmorrisdotca/kyogijo-stadiums/judging";
+ * const table = judgingTable({ style: "kata", mats: [{ officials: [{ seat: 3, name: "Daniel Okafor", id: "J-0377" }] }] });
+ * console.log(table.startsWith("<table"), table.includes("Daniel Okafor"));
+ * // true true
+ * ```
+ */
+export declare function judgingTable(options: JudgingOptions): string;