@johnmorrisdotca/kyogijo-stadiums 0.5.0 → 0.6.0

package/dist/draw.js

@@ -1,10 +1,14 @@
 import { ballparkDrawn, ballparkFor, ballparkSentences } from "./ballpark.js";
-import { inkOn, safeColour, safeLogo } from "./colour.js";
+import { inkOn, safeColour } from "./colour.js";
+import { withEmblems } from "./emblems-source.js";
+import { safeLogo } from "./logo.js";
 import { drawingId, feetFence, isPortrait, lengthUnit, safeClass } from "./common.js";
 import { el, esc, num } from "./format.js";
+import { fieldAttributes } from "./field.data.js";
 import { ERA_SPORTS, footballIn, rulesFor, seasonLabel } from "./eras.js";
 import { FOOTBALL } from "./geometry.js";
 import { renderLayers } from "./layers.js";
+import { arenaById, arenaCourtIn, arenaNameIn, arenaOfficialName, arenaRinkIn } from "./arenas.js";
 import { groundById, groundNameIn, groundOfficialName } from "./grounds.js";
 import { BOARD, courtFor, hasSetsBoard, isNetLeague, isNetSport } from "./court.js";
 import { cricketBoardMarkup } from "./cricket.board.js";
@@ -12,6 +16,16 @@ import { athleticsPlan } from "./athletics/plan.js";
 import { skatingPlan } from "./skating/plan.js";
 import { skatingAbout, skatingSentences } from "./skating/describe.js";
 import { skatingStyle } from "./skating.style.js";
+import { budoPlan, isBudoSport } from "./budo/plan.js";
+import { dojoSpecOf } from "./budo/dojo.js";
+import { dojoGallery } from "./budo/room.js";
+import { budoAbout, budoScoreSentences, budoSentences } from "./budo/describe.js";
+import { lookOf as budoLookOf } from "./budo/looks.js";
+import { kimariteName } from "./budo/kimarite.js";
+import { budoScoreText, budoView } from "./budo.score.js";
+import { KYOGIJO_BUDO_GALLERY_STYLE, budoStyle } from "./budo.style.js";
+import { budoBoardMarkup } from "./budo.board.js";
+import { budoSurface } from "./surfaces/budo.js";
 import { skatingSurface } from "./surfaces/skating.js";
 import { athleticsAbout, athleticsSentences } from "./athletics/describe.js";
 import { athleticsStyle, athleticsTrackRules } from "./athletics.style.js";
@@ -48,6 +62,9 @@ import { featureColours, featureStyle } from "./features.js";
 import { isLook, lookStyle } from "./look.js";
 import { lineLook, restyleLines } from "./restyle.js";
 import { KYOGIJO_MARK_STYLE } from "./mark.js";
+import { readSituation, situationSentences } from "./situation.js";
+import { badgeSituation, drawSituation } from "./situation.draw.js";
+import { KYOGIJO_SITUATION_STYLE } from "./situation.style.js";
 import { outlineOf } from "./outline.js";
 import { autoScore, pageantLayout, pageantOf, ratioOf } from "./pageant.js";
 import { emblemMarkup, picturesMarkup } from "./pageant.draw.js";
@@ -61,6 +78,8 @@ import { fieldSurface } from "./surfaces/field.js";
 import { basketball } from "./surfaces/basketball.js";
 import { football } from "./surfaces/football.js";
 import { hockey } from "./surfaces/hockey.js";
+import { NHL_RINK } from "./leagues/hockey.js";
+import { NBA_COURT } from "./leagues/basketball.js";
 import { soccer } from "./surfaces/soccer.js";
 import { frameMatrix, layoutFromFrame, resolveFrame } from "./surfaces/soccer-providers.js";
 import { composeSpecial, hostSport } from "./special.js";
@@ -71,7 +90,7 @@ import { abbreviate, capitals } from "./text.js";
 import { VERSION } from "./version.js";
 export { isPortrait };
 /** The sports that can be drawn, in the order a menu lists them. */
