@johnmorrisdotca/dougu-sports 0.1.0 → 0.2.0

package/dist/emblems/emblem.equipment.js

@@ -0,0 +1,57 @@
+const GOLD = "medal:gold";
+const TABLE = {
+    nfl: ["ball:football", ["gear:football-helmet", "gear:goalposts"], "trophy:football"],
+    cfl: ["ball:football-cfl", ["gear:football-helmet", "gear:goalposts"], "trophy:canadian-bowl"],
+    ifaf: ["ball:football-ifaf", ["gear:football-helmet", "gear:goalposts"], "trophy:cup"],
+    nhl: ["ball:puck", ["gear:hockey-stick", "gear:hockey-skate", "gear:goalie-mask", "gear:goal-net"], "trophy:hockey-cup"],
+    nba: ["ball:basketball", ["gear:basketball-hoop"], "trophy:basketball"],
+    mlb: ["ball:baseball", ["gear:baseball-bat", "gear:baseball-glove"], "trophy:baseball"],
+    soccer: ["ball:soccer", ["gear:goal-net"], "trophy:soccer-globe", GOLD],
+    curling: ["ball:curling-stone", ["gear:curling-broom"], "trophy:bowl", GOLD],
+    tennis: ["ball:tennis", ["gear:tennis-racket"], "trophy:tennis-cup", GOLD],
+    volleyball: ["ball:volleyball", ["gear:volleyball-net"], "trophy:cup", GOLD],
+    badminton: ["ball:shuttlecock-feather", ["gear:badminton-racket"], "trophy:cup", GOLD],
+    pickleball: ["ball:pickleball-outdoor", ["gear:pickleball-paddle"], "trophy:cup"],
+    tabletennis: ["ball:table-tennis", ["gear:table-tennis-paddle"], "trophy:cup", GOLD],
+    padel: ["ball:padel", ["gear:padel-racket"], "trophy:cup"],
+    squash: ["ball:squash", ["gear:squash-racket"], "trophy:cup", GOLD],
+    racquetball: ["ball:racquetball", ["gear:racquetball-racket"], "trophy:cup"],
+    sepaktakraw: ["ball:sepak-takraw", [], "trophy:cup"],
+    teqball: ["ball:teqball", [], "trophy:cup"],
+    roundnet: ["ball:roundnet", ["gear:roundnet-set"], "trophy:cup"],
+    netball: ["ball:netball", [], "trophy:cup"],
+    swimming: [undefined, ["gear:swim-goggles"], "trophy:cup", GOLD],
+    waterpolo: ["ball:water-polo", ["gear:swim-goggles"], "trophy:cup", GOLD],
+    diving: [undefined, ["gear:diving-board"], "trophy:cup", GOLD],
+    artisticswimming: [undefined, ["gear:swim-goggles"], "trophy:cup", GOLD],
+    lacrosse: ["ball:lacrosse", ["gear:lacrosse-stick"], "trophy:cup", GOLD],
+    rugby: ["ball:rugby", ["gear:goalposts"], "trophy:rugby-cup", GOLD],
+    afl: ["ball:afl", ["gear:goalposts"], "trophy:cup"],
+    gaelic: ["ball:sliotar", ["gear:hurley", "gear:goalposts"], "trophy:cup"],
+    cricket: ["ball:cricket-red", ["gear:cricket-bat", "gear:wicket"], "trophy:cricket-urn", GOLD],
+    fieldhockey: ["ball:field-hockey", ["gear:field-hockey-stick", "gear:goal-net"], "trophy:cup", GOLD],
+    handball: ["ball:handball", ["gear:goal-net"], "trophy:cup", GOLD],
+    athletics: ["ball:shot", ["gear:starting-blocks", "gear:relay-baton", "gear:javelin", "gear:hurdles"], "trophy:laurel", GOLD],
+    skating: [undefined, ["gear:figure-skate", "gear:speed-skate"], "trophy:cup", GOLD],
+    sumo: [undefined, ["gear:gunbai", "gear:mawashi"], "trophy:sumo-cup"],
+    kendo: [undefined, ["gear:shinai", "gear:kendo-men"], "trophy:cup"],
+    judo: [undefined, ["gear:judogi", "gear:obi"], "trophy:cup", GOLD],
+    kyudo: [undefined, ["gear:yumi", "gear:ya"], "trophy:cup"],
+    karate: [undefined, ["gear:karate-gi"], "trophy:cup", GOLD],
+};
+/**
+ * What a sport is played and won with, as ids of the registry: `sportEquipment("nhl")` is the puck, a stick, a skate, a goalie's mask and a net, and the hockey cup. The arrays are new each call. An unknown sport is an error.
+ * @example
+ * ```ts
+ * import { sportEquipment } from "@johnmorrisdotca/dougu-sports/emblems";
+ * const nhl = sportEquipment("nhl");
+ * console.log(nhl.ball, nhl.trophy);
+ * // ball:puck trophy:hockey-cup
+ * ```
+ */
+export function sportEquipment(sport) {
+    if (!Object.hasOwn(TABLE, sport))
+        throw new Error(`Unknown sport "${String(sport).slice(0, 40)}": the equipment is for the names in SPORT_NAMES.`);
+    const [ball, gear, trophy, medal] = TABLE[sport];
+    return { sport, ...(ball === undefined ? {} : { ball }), gear: [...gear], trophy, ...(medal === undefined ? {} : { medal }) };
+}

package/dist/emblems/emblem.flip.d.ts

@@ -0,0 +1,10 @@
+/** What a turn needs. `line` is the line style (the rim is drawn in the page's ink), `back` is the document of the back view, and `thick` is the thickness as a fraction of the width. */
+export interface FlipOptions {
+    yaw: number;
+    pitch: number;
+    line?: boolean;
+    back?: string;
+    thick?: number;
+}
+/** A document turned by `yaw` and `pitch` degrees from its still drawing. With no turn it is the document itself. */
+export declare function flipSvg(svg: string, o: FlipOptions): string;

package/dist/emblems/emblem.flip.js

