@johnmorrisdotca/kyogijo-stadiums 0.16.1 → 0.18.0

package/CHANGELOG.md

@@ -7,6 +7,27 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.18.0] - 2026-10-20
+
+### Added
+
+- **Shiai judging assignments** (`style: "shiai"` of `@johnmorrisdotca/kyogijo-stadiums/judging`). A contest area's officials by seat, with a name and an ID, drawn as the kata area's are (a card in the seat where the name fits, the chart of seat, role, name and ID that never cuts a name, 2D and 3D, light and dark, English and Japanese, `mat`, `focus`, `chart`, `orientation`, `judgingTable`). From the IJF Sport and Organisation Rules of 21 January 2026: **the referee**, on the tatami at its centre 2 m back from the line the athletes start on, facing the technical table (Article 9; the Refereeing Rules' Article 2); **the timekeeper and the scorekeeper**, the two technical officials a tatami should have for timing and scoring (the Refereeing Rules' opening article); **the referee supervisor**, on the technical table with the CARE replay system (the same article); and **two side judges**, for an event with no CARE system (Article 13, 5), drawn only with the new `sideJudges: true` or when a mat names them. Which chair at the table is whose, the side judges' places (two opposite corners of the contest area, 2 m out: the Rules give none), the chairs, the table and the cards are ours. In the close-up of the bench (`focus: "bench"`) only the table's seats are drawn and the referee's and side judges' names are in the chart; in 3D the referee's and a side judge's cards stand on posts. Seat words: `referee`, `timekeeper`, `scorekeeper`, `supervisor`, `side-judge-1`, `side-judge-2` (or their numbers 1 to 6, or `judge-1`, `scorer`, `jury`...). The demo, [judging assignments](https://johnmorrisdotca.github.io/kyogijo-stadiums/judging.html), has a Style choice (`style=shiai`), the side judges' checkbox and a row in its editor for each seat; the docs have [a section](./docs/judging.md#the-seats-of-a-contest) and the gallery [a contest](https://johnmorrisdotca.github.io/kyogijo-stadiums/docs/gallery-judging.html#shiai).
+
+### Changed
+
+- `JudgingStyle` is `"kata" | "shiai"`; `JudgingSeat` has `where` (`table`, `mat` or `corner`) and `optional`, and its `role` the contest's roles; `seatsOf(style, "listed")` leaves out the optional seats; `judgingPlan(style, count)` gives each mat's `places` (a chair and a card for each seat, in metres) and its bench; `fitSeats` takes a box for each seat. A kata assignment draws byte for byte what it did.
+- `JudoLayout` (the judo plan) also gives `desks` (the technical tables) and `free` (the free zone), as data only: no drawing changes.
+
+## [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

package/README.md

@@ -102,6 +102,7 @@ console.log(svg.startsWith("<svg"), svg.includes("USA 3, Canada 2"));
 - **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. [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).
@@ -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
 
@@ -539,7 +541,20 @@ console.log(layout.needs.length, layout.needs.width);
 <br><em>Without `sample`: the empty places an organiser fills.</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.
+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/budo/judo.d.ts

@@ -43,6 +43,10 @@ export interface JudoLayout {
         seats: MBox[];
         coaches: MBox[];
     };
+    /** A contest area's technical tables (ours: 3 m by 0.8 m), one for each area of the top row; empty for a kata area. */
+    desks: MBox[];
+    /** The free zone round the whole competition area. */
+    free: MBox;
 }
 /** The mats of a `tatami` option, or the league's own when none. @throws Error for a name that is not a size of mat. */
 export declare function matOf(asked: BudoStyle["tatami"], fig: JudoFigures): MatSize;

package/dist/budo/judo.js