-export const SPORTS = ["nfl", "cfl", "ifaf", "nhl", "nba", "mlb", "soccer", "curling", "tennis", "volleyball", "badminton", "pickleball", "tabletennis", "padel", "squash", "racquetball", "sepaktakraw", "teqball", "roundnet", "netball", "swimming", "waterpolo", "diving", "artisticswimming", "athletics", "skating", "lacrosse", "rugby", "afl", "gaelic", "cricket", "fieldhockey", "handball"];
+export const SPORTS = ["nfl", "cfl", "ifaf", "nhl", "nba", "mlb", "soccer", "curling", "tennis", "volleyball", "badminton", "pickleball", "tabletennis", "padel", "squash", "racquetball", "sepaktakraw", "teqball", "roundnet", "netball", "swimming", "waterpolo", "diving", "artisticswimming", "athletics", "skating", "judo", "karate", "kendo", "sumo", "kyudo", "dojo", "lacrosse", "rugby", "afl", "gaelic", "cricket", "fieldhockey", "handball"];
 /** The CSS custom property each colour of `Colors` sets. */
 export const COLOR_PROPERTIES = {
     apron: "--ky-apron",
@@ -164,8 +183,8 @@ export function winnerOf(o) {
     const mode = o.winner ?? "auto";
     if (mode === "home" || mode === "away" || mode === "none")
         return mode;
-    const h = fieldTotal(o.sport, o.home) ?? numeric(o.home.score);
-    const a = fieldTotal(o.sport, o.away) ?? numeric(o.away.score);
+    const h = fieldTotal(o.sport, o.home) ?? numeric(o.home.score) ?? (o.sport === undefined ? undefined : numeric(budoScoreText(o.sport, o.home)));
+    const a = fieldTotal(o.sport, o.away) ?? numeric(o.away.score) ?? (o.sport === undefined ? undefined : numeric(budoScoreText(o.sport, o.away)));
     if (h === undefined || a === undefined)
         return "none";
     if (mode === "auto" && !(o.status !== undefined && FINAL.test(o.status.trim())))
@@ -242,6 +261,11 @@ function buildSkating(o, common) {
     const plan = skatingPlan({ ...o, detail: common.detail });
     return skatingSurface(common, plan, common.margin ?? (o.range === undefined ? 20 : 5));
 }
+/** The budō surface: its plan, drawn as it lies. A hall, a kyūdōjō and a range of mats have little ground round them. */
+function buildBudo(o, common) {
+    const plan = budoPlan({ ...o, detail: common.detail });
+    return budoSurface(common, plan, common.margin ?? (o.range === undefined ? 12 : 4));
+}
 /** One text for both ends or sides, or a pair of them. */
 const pair = (text) => (text === undefined ? undefined : typeof text === "string" ? [text, text] : text);
 /** The surface the options ask for, whole: before it is cropped to a `range`. */
@@ -278,10 +302,19 @@ function buildWhole(o, portrait, id, score, scored, extra) {
             const season = rulesFor(sport, o.year).rules;
             return football(footballIn(sport, o.year), common, { hashMarks: season.hash !== null, postShape: season.postShape });
         }
-        case "nhl":
+        case "nhl": {
+            // An arena's rink is the size its sources publish, with the markings of the season asked for; an arena with none published has the NHL's.
+            const sized = league === undefined ? arenaRinkIn(arenaById(o.arena), o.year) : undefined;
+            if (sized !== undefined)
+                return hockey(common, rulesFor("nhl", o.year).rules, { ...NHL_RINK, length: sized.length, width: sized.width });
             return league?.family === "hockey" ? hockey(common, undefined, rinkOf(league, o.year)) : hockey(common, rulesFor("nhl", o.year).rules);
-        case "nba":
+        }
+        case "nba": {
+            const sized = league === undefined ? arenaCourtIn(arenaById(o.arena), o.year) : undefined;
+            if (sized !== undefined)
+                return basketball(common, rulesFor("nba", o.year).rules, { ...NBA_COURT, length: sized.length, width: sized.width });
             return league?.family === "basketball" ? basketball(common, undefined, courtOf(league, o.year)) : basketball(common, rulesFor("nba", o.year).rules);
+        }
         case "mlb": {
             if (league?.family === "baseball") {
                 const diamond = diamondOf(league, o.year);
@@ -333,6 +366,13 @@ function buildWhole(o, portrait, id, score, scored, extra) {
             return buildAthletics({ ...o, sport }, common);
         case "skating":
             return buildSkating({ ...o, sport }, common);
+        case "judo":
+        case "karate":
+        case "kendo":
+        case "sumo":
+        case "kyudo":
+        case "dojo":
+            return buildBudo({ ...o, sport }, common);
         default:
             throw new Error(`Unknown sport "${String(o.sport)}": use one of ${SPORTS.join(", ")}`);
     }
@@ -382,7 +422,10 @@ function standsFor(o, surface, crowd) {
         const walls = park === undefined || crowd.wallSeats === false ? [] : parkWallsIn(park, o.year).filter((w) => (crowd.wallSeats === true ? w.height_ft >= 25 : w.label !== undefined && WALL_SEATS[park.id] === w.label));
         return parkLayout({ fence: fenceOutline(points), backstop, crowd, seatsOnWalls: walls.map((w) => ({ from: w.from, to: w.to, height: w.height_ft })) });
     }
-    return crowdLayout({ sport, box: surface.whole ?? surface.box ?? { x: 0, y: 0, w: 100, h: 100 }, crowd, awaySide, ground: o.ground });
+    // A dojo's crowd sits in its gallery, from the room's balcony data (in feet here); the arenas (the Budokan, the Kokugikan) keep their bowls.
+    const hall = sport === "dojo" ? dojoGallery(o) : undefined;
+    const gallery = hall === undefined ? undefined : { offset: hall.offset / 0.3048, depth: hall.depth / 0.3048, height: [hall.height[0] / 0.3048, hall.height[1] / 0.3048] };
+    return crowdLayout({ sport, box: surface.whole ?? surface.box ?? { x: 0, y: 0, w: 100, h: 100 }, crowd, awaySide, ground: o.ground, arena: o.budo?.hall === "budokan", ...(gallery === undefined ? {} : { gallery }) });
 }
 /** True when the drawing is asked to be small: `detail: "simple"` or a `width` under 480 pixels. */
 const smallDrawing = (o) => {
@@ -408,7 +451,9 @@ function buildCrowded(o, portrait, id, score, scored, extra, crowd) {
     const fine = crowd.detail === "fine" || (crowd.detail === "auto" && !smallDrawing(o));
     const first = /^<[^>]*\/>/.exec(surface.base)?.[0] ?? "";
     const bg = /class="([^"]*)"/.exec(first)?.[1] ?? "ky-apron";
-    const drawn = drawCrowd(stands, { id, crowd, density: densityOf(crowd, seats, ground), fine, ground: bg });
+    // A gallery is sparsely taken unless the options say how full.
+    const taken = stands.gallery === true && crowd.density === undefined && crowd.attendance === undefined ? 0.4 : densityOf(crowd, seats, ground);
+    const drawn = drawCrowd(stands, { id, crowd, density: taken, fine, ground: bg });
     surface.base = first + drawn.markup + surface.base.slice(first.length);
     surface.defs += drawn.defs;
     surface.lines += drawn.over;
@@ -425,6 +470,13 @@ function colourStyle(o, teams, features) {
     };
     for (const [key, property] of Object.entries(COLOR_PROPERTIES))
         set(property, o.colors?.[key]);
+    // A dojo's own colours (and its era's): the mats, the second tone, the border, the heri, the wood and the walls.
+    if (o.sport === "dojo" && o.dojo !== undefined) {
+        const c = dojoSpecOf(o.dojo).colours;
+        if (c !== undefined)
+            for (const [key, property] of [["mat", "--ky-surface"], ["alt", "--ky-surface-alt"], ["border", "--ky-red"], ["heri", "--ky-bud-heri"], ["floor", "--ky-bud-floor"], ["wall", "--ky-boards"]])
+                set(property, c[key]);
+    }
     if (o.court !== undefined)
         for (const [key, property] of Object.entries(COURT_PROPERTIES))
             set(property, o.court[key]);
@@ -479,17 +531,18 @@ function roundOf(team, markShape) {
         return undefined;
     return { round: true, fit: team.markFit === "contain" ? "contain" : undefined, color: safeColour(team.color), ink: safeColour(team.textColor) };
 }
-function teamView(team, side, role, winner, uppercase, sport, markShape) {
+function teamView(team, side, role, winner, uppercase, sport, markShape, theme) {
     const name = String(team.name ?? "");
-    const written = fieldScoreText(sport, team);
+    const abbr = (team.abbr !== undefined && team.abbr.trim() !== "" ? team.abbr.trim() : abbreviate(name)).slice(0, 5);
+    const written = fieldScoreText(sport, team) ?? budoScoreText(sport, team);
     const score = written ?? (team.score === undefined || team.score === null || String(team.score).trim() === "" ? "–" : String(team.score));
     return {
         side,
         role,
         name: uppercase ? capitals(name) : name,
-        abbr: (team.abbr !== undefined && team.abbr.trim() !== "" ? team.abbr.trim() : abbreviate(name)).slice(0, 5),
+        abbr,
         score,
-        logo: safeLogo(team.logo),
+        logo: safeLogo(team.logo, { color: team.color, accent: team.textColor, initials: abbr.slice(0, 3), theme }),
         ...roundOf(team, markShape),
         state: stateOf(winner, role),
         ends: Array.isArray(team.ends) ? team.ends.map(endText) : undefined,
@@ -500,6 +553,7 @@ function teamView(team, side, role, winner, uppercase, sport, markShape) {
         serving: team.serving === true ? true : undefined,
         wickets: sport === "cricket" && team.wickets !== undefined && team.wickets !== null && String(team.wickets).trim() !== "" ? String(team.wickets).trim().slice(0, 2) : undefined,
         overs: sport === "cricket" && team.overs !== undefined && team.overs !== null && String(team.overs).trim() !== "" ? String(team.overs).trim().slice(0, 6) : undefined,
+        budo: isBudoSport(sport) ? budoView(team.budo) : undefined,
         innings: sport === "cricket" && Array.isArray(team.innings) ? team.innings.map((value) => (typeof value === "number" ? (Number.isFinite(value) ? String(value) : "") : typeof value === "string" ? value.trim().slice(0, 7) : "")) : undefined,
     };
 }
@@ -541,6 +595,8 @@ function leagueAbout(league, year, language, sheet) {
     const words = KYOGIJO_STRINGS[language].league;
     if (league.family === "skating")
         return skatingAbout({ sport: "skating", league: league.id }, language);
+    if (league.family === "judo" || league.family === "karate" || league.family === "kendo" || league.family === "sumo" || league.family === "kyudo" || league.family === "dojo")
+        return budoAbout({ sport: league.family, league: league.id }, language);
     if (league.family === "athletics")
         return athleticsAbout({ sport: "athletics", league: league.id, athletics: sheet === undefined ? undefined : undefined }, language);
     // The field sports: their size is the surface drawn (the one the options ask for), in the unit their rulebook prints first.
@@ -574,6 +630,28 @@ function leagueAbout(league, year, language, sheet) {
     const text = fill(words.size, { length: trimmed(convertLength(size.length, "ft", to)), width: trimmed(convertLength(size.width, "ft", to)), unit: words.units[to === "m" || to === "yd" ? to : "ft"] });
     return fill(league.family === "volleyball" && league.id === "fivb-beach" ? words.beachVolleyball : league.family === "volleyball" && league.id === "wpv-sitting" ? words.sittingVolleyball : words[league.family], { size: text });
 }
+/** The football field a drawing is on, for a situation to know the yards between the goal lines and the downs a team has (the CFL's three). */
+function footballFieldOf(o, sport, league) {
+    if (sport !== "nfl" && sport !== "cfl" && sport !== "ifaf")
+        return undefined;
+    const spec = league?.family === "football" ? fieldOf(league, o.year) : sport === "ifaf" ? FOOTBALL.ifaf : footballIn(sport, o.year);
+    return { yards: spec.length / 3, downs: spec.id === "cfl" ? 3 : 4 };
+}
+/** The situation the options ask for, read: which team attacks, which end, what is lit. `undefined` for none, for a sport that has no situation and for a special game. */
+function situationOf(o) {
+    if (o.situation === undefined || o.host !== undefined)
+        return undefined;
+    const { sport, league } = chooseLeague(o);
+    const ctx = {
+        sport,
+        homeSide: resolveHomeSide({ ...o, sport }),
+        direction: o.direction,
+        football: footballFieldOf(o, sport, league),
+        names: isScore(o) ? { home: String(o.home.name ?? ""), away: String(o.away.name ?? "") } : undefined,
+        league: league?.id,
+    };
+    return readSituation(o.situation, ctx);
+}
 /** A drawing's title and description, in a language. */
 export function describe(o) {
     // A special game is drawn whole: a `range` is for a surface of its own.
@@ -591,7 +669,11 @@ export function describe(o) {
     // A league other than the sport's own is named by its rulebook's, and its description is made from its figures.
     const trackGround = sport === "athletics" ? groundById(o.ground) : undefined;
     const trackGroundName = trackGround === undefined ? undefined : groundNameIn(trackGround, o.year, language);
-    const surfaceName = trackGroundName !== undefined ? fill(words.athletics.ground, { ground: trackGroundName }) : groundName !== undefined ? (language === "ja" ? `${groundName}のピッチ` : `${groundName}, soccer pitch`) : league !== undefined && parkName === undefined ? league.name[language] : parkName === undefined ? (pitch?.format === "futsal" ? words.soccer.futsal : words.surface[sport]) : language === "ja" ? `${parkName}のグラウンド` : `${parkName}, baseball field`;
+    // An arena names its rink or its court.
+    const arena = (sport === "nhl" || sport === "nba") && league === undefined ? arenaById(o.arena) : undefined;
+    const arenaName = arena === undefined ? undefined : arenaNameIn(arena, o.year, language);
+    const arenaSize = arena === undefined || arenaName === undefined ? undefined : sport === "nhl" ? arenaRinkIn(arena, o.year) : arenaCourtIn(arena, o.year);
+    const surfaceName = arenaName !== undefined ? fill(sport === "nhl" ? words.said.arenaRink : words.said.arenaCourt, { arena: arenaName }) : trackGroundName !== undefined ? fill(words.athletics.ground, { ground: trackGroundName }) : groundName !== undefined ? (language === "ja" ? `${groundName}のピッチ` : `${groundName}, soccer pitch`) : league !== undefined && parkName === undefined ? league.name[language] : parkName === undefined ? (pitch?.format === "futsal" ? words.soccer.futsal : words.surface[sport]) : language === "ja" ? `${parkName}のグラウンド` : `${parkName}, baseball field`;
     const { stop, colon, gap } = words.said;
     const sentence = (text) => (/[.。]$/.test(text) ? text : `${text}${stop}`);
     const metres = (value) => String(Math.round(value * 10) / 10);
@@ -600,8 +682,10 @@ export function describe(o) {
     const field = isFieldSport(sport) ? fieldPlan({ ...o, sport }) : undefined;
     const pools = isPoolSport(sport) ? poolDescription({ sport, pool: o.pool }, language) : undefined;
     const poolLine = pools === undefined ? "" : pools.after.map((line) => `${gap}${line}`).join("");
-    const aboutText = pools !== undefined ? pools.about : sport === "skating" ? skatingAbout(o, language) : sport === "athletics" ? athleticsAbout(o, language) : field !== undefined ? leagueAbout(league ?? LEAGUES[sport][0], o.year, language, { length: field.length, width: field.width }) : plan !== undefined ? leagueAbout(plan.league, o.year, language, plan.spec) : league !== undefined ? leagueAbout(league, o.year, language) : pitch === undefined ? words.about[sport] : fill(pitch.format === "futsal" ? words.soccer.aboutFutsal : words.about.soccer, { length: metres(pitch.length), width: metres(pitch.width) });
-    const about = `${words.said.on}${colon}${aboutText}${stop}${sport === "athletics" ? athleticsSentences(o, language) : sport === "skating" ? skatingSentences(o, language) : ""}`;
+    // An arena of a size of its own says what it is at that size.
+    const arenaAbout = arenaSize === undefined ? undefined : fill(sport === "nhl" ? words.said.arenaRinkAbout : words.said.arenaCourtAbout, { length: metres(arenaSize.length), width: metres(arenaSize.width), lengthM: metres(arenaSize.length * 0.3048), widthM: metres(arenaSize.width * 0.3048) });
+    const aboutText = arenaAbout !== undefined ? arenaAbout : pools !== undefined ? pools.about : isBudoSport(sport) ? budoAbout(o, language) : sport === "skating" ? skatingAbout(o, language) : sport === "athletics" ? athleticsAbout(o, language) : field !== undefined ? leagueAbout(league ?? LEAGUES[sport][0], o.year, language, { length: field.length, width: field.width }) : plan !== undefined ? leagueAbout(plan.league, o.year, language, plan.spec) : league !== undefined ? leagueAbout(league, o.year, language) : pitch === undefined ? words.about[sport] : fill(pitch.format === "futsal" ? words.soccer.aboutFutsal : words.about.soccer, { length: metres(pitch.length), width: metres(pitch.width) });
+    const about = `${words.said.on}${colon}${aboutText}${stop}${sport === "athletics" ? athleticsSentences(o, language) : sport === "skating" ? skatingSentences(o, language) : isBudoSport(sport) ? budoSentences(o, language) : ""}`;
     const halfLine = pitch !== undefined && !isScore(o) && (o.half === "left" || o.half === "right") ? `${gap}${words.soccer.half}` : "";
     // What the ground says about the size: that it is the published one, or that the ground has none and the international pitch is drawn.
     const year = typeof o.year === "number" && Number.isFinite(o.year) ? o.year : undefined;
@@ -612,7 +696,9 @@ export function describe(o) {
     // A park's walls and quirks that are drawn are said too.
     const ballpark = park === undefined ? undefined : ballparkFor(o);
     const special = specialText(o, language, surfaceName);
-    const parkLine = (parkName === undefined ? `${groundLine}${halfLine}` : `${gap}${fill(words.said.park, { park: parkName })}${officially(parkOfficial)}${ballpark === undefined ? "" : ballparkSentences(ballpark).map((line) => `${gap}${line}`).join("")}`) + (special === undefined ? "" : `${gap}${special.text}`);
+    // What the arena says about the size: that it is the one its sources publish, or that its rink is said to have been shorter and no size is given.
+    const arenaLine = arenaName === undefined ? "" : `${arenaSize !== undefined ? `${gap}${fill(words.said.arenaSize, { arena: arenaName })}` : sport === "nhl" && arena?.rinkUnknown === true ? `${gap}${fill(words.said.arenaUnknown, { arena: arenaName })}` : ""}${officially(arena === undefined ? undefined : arenaOfficialName(arena, language, year))}`;
+    const parkLine = (parkName === undefined ? `${groundLine}${halfLine}${arenaLine}` : `${gap}${fill(words.said.park, { park: parkName })}${officially(parkOfficial)}${ballpark === undefined ? "" : ballparkSentences(ballpark).map((line) => `${gap}${line}`).join("")}`) + (special === undefined ? "" : `${gap}${special.text}`);
     // A drawing of a past season says which: the markings are those of that season.
     const dated = typeof o.year === "number" && Number.isFinite(o.year);
     const eraLine = dated && league !== undefined
@@ -631,14 +717,17 @@ export function describe(o) {
         : plan?.show === "folded"
             ? `${gap}${[foldedWords[isPortrait(o) ? "tall" : "wide"], foldedWords[plan.panels], hasData ? foldedWords.data : ""].filter((part) => part !== "").join(gap)}`
             : describeRange(o, language, hasData);
+    // A situation says what the pill, the lit bases or the line of scrimmage show.
+    const read = situationOf(o);
+    const situationLine = read === undefined ? "" : situationSentences(read, language, isScore(o) ? { home: o.home.name, away: o.away.name } : undefined).map((line) => `${gap}${line}`).join("");
     if (!isScore(o))
-        return { title: o.title ?? special?.title ?? surfaceName, description: o.description ?? `${about}${parkLine}${eraLine}${rangeLine}${poolLine}` };
+        return { title: o.title ?? special?.title ?? surfaceName, description: o.description ?? `${about}${parkLine}${eraLine}${rangeLine}${situationLine}${poolLine}` };
     const winner = winnerOf({ ...o, sport });
     // A pageant says what lies on each half, and the emblem in the middle.
     const pageant = pageantOf(o);
     const pg = KYOGIJO_STRINGS[language].pageant;
     const pageantLine = pageant === undefined ? "" : `${gap}${pageant.style === "stage" ? pg.stage : pg.carpet}${pageant.emblem === undefined ? "" : `${gap}${pageant.emblem.name === undefined ? pg.emblem : fill(pg.emblemNamed, { name: pageant.emblem.name })}`}`;
-    const s = (t) => fieldScoreText(sport, t) ?? (t.score === undefined || String(t.score) === "" ? "–" : String(t.score));
+    const s = (t) => fieldScoreText(sport, t) ?? budoScoreText(sport, t) ?? (t.score === undefined || String(t.score) === "" ? "–" : String(t.score));
     // The sentence follows the drawing: the team on the left is first. The words' {away} and {home} are the first and the second team named.
     const order = resolveHomeSide({ ...o, sport }) === "left" ? [o.home, o.away] : [o.away, o.home];
     const line = fill(words.scoreTitle, { away: order[0].name, awayScore: s(order[0]), home: order[1].name, homeScore: s(order[1]) });
@@ -699,7 +788,7 @@ export function describe(o) {
             : "";
     return {
         title: o.title ?? (status === undefined ? line : `${line}${words.said.sep}${status}`),
-        description: o.description ?? `${extra === "" ? "" : `${sentence(extra)}${gap}`}${sentence(line)}${result}${tied}${curlingLine}${netLine}${fieldLine}${gap}${about}${parkLine}${eraLine}${rangeLine}${pageantLine}${poolLine}`.trim(),
+        description: o.description ?? `${extra === "" ? "" : `${sentence(extra)}${gap}`}${sentence(line)}${result}${tied}${curlingLine}${netLine}${fieldLine}${isBudoSport(sport) ? budoScoreSentences(sport, order, language) : ""}${gap}${about}${parkLine}${eraLine}${rangeLine}${situationLine}${pageantLine}${poolLine}`.trim(),
     };
 }
 /**
@@ -719,6 +808,9 @@ export function describe(o) {
  * ```
  */
 export function drawKyogijo(o) {
+    return withEmblems(o.emblems, () => drawnKyogijo(o));
+}
+function drawnKyogijo(o) {
     if (o.host !== undefined && o.range !== undefined)
         return drawKyogijo({ ...o, range: undefined });
     // A special game is a surface set inside another, drawn to scale with no stands.
@@ -743,7 +835,15 @@ export function drawKyogijo(o) {
         else if (sized === "full")
             sized = "compact";
     }
-    const id = drawingId(o);
+    // A lineup's players stand in the middle of the surface, where the score's panel would hide them: the score goes to the strip under the drawing, as a pageant's does, unless `score: "centre"` asks for it.
+    const lineupped = (o.layers ?? []).some((layer) => layer?.kind === "lineup");
+    const stripped = isScore(o) && lineupped && o.score !== "centre";
+    if (isScore(o) && pageant === undefined && sized === "full" && (o.score === "strip" || stripped) && !(sport === "curling" && portrait))
+        sized = "compact";
+    // The situation of the game (hockey's skaters, baseball's runners, football's down), decided once: the surface, the badge and the description draw from it.
+    const situation = situationOf(o);
+    // A situation that is not drawn (a sport that has none, nothing the sport can have in it) leaves the drawing, its ids included, as it was.
+    const id = drawingId(o.situation !== undefined && situation === undefined ? { ...o, situation: undefined } : o);
     const parts = o.parts === true;
     const homeSide = isScore(o) ? resolveHomeSide({ ...o, sport }) : "right";
     const awaySide = homeSide === "left" ? "right" : "left";
@@ -757,8 +857,8 @@ export function drawKyogijo(o) {
     if (isScore(o)) {
         winner = winnerOf({ ...o, sport });
         status = statusText({ ...o, sport }, language);
-        const home = teamView(o.home, homeSide, "home", winner, uppercase, sport, o.markShape);
-        const away = teamView(o.away, awaySide, "away", winner, uppercase, sport, o.markShape);
+        const home = teamView(o.home, homeSide, "home", winner, uppercase, sport, o.markShape, o.theme === "light" || o.theme === "dark" ? o.theme : undefined);
+        const away = teamView(o.away, awaySide, "away", winner, uppercase, sport, o.markShape, o.theme === "light" || o.theme === "dark" ? o.theme : undefined);
         left = homeSide === "left" ? home : away;
         right = homeSide === "left" ? away : home;
         leftTeam = homeSide === "left" ? o.home : o.away;
@@ -776,6 +876,7 @@ export function drawKyogijo(o) {
     const crowded = crowdOf(o) !== undefined;
     const style = colourStyle(o, { left: leftTeam, right: rightTeam, home: isScore(o) ? o.home : undefined, away: isScore(o) ? o.away : undefined }, featured);
     const palette = isLook(o.look) ? o.look : undefined;
+    const budoLook = isBudoSport(sport) ? budoLookOf(sport, o.budo?.look ?? (sport === "dojo" ? dojoSpecOf(o.dojo).look : undefined)) : undefined;
     let notes;
     const theme = o.theme === "light" || o.theme === "dark" ? o.theme : undefined;
     let viewBox;
@@ -785,7 +886,7 @@ export function drawKyogijo(o) {
     let foldedSheet = false;
     let pg;
     if (isScore(o) && left !== undefined && right !== undefined && sized === "badge") {
-        const badge = badgeMarkup(left, right, { sport, status, parts, id });
+        const badge = badgeMarkup(left, right, { sport, status, parts, id, situation: situation === undefined ? undefined : badgeSituation(situation, language) });
         viewBox = `0 0 ${badge.w} ${badge.h}`;
         body = badge.markup;
     }
@@ -800,8 +901,8 @@ export function drawKyogijo(o) {
         let surface = make({ features, pageant: pageant !== undefined });
         // The score of a pageant with no emblem and no board: the plate stays in the middle if the pictures lose little to it, else it goes to the strip and the surface is built again.
         if (pageant !== undefined && pageant.score === "auto") {
-            let score = "centre";
-            if (isScore(o) && left !== undefined && right !== undefined && leftTeam !== undefined && rightTeam !== undefined && sized === "full") {
+            let score = stripped ? "strip" : "centre";
+            if (!stripped && isScore(o) && left !== undefined && right !== undefined && leftTeam !== undefined && rightTeam !== undefined && sized === "full") {
                 const [first, second] = pageantPair(surface, { left, right, leftTeam, rightTeam });
                 score = autoScore({ pageant, surface, outline: outlineOf(o), left: first, right: second, turned: surface.turned, sport, plate: true });
             }
@@ -838,7 +939,21 @@ export function drawKyogijo(o) {
         const ground = laidOn(surface.base, o.background, id);
         grounded = ground.base !== surface.base;
         defs = surface.defs + ground.defs;
-        let inner = ground.base;
+        // The situation: a tint under the lines, and the rest over them and the data (cut with the surface when it is cropped).
+        const sit = situation === undefined
+            ? undefined
+            : drawSituation(situation, surface, {
+                id,
+                language,
+                homeSide,
+                abbrs: left !== undefined && right !== undefined ? { [left.role]: left.abbr, [right.role]: right.abbr } : undefined,
+                plate: isScore(o) && sized === "full" && o.plate !== false,
+                strip: stripped && sized === "compact",
+            });
+        const cutSit = (markup) => (markup !== "" && surface.defs.includes(`id="${id}-rg"`) ? el("g", { "clip-path": `url(#${id}-rg)` }, markup) : markup);
+        let inner = ground.base + (sit === undefined ? "" : cutSit(sit.under));
+        if (sit !== undefined)
+            defs += sit.defs;
         let teams = "";
         // A pageant lays each team's picture over its half, in place of the names painted at the ends.
         if (pageant !== undefined && isScore(o) && left !== undefined && right !== undefined && leftTeam !== undefined && rightTeam !== undefined && (sized === "full" || sized === "compact")) {
@@ -852,7 +967,7 @@ export function drawKyogijo(o) {
         if (isScore(o) && left !== undefined && right !== undefined && sized === "full" && pg === undefined) {
             const onColour = surface.onColour ?? (sport === "nfl" || sport === "cfl" || sport === "ifaf" || sport === "soccer");
             // A curling sheet, the net sports' courts and a cricket ground have no place for the names: the board names the teams.
-            if (sport !== "curling" && !hasSetsBoard(sport) && sport !== "cricket") {
+            if (sport !== "curling" && !hasSetsBoard(sport) && sport !== "cricket" && sport !== "judo" && sport !== "karate" && sport !== "kendo" && sport !== "sumo") {
                 // Cropped to a range, a team's name is written only where its place is in what is shown.
                 if (shows(surface, surface.left))
                     teams += bannerMarkup(surface.left, left, { turned: surface.turned, onColour, parts, id });
@@ -869,6 +984,9 @@ export function drawKyogijo(o) {
         }
         else
             inner += surface.bannersOver === true ? surface.lines + teams : teams + surface.lines;
+        // A lineup's players stand over what the situation lights (a runner's base, a drive's arrows), so that none of them is hidden; any other data goes over it.
+        if (sit !== undefined && lineupped)
+            inner += cutSit(sit.over);
         // Data goes over the markings and under the score's panel.
         const layered = renderLayers(o, o.layers, surface.turned, surface.whole === undefined ? undefined : surface.box, surface.upright);
         inner += surface.frame === undefined || layered.svg === "" ? layered.svg : el("g", { transform: surface.frame }, layered.svg);
@@ -885,6 +1003,8 @@ export function drawKyogijo(o) {
             const { colon, gap } = KYOGIJO_STRINGS[language].said;
             description = `${said}${gap}${KYOGIJO_STRINGS[language].layers.data}${colon}${layered.summaries.join(gap)}`;
         }
+        if (sit !== undefined && !lineupped)
+            inner += cutSit(sit.over);
         if (surface.over !== undefined)
             inner += surface.over;
         if (notes !== undefined && notes.svg !== "") {
@@ -903,6 +1023,11 @@ export function drawKyogijo(o) {
                 const board = cricketBoardMarkup(surface.plate, left, right, { competition: o.competition, foot: foot === "" ? undefined : foot, innings: words.innings, total: words.total, overs: words.overs }, { parts });
                 inner += el("g", { transform: `translate(${num(surface.plate.cx)} ${num(surface.plate.cy)})${surface.turned ? " rotate(-90)" : ""}` }, board);
             }
+            else if (isBudoSport(sport) && sport !== "kyudo" && sport !== "dojo") {
+                const b = KYOGIJO_STRINGS[language].budo.board;
+                const board = budoBoardMarkup(sport, surface.plate, left, right, { competition: o.competition, foot: foot === "" ? undefined : foot, wazaari: b.wazaari, yuko: b.yuko, shido: b.shido, senshu: b.senshu, chui: b.chui, kimarite: b.kimarite, techniques: b.techniques, kimariteName: (key) => kimariteName(key, language) }, { parts });
+                inner += el("g", { transform: `translate(${num(surface.plate.cx)} ${num(surface.plate.cy)})${surface.turned ? " rotate(-90)" : ""}` }, board);
+            }
             else if (hasSetsBoard(sport)) {
                 const board = setsBoardMarkup(surface.plate, left, right, { competition: o.competition, foot: foot === "" ? undefined : foot, head: KYOGIJO_STRINGS[language].net[BOARD[sport] === "games" ? "games" : "sets"], points: KYOGIJO_STRINGS[language].net.points }, { parts, least: minSets(sport, chooseLeague(o).league?.id) });
                 inner += el("g", { transform: `translate(${num(surface.plate.cx)} ${num(surface.plate.cy)})${surface.turned ? " rotate(-90)" : ""}` }, board);
@@ -910,10 +1035,10 @@ export function drawKyogijo(o) {
             else
                 inner += plateMarkup(surface.plate, left, right, { competition: o.competition, foot: foot === "" ? undefined : foot }, { turned: surface.turned, parts, surfaceSport: sport });
         }
-        const group = el("g", { class: "ky-surface-group", transform: surface.turn, part: parts ? "surface" : undefined }, inner);
+        const group = el("g", { class: "ky-surface-group", transform: surface.turn, part: parts ? "surface" : undefined, ...(o.pointer === true ? fieldAttributes({ ...o, sport }) : {}) }, inner);
         const v = surface.view;
         if (isScore(o) && left !== undefined && right !== undefined && sized === "compact") {
-            const badge = badgeMarkup(left, right, { sport, status, parts, id });
+            const badge = badgeMarkup(left, right, { sport, status, parts, id, situation: situation === undefined ? undefined : badgeSituation(situation, language) });
             const scale = v.w / badge.w;
             const gap = badge.h * scale * 0.12;
             body = group + el("g", { class: "ky-strip", transform: `translate(${num(v.x)} ${num(v.y + v.h + gap)}) scale(${scale.toFixed(4)})` }, badge.markup);
@@ -934,7 +1059,7 @@ export function drawKyogijo(o) {
         "data-league": o.league === undefined || o.league === "" ? undefined : o.league,
         "data-range": isScore(o) && sport === "curling" ? undefined : rangeLabel(o),
         "data-event": o.host !== undefined && typeof o.event === "string" ? safeClass(o.event) : undefined,
-        "data-look": look,
+        "data-look": look ?? budoLook,
         "data-size": sized,
         "data-orientation": portrait ? "portrait" : "landscape",
         "data-theme": theme,
@@ -948,7 +1073,7 @@ export function drawKyogijo(o) {
         part: parts ? "svg" : undefined,
         style: style === "" ? undefined : style,
     }, `<title id="${titleId}">${esc(title)}</title><desc id="${descId}">${esc(description)}</desc>` +
-        (o.style === "none" ? "" : `<style>${KYOGIJO_BASE_STYLE}${left?.round === true || right?.round === true || (pg !== undefined && pageant?.style === "stage") || (pg !== undefined && pageant?.emblem?.shape !== "plain" && pageant?.emblem !== undefined) ? `\n${KYOGIJO_MARK_STYLE}` : ""}${pg === undefined ? "" : `\n${KYOGIJO_PAGEANT_STYLE}${pageant?.animate === undefined || pageant.animate === "none" ? "" : `\n${KYOGIJO_PAGEANT_MOTION}`}`}${sport === "curling" ? `\n${KYOGIJO_CURLING_STYLE}` : ""}${foldedSheet ? `\n${KYOGIJO_FOLD_STYLE}` : ""}${isPoolSport(sport) ? `\n${o.pool?.venue !== undefined ? KYOGIJO_POOL_STYLE : poolStyle({ sport, ...commonOf(o.pool ?? {}), race: o.pool?.race !== undefined, section: o.pool?.section !== undefined && o.pool.section !== false })}` : ""}${plan === undefined ? "" : `\n${courtStyle(plan.sport, plan.look)}`}${fieldsStyle(sport) === "" ? "" : `\n${fieldsStyle(sport)}`}${athleticsStyle(sport) === "" ? "" : `\n${athleticsStyle(sport)}`}${skatingStyle(sport) === "" ? "" : `\n${skatingStyle(sport)}`}${palette === undefined ? "" : `\n${lookStyle(palette)}`}${athleticsTrackRules(sport, o.athletics?.track) === "" ? "" : `\n${athleticsTrackRules(sport, o.athletics?.track)}`}${walled ? `\n${KYOGIJO_WALLS_STYLE}` : ""}${hardwood ? `\n${KYOGIJO_HARDWOOD_STYLE}` : ""}${features === undefined ? "" : `\n${featureStyle(sport, features)}`}${notes === undefined || notes.svg === "" ? "" : `\n${KYOGIJO_NOTE_STYLE}`}${grounded ? `\n${KYOGIJO_BACKGROUND_STYLE}` : ""}${crowded ? `\n${KYOGIJO_CROWD_STYLE}` : ""}${o.host === undefined ? "" : `\n${specialStyle(hostSport(o.host))}`}</style>`) +
+        (o.style === "none" ? "" : `<style>${KYOGIJO_BASE_STYLE}${left?.round === true || right?.round === true || (pg !== undefined && pageant?.style === "stage") || (pg !== undefined && pageant?.emblem?.shape !== "plain" && pageant?.emblem !== undefined) ? `\n${KYOGIJO_MARK_STYLE}` : ""}${pg === undefined ? "" : `\n${KYOGIJO_PAGEANT_STYLE}${pageant?.animate === undefined || pageant.animate === "none" ? "" : `\n${KYOGIJO_PAGEANT_MOTION}`}`}${sport === "curling" ? `\n${KYOGIJO_CURLING_STYLE}` : ""}${foldedSheet ? `\n${KYOGIJO_FOLD_STYLE}` : ""}${isPoolSport(sport) ? `\n${o.pool?.venue !== undefined ? KYOGIJO_POOL_STYLE : poolStyle({ sport, ...commonOf(o.pool ?? {}), race: o.pool?.race !== undefined, section: o.pool?.section !== undefined && o.pool.section !== false })}` : ""}${plan === undefined ? "" : `\n${courtStyle(plan.sport, plan.look)}`}${fieldsStyle(sport) === "" ? "" : `\n${fieldsStyle(sport)}`}${athleticsStyle(sport) === "" ? "" : `\n${athleticsStyle(sport)}`}${skatingStyle(sport) === "" ? "" : `\n${skatingStyle(sport)}`}${budoLook === undefined ? "" : `\n${budoStyle(sport, budoLook)}`}${palette === undefined ? "" : `\n${lookStyle(palette)}`}${athleticsTrackRules(sport, o.athletics?.track) === "" ? "" : `\n${athleticsTrackRules(sport, o.athletics?.track)}`}${walled ? `\n${KYOGIJO_WALLS_STYLE}` : ""}${hardwood ? `\n${KYOGIJO_HARDWOOD_STYLE}` : ""}${features === undefined ? "" : `\n${featureStyle(sport, features)}`}${notes === undefined || notes.svg === "" ? "" : `\n${KYOGIJO_NOTE_STYLE}`}${grounded ? `\n${KYOGIJO_BACKGROUND_STYLE}` : ""}${crowded ? `\n${KYOGIJO_CROWD_STYLE}` : ""}${crowded && sport === "dojo" ? KYOGIJO_BUDO_GALLERY_STYLE : ""}${situation === undefined ? "" : `\n${KYOGIJO_SITUATION_STYLE}`}${o.host === undefined ? "" : `\n${specialStyle(hostSport(o.host))}`}</style>`) +
         (defs === "" ? "" : `<defs>${defs}</defs>`) +
         body);
     return root;

package/dist/element-entry.d.ts

@@ -1 +1,3 @@
 export { KYOGIJO_ATTRIBUTES, KYOGIJO_TAG, KyogijoField, defineKyogijoField, optionsFromAttributes, replaySettingsFromAttributes, turnSettingsFromAttributes, turnWanted } from "./element.ts";
+export { useEmblems } from "./emblems-source.ts";
+export type { EmblemRenderer } from "./emblems-source.ts";

package/dist/element-entry.js

@@ -1,2 +1,3 @@
 // The custom element's class and its registration function; importing this entry registers nothing.
 export { KYOGIJO_ATTRIBUTES, KYOGIJO_TAG, KyogijoField, defineKyogijoField, optionsFromAttributes, replaySettingsFromAttributes, turnSettingsFromAttributes, turnWanted } from "./element.js";
+export { useEmblems } from "./emblems-source.js";

package/dist/element.d.ts

@@ -6,7 +6,7 @@ import type { ScoreOptions, SurfaceOptions } from "./types.ts";
 /** The tag of the element. */
 export declare const KYOGIJO_TAG = "kyogijo-field";
 /** The attributes the element reads. */
-export declare const KYOGIJO_ATTRIBUTES: readonly ["sport", "league", "size", "theme", "language", "orientation", "park", "ground", "year", "detail", "margin", "stripes", "exact-lines", "uppercase", "pitch", "pitch-type", "half", "range", "range-end", "goals", "stripe-pattern", "corner-flags", "look", "line-width", "line-dash", "line-opacity", "landmarks", "walls", "quirks", "home", "away", "home-abbr", "away-abbr", "home-score", "away-score", "home-penalties", "away-penalties", "score", "home-logo", "away-logo", "home-color", "away-color", "status", "competition", "date", "label", "winner", "home-side", "pageant", "description", "options", "loop", "speed", "autoplay", "controls", "trail", "turn", "turn-view", "turn-controls", "turn-uprights", "turn-score", "turn-touch"];
+export declare const KYOGIJO_ATTRIBUTES: readonly ["sport", "league", "size", "theme", "language", "orientation", "park", "ground", "arena", "year", "detail", "margin", "stripes", "exact-lines", "uppercase", "pitch", "pitch-type", "half", "range", "range-end", "goals", "stripe-pattern", "corner-flags", "look", "line-width", "line-dash", "line-opacity", "landmarks", "walls", "quirks", "home", "away", "home-abbr", "away-abbr", "home-score", "away-score", "home-penalties", "away-penalties", "score", "home-logo", "away-logo", "home-color", "away-color", "status", "competition", "date", "label", "winner", "home-side", "pageant", "description", "options", "loop", "speed", "autoplay", "controls", "trail", "turn", "turn-view", "turn-controls", "turn-uprights", "turn-score", "turn-touch"];
 /** The settings of a 3D view an element's attributes make: `turn-view` names the viewpoint it opens on, `turn-controls="false"` and `turn-uprights="false"` leave the buttons and what stands on the surface out, `turn-score="floor"` leaves the score panel on the floor, `turn-touch="turn"` keeps every touch for the view. */
 export declare function turnSettingsFromAttributes(read: (name: string) => string | null, base?: TurnSettings): TurnSettings;
 /** Whether an element's `turn` attribute asks for the 3D view: present, and not `false`. */
@@ -24,7 +24,7 @@ export declare function optionsFromAttributes(read: (name: string) => string | n
 declare const Base: typeof HTMLElement;
 export declare class KyogijoField extends Base {
     #private;
-    static observedAttributes: readonly ["sport", "league", "size", "theme", "language", "orientation", "park", "ground", "year", "detail", "margin", "stripes", "exact-lines", "uppercase", "pitch", "pitch-type", "half", "range", "range-end", "goals", "stripe-pattern", "corner-flags", "look", "line-width", "line-dash", "line-opacity", "landmarks", "walls", "quirks", "home", "away", "home-abbr", "away-abbr", "home-score", "away-score", "home-penalties", "away-penalties", "score", "home-logo", "away-logo", "home-color", "away-color", "status", "competition", "date", "label", "winner", "home-side", "pageant", "description", "options", "loop", "speed", "autoplay", "controls", "trail", "turn", "turn-view", "turn-controls", "turn-uprights", "turn-score", "turn-touch"];
+    static observedAttributes: readonly ["sport", "league", "size", "theme", "language", "orientation", "park", "ground", "arena", "year", "detail", "margin", "stripes", "exact-lines", "uppercase", "pitch", "pitch-type", "half", "range", "range-end", "goals", "stripe-pattern", "corner-flags", "look", "line-width", "line-dash", "line-opacity", "landmarks", "walls", "quirks", "home", "away", "home-abbr", "away-abbr", "home-score", "away-score", "home-penalties", "away-penalties", "score", "home-logo", "away-logo", "home-color", "away-color", "status", "competition", "date", "label", "winner", "home-side", "pageant", "description", "options", "loop", "speed", "autoplay", "controls", "trail", "turn", "turn-view", "turn-controls", "turn-uprights", "turn-score", "turn-touch"];
     /** The options given as a property: an object, laid under the attributes. */
     get options(): Partial<ScoreOptions> | undefined;
     set options(value: Partial<ScoreOptions> | undefined);

package/dist/element.js

@@ -20,7 +20,7 @@ import { mountKyogijoTurn } from "./turn.dom.js";
 export const KYOGIJO_TAG = "kyogijo-field";
 /** The attributes the element reads. */
 export const KYOGIJO_ATTRIBUTES = [
-    "sport", "league", "size", "theme", "language", "orientation", "park", "ground", "year", "detail", "margin", "stripes", "exact-lines", "uppercase",
+    "sport", "league", "size", "theme", "language", "orientation", "park", "ground", "arena", "year", "detail", "margin", "stripes", "exact-lines", "uppercase",
     "pitch", "pitch-type", "half", "range", "range-end", "goals", "stripe-pattern", "corner-flags", "look", "line-width", "line-dash", "line-opacity", "landmarks", "walls", "quirks",
     "home", "away", "home-abbr", "away-abbr", "home-score", "away-score", "home-penalties", "away-penalties", "score", "home-logo", "away-logo", "home-color", "away-color",
     "status", "competition", "date", "label", "winner", "home-side", "pageant", "description", "options",
@@ -109,6 +109,7 @@ export function optionsFromAttributes(read, base) {
     text("orientation");
     text("park");
     text("ground");
+    text("arena");
     text("detail");
     text("pitch");
     text("pitch-type");

package/dist/emblems-source.d.ts

@@ -0,0 +1,50 @@
+/** The styles an emblem is drawn in: full colour with metallic gradients, one outline in the page's ink, or flat fills. */
+export type EmblemStyleName = "metal" | "line" | "color";
+/** What kyogijo asks of a renderer. It is a subset of dougu-sports' `EmblemOptions`. */
+export interface EmblemDrawOptions {
+    style?: EmblemStyleName;
+    /** The colour of the emblem's main part: a crest takes the team's colour. */
+    tint?: string;
+    /** A second colour: a crest's band. */
+    accent?: string;
+    /** The letters of a crest, up to three. */
+    initials?: string;
+    /** `inherit`, `auto` (by the device's setting), `light` or `dark`. */
+    theme?: "inherit" | "auto" | "light" | "dark";
+    size?: number;
+}
+/**
+ * A function that draws an emblem from its id as a document of SVG, and throws for an id it does not know: `renderEmblem` of `@johnmorrisdotca/dougu-sports/emblems` is one.
+ * The id may end in `/metal`, `/line` or `/color`, and the renderer reads that suffix.
+ */
+export type EmblemRenderer = (id: string, options?: EmblemDrawOptions) => string;
+type Known<T> = 0 extends 1 & T ? string : T;
+/** @ts-ignore optional: resolves only where @johnmorrisdotca/dougu-sports is installed; elsewhere it is `any`, which `Known` turns into `string`. */
+type DouguId = import("@johnmorrisdotca/dougu-sports/emblems").EmblemId;
+/**
+ * The ids of dougu-sports' emblems (`"trophy:cup"`, `"crest:shield"`), when that package is installed, so that an editor completes them; any other string otherwise. An id may end in `/metal`, `/line` or `/color`,
+ * and a trophy or an award may be written without its group (`"cup"`). Nothing is imported at run time.
+ */
+export type EmblemId = Known<DouguId>;
+/** An emblem as a logo, a mark or a pageant's emblem is given: its id, with or without a style, or any string (an address, a data address or an SVG document). */
+export type EmblemRef = EmblemId | `${EmblemId}/${EmblemStyleName}` | (string & {});
+/**
+ * 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 declare function useEmblems(render: EmblemRenderer | undefined): void;
+/** 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 declare function withEmblems<T>(render: EmblemRenderer | undefined, draw: () => T): T;
+/** The renderer in use: the drawing's own, else the page's, else none. */
+export declare function emblemRenderer(): EmblemRenderer | undefined;
+/** An id with its group, which no address has in practice: what a missing renderer is told about. */
+export declare const GROUPED_ID: RegExp;
+/** 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 declare function renderedEmblem(value: unknown, options?: EmblemDrawOptions): string | undefined;
+export {};