@@ -0,0 +1,45 @@
+// The coin-flip turn for any flat drawing: it takes a finished document and returns it turned. The face is squeezed by the cosine of the yaw and shows its back past a quarter turn, and the rim
+// (the thickness of the sheet) shows as a dark edge on the side that is turning away, widest when the drawing is edge on. A piece with no drawing of its own for the back (a bat, a racket, a pictogram)
+// shows its front mirrored and a little darker, as the other side of a cut-out; a pennant passes the drawing of its back. A pure function of strings and numbers; it imports nothing.
+const RAD = Math.PI / 180;
+const n2 = (value) => String(Math.round(value * 100) / 100 + 0);
+/** The parts of a document of SVG: its opening tag, its titles, and the rest. */
+function split(svg) {
+    const open = /^<svg[^>]*>/.exec(svg)?.[0] ?? "";
+    const after = svg.slice(open.length, svg.length - "</svg>".length);
+    const head = /^<title>[\s\S]*?<\/title>(?:<desc>[\s\S]*?<\/desc>)?/.exec(after)?.[0] ?? "";
+    const box = (/viewBox="([^"]*)"/.exec(open)?.[1] ?? "0 0 64 64").split(/\s+/).map(Number);
+    return { open, head, rest: after.slice(head.length), box: [box[0] ?? 0, box[1] ?? 0, box[2] || 64, box[3] || 64] };
+}
+/** A document turned by `yaw` and `pitch` degrees from its still drawing. With no turn it is the document itself. */
+export function flipSvg(svg, o) {
+    if (o.yaw === 0 && o.pitch === 0)
+        return svg;
+    const across = Math.cos(o.yaw * RAD);
+    const tilt = Math.cos(o.pitch * RAD);
+    const front = split(svg);
+    const showBack = across < 0;
+    const own = showBack && o.back !== undefined ? split(o.back) : undefined;
+    const face = own ?? front;
+    const [x0, y0, w, h] = front.box;
+    const sx = Math.max(Math.abs(across), 0.02);
+    const sy = Math.max(Math.abs(tilt), 0.02);
+    const thick = w * (o.thick ?? 0.035);
+    const dx = thick * Math.sin(o.yaw * RAD);
+    const dy = -thick * Math.sin(o.pitch * RAD) * 0.6;
+    const mirror = showBack && own === undefined;
+    const cx = x0 + w / 2;
+    const cy = y0 + h / 2;
+    // The turned face, then the filter that adds the rim behind it (and dims a mirrored back).
+    // The id names everything the definition depends on (its region comes from the box), so two drawings in one page that share an id share one filter.
+    const id = `dgf${o.line === true ? "l" : "c"}${mirror ? "b" : "f"}${Math.round(dx * 100)}_${Math.round(dy * 100)}_${[x0, y0, w, h].map((v) => Math.round(v)).join("_")}`;
+    const flood = o.line === true ? '<feFlood flood-color="currentColor" flood-opacity=".5"/>' : '<feFlood flood-color="#000" flood-opacity=".42"/>';
+    const steps = [1, 2, 3].map((k) => (Math.abs(dx) + Math.abs(dy) < 0.05 ? "" : `<feOffset in="s" dx="${n2((dx * k) / 3)}" dy="${n2((dy * k) / 3)}" result="o${k}"/>`)).join("");
+    const nodes = Math.abs(dx) + Math.abs(dy) < 0.05 ? "" : '<feMergeNode in="o3"/><feMergeNode in="o2"/><feMergeNode in="o1"/>';
+    const dim = mirror && o.line !== true ? '<feColorMatrix in="SourceGraphic" values=".8 0 0 0 0 0 .8 0 0 0 0 0 .8 0 0 0 0 0 1 0" result="d"/>' : "";
+    const filter = `<filter id="${id}" x="${n2(x0 - w * 0.15)}" y="${n2(y0 - h * 0.15)}" width="${n2(w * 1.3)}" height="${n2(h * 1.3)}" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">` +
+        `${flood}<feComposite in2="SourceAlpha" operator="in" result="s"/>${steps}${dim}<feMerge>${nodes}<feMergeNode in="${dim === "" ? "SourceGraphic" : "d"}"/></feMerge></filter>`;
+    const flip = mirror ? -1 : 1;
+    const group = `<g filter="url(#${id})"><g transform="translate(${n2(cx)} ${n2(cy)}) scale(${n2(sx * flip)} ${n2(sy)}) translate(${n2(-cx)} ${n2(-cy)})">${face.rest}</g></g>`;
+    return `${front.open}${front.head}<defs>${filter}</defs>${group}</svg>`;
+}

package/dist/emblems/emblem.ids.d.ts

@@ -1,11 +1,11 @@
-/** The thirty-three sports the emblems are made for: the names that `ball:<sport>`, `gear:<sport>` and `sport:<sport>` use. */
-export declare const SPORT_NAMES: readonly ["nfl", "cfl", "ifaf", "nhl", "nba", "mlb", "soccer", "curling", "tennis", "volleyball", "badminton", "pickleball", "tabletennis", "padel", "squash", "racquetball", "sepaktakraw", "teqball", "roundnet", "netball", "swimming", "waterpolo", "diving", "artisticswimming", "lacrosse", "rugby", "afl", "gaelic", "cricket", "fieldhockey", "handball", "athletics", "skating"];
+/** The thirty-eight sports the emblems are made for (the five Japanese ones, sumo, kendo, judo, kyudo and karate, have a pictogram and their gear, and no ball): the names that `ball:<sport>`, `gear:<sport>` and `sport:<sport>` use. */
+export declare const SPORT_NAMES: readonly ["nfl", "cfl", "ifaf", "nhl", "nba", "mlb", "soccer", "curling", "tennis", "volleyball", "badminton", "pickleball", "tabletennis", "padel", "squash", "racquetball", "sepaktakraw", "teqball", "roundnet", "netball", "swimming", "waterpolo", "diving", "artisticswimming", "lacrosse", "rugby", "afl", "gaelic", "cricket", "fieldhockey", "handball", "athletics", "skating", "sumo", "kendo", "judo", "kyudo", "karate"];
 export type SportName = (typeof SPORT_NAMES)[number];
-/** The awards, drawn from Material Symbols: a medal on a ribbon, a badge, a crown, a star and a shield. */
+/** The awards: a medal on a ribbon, a badge, a crown, a star and a shield. */
 export declare const AWARD_IDS: readonly ["award:medal", "award:badge", "award:crown", "award:star", "award:shield"];
 export type AwardId = (typeof AWARD_IDS)[number];
 /** The trophies: a cup for each league's champion in a descriptive, generic form, the plain cups and dishes, and the flat plaque, belt, wreath and rosette. */
-export declare const TROPHY_IDS: readonly ["trophy:cup", "trophy:lidded-cup", "trophy:bowl", "trophy:salver", "trophy:globe", "trophy:hockey-cup", "trophy:basketball", "trophy:baseball", "trophy:football", "trophy:canadian-bowl", "trophy:soccer-ball", "trophy:soccer-globe", "trophy:tennis-plate", "trophy:tennis-cup", "trophy:cricket-urn", "trophy:rugby-cup", "trophy:plaque", "trophy:belt", "trophy:laurel", "trophy:rosette"];
+export declare const TROPHY_IDS: readonly ["trophy:cup", "trophy:lidded-cup", "trophy:bowl", "trophy:salver", "trophy:globe", "trophy:hockey-cup", "trophy:basketball", "trophy:baseball", "trophy:football", "trophy:canadian-bowl", "trophy:soccer-ball", "trophy:soccer-globe", "trophy:tennis-plate", "trophy:tennis-cup", "trophy:cricket-urn", "trophy:rugby-cup", "trophy:plaque", "trophy:belt", "trophy:laurel", "trophy:rosette", "trophy:ring", "trophy:banner", "trophy:sumo-cup", "trophy:championship-banner"];
 export type TrophyId = (typeof TROPHY_IDS)[number];
 /** The medals on a ribbon, and the badges for the first three places. */
 export declare const MEDAL_KINDS: readonly ["gold", "silver", "bronze"];
