@johnmorrisdotca/kyogijo-stadiums 0.5.0 → 0.6.0

package/dist/emblems-source.js

@@ -0,0 +1,56 @@
+// Where kyogijo gets ready-made emblems from: a renderer that the page plugs in, so that kyogijo bundles no art and keeps zero dependencies. The renderer is
+// `renderEmblem` of @johnmorrisdotca/dougu-sports (or any function with its shape); `useEmblems(renderEmblem)` plugs it in for the page, `emblems: renderEmblem` for one drawing.
+// This module knows nothing of any emblem: it only decides whether a string might be an emblem's id, asks the renderer, and keeps what the renderer gives back.
+let plugged;
+let scoped;
+/**
+ * Plug a renderer of ready-made emblems into kyogijo, for every drawing on the page: after this `logo: "crest:shield"` and `emblem: "trophy:hockey-cup"` are drawn. Call it once, at start-up. Without one, an id is
+ * an address and is refused. `useEmblems(undefined)` unplugs it.
+ * @example
+ * ```ts
+ * import { useEmblems } from "@johnmorrisdotca/kyogijo-stadiums";
+ * import { renderEmblem } from "@johnmorrisdotca/dougu-sports/emblems";
+ * useEmblems(renderEmblem);
+ * ```
+ */
+export function useEmblems(render) {
+    plugged = typeof render === "function" ? render : undefined;
+}
+/** Run a drawing with a renderer for that drawing alone (the `emblems` option), putting back whatever was there. Without a renderer it runs as it is. */
+export function withEmblems(render, draw) {
+    if (typeof render !== "function")
+        return draw();
+    const before = scoped;
+    scoped = render;
+    try {
+        return draw();
+    }
+    finally {
+        scoped = before;
+    }
+}
+/** The renderer in use: the drawing's own, else the page's, else none. */
+export function emblemRenderer() {
+    return scoped ?? plugged;
+}
+/** The look of an id: lower-case words, optionally `group:name`, optionally a style. An address, a path with a dot or a slash, a data address or an SVG document never has it. */
+const ID = /^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*)?(?:\/(?:metal|line|color))?$/;
+/** An id with its group, which no address has in practice: what a missing renderer is told about. */
+export const GROUPED_ID = /^(?:trophy|medal|award|crest|sport|ball|gear):[a-z0-9]+(?:-[a-z0-9]+)*(?:\/(?:metal|line|color))?$/;
+/** The SVG document for a value that names an emblem, drawn by the renderer in use, or `undefined` (no renderer, not the look of an id, or an id the renderer does not know). */
+export function renderedEmblem(value, options) {
+    const render = emblemRenderer();
+    if (render === undefined || typeof value !== "string")
+        return undefined;
+    const text = value.trim();
+    if (text.length > 60 || !ID.test(text))
+        return undefined;
+    let svg;
+    try {
+        svg = render(text, options);
+    }
+    catch {
+        return undefined;
+    }
+    return typeof svg === "string" && /^\s*(?:<\?xml|<svg)\b/i.test(svg) ? svg : undefined;
+}

package/dist/eras.d.ts

@@ -54,6 +54,8 @@ export interface NhlRules {
     } | null;
     /** The gap between the two hash marks beside an end-zone face-off circle (Rule 1.9). */
     hashApart: number;