@@ -139,7 +139,7 @@ export function judoParts(o) {
     if (judges.coaches.length > 0)
         marks.push({ id: "coach-chair", x: (judges.coaches[0].x0 + judges.coaches[0].x1) / 2, y: (judges.coaches[0].y0 + judges.coaches[0].y1) / 2, side: "bottom" });
     const extent = union([free, ...desks.map((d) => grow(d, 0.3)), ...[...judges.tables, ...judges.seats, ...judges.coaches].map((d) => grow(d, 0.3))]);
-    return { parts, tatami, extent, contests, gap, pieces, mat, marks, danger: band, judges };
+    return { parts, tatami, extent, contests, gap, pieces, mat, marks, danger: band, judges, desks, free };
 }
 /** The number of mats of the competition area: a half mat counts a half. */
 export const mats = (layout, mat) => Math.round(matCount(layout.pieces, mat) * 100) / 100;

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_SEAT_WORDS, JUDGING_STYLES } from "./judging.data.ts";
+export { JUDGING_LIMITS, benchOf, judgingPlan, judgingSetting, matLabel, seatIn, 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, MatPlaces, SeatPlace } 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_SEAT_WORDS, JUDGING_STYLES } from "./judging.data.js";
+export { JUDGING_LIMITS, benchOf, judgingPlan, judgingSetting, matLabel, seatIn, 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,74 @@
+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: every one, or without the optional ones (the side judges of a contest). @throws TypeError for a style that is not one. */
+export declare function seatsOf(style: unknown, only?: "all" | "listed"): readonly JudgingSeat[];
+/**
+ * The seat a name stands for: its number (`3`, `"3"`), its key (`"judge-3"`, `"Judge 3"`, `"referee"`, `"timekeeper"`) or a word (`"central"`, `"scorer"`, `"jury"`).
+ * @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 one seat is on a mat's plan, in metres from the top left of the tatami: its chair (or the place where the official stands) and the card that carries the name, which may lie over the table in front of it. */
+export interface SeatPlace {
+    chair: MBox;
+    card: MBox;
+}
+/** One mat's seats, in the order the style lists them (`JUDGING_SEATS`, optional seats included), its table and its bench. */
+export interface MatPlaces {
+    places: SeatPlace[];
+    /** The judges' table or the technical table behind the seats at it. */
+    table: MBox;
+    /** The seats at the table close up: the picture of `focus: "bench"`. */
+    bench: MBox;
+}
+/** Where the seats are on the plan of a style, and the plan they are on. */
+export interface JudgingPlan {
+    plan: BudoPlan;
+    /** Each mat's seats, for the mats side by side the plan has (`count`). */
+    mats: MatPlaces[];
+    /** The first mat's seats, its table and its bench, as `mats[0]` has them (the chairs of the seats, in order). */
+    places: SeatPlace[];
+    chairs: MBox[];
+    table: MBox;
+    bench: MBox;
+    /** The distance between two seats at the table. */
+    pitch: number;
+    /** The whole picture of a mat (the free zone, the table, the seats, their cards): what `focus: "mat"` shows, for the first mat. */
+    extent: MBox;
+}
+/**
+ * The judges' bench close up: the seats and their 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 `count` mats side by side 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, count?: number): JudgingPlan;
+/** Whether a seat is in a box: its card's middle is inside it. A seat that is not is not drawn in a close-up of the bench, and its name is in the chart only. */
+export declare function seatIn(place: SeatPlace, box: MBox): boolean;

package/dist/judging.data.d.ts

@@ -0,0 +1,16 @@
+import type { JudgingSeat, JudgingStyle } from "./judging.types.ts";
+/** How many officials a style seats at the most (a contest's two side judges included). */
+export declare const JUDGING_SEAT_COUNT: Readonly<Record<JudgingStyle, number>>;
+/** The seats of every style, in the order they are listed. */
+export declare const JUDGING_SEATS: Readonly<Record<JudgingStyle, readonly JudgingSeat[]>>;
+/** The other words a seat is asked for by, besides its key and its number. */
+export declare const JUDGING_SEAT_WORDS: Readonly<Record<string, readonly string[]>>;
+/** 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,53 @@
+// 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).
+// A contest (shiai) has one referee, on the tatami at its centre 2 m back from the line the athletes start on, facing the technical table (SOR, Refereeing Rules, Article 9 and Article 2); two technical officials a
+// tatami for timing and scoring (the Refereeing Rules' opening article); the IJF Referee Supervisor(s) on the technical table with the CARE replay system, and the referees not officiating seated at it (Article 3);
+// and, for an event with no CARE system, two side judges with a majority of three (Article 13, 5). The Rules give no place for a side judge: the corners of the contest area are ours. The positions are the plan's own
+// (`budoPlan`) and the figures round them in `judging.ts`, so that what is drawn and what is named cannot differ.
+import { IJF_KATA } from "./leagues/budo.js";
+/** How many officials a style seats at the most (a contest's two side judges included). */
+export const JUDGING_SEAT_COUNT = Object.freeze({ kata: IJF_KATA.panel?.count ?? 5, shiai: 6 });
+/** The seats of a kata area: five judges, the middle one the central judge. */
+function kata() {
+    const count = IJF_KATA.panel?.count ?? 5;
+    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", where: "table", label: { en: central ? `Judge ${n}, central` : `Judge ${n}`, ja: central ? `審判員${n}（中央）` : `審判員${n}` } };
+    });
+}
+/** The seats of a contest: the referee, then the technical table's three, then the side judges (drawn only when asked for or named). */
+function shiai() {
+    const seat = (n, id, role, where, en, ja, optional = false) => ({ id, n, role, where, label: { en, ja }, ...(optional ? { optional: true } : {}) });
+    return [
+        seat(1, "referee", "referee", "mat", "Referee", "主審"),
+        seat(2, "timekeeper", "timekeeper", "table", "Timekeeper", "計時係"),
+        seat(3, "scorekeeper", "scorekeeper", "table", "Scorekeeper", "記録係"),
+        seat(4, "supervisor", "supervisor", "table", "Referee supervisor", "審判委員"),
+        seat(5, "side-judge-1", "side-judge", "corner", "Side judge 1", "副審1", true),
+        seat(6, "side-judge-2", "side-judge", "corner", "Side judge 2", "副審2", true),
+    ];
+}
+/** The seats of every style, in the order they are listed. */
+export const JUDGING_SEATS = Object.freeze({ kata: Object.freeze(kata()), shiai: Object.freeze(shiai()) });
+/** The other words a seat is asked for by, besides its key and its number. */
+export const JUDGING_SEAT_WORDS = Object.freeze({
+    "judge-3": ["central", "centre", "center"],
+    referee: ["main", "main-referee", "central-referee", "shimpan"],
+    timekeeper: ["time", "timer", "timing"],
+    scorekeeper: ["score", "scorer", "scoring", "recorder"],
+    supervisor: ["referee-supervisor", "jury", "care"],
+    "side-judge-1": ["judge-1", "side-1"],
+    "side-judge-2": ["judge-2", "side-2"],
+});
+/** The styles that can be asked for. */
+export const JUDGING_STYLES = Object.freeze(["kata", "shiai"]);
+/** 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"] },
+    shiai: { league: "ijf", sources: ["ijf-sor"] },
+});
+/** 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;