@@ -20,23 +20,30 @@ export type CrestId = (typeof CREST_IDS)[number];
 /** The balls: one for each ball and implement the sports use, in 3D, with the official size it comes from. The balls of one family (the three crickets, the five squash balls) share a module. */
 export declare const BALL_IDS: readonly ["ball:soccer", "ball:soccer-colour", "ball:teqball", "ball:basketball", "ball:basketball-6", "ball:basketball-3x3", "ball:baseball", "ball:softball", "ball:tennis", "ball:padel", "ball:sliotar", "ball:volleyball", "ball:volleyball-8", "ball:beach-volleyball", "ball:cricket-red", "ball:cricket-white", "ball:cricket-pink", "ball:football", "ball:football-cfl", "ball:football-ifaf", "ball:rugby", "ball:afl", "ball:gaelic-football", "ball:netball", "ball:pickleball-outdoor", "ball:pickleball-indoor", "ball:squash", "ball:squash-yellow", "ball:squash-green", "ball:squash-red", "ball:squash-blue", "ball:racquetball", "ball:lacrosse", "ball:field-hockey", "ball:table-tennis", "ball:handball", "ball:water-polo", "ball:golf", "ball:puck", "ball:curling-stone", "ball:shot", "ball:discus", "ball:hammer", "ball:sepak-takraw", "ball:roundnet", "ball:shuttlecock-feather", "ball:shuttlecock-nylon"];
 export type BallId = (typeof BALL_IDS)[number];
-/** The pieces of gear: a piece of equipment for each sport, flat, drawn here or copied from open icon sets (NOTICE.md says which). */
-export declare const GEAR_IDS: readonly ["gear:hockey-stick", "gear:goalie-stick", "gear:hockey-skate", "gear:goalie-mask", "gear:goal-net", "gear:field-hockey-stick", "gear:lacrosse-stick", "gear:cricket-bat", "gear:wicket", "gear:table-tennis-paddle", "gear:badminton-racket", "gear:tennis-racket", "gear:squash-racket", "gear:racquetball-racket", "gear:padel-racket", "gear:pickleball-paddle", "gear:roundnet-set", "gear:volleyball-net", "gear:basketball-hoop", "gear:baseball-bat", "gear:baseball-glove", "gear:football-helmet", "gear:goalposts", "gear:hurley", "gear:curling-broom", "gear:figure-skate", "gear:speed-skate", "gear:diving-board", "gear:swim-goggles", "gear:starting-blocks", "gear:relay-baton", "gear:javelin", "gear:hurdles"];
+/** The pieces of gear: a piece of equipment for each sport, flat, drawn for this package, turning like a coin. */
+export declare const GEAR_IDS: readonly ["gear:hockey-stick", "gear:goalie-stick", "gear:hockey-skate", "gear:goalie-mask", "gear:goal-net", "gear:field-hockey-stick", "gear:lacrosse-stick", "gear:cricket-bat", "gear:wicket", "gear:table-tennis-paddle", "gear:badminton-racket", "gear:tennis-racket", "gear:squash-racket", "gear:racquetball-racket", "gear:padel-racket", "gear:pickleball-paddle", "gear:roundnet-set", "gear:volleyball-net", "gear:basketball-hoop", "gear:baseball-bat", "gear:baseball-glove", "gear:football-helmet", "gear:goalposts", "gear:hurley", "gear:curling-broom", "gear:figure-skate", "gear:speed-skate", "gear:diving-board", "gear:swim-goggles", "gear:starting-blocks", "gear:relay-baton", "gear:javelin", "gear:hurdles", "gear:gunbai", "gear:mawashi", "gear:shinai", "gear:kendo-men", "gear:judogi", "gear:obi", "gear:yumi", "gear:ya", "gear:karate-gi"];
 export type GearId = (typeof GEAR_IDS)[number];
-/** The sports' own emblems: one pictogram for each of the thirty-three. */
+/** The Japanese sports and budo: sumo, kendo, judo, kyudo and karate, with the trophies and the gear that belong to them. Every one is also in its own group; this list is for showing them together. */
+export declare const JAPANESE_IDS: readonly ["sport:sumo", "trophy:sumo-cup", "gear:gunbai", "gear:mawashi", "trophy:championship-banner", "sport:kendo", "gear:shinai", "gear:kendo-men", "sport:judo", "gear:judogi", "gear:obi", "sport:kyudo", "gear:yumi", "gear:ya", "sport:karate", "gear:karate-gi"];
+export type JapaneseId = (typeof JAPANESE_IDS)[number];
+/** The pennants: a felt championship pennant with a stitched edge. */
+export declare const PENNANT_IDS: readonly ["pennant:championship"];
+export type PennantId = (typeof PENNANT_IDS)[number];
+/** The sports' own emblems: one pictogram for each of the thirty-eight. */
 export type SportEmblemId = `sport:${SportName}`;
 export declare const SPORT_IDS: readonly SportEmblemId[];
 /** Every emblem id. */