+    /** The centre red line judges the offside pass: a pass from inside a team's own defensive zone across both its blue line and the centre line, to a team-mate who has not touched it, stops play. Data only: the lines are drawn the same. */
+    twoLinePass: boolean;
 }
 /** The NBA court's markings in a season. Lengths are feet. */
 export interface NbaRules {
@@ -138,7 +140,7 @@ export interface EraChange {
  * import { eraChanges } from "@johnmorrisdotca/kyogijo-stadiums/eras";
  * const nhl = eraChanges("nhl");
  * console.log(nhl.length, nhl[0].id, nhl[0].from);
- * // 10 nhl.centreLine.1943 1943
+ * // 12 nhl.centreLine.1943 1943
  * ```
  */
 export declare function eraChanges(sport: EraSport): EraChange[];

package/dist/eras.js

@@ -29,7 +29,7 @@ const wikipedia = (id, title, revision, note) => ({
 });
 /** Every page a change was read from, by id. Wikipedia is cited by revision, for facts only. */
 export const ERA_SOURCES = Object.freeze(Object.fromEntries([
-    wikipedia("wp-offside", "Offside (ice hockey)", 1366324643, "the two blue lines of 1928-29, the centre red line introduced in 1943-44"),
+    wikipedia("wp-offside", "Offside (ice hockey)", 1366324643, "the two blue lines of 1928-29, the centre red line introduced in 1943-44, the offside pass judged by it until the 2005 collective bargaining agreement"),
     wikipedia("wp-rink", "Ice hockey rink", 1369579112, "the NHL's blue lines at 75 feet and goal lines at 11 feet; the trapezoid from 2005-06, 18 feet at the goal line, 22 feet from 2014-15"),
     wikipedia("wp-nhl-rules", "National Hockey League rules", 1379666522, "the trapezoid since 2005-06, lengthened by 2 feet each side in 2014"),
     {
@@ -152,6 +152,11 @@ const NHL_SPANS = {
         { from: 2005, value: { atGoalLine: 18, atBoards: 28 }, what: "The goaltender's trapezoid is marked behind each net: 18 feet at the goal line, 28 feet at the end boards.", ja: "各ゴールの裏に、ゴーリーがパックを扱える区域として台形（トラペゾイド）が引かれます。ゴールライン側が18フィート、エンドボード側が28フィートです。", sources: ["wp-rink", "wp-nhl-rules"] },
         { from: 2014, value: { atGoalLine: NHL.trapezoid.atGoalLine, atBoards: NHL.trapezoid.atBoards }, what: "The trapezoid is widened to 22 feet at the goal line (2 feet each side).", ja: "トラペゾイドのゴールライン側が左右2フィートずつ広がり、22フィートになります。", sources: ["wp-rink", "wp-nhl-rules"] },
     ],
+    twoLinePass: [
+        { from: null, value: false, what: "No two-line pass rule: there is no centre line to judge it by.", ja: "ツーライン・パス（2本のラインをまたぐパス）の反則はありません。判定に使うセンターラインがまだないためです。", sources: ["wp-offside"] },
+        { from: 1943, value: true, what: "The centre red line judges the two-line pass: a pass across both a team's own blue line and the centre line, to a team-mate who has not touched it, is an offside pass.", ja: "センターレッドラインでツーライン・パスを判定します。自陣のブルーラインとセンターラインの両方をまたぐパスを、まだ触れていない味方が受けると、オフサイドパスの反則になります。", sources: ["wp-offside"] },
+        { from: 2005, value: false, what: "The centre line no longer judges the offside pass, under the 2005 collective bargaining agreement, so a pass across two lines is legal.", ja: "2005年の労使協定により、センターラインはオフサイドパスの判定に使われなくなり、ツーライン・パスは反則ではなくなります。", sources: ["wp-offside"] },
+    ],
     hashApart: [
         { from: 2012, value: 3, what: "The two hash marks beside each end-zone face-off circle are 3 feet apart (Rule 1.9 of 2012-13; no earlier season is cited).", ja: "エンドゾーンのフェイスオフサークルの両脇にある2本のハッシュマークは、間隔が3フィート（約91cm）です（2012-13シーズンのルール1.9。それ以前のシーズンを示す資料は見つかっていません）。", sources: ["nhl-rules-2012", "nhl-hash-2014", "cbs-hash-2014"] },
         { from: 2014, value: NHL.hashApart, what: "The hash marks move apart to 5 feet 7 inches, more in line with the marks on international ice.", ja: "2本のハッシュマークの間隔が5フィート7インチ（約1.7m）に広がり、国際大会のリンクにあるマークに近づきます。", sources: ["nhl-hash-2014", "cbs-hash-2014"] },
@@ -258,7 +263,7 @@ const SPANS = {
 function present(sport) {
     switch (sport) {
         case "nhl":
-            return { centreLine: true, goalLine: NHL.goalLine, blueLine: NHL.blueLine, trapezoid: { atGoalLine: NHL.trapezoid.atGoalLine, atBoards: NHL.trapezoid.atBoards }, hashApart: NHL.hashApart };
+            return { centreLine: true, goalLine: NHL.goalLine, blueLine: NHL.blueLine, trapezoid: { atGoalLine: NHL.trapezoid.atGoalLine, atBoards: NHL.trapezoid.atBoards }, hashApart: NHL.hashApart, twoLinePass: false };
         case "nba":
             return { keyWidth: NBA.lane, threePoint: { radius: NBA.threePoint.radius }, restrictedArea: true };
         case "nfl":
@@ -298,7 +303,7 @@ const featuresOf = (sport) => Object.entries(SPANS[sport]);
  * import { eraChanges } from "@johnmorrisdotca/kyogijo-stadiums/eras";
  * const nhl = eraChanges("nhl");
  * console.log(nhl.length, nhl[0].id, nhl[0].from);
- * // 10 nhl.centreLine.1943 1943
+ * // 12 nhl.centreLine.1943 1943
  * ```
  */
 export function eraChanges(sport) {

package/dist/features.js

@@ -86,6 +86,73 @@ const SKATING = [
     f("technical-panel", "--ky-ink", "The technical panel's table."),
     f("kiss-and-cry", "--ky-red", "The kiss and cry."),
 ];
+const JUDO = [
+    f("apron", "--ky-apron", "The ground round the competition area."),
+    f("free-zone", "--ky-free", "The free zone of 50 cm kept round the competition area."),
+    f("platform", "--ky-bud-floor", "The platform under the tatami, when there is one."),
+    f("floor", "--ky-bud-floor", "The arena floor under the surface, when there is one (the Budokan's)."),
+    f("contest-area", "--ky-surface", "The tatami of the contest area."),
+    f("safety-area", "--ky-surface-alt", "The tatami of the safety area."),
+    f("danger-zone", "--ky-red", "The red tatami of the danger zone inside a contest area (the AJJF's)."),
+    f("seams", "--ky-ink", "The seams between the mats."),
+    f("start-right", ["--ky-blue", "--ky-red"], "The tape where the contestant to the referee's right starts: blue, or red in the AJJF's."),
+    f("start-left", "--ky-line", "The tape where the contestant to the referee's left starts."),
+    f("officials", "--ky-ink", "The technical table."),
+];
+const KARATE = [
+    f("apron", "--ky-apron", "The ground round the mats."),
+    f("floor", "--ky-bud-floor", "The arena floor under the surface, when there is one (the Budokan's)."),
+    f("safety-area", "--ky-surface-alt", "The mats of the safety area."),
+    f("boundary-band", "--ky-red", "The outer metre of a kumite area, in another colour."),
+    f("competition-area", "--ky-surface", "The mats inside the boundary band."),
+    f("start-mats", "--ky-red", "The two mats turned over at the start."),
+    f("seams", "--ky-ink", "The seams between the mats."),
+    f("judges", "--ky-ink", "The judges' seats."),
+    f("referee", "--ky-ink", "The referee's place."),
+    f("officials", "--ky-ink", "The officials' table."),
+];
+const KENDO = [
+    f("apron", "--ky-apron", "The ground round the shiai-jo."),
+    f("outside", "--ky-free", "The 1.5 m kept clear outside the boundary lines."),
+    f("floor", "--ky-bud-floor", "The wooden floor."),
+    f("boards", "--ky-ink", "The seams between the floorboards."),
+    f("boundary-lines", "--ky-line", "The boundary lines."),
+    f("cross", "--ky-line", "The cross at the centre."),
+    f("start-lines", "--ky-line", "The two kaishi-sen."),
+    f("outer-boundary", "--ky-ink", "The outer boundary, 1.5 m outside."),
+];
+const SUMO = [
+    f("apron", "--ky-apron", "The ground round the dohyō."),
+    f("clay", "--ky-dirt", "The clay of the platform and of the ring."),
+    f("jano-me", "--ky-sand", "The sand outside the tawara."),
+    f("tawara", "--ky-bud-straw", "The tawara of the ring."),
+    f("shikiri-sen", "--ky-line", "The two shikiri-sen."),
+];
+const KYUDO = [
+    f("apron", "--ky-apron", "The ground round the range."),
+    f("shajo", "--ky-bud-floor", "The floor of the shajō."),
+    f("yamichi", "--ky-surface", "The yamichi."),
+    f("yatori-michi", "--ky-surface-alt", "The path for fetching the arrows."),
+    f("azuchi", "--ky-dirt", "The azuchi, the mound."),
+    f("shooting-positions", "--ky-line", "The shooting positions and their line."),
+    f("honza", "--ky-line", "The honza and their line."),
+    f("targets", "--ky-line", "The targets."),
+    f("roofs", "--ky-ink", "The outlines of the roofs of the shajō and the matoba."),
+];
+const DOJO = [
+    f("apron", "--ky-apron", "The ground round the dojo."),
+    f("mats", "--ky-surface", "The mats, or the first tone of a checker or a competition floor."),
+    f("mats-alt", "--ky-surface-alt", "The second tone of a checker or a competition floor."),
+    f("border", "--ky-red", "The border of another colour of a border floor."),
+    f("seams", "--ky-ink", "The seams between the mats."),
+    f("heri", "--ky-ink", "The heri, the cloth along the long sides of a traditional mat."),
+    f("walls", "--ky-boards", "The walls."),
+    f("doors", "--ky-apron", "The doors."),
+    f("windows", "--ky-blue", "The windows."),
+    f("shrine", "--ky-red", "The shinzen, the shrine."),
+    f("dais", "--ky-bud-floor", "The raised platform of the seat of honour."),
+    f("banner", "--ky-ink", "The banner on the kamiza wall."),
+];
 const KEY = ["--ky-key", "--ky-key-left", "--ky-key-right"];
 const BASKETBALL = [
     f("apron", "--ky-apron", "The ground round the court."),
@@ -360,6 +427,12 @@ export const FEATURE_INFO = Object.freeze({
     handball: HANDBALL,
     athletics: ATHLETICS,
     skating: SKATING,
+    judo: JUDO,
+    karate: KARATE,
+    kendo: KENDO,
+    sumo: SUMO,
+    kyudo: KYUDO,
+    dojo: DOJO,
 });
 /**
  * The names of the features of each sport: the keys `featureColors` takes. Football's three fields have the same, and so have the five net sports.

package/dist/field.data.d.ts

@@ -0,0 +1,16 @@
+import type { SurfaceOptions } from "./types.ts";
+/** The `data-box` and `data-rules` of a drawing's surface group, or nothing for a drawing the question does not apply to (a special game). */
+export declare function fieldAttributes(o: SurfaceOptions): {
+    "data-box"?: string;
+    "data-rules"?: string;
+};
+/** The box and the options a surface group carries, or `undefined` when it carries none. */
+export declare function readField(get: (name: string) => string | null): {
+    box: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    rules: Record<string, unknown>;
+} | undefined;

package/dist/field.data.js

@@ -0,0 +1,50 @@
+// What a drawing writes on its surface group so that a page can ask the drawing where a click is (pointer.ts): the box of the playing surface in feet in the
+// drawing's wide frame, and the few options that decide its rules (the league, the season, the park, the pitch). The group's own `transform` is the quarter turn of a
+// tall drawing, so its coordinates are always the wide frame's, whatever the drawing's shape on the page.
+import { num } from "./format.js";
+import { outlineOf } from "./outline.js";
+const SIMPLE = ["league", "year", "pitch", "park", "fence", "units", "field"];
+const COMPLEX = ["sheet", "net", "pool", "athletics", "skating"];
+/** The longest the options that hold data of their own (a pool's race, an athletics meeting) may be, written out, before the drawing leaves them out of the page. */
+const MOST = 600;
+/** The `data-box` and `data-rules` of a drawing's surface group, or nothing for a drawing the question does not apply to (a special game). */
+export function fieldAttributes(o) {
+    if (o.host !== undefined)
+        return {};
+    try {
+        const { box } = outlineOf(o);
+        const rules = {};
+        for (const key of SIMPLE)
+            if (o[key] !== undefined)
+                rules[key] = o[key];
+        for (const key of COMPLEX)
+            if (o[key] !== undefined && JSON.stringify(o[key]).length <= MOST)
+                rules[key] = o[key];
+        return { "data-box": [box.x, box.y, box.w, box.h].map(num).join(" "), "data-rules": Object.keys(rules).length === 0 ? undefined : JSON.stringify(rules) };
+    }
+    catch {
+        return {};
+    }
+}
+/** The box and the options a surface group carries, or `undefined` when it carries none. */
+export function readField(get) {
+    const raw = get("data-box");
+    if (raw === null)
+        return undefined;
+    const [x, y, w, h] = raw.split(" ").map(Number);
+    if (![x, y, w, h].every(Number.isFinite))
+        return undefined;
+    let rules = {};
+    const text = get("data-rules");
+    if (text !== null) {
+        try {
+            const parsed = JSON.parse(text);
+            if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed))
+                rules = parsed;
+        }
+        catch {
+            rules = {};
+        }
+    }
+    return { box: { x, y, w, h }, rules };
+}

package/dist/fields.kit.d.ts

@@ -1,4 +1,4 @@
-import type { AthleticsMark, SkatingMark, ArcShape, BarShape, BoxShape, Dash, DotShape, LineShape, Outline, PathShape, PolyShape, RingShape } from "./fields.types.ts";
+import type { AthleticsMark, SkatingMark, BudoMark, ArcShape, BarShape, BoxShape, Dash, DotShape, LineShape, Outline, PathShape, PolyShape, RingShape } from "./fields.types.ts";
 import type { Span } from "./leagues/fields.ts";
 import { type PlateSpot, type Zone } from "./surfaces/surface.ts";
 import type { Box } from "./types.ts";
@@ -8,7 +8,7 @@ interface Style {
     dash?: Dash;
     /** The least this shape is drawn at, in feet, when the drawing is not at the true widths (a crease on a pitch has to stay thin beside a ground). */
     least?: number;
-    cls?: "ky-line" | "ky-red" | AthleticsMark | SkatingMark;
+    cls?: "ky-line" | "ky-red" | AthleticsMark | SkatingMark | BudoMark;
 }
 /** A line from one point to another. */
 export declare const line: (id: string, feature: string, x0: number, y0: number, x1: number, y1: number, style?: Style) => LineShape;

package/dist/fields.types.d.ts

@@ -14,7 +14,7 @@ interface Stroked extends Named {
     /** The least this shape is drawn at, in feet, when the drawing is not at true widths: the plan's `drawnLine` when missing. */
     least?: number;
     /** The class it is painted with: the ordinary line (`ky-line`, white) unless it is a red line (`ky-red`), or one of athletics' coloured marks (yellow, blue, green, black or red). */
-    cls?: "ky-line" | "ky-red" | AthleticsMark | SkatingMark;
+    cls?: "ky-line" | "ky-red" | AthleticsMark | SkatingMark | BudoMark;
 }
 /** The coloured marks of an athletics track: the yellow of the 4 x 100 m's takeover zones, the blue of the 4 x 400 m's and the 110 m hurdles (red on a blue track), the green of the 400 m hurdles and the breakline, black marks and red ones. */
 /** The fills of an athletics track's coloured marks (a bar of yellow, blue, green, black or red). */
@@ -22,6 +22,10 @@ export type AthleticsFill = "ky-ath-y-fill" | "ky-ath-b-fill" | "ky-ath-g-fill"
 export type AthleticsMark = "ky-ath-y" | "ky-ath-b" | "ky-ath-g" | "ky-ath-k" | "ky-ath-r" | "ky-ath-s";
 /** The coloured marks of a skating rink: the blue lines that demarcate the lanes, the red starting, finishing and coaches' lines, black lines, the dotted blocks of a curve. */
 export type SkatingMark = "ky-ska-b" | "ky-ska-r" | "ky-ska-k" | "ky-ska-blocks";
+/** The coloured marks of a budō surface: the white line, the blue, white and red tape, the seam between mats. */
+/** The fills of a budō surface's tape: blue, white, red and ink. */
+export type BudoFill = "ky-bud-blue-fill" | "ky-bud-white-fill" | "ky-bud-red-fill" | "ky-bud-ink-fill";
+export type BudoMark = "ky-bud-line" | "ky-bud-blue" | "ky-bud-white" | "ky-bud-red" | "ky-bud-seam" | "ky-bud-ink";
 /** A line from one point to another. */
 export interface LineShape extends Stroked {
     kind: "line";
@@ -74,7 +78,7 @@ export interface DotShape extends Named {
 export interface BarShape extends Named {
     kind: "bar";
     /** The class it is filled with, when it is not the line's colour. */
-    cls?: "ky-fill-line" | AthleticsFill;
+    cls?: "ky-fill-line" | AthleticsFill | BudoFill;
     x0: number;
     y0: number;
     x1: number;
@@ -90,10 +94,12 @@ export type Shape = LineShape | ArcShape | RingShape | BoxShape | PolyShape | Do
 /** The areas of an athletics stadium: the track, the grass, the sand of a pit, the mat of a jump, the water of a pit, the concrete of a circle and a runway's cover. */
 /** The areas of a skating rink: the ice, the floor of the infield, the warm-up lane, the padding and the furniture. */
 export type SkatingArea = "ky-ska-ice" | "ky-ska-floor" | "ky-ska-warm" | "ky-ska-pad" | "ky-ska-desk" | "ky-ska-kiss";
+/** The areas of a budō surface: the mats in three tones, the heri of a mat, the floor, the walls, the platform and the furniture, the clay and the sand and the straw of a dohyō, the azuchi and the yamichi. */
+export type BudoArea = "ky-bud-t1" | "ky-bud-t2" | "ky-bud-t3" | "ky-bud-heri" | "ky-bud-floor" | "ky-bud-wall" | "ky-bud-window" | "ky-bud-door" | "ky-bud-platform" | "ky-bud-free" | "ky-bud-desk" | "ky-bud-clay" | "ky-bud-sand" | "ky-bud-tawara" | "ky-bud-azuchi" | "ky-bud-roof" | "ky-bud-yamichi" | "ky-bud-shrine" | "ky-bud-dais" | "ky-bud-banner" | "ky-bud-lane" | "ky-bud-mato" | "ky-bud-tassel-e" | "ky-bud-tassel-s" | "ky-bud-tassel-w" | "ky-bud-tassel-n" | "ky-bud-seat";
 export type AthleticsArea = "ky-ath-track" | "ky-ath-grass" | "ky-ath-sand" | "ky-ath-mat" | "ky-ath-water" | "ky-ath-concrete" | "ky-ath-pad" | "ky-ath-board" | "ky-ath-bank";
 /** A painted area, under the lines: a rectangle or an ellipse filled with a class of the stylesheet (`ky-area`, the tint of a goal area, or `ky-zone`). */
 export interface Area extends Named {
-    cls: "ky-area" | "ky-zone" | "ky-dirt" | "ky-key" | "ky-boards" | AthleticsArea | SkatingArea;
+    cls: "ky-area" | "ky-zone" | "ky-dirt" | "ky-key" | "ky-boards" | AthleticsArea | SkatingArea | BudoArea;
     /** Fill the path's insides by the even-odd rule: a ring (the track between its kerb and its outer edge). */
     evenodd?: boolean;
     /** A rectangle `[x0, y0, x1, y1]`, an ellipse's centre and radii, a path of your own, or a frame: the ring between a rounded rectangle and the one `thick` outside it (boards). */

package/dist/formations.js

@@ -1,6 +1,12 @@
+// Formations (the first five sports' here, the others' in formations.sports.ts): where the players of a team stand, as named positions in a registered coordinate frame, so that a formation lies on a surface of any
+// size and can be read back in a provider's own numbers. The positions are the usual ones of each sport, and the numbers are ours: a formation is a
+// convention that coaches draw a little differently each time, so each place is an example of the shape and not a measurement. The names of the
+// positions are the conventional ones; the rulebooks name few of them (the Laws of the Game, Law 3, name the goalkeeper and no other position; the
+// Official Baseball Rules name the nine fielders, whose numbers 1 to 9 are the scorer's). The sources are in docs/sources.md.
+import { DESIGNATED_HITTER, MORE_FORMATIONS, MORE_NAMES } from "./formations.sports.js";
 const named = (en, ja) => ({ en, ja });
-/** The names of the positions of each sport, by the id a formation uses for them. */
-export const POSITION_NAMES = Object.freeze({
+/** The names of the positions of the first five sports (the others are in formations.sports.ts), by the id a formation uses for them. */
+const FIRST_NAMES = {
     soccer: {
         GK: named("Goalkeeper", "ゴールキーパー"),
         RB: named("Right back", "右サイドバック"),
@@ -83,7 +89,9 @@ export const POSITION_NAMES = Object.freeze({
         CF: named("Centre fielder", "センター"),
         RF: named("Right fielder", "ライト"),
     },
-});
+};
+/** The names of the positions of each sport, by the id a formation uses for them. */
+export const POSITION_NAMES = Object.freeze(Object.fromEntries(["soccer", "nhl", "nba", "nfl", "mlb", "rugby", "afl", "cricket", "volleyball", "handball", "waterpolo", "fieldhockey", "netball"].map((sport) => [sport, Object.freeze({ ...FIRST_NAMES[sport], ...MORE_NAMES[sport] })])));
 const at = (id, x, y) => ({ id, x, y });
 // Soccer, in the `opta` frame: x runs 0 to 100 from the team's own goal to the one it attacks, y runs 0 to 100 up the page, so the team's right flank is the low y.
 const GK = at("GK", 5, 50);
@@ -149,7 +157,7 @@ export const FORMATIONS = Object.freeze(Object.fromEntries([
         id: "football-i-formation",
         sport: "nfl",
         frame: "nfl-tracking",
-        name: { en: "Football, I formation", ja: "アメリカンフットボール（Iフォーメーション）" },
+        name: { en: "Football, I formation", ja: "アメフト（Iフォーメーション）" },
         about: { en: "Offence: the quarterback under centre with the fullback and the halfback in a line behind him, a tight end and two wide receivers.", ja: "オフェンス。センターの真後ろにクォーターバック、その後ろにフルバックとハーフバックが縦一列、タイトエンド1人とワイドレシーバー2人。" },
         positions: [...LINE, at("QB", 58.8, 26.67), at("FB", 55, 26.67), at("HB", 52, 26.67), at("TE", 60, 22.4), at("WR1", 60, 50), at("WR2", 58.5, 4)],
     },
@@ -157,7 +165,7 @@ export const FORMATIONS = Object.freeze(Object.fromEntries([
         id: "football-shotgun",
         sport: "nfl",
         frame: "nfl-tracking",
-        name: { en: "Football, shotgun", ja: "アメリカンフットボール（ショットガン）" },
+        name: { en: "Football, shotgun", ja: "アメフト（ショットガン）" },
         about: { en: "Offence: the quarterback a few yards behind the centre with a halfback beside him, a tight end and three wide receivers.", ja: "オフェンス。クォーターバックはセンターの数ヤード後ろに下がり、隣にハーフバック、タイトエンド1人とワイドレシーバー3人。" },
         positions: [...LINE, at("QB", 54, 26.67), at("HB", 54, 30), at("TE", 60, 22.4), at("WR1", 60, 50), at("WR2", 59, 5), at("WR3", 59, 41)],
     },
@@ -165,7 +173,7 @@ export const FORMATIONS = Object.freeze(Object.fromEntries([
         id: "football-4-3",
         sport: "nfl",
         frame: "nfl-tracking",
-        name: { en: "Football, 4-3 defence", ja: "アメリカンフットボール（4-3ディフェンス）" },
+        name: { en: "Football, 4-3 defence", ja: "アメフト（4-3ディフェンス）" },
         about: { en: "Defence against an offence going right: four linemen, three linebackers, two cornerbacks and two safeties. Left and right are the defenders' own.", ja: "右へ進むオフェンスに対するディフェンス。ディフェンスライン4人、ラインバッカー3人、コーナーバック2人、セーフティ2人。左右はディフェンス側から見たものです。" },
         positions: [at("LDE", 61, 20), at("LDT", 61, 25), at("RDT", 61, 28.4), at("RDE", 61, 33), at("LLB", 65, 17), at("MLB", 65, 26.67), at("RLB", 65, 36), at("LCB", 65, 5), at("RCB", 65, 48), at("FS", 72, 33), at("SS", 72, 20)],
     },
@@ -173,7 +181,7 @@ export const FORMATIONS = Object.freeze(Object.fromEntries([
         id: "football-3-4",
         sport: "nfl",
         frame: "nfl-tracking",
-        name: { en: "Football, 3-4 defence", ja: "アメリカンフットボール（3-4ディフェンス）" },
+        name: { en: "Football, 3-4 defence", ja: "アメフト（3-4ディフェンス）" },
         about: { en: "Defence against an offence going right: three linemen, four linebackers, two cornerbacks and two safeties. Left and right are the defenders' own.", ja: "右へ進むオフェンスに対するディフェンス。ディフェンスライン3人、ラインバッカー4人、コーナーバック2人、セーフティ2人。左右はディフェンス側から見たものです。" },
         positions: [at("LDE", 61, 21), at("NT", 61, 26.67), at("RDE", 61, 32), at("LOLB", 64.5, 15), at("LILB", 64.5, 23), at("RILB", 64.5, 30.5), at("ROLB", 64.5, 38), at("LCB", 65, 5), at("RCB", 65, 48), at("FS", 72, 33), at("SS", 72, 20)],
     },
@@ -184,6 +192,7 @@ export const FORMATIONS = Object.freeze(Object.fromEntries([
         name: { en: "Baseball, standard defence", ja: "野球（通常の守備位置）" },
         about: { en: "The nine fielders where they usually stand: a straight infield and the outfielders in their fields.", ja: "9人の野手の定位置。内野はシフトなしで、外野手はそれぞれ自分の守備範囲に立ちます。" },
         positions: [at("P", 0, 60.5), at("C", 0, -3), at("1B", 70, 78), at("2B", 36, 140), at("SS", -36, 140), at("3B", -70, 78), at("LF", -120, 260), at("CF", 0, 290), at("RF", 120, 260)],
+        extra: DESIGNATED_HITTER,
     },
     {
         id: "baseball-shift",
@@ -192,7 +201,9 @@ export const FORMATIONS = Object.freeze(Object.fromEntries([
         name: { en: "Baseball, infield shift against a left-handed pull hitter", ja: "野球（左打者の引っ張り対策の内野シフト）" },
         about: { en: "Three infielders on the right side of second base and the outfield turned the same way. Since 2023 MLB's Rule 5.02 requires two infielders on each side of second base, so this shift is not allowed there.", ja: "二塁ベースの一塁側に内野手3人が寄り、外野手も同じ方向に寄った守備。2023年から、MLBの規則5.02は二塁ベースの一塁側と三塁側に内野手を2人ずつ置くことを求めているため、MLBではこのシフトは認められません。" },
         positions: [at("P", 0, 60.5), at("C", 0, -3), at("1B", 82, 92), at("2B", 60, 175), at("SS", 24, 135), at("3B", -34, 138), at("LF", -70, 275), at("CF", 60, 295), at("RF", 135, 270)],
+        extra: DESIGNATED_HITTER,
     },
+    ...MORE_FORMATIONS,
 ].map((f) => [f.id, f])));
 /** The ids of the formations, in the order of the table. */
 export const FORMATION_IDS = Object.freeze(Object.keys(FORMATIONS));

package/dist/formations.sports.d.ts

@@ -0,0 +1,8 @@
+import type { Named } from "./formations.ts";
+import type { Formation, FormationPosition, FormationSport } from "./team.types.ts";
+/** The names of the positions of the sports in this file, and of the places this file adds to the first five, by id. */
+export declare const MORE_NAMES: Readonly<Partial<Record<FormationSport, Readonly<Record<string, Named>>>>>;
+/** The formations of this file, in the order of the table that holds them. */
+export declare const MORE_FORMATIONS: readonly Formation[];
+/** The designated hitter's place, which `baseball-standard` and `baseball-shift` list and do not field. */
+export declare const DESIGNATED_HITTER: readonly FormationPosition[];