@johnmorrisdotca/kyogijo-stadiums 0.4.0 → 0.6.0

package/dist/features.js

@@ -38,6 +38,121 @@ const HOCKEY = [
     f("nets", "--ky-red", "The nets."),
     f("referee-crease", "--ky-red", "The referee's crease at the boards."),
 ];
+const ATHLETICS = [
+    f("apron", "--ky-apron", "The ground round the stadium."),
+    f("track", "--ky-track", "The synthetic surface of the track, the straights and the segments."),
+    f("infield", "--ky-surface", "The turf inside the track."),
+    f("mowing", "--ky-surface-alt", "The lighter tone of the mown turf."),
+    f("kerb", LINE, "The kerb on the inside edge of the track."),
+    f("lane-lines", LINE, "The lines between the lanes and the track's outer edge."),
+    f("lane-numbers", LINE, "The lane numbers painted before the finish and the starts."),
+    f("finish-line", LINE, "The finish line and the short lines 1 m before it."),
+    f("start-lines", LINE, "The start lines: straight, staggered and curved."),
+    f("breakline", "--ky-ath-g", "The breakline of the 800 m and the 4 x 400 m."),
+    f("relay-zones", ["--ky-ath-y", "--ky-ath-b", LINE], "The takeover zones' marks and the scratch lines."),
+    f("hurdle-marks", ["--ky-ath-y", "--ky-ath-b", "--ky-ath-g"], "The marks of the hurdles on the track."),
+    f("steeplechase-hurdles", "--ky-ath-k", "The steeplechase's hurdles."),
+    f("water-jump", ["--ky-water", LINE, "--ky-ath-k"], "The water jump: its pit, its border and its hurdle."),
+    f("high-jump", ["--ky-mat", LINE, "--ky-ath-k"], "The high jump: the mat, the crossbar and the lines."),
+    f("pole-vault", ["--ky-mat", "--ky-pad", LINE], "The pole vault: the mats, the boxes and the runways."),
+    f("long-jump", ["--ky-sand", LINE], "The long jump's pits, boards and runways."),
+    f("triple-jump", ["--ky-sand", LINE], "The triple jump's pits, boards and runways."),
+    f("shot-put", ["--ky-concrete", LINE], "The shot put's circles, stop boards and sectors."),
+    f("discus-throw", ["--ky-concrete", LINE], "The discus throw's circle and sector."),
+    f("hammer-throw", ["--ky-concrete", LINE], "The hammer throw's circle and sector."),
+    f("javelin-throw", LINE, "The javelin's runway, arc and sector."),
+    f("cage", "--ky-ath-k", "The discus and hammer cage."),
+    f("banking", "--ky-ath-k", "The shade of the covered track's banked bends."),
+];
+const SKATING = [
+    f("apron", "--ky-apron", "The ground round the rink."),
+    f("ice", "--ky-surface", "The ice."),
+    f("infield", "--ky-surface-alt", "The floor or the ice inside the track."),
+    f("warm-up", "--ky-surface-alt", "The warm-up lane of the long track."),
+    f("padding", "--ky-boards", "The padding round the track."),
+    f("boards", "--ky-boards", "The boards of a figure skating rink."),
+    f("lane-lines", "--ky-blue", "The lines that demarcate the lanes of the long track."),
+    f("track-line", ["--ky-blue", "--ky-ink"], "The line of the short track and the line between its blocks."),
+    f("blocks", "--ky-ink", "The blocks of a curve."),
+    f("cones", "--ky-red", "The cones at the entrance of a curve."),
+    f("finish-line", "--ky-red", "The finishing line."),
+    f("finish-marks", "--ky-blue", "The lines 1 m apart in the last 5 m before the finishing line."),
+    f("start-lines", "--ky-red", "The starting lines of the races marked."),
+    f("pre-start-lines", "--ky-blue", "The pre-start line 2 m before each starting line."),
+    f("start-positions", "--ky-ink", "The starting positions of the short track's 500 m and 1000 m."),
+    f("coaches-area", "--ky-red", "The coaches' area on the crossing straight."),
+    f("judges", "--ky-ink", "The judges' seats at the rinkboard."),
+    f("referee", "--ky-ink", "The referee's seat."),
+    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."),
@@ -107,6 +222,63 @@ const CURLING = [
     f("hog-lines", "--ky-hog", "The hog lines."),
     f("hacks", "--ky-hack", "The hacks."),
 ];
+const ROPES = ["--ky-pg", "--ky-pb", "--ky-py"];
+const SWIMMING = [
+    f("apron", "--ky-apron", "The deck round the pool."),
+    f("gutter", "--ky-boards", "The gutter and the coping round the water."),
+    f("water", "--ky-surface", "The water."),
+    f("lane-lines", LINE, "The lane markings on the floor with their cross lines, the cross lines at 15 m, the marks on the deck and the target lines."),
+    f("touch-pads", "--ky-pd", "The touch panels on the end walls."),
+    f("starting-blocks", "--ky-pk", "The starting blocks."),
+    f("lane-ropes", ROPES, "The lane ropes' green, blue and yellow floats; the red floats near the walls are `rope-red` and the distinct marks `rope-white`."),
+    f("rope-green", "--ky-pg", "The green ropes of the outside lanes."),
+    f("rope-blue", "--ky-pb", "The blue ropes."),
+    f("rope-yellow", "--ky-py", "The yellow ropes of the middle lanes."),
+    f("rope-red", "--ky-pr", "The red floats within 5 m of each wall."),
+    f("rope-white", "--ky-pw", "The floats of a distinct colour at 15 m and 25 m."),
+    f("backstroke-flags", ["--ky-fa"], "The backstroke flags' rope 5 m from each wall."),
+    f("false-start-rope", "--ky-pf", "The false start rope 15 m from the starting end."),
+    f("pace-bars", "--ky-pe", "The outline of the split pace bars."),
+];
+const WATER_POLO = [
+    f("apron", "--ky-apron", "The deck round the pool."),
+    f("gutter", "--ky-boards", "The gutter round the water."),
+    f("water", "--ky-surface", "The water."),
+    f("goal-lines", "--ky-pw", "The two goal lines."),
+    f("half-distance-line", "--ky-pw", "The half distance line."),
+    f("two-metre-lines", "--ky-pr", "The 2 m lines."),
+    f("five-metre-marks", "--ky-pr", "The 5 m marks, where a penalty throw is taken from."),
+    f("six-metre-lines", "--ky-py", "The 6 m lines."),
+    f("goal-area-lines", "--ky-pr", "The lines 2 m long from the goal posts that make the goal areas."),
+    f("re-entry-areas", "--ky-pr", "The excluded players' re-entry areas."),
+    f("referee-platforms", ["--ky-pr", "--ky-py", "--ky-pg"], "The referees' platforms along both sides, coloured as the ropes are."),
+    f("lane-ropes", ROPES, "The ropes along the sides: their green floats, their yellow floats; the red ones are `rope-red`, the white ones `rope-white`."),
+    f("rope-green", "--ky-pg", "The green floats from 6 m to the half distance line."),
+    f("rope-yellow", "--ky-py", "The yellow floats from 2 to 6 m."),
+    f("rope-red", "--ky-pr", "The red floats from the goal line to 2 m and the 5 m mark."),
+    f("rope-white", "--ky-pw", "The white floats at the goal lines and the half distance line."),
+    f("goals", "--ky-pw", "The goals: the crossbar and the net."),
+    f("goal-posts", "--ky-pw", "The goal posts."),
+    f("official-table", "--ky-pk", "The official table."),
+    f("substitution-areas", ["--ky-left", "--ky-right"], "The areas for flying substitutions, in each team's colour."),
+];
+const DIVING = [
+    f("apron", "--ky-apron", "The deck round the well."),
+    f("gutter", "--ky-boards", "The gutter round the well."),
+    f("water", "--ky-surface", "The water."),
+    f("lane-lines", LINE, "The three lines across the well."),
+    f("stands", "--ky-boards", "The stands the boards are fixed to."),
+    f("platforms", "--ky-pc", "The platforms."),
+    f("springboards", "--ky-pbd", "The springboards."),
+];
+const ARTISTIC_SWIMMING = [
+    f("apron", "--ky-apron", "The deck round the pool."),
+    f("gutter", "--ky-boards", "The gutter round the water."),
+    f("water", "--ky-surface", "The water."),
+    f("floor-lines", LINE, "The lines on the floor along the pool."),
+    f("judges-platform", "--ky-pk", "The judges' platform."),
+    f("starting-platform", "--ky-pk", "The starting platform."),
+];
 const NET = [
     f("apron", "--ky-apron", "The ground round the court."),
     f("free-zone", "--ky-free", "The free zone round the court, where the rules give one."),
@@ -117,6 +289,19 @@ const NET = [
     f("posts", "--ky-net", "The posts and the singles sticks."),
     f("antennae", "--ky-red", "The antennae of a volleyball net."),
 ];
+const APRON_COURT = [f("apron", "--ky-apron", "The ground round the court."), f("court", "--ky-surface", "The court."), f("lines", LINE, "The painted lines.")];
+/** A padel court: the net's features, and the walls and the metal fence of its enclosure. */
+const PADEL = [...NET, f("walls", "--ky-wall", "The walls of the enclosure."), f("fence", "--ky-mesh", "The metal fence between the walls.")];
+/** A squash court: no net, walls round it, and its front wall laid flat beside it, with its tin. */
+const SQUASH = [...APRON_COURT, f("walls", "--ky-wall", "The walls round the court."), f("wall-face", "--ky-face", "The front wall, laid flat beside the court."), f("tin", "--ky-tin", "The tin, on the front wall."), f("wall-lines", "--ky-wall-line", "The lines on the front wall.")];
+/** A racquetball court: no net, and walls round it. */
+const RACQUETBALL = [...APRON_COURT, f("walls", "--ky-wall", "The walls round the court.")];
+/** A teqball court: the net, the table, and the court surrounds. */
+const TEQBALL = [...APRON_COURT, f("net", "--ky-net", "The net."), f("table", "--ky-table", "The teqball table."), f("walls", "--ky-wall", "The court surrounds.")];
+/** A roundnet court: the ground, the lines (the circles and the service marks), and the set. */
+const ROUNDNET = [...APRON_COURT, f("net", "--ky-net", "The set: its rim.")];
+/** A netball court: the ground and free zone, the lines and circles, and the goalposts. */
+const NETBALL = [f("apron", "--ky-apron", "The ground round the court."), f("free-zone", "--ky-free", "The court surround."), f("court", "--ky-surface", "The court."), f("lines", LINE, "The painted lines and circles."), f("posts", "--ky-net", "The goalposts.")];
 const TURF = [f("apron", "--ky-apron", "The ground round the surface."), f("turf", "--ky-surface", "The grass."), f("mowing", "--ky-surface-alt", "The lighter tone of the mown pattern.")];
 const POST = "--ky-post";
 const RUGBY = [
@@ -217,11 +402,22 @@ export const FEATURE_INFO = Object.freeze({
     mlb: BASEBALL,
     soccer: SOCCER,
     curling: CURLING,
+    swimming: SWIMMING,
+    waterpolo: WATER_POLO,
+    diving: DIVING,
+    artisticswimming: ARTISTIC_SWIMMING,
     tennis: NET,
     volleyball: NET,
     badminton: NET,
     pickleball: NET,
     tabletennis: NET,
+    padel: PADEL,
+    squash: SQUASH,
+    racquetball: RACQUETBALL,
+    sepaktakraw: NET,
+    teqball: TEQBALL,
+    roundnet: ROUNDNET,
+    netball: NETBALL,
     lacrosse: LACROSSE,
     rugby: RUGBY,
     afl: AFL,
@@ -229,6 +425,14 @@ export const FEATURE_INFO = Object.freeze({
     cricket: CRICKET,
     fieldhockey: FIELD_HOCKEY,
     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 { 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";
+    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

@@ -13,9 +13,19 @@ interface Stroked extends Named {
     dash?: Dash;
     /** 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`). */
-    cls?: "ky-line" | "ky-red";
+    /** 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 | 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). */
+export type AthleticsFill = "ky-ath-y-fill" | "ky-ath-b-fill" | "ky-ath-g-fill" | "ky-ath-k-fill" | "ky-ath-r-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";
@@ -62,11 +72,13 @@ export interface DotShape extends Named {
     cy: number;
     r: number;
     /** The paint: the line's (`line`, the default), or the post's. */
-    paint?: "line" | "post";
+    paint?: "line" | "post" | "block" | "cone";
 }
 /** A rectangle filled in the line's colour: a short thick mark. */
 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 | BudoFill;
     x0: number;
     y0: number;
     x1: number;
@@ -79,9 +91,17 @@ export interface PathShape extends Stroked {
 }
 /** Every shape that is a marking. */
 export type Shape = LineShape | ArcShape | RingShape | BoxShape | PolyShape | DotShape | BarShape | PathShape;
+/** 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";
+    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). */
     rect?: readonly [x0: number, y0: number, x1: number, y1: number];
     ellipse?: readonly [cx: number, cy: number, rx: number, ry: number];

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[];