-export type EmblemId = AwardId | TrophyId | MedalId | CrestId | BallId | GearId | SportEmblemId;
+export type EmblemId = AwardId | TrophyId | MedalId | CrestId | BallId | GearId | SportEmblemId | PennantId;
 /** The groups of ids, in the order a gallery shows them. */
 export declare const EMBLEM_GROUPS: {
     readonly award: readonly ["award:medal", "award:badge", "award:crown", "award:star", "award:shield"];
-    readonly trophy: readonly ["trophy:cup", "trophy:lidded-cup", "trophy:bowl", "trophy:salver", "trophy:globe", "trophy:hockey-cup", "trophy:basketball", "trophy:baseball", "trophy:football", "trophy:canadian-bowl", "trophy:soccer-ball", "trophy:soccer-globe", "trophy:tennis-plate", "trophy:tennis-cup", "trophy:cricket-urn", "trophy:rugby-cup", "trophy:plaque", "trophy:belt", "trophy:laurel", "trophy:rosette"];
+    readonly trophy: readonly ["trophy:cup", "trophy:lidded-cup", "trophy:bowl", "trophy:salver", "trophy:globe", "trophy:hockey-cup", "trophy:basketball", "trophy:baseball", "trophy:football", "trophy:canadian-bowl", "trophy:soccer-ball", "trophy:soccer-globe", "trophy:tennis-plate", "trophy:tennis-cup", "trophy:cricket-urn", "trophy:rugby-cup", "trophy:plaque", "trophy:belt", "trophy:laurel", "trophy:rosette", "trophy:ring", "trophy:banner", "trophy:sumo-cup", "trophy:championship-banner"];
     readonly medal: readonly ["medal:gold", "medal:silver", "medal:bronze", "medal:place-1", "medal:place-2", "medal:place-3"];
     readonly crest: readonly ["crest:shield", "crest:roundel", "crest:diamond", "crest:pennant"];
     readonly ball: readonly ["ball:soccer", "ball:soccer-colour", "ball:teqball", "ball:basketball", "ball:basketball-6", "ball:basketball-3x3", "ball:baseball", "ball:softball", "ball:tennis", "ball:padel", "ball:sliotar", "ball:volleyball", "ball:volleyball-8", "ball:beach-volleyball", "ball:cricket-red", "ball:cricket-white", "ball:cricket-pink", "ball:football", "ball:football-cfl", "ball:football-ifaf", "ball:rugby", "ball:afl", "ball:gaelic-football", "ball:netball", "ball:pickleball-outdoor", "ball:pickleball-indoor", "ball:squash", "ball:squash-yellow", "ball:squash-green", "ball:squash-red", "ball:squash-blue", "ball:racquetball", "ball:lacrosse", "ball:field-hockey", "ball:table-tennis", "ball:handball", "ball:water-polo", "ball:golf", "ball:puck", "ball:curling-stone", "ball:shot", "ball:discus", "ball:hammer", "ball:sepak-takraw", "ball:roundnet", "ball:shuttlecock-feather", "ball:shuttlecock-nylon"];
-    readonly gear: readonly ["gear:hockey-stick", "gear:goalie-stick", "gear:hockey-skate", "gear:goalie-mask", "gear:goal-net", "gear:field-hockey-stick", "gear:lacrosse-stick", "gear:cricket-bat", "gear:wicket", "gear:table-tennis-paddle", "gear:badminton-racket", "gear:tennis-racket", "gear:squash-racket", "gear:racquetball-racket", "gear:padel-racket", "gear:pickleball-paddle", "gear:roundnet-set", "gear:volleyball-net", "gear:basketball-hoop", "gear:baseball-bat", "gear:baseball-glove", "gear:football-helmet", "gear:goalposts", "gear:hurley", "gear:curling-broom", "gear:figure-skate", "gear:speed-skate", "gear:diving-board", "gear:swim-goggles", "gear:starting-blocks", "gear:relay-baton", "gear:javelin", "gear:hurdles"];
-    readonly sport: readonly ("sport:nfl" | "sport:cfl" | "sport:ifaf" | "sport:nhl" | "sport:nba" | "sport:mlb" | "sport:soccer" | "sport:curling" | "sport:tennis" | "sport:volleyball" | "sport:badminton" | "sport:pickleball" | "sport:tabletennis" | "sport:padel" | "sport:squash" | "sport:racquetball" | "sport:sepaktakraw" | "sport:teqball" | "sport:roundnet" | "sport:netball" | "sport:swimming" | "sport:waterpolo" | "sport:diving" | "sport:artisticswimming" | "sport:lacrosse" | "sport:rugby" | "sport:afl" | "sport:gaelic" | "sport:cricket" | "sport:fieldhockey" | "sport:handball" | "sport:athletics" | "sport:skating")[];
+    readonly gear: readonly ["gear:hockey-stick", "gear:goalie-stick", "gear:hockey-skate", "gear:goalie-mask", "gear:goal-net", "gear:field-hockey-stick", "gear:lacrosse-stick", "gear:cricket-bat", "gear:wicket", "gear:table-tennis-paddle", "gear:badminton-racket", "gear:tennis-racket", "gear:squash-racket", "gear:racquetball-racket", "gear:padel-racket", "gear:pickleball-paddle", "gear:roundnet-set", "gear:volleyball-net", "gear:basketball-hoop", "gear:baseball-bat", "gear:baseball-glove", "gear:football-helmet", "gear:goalposts", "gear:hurley", "gear:curling-broom", "gear:figure-skate", "gear:speed-skate", "gear:diving-board", "gear:swim-goggles", "gear:starting-blocks", "gear:relay-baton", "gear:javelin", "gear:hurdles", "gear:gunbai", "gear:mawashi", "gear:shinai", "gear:kendo-men", "gear:judogi", "gear:obi", "gear:yumi", "gear:ya", "gear:karate-gi"];
+    readonly sport: readonly ("sport:sumo" | "sport:kendo" | "sport:judo" | "sport:kyudo" | "sport:karate" | "sport:nfl" | "sport:cfl" | "sport:ifaf" | "sport:nhl" | "sport:nba" | "sport:mlb" | "sport:soccer" | "sport:curling" | "sport:tennis" | "sport:volleyball" | "sport:badminton" | "sport:pickleball" | "sport:tabletennis" | "sport:padel" | "sport:squash" | "sport:racquetball" | "sport:sepaktakraw" | "sport:teqball" | "sport:roundnet" | "sport:netball" | "sport:swimming" | "sport:waterpolo" | "sport:diving" | "sport:artisticswimming" | "sport:lacrosse" | "sport:rugby" | "sport:afl" | "sport:gaelic" | "sport:cricket" | "sport:fieldhockey" | "sport:handball" | "sport:athletics" | "sport:skating")[];
+    readonly pennant: readonly ["pennant:championship"];
 };
 export type EmblemGroup = keyof typeof EMBLEM_GROUPS;
 /** Every id, in group order. */
@@ -50,6 +57,7 @@ export declare const EMBLEM_FOLDERS: {
     readonly ball: "ball";
     readonly gear: "gear";
     readonly sport: "sport";
+    readonly pennant: "pennant";
 };
 /** The short names of the trophies and awards that stand for a full id: `"cup"` is `"trophy:cup"` and `"crown"` is `"award:crown"`. */
 export declare const EMBLEM_ALIASES: Readonly<Record<string, EmblemId>>;

package/dist/emblems/emblem.ids.js

@@ -1,18 +1,20 @@
 // The ids of the emblems, in their groups, and the types they make. Nothing is imported: this file is only names, so it costs nothing to read. An id is `<group>:<name>`.
 // Each list below holds the emblems that exist. The art for the rest arrives group by group (docs/layout.md), and each arrival adds its names here and its entry to emblem.registry.ts.
-/** The thirty-three sports the emblems are made for: the names that `ball:<sport>`, `gear:<sport>` and `sport:<sport>` use. */
+/** The thirty-eight sports the emblems are made for (the five Japanese ones, sumo, kendo, judo, kyudo and karate, have a pictogram and their gear, and no ball): the names that `ball:<sport>`, `gear:<sport>` and `sport:<sport>` use. */
 export const SPORT_NAMES = [
     "nfl", "cfl", "ifaf", "nhl", "nba", "mlb", "soccer", "curling", "tennis", "volleyball", "badminton", "pickleball", "tabletennis", "padel", "squash", "racquetball", "sepaktakraw", "teqball", "roundnet", "netball",
     "swimming", "waterpolo", "diving", "artisticswimming", "lacrosse", "rugby", "afl", "gaelic", "cricket", "fieldhockey", "handball", "athletics", "skating",
+    "sumo", "kendo", "judo", "kyudo", "karate",
 ];
-/** The awards, drawn from Material Symbols: a medal on a ribbon, a badge, a crown, a star and a shield. */
+/** The awards: a medal on a ribbon, a badge, a crown, a star and a shield. */
 export const AWARD_IDS = ["award:medal", "award:badge", "award:crown", "award:star", "award:shield"];
 /** The trophies: a cup for each league's champion in a descriptive, generic form, the plain cups and dishes, and the flat plaque, belt, wreath and rosette. */
 export const TROPHY_IDS = [
     "trophy:cup", "trophy:lidded-cup", "trophy:bowl", "trophy:salver", "trophy:globe",
     "trophy:hockey-cup", "trophy:basketball", "trophy:baseball", "trophy:football", "trophy:canadian-bowl", "trophy:soccer-ball", "trophy:soccer-globe",
     "trophy:tennis-plate", "trophy:tennis-cup", "trophy:cricket-urn", "trophy:rugby-cup",
-    "trophy:plaque", "trophy:belt", "trophy:laurel", "trophy:rosette",
+    "trophy:plaque", "trophy:belt", "trophy:laurel", "trophy:rosette", "trophy:ring", "trophy:banner",
+    "trophy:sumo-cup", "trophy:championship-banner",
 ];
 /** The medals on a ribbon, and the badges for the first three places. */
 export const MEDAL_KINDS = ["gold", "silver", "bronze"];
@@ -28,13 +30,25 @@ export const BALL_IDS = [
     "ball:squash-green", "ball:squash-red", "ball:squash-blue", "ball:racquetball", "ball:lacrosse", "ball:field-hockey", "ball:table-tennis", "ball:handball", "ball:water-polo", "ball:golf",
     "ball:puck", "ball:curling-stone", "ball:shot", "ball:discus", "ball:hammer", "ball:sepak-takraw", "ball:roundnet", "ball:shuttlecock-feather", "ball:shuttlecock-nylon"
 ];
-/** The pieces of gear: a piece of equipment for each sport, flat, drawn here or copied from open icon sets (NOTICE.md says which). */
+/** The pieces of gear: a piece of equipment for each sport, flat, drawn for this package, turning like a coin. */
 export const GEAR_IDS = [
     "gear:hockey-stick", "gear:goalie-stick", "gear:hockey-skate", "gear:goalie-mask", "gear:goal-net", "gear:field-hockey-stick", "gear:lacrosse-stick", "gear:cricket-bat", "gear:wicket",
     "gear:table-tennis-paddle", "gear:badminton-racket", "gear:tennis-racket", "gear:squash-racket", "gear:racquetball-racket", "gear:padel-racket", "gear:pickleball-paddle",
     "gear:roundnet-set", "gear:volleyball-net", "gear:basketball-hoop", "gear:baseball-bat", "gear:baseball-glove", "gear:football-helmet", "gear:goalposts", "gear:hurley",
-    "gear:curling-broom", "gear:figure-skate", "gear:speed-skate", "gear:diving-board", "gear:swim-goggles", "gear:starting-blocks", "gear:relay-baton", "gear:javelin", "gear:hurdles"
+    "gear:curling-broom", "gear:figure-skate", "gear:speed-skate", "gear:diving-board", "gear:swim-goggles", "gear:starting-blocks", "gear:relay-baton", "gear:javelin", "gear:hurdles",
+    "gear:gunbai", "gear:mawashi", "gear:shinai", "gear:kendo-men", "gear:judogi", "gear:obi", "gear:yumi", "gear:ya", "gear:karate-gi"
 ];
+/** The Japanese sports and budo: sumo, kendo, judo, kyudo and karate, with the trophies and the gear that belong to them. Every one is also in its own group; this list is for showing them together. */
+export const JAPANESE_IDS = [
+    "sport:sumo", "trophy:sumo-cup", "gear:gunbai", "gear:mawashi",
+    "trophy:championship-banner",
+    "sport:kendo", "gear:shinai", "gear:kendo-men",
+    "sport:judo", "gear:judogi", "gear:obi",
+    "sport:kyudo", "gear:yumi", "gear:ya",
+    "sport:karate", "gear:karate-gi",
+];
+/** The pennants: a felt championship pennant with a stitched edge. */
+export const PENNANT_IDS = ["pennant:championship"];
 export const SPORT_IDS = SPORT_NAMES.map((name) => `sport:${name}`);
 /** The groups of ids, in the order a gallery shows them. */
 export const EMBLEM_GROUPS = {
@@ -45,10 +59,11 @@ export const EMBLEM_GROUPS = {
     ball: BALL_IDS,
     gear: GEAR_IDS,
     sport: SPORT_IDS,
+    pennant: PENNANT_IDS,
 };
 /** Every id, in group order. */
 export const EMBLEM_IDS = Object.values(EMBLEM_GROUPS).flat();
 /** The folder under `src/emblems/` that holds a group's art, one module per item named by the id's last part: `trophy:hockey-cup` is `trophy/hockey-cup.ts`, `ball:soccer` is `ball/soccer.ts`. Each group has a folder of its own, so no two ids share a file name. */
-export const EMBLEM_FOLDERS = { award: "award", trophy: "trophy", medal: "medal", crest: "crest", ball: "ball", gear: "gear", sport: "sport" };
+export const EMBLEM_FOLDERS = { award: "award", trophy: "trophy", medal: "medal", crest: "crest", ball: "ball", gear: "gear", sport: "sport", pennant: "pennant" };
 /** The short names of the trophies and awards that stand for a full id: `"cup"` is `"trophy:cup"` and `"crown"` is `"award:crown"`. */
 export const EMBLEM_ALIASES = Object.fromEntries([...TROPHY_IDS, ...AWARD_IDS].map((id) => [id.slice(id.indexOf(":") + 1), id]));

package/dist/emblems/emblem.lathe.d.ts

@@ -1,4 +1,5 @@
 import { type Emblem, type EmblemSource, type Metal } from "./emblem.core.ts";
+import { type Band } from "./emblem.engrave.ts";
 /** A point of the profile: the height `y` (0 at the top of the 64 unit box), the radius `r` from the axis (x = 32), 1 for a sharp corner (a smooth run of points ends at one), and the tone of the piece that starts here. */
 export type Pt = readonly [y: number, r: number, corner?: 0 | 1, tone?: string];
 /** Something drawn on the surface, by height and angle (90 degrees is the right side, 0 faces the eye): a `ring` round the body at a height; `mer`idians from one height to another; `helix` strands that wind `turns` times; a diamond `net`; `dots` (beads) round at a height with a size; on an open top, a `disc` of a tone out to a radius and `pills`, short rounded marks, round a radius. */
@@ -52,6 +53,8 @@ export interface LatheModel {
     handles?: readonly Handle[];
     balls?: readonly Ball[];
     poles?: Poles;
+    /** The plinth: the band of the body (heights, the tone it is cut into, and for a body with flat sides which side) that holds an engraving, which turns with the body. */
+    plate?: Band;
 }
 /** The radius of the body at a height. */
 export declare function radiusAt(profile: readonly Pt[], y: number): number;

package/dist/emblems/emblem.lathe.js

@@ -2,7 +2,8 @@
 // grooves round the body, a pattern on a dish) are placed by the angle they are turned to. One model draws the still emblem (yaw 0) and the emblem turned (`frame`), so the 2D and the turning view
 // come from the same data. The silhouette is the profile at every yaw; the light, the handles, the grooves and the seams move to where `sin(yaw)` puts them, and are drawn back to front. Plain SVG.
 // Imports only the core.
-import { cylinderGradient, defsOf, hexOf, mainOf, mix, orbGradient, readColour, resolve, wrap, } from "./emblem.core.js";
+import { cylinderGradient, defsOf, hexOf, labelled, mainOf, mix, orbGradient, readColour, resolve, wrap, } from "./emblem.core.js";
+import { cylinderText, engravingInk, engravingOf, flatText, sideText } from "./emblem.engrave.js";
 const CX = 32;
 const RAD = Math.PI / 180;
 const f = (n) => String(Math.round(n * 10) / 10 + 0);
@@ -64,7 +65,7 @@ function piecesOf(p) {
 const arc = (y, r, s, toLeft) => `Q${pt(CX, y + 2 * r * s)} ${pt(CX + (toLeft ? -r : r), y)}`;
 const ellipse = (cx, cy, rx, ry, fill, extra = "") => `<ellipse cx="${f(cx)}" cy="${f(cy)}" rx="${f(rx)}" ry="${f(Math.max(ry, 0.25))}" fill="${fill}"${extra}/>`;
 /** The geometry and paint of one drawing of the model at a yaw and a pitch. */
-function draw(model, r, yaw, pitch) {
+function draw(model, r, o, yaw, pitch) {
     const line = r.style === "line";
     const flat = r.style === "color";
     const elevation = Math.max(0, Math.min(75, (model.tilt ?? 12) + pitch));
@@ -384,6 +385,26 @@ function draw(model, r, yaw, pitch) {
         }
         mid.push(...parts);
     }
+    // The engraving on the plinth: letters set round the body (or along one flat side), foreshortened and hidden as they turn away.
+    const plate = model.plate;
+    const words = plate === undefined ? "" : flatText(engravingOf(o));
+    if (plate !== undefined && words !== "") {
+        const y = (plate.y0 + plate.y1) / 2;
+        const solid = model.solids.find((q) => q.p[0][0] <= y && y <= q.p[q.p.length - 1][0]) ?? model.solids[0];
+        const radius = radiusAt(solid.p, y);
+        const ink = engravingInk(r.style, tone(plate.tone ?? solid.tone).rgb);
+        if (solid.sides === undefined)
+            mid.push(cylinderText(words, radius, plate.y1 - plate.y0, ink, yaw, plate.at ?? 0, (deg) => at(radius, y, deg)));
+        else {
+            const n = solid.sides;
+            const k = plate.face ?? 0;
+            const a0 = (360 * k) / n + yaw;
+            const a1 = (360 * (k + 1)) / n + yaw;
+            const [ax, ay] = at(radius, y, a0);
+            const [bx, by] = at(radius, y, a1);
+            mid.push(sideText(words, 2 * radius * Math.sin(Math.PI / n), plate.y1 - plate.y0, ink, [ax, ay], [bx, by], Math.cos(((a0 + a1) / 2) * RAD)));
+        }
+    }
     return { body: back.join("") + mid.join("") + front.join(""), defs: line || flat ? "" : defsOf(grads), edge: main.edge };
 }
 /** The twelve pentagons of a ball, as the centres of a sphere's faces: the poles and two rings of five. */
@@ -397,8 +418,9 @@ export function defineLathe(id, en, ja, source, model) {
         const r = resolve(o);
         const yaw = typeof o?.yaw === "number" && Number.isFinite(o.yaw) ? o.yaw % 360 : 0;
         const pitch = typeof o?.pitch === "number" && Number.isFinite(o.pitch) ? Math.max(-40, Math.min(60, o.pitch)) : 0;
-        const d = draw(model, r, yaw, pitch);
+        const d = draw(model, r, o, yaw, pitch);
         return wrap({ title: en, size: r.size, style: r.style, theme: r.theme, defs: d.defs, body: d.body, edge: d.edge, width: r.style === "line" ? 2.3 : 0.6 });
     };
-    return { id, en, ja, source, kind: "lathe", model, svg: (o) => frame(o), frame };
+    const still = labelled(en, ja, (o) => frame(o));
+    return { id, en, ja, source, kind: "lathe", model, svg: still, frame: labelled(en, ja, frame) };
 }

package/dist/emblems/emblem.medal.js

@@ -23,16 +23,16 @@ export function defineMedal(id, en, ja, metal) {
     const front = [
         ...ribbon(),
         ...disc,
-        ["m", starPath(32, 43, 9, 3.9)],
+        ["M", starPath(32, 43, 9, 3.9)],
         ["l", "M19.2 40a13.4 13.4 0 0 1 9.4-10.4 14 14 0 0 0-6.6 12.6z"],
     ];
-    const back = [...disc, ["e", circlePath(32, 43, 8.4), "1.4"]];
-    return defineFlat(id, en, ja, "ours", { metal, front, back, rim: 3 });
+    const back = [...disc, ["E", circlePath(32, 43, 8.4), "1.4"]];
+    return defineFlat(id, en, ja, "ours", { metal, front, back, rim: 3, engrave: { front: { x: 32, y: 43, w: 19, h: 15 }, back: { x: 32, y: 43, w: 20, h: 13 } } });
 }
 /** The numerals 1, 2 and 3 as strokes. */
 const NUMERALS = { 1: "M26 28l7-5v20", 2: "M25 28c1-9 15-9 15 0 0 6-14 9-15 15h16", 3: "M25 26c4-6 14-4 13 2-1 5-6 6-9 6 3 0 9 1 9 7 0 8-14 9-16 2" };
 /** A plain badge for a place: a bevelled disc with its numeral. */
 export function definePlace(id, en, ja, place, metal) {
     const base = [["o", circlePath(32, 32, 27.5)], ["e", circlePath(32, 32, 24.2), "2.2"]];
-    return defineFlat(id, en, ja, "ours", { metal, front: [...base, ["d", NUMERALS[place]], ["l", "M10.4 28a22 22 0 0 1 16.6-17 24 24 0 0 0-11 22z"]], back: [...base, ["e", circlePath(32, 32, 14), "1.6"]], rim: 3 });
+    return defineFlat(id, en, ja, "ours", { metal, front: [...base, ["D", NUMERALS[place]], ["l", "M10.4 28a22 22 0 0 1 16.6-17 24 24 0 0 0-11 22z"]], back: [...base, ["E", circlePath(32, 32, 14), "1.6"]], rim: 3, engrave: { front: { x: 32, y: 32, w: 30, h: 28 }, back: { x: 32, y: 32, w: 30, h: 20 }, rank: String(place) } });
 }

package/dist/emblems/emblem.pennant.d.ts

@@ -0,0 +1,3 @@
+import { type Emblem } from "./emblem.core.ts";
+/** A pennant: its front with the lettering, turned like a coin to its plain back. */
+export declare function definePennant(id: string, en: string, ja: string): Emblem<null>;

package/dist/emblems/emblem.pennant.js

@@ -0,0 +1,79 @@
+// A championship pennant: a long triangle of felt on a dowel, with an edge sewn in a second colour and the words and the year in felt letters. Drawn felt-flat in `metal` and `color` (the fibres are a
+// faint speckle, the `metal` style adds a soft light), and as one outline in `line`. Turned, it flips like a coin and shows its back, which is plain felt and the stitching, with the dowel on the other
+// side. Imports the core, the text widths of the engraving helpers and the coin-flip turn.
+import { degrees, escape, hexOf, mix, n2, readColour, resolve, wrap } from "./emblem.core.js";
+import { engravingOf, widthOf } from "./emblem.engrave.js";
+import { flipSvg } from "./emblem.flip.js";
+const FELT = "#8f1d2c";
+const CREAM = "#f4f0e4";
+const FONT = "system-ui,-apple-system,'Segoe UI','Hiragino Sans','Noto Sans JP','Yu Gothic',sans-serif";
+/** The felt: a wide left edge on the dowel, a point at the right, edges that sag a little. */
+const SHAPE = "M8 15Q34 22 60 32Q34 42 8 49Z";
+const STITCH = "M10.2 18Q34 24.6 55.6 32Q34 39.4 10.2 46Z";
+const ROD = "M4.6 11.5h3.4v41h-3.4z";
+/** The half height of the felt at x. */
+const half = (x) => 17 - ((x - 8) * 17) / 52;
+/** The lines of lettering, each as large as fits inside the triangle from the left edge: the main words, then the year. */
+function lettering(rows) {
+    if (rows.length === 0)
+        return [];
+    const x0 = 12.5;
+    for (let f = 11; f >= 0.8; f -= 0.2) {
+        const sizes = rows.map((_, i) => (i === 0 ? f : f * 0.55));
+        const total = sizes.reduce((sum, s) => sum + s * 1.12, 0);
+        let top = 32 - total / 2;
+        const placed = rows.map((t, i) => {
+            const size = sizes[i];
+            const y = top + size * 0.86;
+            top += size * 1.12;
+            return { text: t, x: x0, y, size, width: widthOf(t) * size };
+        });
+        const fits = placed.every((p) => {
+            const end = p.x + p.width;
+            const reach = half(end) - 3;
+            return end <= 56 && p.y - p.size * 0.8 >= 32 - reach && p.y + p.size * 0.04 <= 32 + reach;
+        });
+        if (fits)
+            return placed;
+    }
+    return rows.map((t, i) => ({ text: t, x: x0, y: 32 + i * 5, size: 2.2, width: widthOf(t) * 2.2 }));
+}
+/** One side of the pennant as a document. */
+function draw(title, o, back) {
+    const r = resolve(o);
+    const line = r.style === "line";
+    const felt = r.tint ?? readColour(FELT);
+    const trim = r.accent ?? CREAM;
+    const ink = hexOf(readColour(o?.numberColor) ?? readColour(trim));
+    // The lettering is the engraving of the options: the free text (one line a row) or the rank and label, then the year, in capitals.
+    const e = engravingOf(o);
+    const rows = [...(e.free !== undefined ? e.free.split("\n") : [[e.rank, e.label].filter((part) => part !== undefined).join(" ")]), e.year ?? ""].map((t) => t.toUpperCase()).filter((t) => t !== "");
+    const flatFelt = hexOf(felt);
+    const pid = `dgpf${flatFelt.slice(1)}`;
+    let body = `<g${back ? ' transform="translate(64 0) scale(-1 1)"' : ""}>`;
+    body += `<path d="${ROD}" fill="${line ? "none" : "#a8743c"}"/>`;
+    body += `<path d="${SHAPE}" fill="${line ? "none" : r.style === "metal" ? `url(#${pid})` : flatFelt}"/>`;
+    if (!line && r.style === "metal")
+        body += `<path d="${SHAPE}" fill="url(#dgsp)" stroke="none"/>`;
+    body += `<path d="${STITCH}" fill="none" stroke="${line ? "currentColor" : trim}" stroke-width="${line ? 1.2 : 0.7}" stroke-dasharray="1.9 1.5" stroke-linecap="butt"/>`;
+    const text = back ? [] : lettering(rows);
+    if (text.length > 0) {
+        body += `<g font-family="${FONT}" font-weight="800" fill="${line ? "currentColor" : ink}" stroke="none">${text
+            .map((t) => `<text x="${n2(t.x)}" y="${n2(t.y)}" font-size="${n2(t.size)}" textLength="${n2(t.width)}" lengthAdjust="spacingAndGlyphs">${escape(t.text)}</text>`)
+            .join("")}</g>`;
+    }
+    body += "</g>";
+    const defs = r.style !== "metal"
+        ? ""
+        : `<defs><pattern id="${pid}" width="2.4" height="2.4" patternUnits="userSpaceOnUse"><rect width="2.4" height="2.4" fill="${flatFelt}" stroke="none"/><circle cx=".6" cy=".7" r=".32" fill="#fff" fill-opacity=".14" stroke="none"/><circle cx="1.8" cy="1.6" r=".3" fill="#000" fill-opacity=".14" stroke="none"/></pattern><linearGradient id="dgsp" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#fff" stop-opacity=".22"/><stop offset=".5" stop-color="#fff" stop-opacity="0"/><stop offset="1" stop-color="#000" stop-opacity=".28"/></linearGradient></defs>`;
+    return wrap({ title, size: r.size, style: r.style, theme: r.theme, defs, body, edge: mix(felt, -0.5), width: 0.8 });
+}
+/** A pennant: its front with the lettering, turned like a coin to its plain back. */
+export function definePennant(id, en, ja) {
+    const svg = (o) => draw(en, o, o?.view === "back");
+    const frame = (o) => {
+        const back = o?.view === "back";
+        return flipSvg(draw(en, o, back), { yaw: degrees(o?.yaw), pitch: degrees(o?.pitch), line: o?.style === "line", back: draw(en, o, !back), thick: 0.016 });
+    };
+    return { id, en, ja, source: "ours", kind: "flat", model: null, svg, frame };
+}

package/dist/emblems/emblem.registry.js

@@ -23,6 +23,10 @@ import { TROPHY_PLAQUE } from "./trophy/plaque.js";
 import { TROPHY_BELT } from "./trophy/belt.js";
 import { TROPHY_LAUREL } from "./trophy/laurel.js";
 import { TROPHY_ROSETTE } from "./trophy/rosette.js";
+import { TROPHY_SUMO_CUP } from "./trophy/sumo-cup.js";
+import { TROPHY_CHAMPIONSHIP_BANNER } from "./trophy/championship-banner.js";
+import { TROPHY_RING } from "./trophy/ring.js";
+import { TROPHY_BANNER } from "./trophy/banner.js";
 import { MEDAL_GOLD } from "./medal/gold.js";
 import { MEDAL_SILVER } from "./medal/silver.js";
 import { MEDAL_BRONZE } from "./medal/bronze.js";
@@ -33,6 +37,7 @@ import { CREST_SHIELD } from "./crest/shield.js";
 import { CREST_ROUNDEL } from "./crest/roundel.js";
 import { CREST_DIAMOND } from "./crest/diamond.js";
 import { CREST_PENNANT } from "./crest/pennant.js";
+import { PENNANT_CHAMPIONSHIP } from "./pennant/championship.js";
 import { BALLS } from "./ball/ball.index.js";
 import { GEARS } from "./gear/gear.index.js";
 import { SPORT_NFL } from "./sport/nfl.js";
@@ -68,6 +73,11 @@ import { SPORT_FIELDHOCKEY } from "./sport/fieldhockey.js";
 import { SPORT_HANDBALL } from "./sport/handball.js";
 import { SPORT_ATHLETICS } from "./sport/athletics.js";
 import { SPORT_SKATING } from "./sport/skating.js";
+import { SPORT_SUMO } from "./sport/sumo.js";
+import { SPORT_KENDO } from "./sport/kendo.js";
+import { SPORT_JUDO } from "./sport/judo.js";
+import { SPORT_KYUDO } from "./sport/kyudo.js";
+import { SPORT_KARATE } from "./sport/karate.js";
 /** The balls and the gear are drawn by families, each family in a module of its own, and listed in order by their own indexes. */
 const PIECES = Object.fromEntries([...BALLS, ...GEARS].map((piece) => [piece.id, piece]));
 /** The emblems drawn one to a module: every id but the balls and the gear. A missing or extra entry is a type error. */
@@ -97,6 +107,10 @@ const OWN = {
     "trophy:belt": TROPHY_BELT,
     "trophy:laurel": TROPHY_LAUREL,
     "trophy:rosette": TROPHY_ROSETTE,
+    "trophy:sumo-cup": TROPHY_SUMO_CUP,
+    "trophy:championship-banner": TROPHY_CHAMPIONSHIP_BANNER,
+    "trophy:ring": TROPHY_RING,
+    "trophy:banner": TROPHY_BANNER,
     "medal:gold": MEDAL_GOLD,
     "medal:silver": MEDAL_SILVER,
     "medal:bronze": MEDAL_BRONZE,
@@ -107,6 +121,7 @@ const OWN = {
     "crest:roundel": CREST_ROUNDEL,
     "crest:diamond": CREST_DIAMOND,
     "crest:pennant": CREST_PENNANT,
+    "pennant:championship": PENNANT_CHAMPIONSHIP,
     "sport:nfl": SPORT_NFL,
     "sport:cfl": SPORT_CFL,
     "sport:ifaf": SPORT_IFAF,
@@ -140,6 +155,11 @@ const OWN = {
     "sport:handball": SPORT_HANDBALL,
     "sport:athletics": SPORT_ATHLETICS,
     "sport:skating": SPORT_SKATING,
+    "sport:sumo": SPORT_SUMO,
+    "sport:kendo": SPORT_KENDO,
+    "sport:judo": SPORT_JUDO,
+    "sport:kyudo": SPORT_KYUDO,
+    "sport:karate": SPORT_KARATE,
 };
 /** Every emblem, by id. */
 export const EMBLEM_TABLE = { ...OWN, ...PIECES };

package/dist/emblems/emblem.shapes.d.ts

@@ -1,10 +1,13 @@
 import { type Emblem, type EmblemSource, type Metal } from "./emblem.core.ts";
+import { type Plate } from "./emblem.engrave.ts";
 /**
  * What a shape is for. `m` the main metal, shaded across a sheet; `o` the main metal on a round, lit from a corner; `e` a bevelled ring (a line the width of the third item, bright on one side and dark on
  * the other); `s` its shade; `l` a glint (a fill with no outline, left out of the line style); `r` the second colour (a ribbon, a band: the `accent` option); `f` a fixed colour (the third item); `p` white
  * ink at a tenth; `k` ink; `n` an outline with no fill; `t` a thin line (a detail); `b` a bold line in ink (a limb, a shaft); `d` a bold line in a fixed dark colour (a numeral on a medal).
  */
-export type Role = "m" | "o" | "e" | "s" | "l" | "r" | "f" | "p" | "k" | "n" | "t" | "b" | "d";
+export type Role = DropRole | "m" | "o" | "e" | "s" | "l" | "r" | "f" | "p" | "k" | "n" | "t" | "b" | "d";
+/** A role in capitals is the same shape, left out of a face that is engraved (the star of a medal, the numeral of a place badge, the lines of a plaque). */
+type DropRole = "M" | "D" | "T" | "E";
 /** A path, its role, and for `f` its colour and for `e` its width. */
 export type Shape = readonly [Role, string, string?];
 /** A flat object or an icon. */
@@ -25,12 +28,19 @@ export interface FlatModel {
     ink?: boolean;
     /** Shapes drawn when there are no initials, for a crest (and only then). */
     blank?: readonly Shape[];
+    /** Where an engraving goes: the plate of the front (and of the year when a plate of its own holds it) and of the back, and the rank the front takes when it is engraved and none is given (a place badge's own place). */
+    engrave?: {
+        front: Plate;
+        year?: Plate;
+        back?: Plate;
+        rank?: string;
+    };
     /** Where a crest's letters go: the centre's x and y, and the size for one letter. */
     letters?: readonly [x: number, y: number, size: number];
 }
 /** A flat object (a medal, a crest, a plaque): drawn as it is by `svg`; turned about its vertical axis it flips like a coin and shows its back, with its rim for a moment edge on. */
 export declare function defineFlat(id: string, en: string, ja: string, source: EmblemSource, model: FlatModel): Emblem<FlatModel>;
-/** An icon: one drawing from shapes, which is not turned. */
+/** An icon: one drawing from shapes. Turned, it is a thin cut-out: it squeezes like a coin, shows its front mirrored and a little darker past a quarter turn, and has a dark rim. */
 export declare function defineIcon(id: string, en: string, ja: string, source: EmblemSource, model: FlatModel): Emblem<FlatModel>;
 /** A circle as a path, so every shape is one kind of thing. */
 export declare const circlePath: (cx: number, cy: number, r: number) => string;
@@ -38,3 +48,10 @@ export declare const circlePath: (cx: number, cy: number, r: number) => string;
 export declare const ellipsePath: (cx: number, cy: number, rx: number, ry: number) => string;
 /** A star as a path, one point up. */
 export declare function starPath(cx: number, cy: number, outer: number, inner: number, points?: number): string;
+/** A regular polygon of `n` sides with a corner at `deg` degrees (0 is straight up), as a path. */
+export declare function polygon(cx: number, cy: number, r: number, n: number, deg?: number): string;
+/** An ellipse turned `deg` degrees about its centre, as a path. */
+export declare function tiltedEllipse(cx: number, cy: number, rx: number, ry: number, deg: number): string;
+/** A bar with square ends from one point to another, `w` wide, as a path. */
+export declare function bar(x1: number, y1: number, x2: number, y2: number, w: number): string;
+export {};