@johnmorrisdotca/dougu-sports 0.1.0 → 0.2.0

package/dist/emblems/award/medal.d.ts

@@ -1,2 +1,2 @@
-/** Medal. */
-export declare const AWARD_MEDAL: import("../emblem.core.ts").Emblem<import("../emblem.material.ts").MaterialModel>;
+/** Medal on a ribbon. */
+export declare const AWARD_MEDAL: import("../emblem.core.ts").Emblem<import("../emblem.shapes.ts").FlatModel>;

package/dist/emblems/award/medal.js

@@ -1,5 +1,14 @@
-// Medal: the Material Symbols icon `military_tech` (Google, Apache License 2.0; see NOTICE.md), in metal, line and flat colour.
-import { M_MILITARY_TECH } from "../emblem.material.data.js";
-import { defineMaterial } from "../emblem.material.js";
-/** Medal. */
-export const AWARD_MEDAL = /* @__PURE__ */ defineMaterial("award:medal", "Medal", "メダル", M_MILITARY_TECH, "gold");
+// Medal: a ribbon with a notched end and a star hanging from it, drawn for this package, in metal, line and flat colour.
+import { defineIcon, starPath } from "../emblem.shapes.js";
+/** Medal on a ribbon. */
+export const AWARD_MEDAL = /* @__PURE__ */ defineIcon("award:medal", "Medal", "メダル", "ours", {
+    metal: "gold",
+    ribbon: "#c0392b",
+    front: [
+        ["r", "M21 3h22v26L32 23.4 21 29z"],
+        ["e", "M26 3v22M38 3v22", "1.4"],
+        ["m", "M32 27.4a2.6 2.6 0 1 1 0 5.2a2.6 2.6 0 1 1 0-5.2z"],
+        ["m", starPath(32, 46, 16.4, 7)],
+        ["l", "M32 34.6l3.4 8-9.4 1.4z"],
+    ],
+});

package/dist/emblems/award/shield.d.ts

@@ -1,2 +1,2 @@
 /** Shield. */
-export declare const AWARD_SHIELD: import("../emblem.core.ts").Emblem<import("../emblem.material.ts").MaterialModel>;
+export declare const AWARD_SHIELD: import("../emblem.core.ts").Emblem<import("../emblem.shapes.ts").FlatModel>;

package/dist/emblems/award/shield.js

@@ -1,5 +1,11 @@
-// Shield: the Material Symbols icon `shield` (Google, Apache License 2.0; see NOTICE.md), in metal, line and flat colour.
-import { M_SHIELD } from "../emblem.material.data.js";
-import { defineMaterial } from "../emblem.material.js";
+// Shield: a shield with a bevelled face, drawn for this package, in metal, line and flat colour.
+import { defineIcon } from "../emblem.shapes.js";
 /** Shield. */
-export const AWARD_SHIELD = /* @__PURE__ */ defineMaterial("award:shield", "Shield", "盾", M_SHIELD, "silver");
+export const AWARD_SHIELD = /* @__PURE__ */ defineIcon("award:shield", "Shield", "盾", "ours", {
+    metal: "silver",
+    front: [
+        ["m", "M32 4L10 12v18c0 14 9 25 22 30 13-5 22-16 22-30V12z"],
+        ["e", "M32 10.4L15.6 16.4V30c0 10.6 6.4 18.8 16.4 22.8 10-4 16.4-12.2 16.4-22.8V16.4z", "2"],
+        ["l", "M17 18l13-5v38C21 46 17 38 17 30z"],
+    ],
+});

package/dist/emblems/award/star.d.ts

@@ -1,2 +1,2 @@
 /** Star. */
-export declare const AWARD_STAR: import("../emblem.core.ts").Emblem<import("../emblem.material.ts").MaterialModel>;
+export declare const AWARD_STAR: import("../emblem.core.ts").Emblem<import("../emblem.shapes.ts").FlatModel>;

package/dist/emblems/award/star.js

@@ -1,5 +1,11 @@
-// Star: the Material Symbols icon `star` (Google, Apache License 2.0; see NOTICE.md), in metal, line and flat colour.
-import { M_STAR } from "../emblem.material.data.js";
-import { defineMaterial } from "../emblem.material.js";
+// Star: a five-pointed star with a bevelled face, drawn for this package, in metal, line and flat colour.
+import { defineIcon, starPath } from "../emblem.shapes.js";
 /** Star. */
-export const AWARD_STAR = /* @__PURE__ */ defineMaterial("award:star", "Star", "星", M_STAR, "gold");
+export const AWARD_STAR = /* @__PURE__ */ defineIcon("award:star", "Star", "星", "ours", {
+    metal: "gold",
+    front: [
+        ["m", starPath(32, 34, 29, 12.4)],
+        ["e", starPath(32, 35, 18.6, 7.8), "1.8"],
+        ["l", "M32 8.4l5 14.6-5 3.6-5-3.6z"],
+    ],
+});

package/dist/emblems/ball/ball.afl.js

@@ -6,7 +6,7 @@ import { mix } from "./ball.core.js";
 export const BALL_AFL = /* @__PURE__ */ defineBall({
     id: "ball:afl",
     en: "Australian football",
-    ja: "オーストラリアンフットボールのボール",
+    ja: "オージーボール",
     size: { extentMm: 280, lengthMm: 280, circumferenceMm: 550.0, longCircumferenceMm: 725.0, rule: "Laws of Australian Football 2026, Law 4 The Football, 4.1 Specifications", note: "The Laws give the two circumferences (720-730 mm and 545-555 mm) and no length: 280 mm is the length of an ellipse of those two girths." },
     spec: {
         axes: [1, 0.7, 0.7],

package/dist/emblems/ball/ball.basketball6.js

@@ -4,7 +4,7 @@ import { basketballSpec } from "./ball.basketball.js";
 export const BALL_BASKETBALL_6 = /* @__PURE__ */ defineBall({
     id: "ball:basketball-6",
     en: "Basketball, size 6",
-    ja: "バスケットボール（6号球）",
+    ja: "バスケットボール6号球",
     size: { extentMm: 230.0, diameterMm: 230.0, circumferenceMm: 722.5, massG: [510, 550], rule: "FIBA Basketball Equipment 2026, Rule 2 Basketballs, 2.4 and Table 1 (size 6 = women's competitions)", note: "Diameter worked out from the middle of the circumference range." },
     spec: basketballSpec("#e57a26"),
 });

package/dist/emblems/ball/ball.core.d.ts

@@ -14,6 +14,10 @@ export interface PieceOptions {
     accent?: string;
     /** Force the grain on or off. By default it is on for a colour ball of 48 pixels or more that is not turning. */
     grain?: boolean;
+    /** The language of the `<title>`: `"en"` (the default) or `"ja"`. */
+    locale?: "en" | "ja";
+    /** A string is the `<title>` (escaped); `false` drops it and marks the drawing `aria-hidden="true"`. */
+    title?: string | false;
 }
 /** A turn: `yaw` degrees about the vertical axis (0 is the default view), `pitch` the tilt toward you, `roll` the turn about the line of sight. */
 export interface BallFrameOptions extends PieceOptions {
@@ -22,8 +26,8 @@ export interface BallFrameOptions extends PieceOptions {
     roll?: number;
 }
 /** Where a drawing comes from. */
-export type PieceSource = "generated" | "drawn" | "noto" | "mdi" | "commons" | "gameicons";
-/** `ball` is turned in 3D; `gear` is a flat drawing in a colour and a line style. */
+export type PieceSource = "generated" | "drawn";
+/** `ball` is turned in 3D; `gear` is a flat drawing in a metal, a colour and a line style, which flips like a coin when turned. */
 export type PieceKind = "ball" | "gear";
 /** The official size of a ball or an implement, from the rulebook that governs it. Lengths in millimetres, mass in grams. */
 export interface PieceSize {
@@ -57,7 +61,7 @@ export interface Piece<Model = unknown> {
     readonly size?: PieceSize;
     /** The still drawing: a document of SVG. */
     svg: (options?: PieceOptions) => string;
-    /** The piece turned (a ball in 3D; gear is drawn as it is). */
+    /** The piece turned: a ball in 3D, gear flipped like a coin. */
     frame: (options?: BallFrameOptions) => string;
 }
 type Rgb = readonly [number, number, number];
@@ -98,6 +102,8 @@ export declare function wrapPiece(o: {
     box?: string;
     desc?: string;
 }): string;
+/** A piece's drawing function, with the `<title>` its options ask for: the Japanese name, a title of the caller's own, or none (the same rule as the emblems', in emblem.core.ts). */
+export declare const labelled: <O extends PieceOptions>(en: string, ja: string, draw: (options?: O) => string) => (options?: O) => string;
 /** Degrees to radians, for a value that may be missing or not a number. */
 export declare const radians: (degrees: number | undefined, fallback: number) => number;
 /** The definition of the grain filter: noise lit from the upper left and multiplied into what it is applied to. It works in the box's own units, so the grain stays where it is while a ball turns. */

package/dist/emblems/ball/ball.core.js

@@ -58,6 +58,19 @@ export function wrapPiece(o) {
     return (`<svg xmlns="http://www.w3.org/2000/svg" viewBox="${o.box ?? "0 0 100 100"}" width="${o.size}" height="${o.size}" role="img"${colour === "" ? "" : ` color="${colour}"`}>` +
         `<title>${escape(o.title)}</title>${o.desc === undefined ? "" : `<desc>${escape(o.desc)}</desc>`}${auto}${o.defs === undefined || o.defs === "" ? "" : `<defs>${o.defs}</defs>`}${o.body}</svg>`);
 }
+/** A piece's drawing function, with the `<title>` its options ask for: the Japanese name, a title of the caller's own, or none (the same rule as the emblems', in emblem.core.ts). */
+export const labelled = (en, ja, draw) => (options) => {
+    const svg = draw(options);
+    const title = options?.title;
+    const custom = typeof title === "string" && title.trim() !== "";
+    if (title === false)
+        return svg.replace(/<title>[^<]*<\/title>/, "").replace(' role="img"', ' aria-hidden="true"');
+    if (!custom && options?.locale !== "ja")
+        return svg;
+    const text = custom ? title.trim().slice(0, 300) : ja;
+    const titled = svg.replace(/<title>[^<]*<\/title>/, () => `<title>${escape(text)}</title>`);
+    return custom ? titled : titled.replace(' role="img"', ' role="img" lang="ja"');
+};
 /** Degrees to radians, for a value that may be missing or not a number. */
 export const radians = (degrees, fallback) => ((typeof degrees === "number" && Number.isFinite(degrees) ? degrees : fallback) * Math.PI) / 180;
 /** The definition of the grain filter: noise lit from the upper left and multiplied into what it is applied to. It works in the box's own units, so the grain stays where it is while a ball turns. */

package/dist/emblems/ball/ball.cricket.js

@@ -28,4 +28,4 @@ function cricket(id, en, ja, base, thread, size, shade) {
 const SIZE = { extentMm: 72.1, diameterMm: 72.1, circumferenceMm: 226.5, massG: [156, 163], rule: "Laws of Cricket, Law 4 The Ball, 4.1 Weight and size (Size 1, Size 2, Size 3)", note: "Size 1 (men's). Diameter worked out from the middle of the circumference range. The Laws do not set a colour." };
 export const BALL_CRICKET_RED = /* @__PURE__ */ cricket("ball:cricket-red", "Cricket ball, red", "クリケットボール（赤）", "#a9161e", "#f2e8d2", SIZE, "#2a0408");
 export const BALL_CRICKET_WHITE = /* @__PURE__ */ cricket("ball:cricket-white", "Cricket ball, white", "クリケットボール（白）", "#f3f0e8", "#2a2a2a", SIZE, "#4a4a58");
-export const BALL_CRICKET_PINK = /* @__PURE__ */ cricket("ball:cricket-pink", "Cricket ball, pink", "クリケットボール（ピンク）", "#e45a8c", "#2a2a2a", SIZE, "#4a0a22");
+export const BALL_CRICKET_PINK = /* @__PURE__ */ cricket("ball:cricket-pink", "Cricket ball, pink", "ピンクのクリケット球", "#e45a8c", "#2a2a2a", SIZE, "#4a0a22");

package/dist/emblems/ball/ball.engine.js

@@ -1,7 +1,7 @@
 // The ball renderer: one procedural engine for every sphere and every prolate ball. A ball is drawn in true 3D: a rotation, an orthographic projection, back faces dropped, panels cut at the limb
 // along the limb itself, then radial-gradient shading and a grain that stays where it is while the ball turns. A ball is a `BallSpec`: its shape (the semi-axes of an ellipsoid), its
 // view, its material and a `draw` function that lays panels, seams and dots on the unit sphere; the engine does the rest.
-import { grainDef, escape, hashOf, mix, num, radians, resolveOptions, wrapPiece } from "./ball.core.js";
+import { grainDef, escape, hashOf, labelled, mix, num, radians, resolveOptions, wrapPiece } from "./ball.core.js";
 import { add, apply, basis, cross, dot, ellipseOf, len, mul, norm, rotation, sampleRing, sub } from "./ball.math.js";
 const EPS = 1e-6;
 const STEP = Math.PI / 18;
@@ -336,7 +336,7 @@ export function defineBall(def) {
         kind: "ball",
         model: def.spec,
         size: def.size,
-        svg: (o) => render(o, false),
-        frame: (o) => render(o, true),
+        svg: labelled(def.en, def.ja, (o) => render(o, false)),
+        frame: labelled(def.en, def.ja, (o) => render(o, true)),
     };
 }

package/dist/emblems/ball/ball.football.js

@@ -46,6 +46,6 @@ function football(id, en, ja, size, stripes, colour) {
     });
 }
 const SIZE = { extentMm: 282.6, lengthMm: 282.6, circumferenceMm: 536.58, longCircumferenceMm: 717.55, massG: [396.89, 425.24], rule: "NFL Rulebook, Rule 2 The Ball, Section 1 (Dimensions)" };
-export const BALL_FOOTBALL = /* @__PURE__ */ football("ball:football", "Football (NFL)", "アメリカンフットボールのボール（NFL）", SIZE, "none", BROWN);
-export const BALL_FOOTBALL_CFL = /* @__PURE__ */ football("ball:football-cfl", "Football (CFL)", "カナディアンフットボールのボール（CFL）", { extentMm: 282.6, lengthMm: 282.6, circumferenceMm: 536.58, longCircumferenceMm: 717.55, massG: [396.89, 425.24], rule: "CFL Official Playing Rules, Rule 1 Conduct of the Game, Section 2 The Ball" }, "ring", BROWN);
-export const BALL_FOOTBALL_IFAF = /* @__PURE__ */ football("ball:football-ifaf", "Football (IFAF)", "アメリカンフットボールのボール（IFAF）", { extentMm: 283.4, lengthMm: 283.4, circumferenceMm: 533.4, longCircumferenceMm: 714.38, massG: [396.89, 425.24], rule: "IFAF Football Rules and Interpretations 2026, Rule 1 (The Game, Field, Players and Equipment), Section 3 The Ball, Article 1 a-i", note: "The IFAF figures are in a diagram of the rules, read from the rendered page." }, "top", "#a8693a");
+export const BALL_FOOTBALL = /* @__PURE__ */ football("ball:football", "Football (NFL)", "アメフトボール（NFL）", SIZE, "none", BROWN);
+export const BALL_FOOTBALL_CFL = /* @__PURE__ */ football("ball:football-cfl", "Football (CFL)", "フットボール（CFL）", { extentMm: 282.6, lengthMm: 282.6, circumferenceMm: 536.58, longCircumferenceMm: 717.55, massG: [396.89, 425.24], rule: "CFL Official Playing Rules, Rule 1 Conduct of the Game, Section 2 The Ball" }, "ring", BROWN);
+export const BALL_FOOTBALL_IFAF = /* @__PURE__ */ football("ball:football-ifaf", "Football (IFAF)", "アメフトボール（IFAF）", { extentMm: 283.4, lengthMm: 283.4, circumferenceMm: 533.4, longCircumferenceMm: 714.38, massG: [396.89, 425.24], rule: "IFAF Football Rules and Interpretations 2026, Rule 1 (The Game, Field, Players and Equipment), Section 3 The Ball, Article 1 a-i", note: "The IFAF figures are in a diagram of the rules, read from the rendered page." }, "top", "#a8693a");

package/dist/emblems/ball/ball.gaelic.js

@@ -5,7 +5,7 @@ import { strips18 } from "./ball.family.panelled.js";
 export const BALL_GAELIC_FOOTBALL = /* @__PURE__ */ defineBall({
     id: "ball:gaelic-football",
     en: "Gaelic football",
-    ja: "ゲーリックフットボールのボール",
+    ja: "ゲーリックフットボール",
     size: { extentMm: 219.6, diameterMm: 219.6, circumferenceMm: 690.0, massG: [480, 500], rule: "GAA Official Guide Part 2, Rules of Specification, Rule 4.4(ii)", note: "Diameter worked out from the middle of the circumference range." },
     spec: {
         view: { yaw: 28, pitch: 22, roll: 0 },

package/dist/emblems/ball/ball.object.js

@@ -1,5 +1,5 @@
 // Objects that are not an ellipsoid: a puck, a stone, a shuttlecock. They share what a ball has (the rotation, the options, the shading palette and the `Piece` shape) and draw their own geometry.
-import { escape, hashOf, radians, resolveOptions, wrapPiece } from "./ball.core.js";
+import { escape, hashOf, labelled, radians, resolveOptions, wrapPiece } from "./ball.core.js";
 import { apply, rotation } from "./ball.math.js";
 const finite = (v) => (typeof v === "number" && Number.isFinite(v) ? v : 0);
 export function defineObject(def) {
@@ -16,5 +16,5 @@ export function defineObject(def) {
         const { defs, body } = def.draw({ rot, opts, turning, id, minWidth: 80 / opts.size, at });
         return wrapPiece({ title: escape(def.en), size: opts.size, theme: opts.theme, defs, body });
     };
-    return { id: def.id, en: def.en, ja: def.ja, source: "generated", kind: "ball", model: def.model, size: def.size, svg: (o) => render(o, false), frame: (o) => render(o, true) };
+    return { id: def.id, en: def.en, ja: def.ja, source: "generated", kind: "ball", model: def.model, size: def.size, svg: labelled(def.en, def.ja, (o) => render(o, false)), frame: labelled(def.en, def.ja, (o) => render(o, true)) };
 }

package/dist/emblems/ball/ball.shuttlecock.js

@@ -72,7 +72,7 @@ const VIEW = { yaw: 0, pitch: 22, roll: -32 };
 export const BALL_SHUTTLECOCK_FEATHER = /* @__PURE__ */ defineObject({
     id: "ball:shuttlecock-feather",
     en: "Shuttlecock, feather",
-    ja: "シャトルコック（水鳥の羽根）",
+    ja: "水鳥シャトル",
     size: { extentMm: 150, diameterMm: 63, lengthMm: 66, massG: [4.74, 5.5], rule: "BWF Laws of Badminton, Law 2 Shuttle (2.1 general, 2.2 Feathered shuttle 2.2.1-2.2.6, 2.3 Non-feathered shuttle, 2.4 modifications) and Laws 3 Testing a shuttle for speed", note: "62 to 70 mm long with the tips on a circle 58 to 68 mm across, on a base 25 to 28 mm across; the box is drawn at the scale of the shuttlecock, which fills a part of it." },
     view: VIEW,
     scale: 0.43,
@@ -83,7 +83,7 @@ export const BALL_SHUTTLECOCK_FEATHER = /* @__PURE__ */ defineObject({
 export const BALL_SHUTTLECOCK_NYLON = /* @__PURE__ */ defineObject({
     id: "ball:shuttlecock-nylon",
     en: "Shuttlecock, nylon",
-    ja: "シャトルコック（ナイロン）",
+    ja: "ナイロンシャトル",
     size: { extentMm: 150, diameterMm: 63, lengthMm: 66, massG: [4.74, 5.5], rule: "BWF Laws of Badminton, Law 2 Shuttle (2.1 general, 2.2 Feathered shuttle 2.2.1-2.2.6, 2.3 Non-feathered shuttle, 2.4 modifications) and Laws 3 Testing a shuttle for speed", note: "A non-feathered shuttle follows the same measures, with a tolerance of 10 per cent (Law 2.3); the box is drawn at the scale of the shuttlecock, which fills a part of it." },
     view: VIEW,
     scale: 0.43,

package/dist/emblems/ball/ball.squash.js

@@ -20,8 +20,8 @@ function squash(id, en, ja, colour, count, size) {
     });
 }
 const SIZE = { extentMm: 40.0, diameterMm: 40.0, massG: [23.0, 25.0], rule: "World Squash 'Specifications for Squash Balls' (Recommended standards approved by the WSF; updated WSF AGM 2021, rebranded 2025), sections 1-3 and Notes 2-4", note: "Size and weight are set for the double yellow, yellow and green dot balls; the red and blue dot balls carry no limits in the specification." };
-export const BALL_SQUASH_DOUBLE_YELLOW = /* @__PURE__ */ squash("ball:squash", "Squash ball, double yellow dot", "スカッシュボール（ダブルイエロードット）", "#f4d41c", 2, SIZE);
-export const BALL_SQUASH_YELLOW = /* @__PURE__ */ squash("ball:squash-yellow", "Squash ball, yellow dot", "スカッシュボール（イエロードット）", "#f4d41c", 1, SIZE);
-export const BALL_SQUASH_RED = /* @__PURE__ */ squash("ball:squash-red", "Squash ball, red dot", "スカッシュボール（レッドドット）", "#d9262c", 1, SIZE);
-export const BALL_SQUASH_BLUE = /* @__PURE__ */ squash("ball:squash-blue", "Squash ball, blue dot", "スカッシュボール（ブルードット）", "#2b6fd6", 1, SIZE);
-export const BALL_SQUASH_GREEN = /* @__PURE__ */ squash("ball:squash-green", "Squash ball, green dot", "スカッシュボール（グリーンドット）", "#2aa84a", 1, SIZE);
+export const BALL_SQUASH_DOUBLE_YELLOW = /* @__PURE__ */ squash("ball:squash", "Squash ball, 2 yellow dots", "スカッシュ球（ダブルイエロー）", "#f4d41c", 2, SIZE);
+export const BALL_SQUASH_YELLOW = /* @__PURE__ */ squash("ball:squash-yellow", "Squash ball, yellow dot", "スカッシュ球（黄色）", "#f4d41c", 1, SIZE);
+export const BALL_SQUASH_RED = /* @__PURE__ */ squash("ball:squash-red", "Squash ball, red dot", "スカッシュ球（赤）", "#d9262c", 1, SIZE);
+export const BALL_SQUASH_BLUE = /* @__PURE__ */ squash("ball:squash-blue", "Squash ball, blue dot", "スカッシュ球（青）", "#2b6fd6", 1, SIZE);
+export const BALL_SQUASH_GREEN = /* @__PURE__ */ squash("ball:squash-green", "Squash ball, green dot", "スカッシュ球（緑）", "#2aa84a", 1, SIZE);

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

@@ -1,6 +1,7 @@
-import type { Emblem, EmblemOptions, EmblemStyle, EmblemTheme, FrameOptions } from "./emblem.core.ts";
+import type { Emblem, EmblemLocale, EmblemOptions, EmblemStyle, EmblemTheme, FrameOptions } from "./emblem.core.ts";
 import { type BallId, type CrestShape, type EmblemId, type MedalKind, type SportName } from "./emblem.ids.ts";
 import type { PieceSize } from "./ball/ball.core.ts";
+import { type EmblemDescription } from "./emblem.descriptions.ts";
 /** What can name an emblem: an id, a short name (`"cup"` for `"trophy:cup"`), either with a style (`"trophy:cup/line"`), or the emblem itself. */
 export type EmblemRef = EmblemId | `${EmblemId}/${EmblemStyle}` | (string & {}) | Emblem;
 /** The id and style a string names, or `undefined` when it is not an emblem. An id may end in `/metal`, `/line` or `/color`, and a trophy or an award may be written without its group (`cup`, `crown`). */
@@ -54,6 +55,8 @@ export interface EmblemInfo {
     kind: Emblem["kind"];
     /** A ball's or an implement's official size, with the rule it is from, where the rulebook gives one. */
     size?: PieceSize;
+    /** What is drawn, in more words than the short name (which is the accessible name), for the docs and a gallery; not every emblem has one. */
+    description?: EmblemDescription;
 }
 /** The names, source and kind of an emblem. */
 export declare function emblemInfo(id: EmblemId): EmblemInfo;
@@ -72,6 +75,10 @@ export interface CrestOptions {
     size?: number;
     style?: EmblemStyle;
     theme?: EmblemTheme;
+    /** The language of the `<title>`, `"en"` (the default) or `"ja"`. */
+    locale?: EmblemLocale;
+    /** A string is the `<title>`; `false` drops it and hides the drawing from a screen reader. */
+    title?: string | false;
 }
 /**
  * A generic crest tinted by a team's colours, with its letters if it has any: what a team with no logo gets. The letters are in the ink that reads on the colour.
@@ -88,3 +95,34 @@ export declare function crest(options?: CrestOptions): string;
 export declare function medal(kind: MedalKind, options?: EmblemOptions): string;
 /** The icon of a sport, by the names of `SPORT_NAMES`: `sportIcon("nhl")`. An unknown sport is an error. */
 export declare function sportIcon(sport: SportName, options?: EmblemOptions): string;
+/** What `pennant` takes. */
+export interface PennantOptions {
+    /** The felt, the stitching, and the lettering (the stitching's colour unless a third is given), as hex colours or `rgb()`. */
+    colors?: string | readonly [felt?: string, stitching?: string, lettering?: string];
+    /** The words, in capitals ("Champions", "優勝"); more than one line with line breaks. The engraving options `label`, `rank` and `year` work too. */
+    text?: string;
+    /** The label and rank, as for any engraving: ignored when `text` is given. */
+    label?: string;
+    rank?: number | string;
+    /** The year, in smaller letters under the words. */
+    year?: number | string;
+    /** `"front"` (the default) or `"back"`: plain felt, with the dowel on the other side. */
+    view?: "front" | "back";
+    size?: number;
+    style?: EmblemStyle;
+    theme?: EmblemTheme;
+    /** A turn from the resting view, in degrees. */
+    yaw?: number;
+    pitch?: number;
+}
+/**
+ * A felt championship pennant with a stitched edge, lettered with its words and its year.
+ * @example
+ * ```ts
+ * import { pennant } from "@johnmorrisdotca/dougu-sports/emblems";
+ * const svg = pennant({ colors: ["#1f4e8c", "#f2c230"], text: "Champions", year: 2026 });
+ * console.log(svg.includes(">CHAMPIONS<"), svg.includes(">2026<"));
+ * // true true
+ * ```
+ */
+export declare function pennant(options?: PennantOptions): string;

package/dist/emblems/emblem.api.js

@@ -1,5 +1,6 @@
 import { EMBLEM_STYLES } from "./emblem.core.js";
 import { BALL_IDS, CREST_SHAPES, EMBLEM_ALIASES, EMBLEM_IDS } from "./emblem.ids.js";
+import { EMBLEM_DESCRIPTIONS } from "./emblem.descriptions.js";
 import { EMBLEM_TABLE } from "./emblem.registry.js";
 /** The id and style a string names, or `undefined` when it is not an emblem. An id may end in `/metal`, `/line` or `/color`, and a trophy or an award may be written without its group (`cup`, `crown`). */
 export function parseEmblem(value) {
@@ -78,7 +79,8 @@ export const EMBLEMS = Object.freeze(Object.fromEntries(EMBLEM_IDS.map((id) => [
 export function emblemInfo(id) {
     const e = EMBLEM_TABLE[id];
     const size = e.size;
-    return size === undefined ? { id, en: e.en, ja: e.ja, source: e.source, kind: e.kind } : { id, en: e.en, ja: e.ja, source: e.source, kind: e.kind, size };
+    const description = EMBLEM_DESCRIPTIONS[id];
+    return { id, en: e.en, ja: e.ja, source: e.source, kind: e.kind, ...(size === undefined ? {} : { size }), ...(description === undefined ? {} : { description }) };
 }
 /** An emblem's name in a language. */
 export function emblemName(id, language = "en") {
@@ -101,7 +103,7 @@ export function emblemModel(id) {
 export function crest(options = {}) {
     const colors = typeof options.colors === "string" ? [options.colors] : (options.colors ?? []);
     const shape = CREST_SHAPES.includes(options.shape) ? options.shape : "shield";
-    return EMBLEM_TABLE[`crest:${shape}`].svg({ tint: colors[0], accent: colors[1], initials: options.initials, size: options.size, style: options.style, theme: options.theme });
+    return EMBLEM_TABLE[`crest:${shape}`].svg({ tint: colors[0], accent: colors[1], initials: options.initials, size: options.size, style: options.style, theme: options.theme, locale: options.locale, title: options.title });
 }
 /** A medal on a ribbon: `medal("gold")`, `"silver"` or `"bronze"`; any other kind is the gold one. */
 export function medal(kind, options) {
@@ -114,3 +116,19 @@ export function sportIcon(sport, options) {
         throw new Error(`Unknown sport "${String(sport).slice(0, 40)}": the icons are for the names in SPORT_NAMES.`);
     return e.svg(options);
 }
+/**
+ * A felt championship pennant with a stitched edge, lettered with its words and its year.
+ * @example
+ * ```ts
+ * import { pennant } from "@johnmorrisdotca/dougu-sports/emblems";
+ * const svg = pennant({ colors: ["#1f4e8c", "#f2c230"], text: "Champions", year: 2026 });
+ * console.log(svg.includes(">CHAMPIONS<"), svg.includes(">2026<"));
+ * // true true
+ * ```
+ */
+export function pennant(options = {}) {
+    const colors = typeof options.colors === "string" ? [options.colors] : (options.colors ?? []);
+    const o = { tint: colors[0], accent: colors[1], numberColor: colors[2], engrave: options.text, label: options.label, rank: options.rank, year: options.year, view: options.view, size: options.size, style: options.style, theme: options.theme, yaw: options.yaw, pitch: options.pitch };
+    const e = EMBLEM_TABLE["pennant:championship"];
+    return options.yaw === undefined && options.pitch === undefined ? e.svg(o) : e.frame(o);
+}

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

@@ -0,0 +1,31 @@
+/** An emblem's document taken apart. */
+export interface Parts {
+    /** The view box, `0 0 64 64` unless the drawing came from elsewhere. */
+    box: string;
+    /** The definitions, one string for each top-level element of the `<defs>` (a gradient, a clip path, a filter), with the id it carries. */
+    defs: readonly {
+        id: string;
+        text: string;
+    }[];
+    /** Everything that draws: the body, with the `<title>`, `<style>` and `<defs>` taken out. A `<desc>` stays, because it carries the credit of copied art. */
+    body: string;
+}
+/** Takes an emblem's document apart. */
+export declare function partsOf(svg: string): Parts;
+/**
+ * Documents put together: the definitions of all of them in one list with none twice, and every id renamed so that two different definitions never share one. With a `prefix` the ids are the prefix and a short
+ * counter, so a sheet's ids cannot meet the page's own; with none an id keeps its name until a different definition wants it.
+ */
+export declare class IdSpace {
+    private readonly named;
+    private readonly taken;
+    private readonly prefix;
+    private count;
+    readonly defs: string[];
+    constructor(prefix?: string);
+    private fresh;
+    /** Takes one document's parts in: its definitions join the list, and its body comes back with the ids it uses. */
+    add(parts: Parts): string;
+}
+/** A document nested inside another: its box becomes the place the parent gives it. */
+export declare function nest(box: string, body: string, x: number, y: number, width: number, height: number): string;

package/dist/emblems/emblem.compose.js

@@ -0,0 +1,91 @@
+// The pieces that the sprite, the podium and the award case share: an emblem's document taken apart (its view box, its definitions, its body), and put together again inside another document with
+// every id unique. The emblems are written by this package, so the parts are found by their shape, not by a general XML parser.
+/** The top-level elements of a run of markup, each with its `id` attribute (an empty string when it has none). */
+function topLevel(markup) {
+    const out = [];
+    const tag = /<(\/?)[A-Za-z][\w:-]*[^>]*?(\/?)>/g;
+    let depth = 0;
+    let start = 0;
+    for (let m = tag.exec(markup); m !== null; m = tag.exec(markup)) {
+        if (m[1] === "/") {
+            depth--;
+            if (depth === 0)
+                out.push({ id: "", text: markup.slice(start, m.index + m[0].length) });
+        }
+        else if (m[2] === "/") {
+            if (depth === 0)
+                out.push({ id: "", text: m[0] });
+        }
+        else {
+            if (depth === 0)
+                start = m.index;
+            depth++;
+        }
+    }
+    return out.map((e) => ({ id: /\sid="([^"]*)"/.exec(e.text)?.[1] ?? "", text: e.text }));
+}
+/** Takes an emblem's document apart. */
+export function partsOf(svg) {
+    const open = /^<svg\s[^>]*>/.exec(svg);
+    const box = (open === null ? undefined : /\sviewBox="([^"]+)"/.exec(open[0])?.[1]) ?? "0 0 64 64";
+    let inner = open === null ? svg : svg.slice(open[0].length, svg.lastIndexOf("</svg>"));
+    inner = inner.replace(/<title>[^<]*<\/title>/, "").replace(/<style>[^<]*<\/style>/, "");
+    const defs = [];
+    inner = inner.replace(/<defs>([\s\S]*?)<\/defs>/g, (_, content) => {
+        defs.push(...topLevel(content));
+        return "";
+    });
+    return { box, defs, body: inner };
+}
+/** The ids a document of ours refers to: `id="x"`, `url(#x)` and `href="#x"`. */
+const REFERENCE = /(\sid="|url\(#|href="#)([^")]+)/g;
+/**
+ * Documents put together: the definitions of all of them in one list with none twice, and every id renamed so that two different definitions never share one. With a `prefix` the ids are the prefix and a short
+ * counter, so a sheet's ids cannot meet the page's own; with none an id keeps its name until a different definition wants it.
+ */
+export class IdSpace {
+    named = new Map();
+    taken = new Set();
+    prefix;
+    count = 0;
+    defs = [];
+    constructor(prefix = "") {
+        this.prefix = prefix;
+    }
+    fresh(id) {
+        if (this.prefix === "") {
+            let candidate = id;
+            while (this.taken.has(candidate))
+                candidate = `${id}-${(++this.count).toString(36)}`;
+            return candidate;
+        }
+        return `${this.prefix}_${(this.count++).toString(36)}`;
+    }
+    /** Takes one document's parts in: its definitions join the list, and its body comes back with the ids it uses. */
+    add(parts) {
+        const rename = new Map();
+        const added = [];
+        for (const def of parts.defs) {
+            if (def.id === "")
+                continue;
+            const key = `${def.id}\u0000${def.text}`;
+            let name = this.named.get(key);
+            if (name === undefined) {
+                name = this.fresh(def.id);
+                this.taken.add(name);
+                this.named.set(key, name);
+                added.push(def.text);
+            }
+            rename.set(def.id, name);
+        }
+        const apply = (text) => text.replace(REFERENCE, (all, lead, id) => (rename.has(id) ? `${lead}${rename.get(id)}` : all));
+        for (const text of added)
+            this.defs.push(apply(text));
+        return apply(parts.body);
+    }
+}
+/** A document nested inside another: its box becomes the place the parent gives it. */
+export function nest(box, body, x, y, width, height) {
+    const n = (v) => String(Math.round(v * 100) / 100 + 0);
+    return `<svg x="${n(x)}" y="${n(y)}" width="${n(width)}" height="${n(height)}" viewBox="${box}">${body}</svg>`;
+}

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

@@ -6,6 +6,8 @@ export declare const EMBLEM_STYLES: readonly ["metal", "line", "color"];
  * one, for an image (an `<img>`, a data address) that cannot inherit. `light` and `dark` force one.
  */
 export type EmblemTheme = "inherit" | "auto" | "light" | "dark";
+/** The languages an emblem's `<title>` can be written in. */
+export type EmblemLocale = "en" | "ja";
 export interface EmblemOptions {
     /** `metal` (the default), `line` or `color`. */
     style?: EmblemStyle;
@@ -21,6 +23,27 @@ export interface EmblemOptions {
     initials?: string;
     /** A ball: force the grain of its surface on or off. By default it is on for a ball of 48 pixels or more that is not turning. */
     grain?: boolean;
+    /** The language of the `<title>`: `"en"` (the default) or `"ja"`, from the emblem's English or Japanese name. */
+    locale?: EmblemLocale;
+    /** The `<title>`: a string writes that title (escaped); `false` drops it and marks the drawing `aria-hidden="true"`, for an emblem that sits beside text that says the same. */
+    title?: string | false;
+    /**
+     * Text cut into the face of a medal or place badge, the plaque, the belt, and the plinth of a cup: any text, Japanese included, up to three lines (a line break, or a space between a word and a year, makes lines).
+     * It wins over `label`, `year` and `rank`.
+     */
+    engrave?: string;
+    /** The words to engrave ("MVP"), with `year` and `rank` as lines of their own. Ignored when `engrave` is given. */
+    label?: string;
+    /** A year, engraved small under the label (on a plaque, on its nameplate). A number or a string. */
+    year?: number | string;
+    /** A place or a number, engraved large ("1"). On a place badge it is the badge's own place unless given. */
+    rank?: number | string;
+    /** The engraving of a medal's back, shown when it is turned over. Without it the back is plain. */
+    engraveBack?: string;
+    /** The colour of a pennant's lettering when it is not the second colour. A hex colour or `rgb()`. */
+    numberColor?: string;
+    /** Which side of a pennant is drawn at rest: `"front"` (the default) or `"back"`. */
+    view?: "front" | "back";
 }
 /** A turn, in degrees from the resting view (0 and 0 is the still drawing): `yaw` about the vertical axis, `pitch` the tilt toward the eye. */
 export interface FrameOptions extends EmblemOptions {
@@ -46,8 +69,8 @@ export declare const METALS: {
 };
 /** A metal by name, or `flat` for a colour that is no metal (a crest's blue, a sport's plain ink). */
 export type Metal = keyof typeof METALS | "flat";
-/** Where an emblem's art comes from: drawn for this package (`ours`) or taken from a source listed in NOTICE.md. */
-export type EmblemSource = "ours" | "material" | "generated" | "drawn" | "noto" | "mdi" | "commons" | "gameicons";
+/** Where an emblem's art comes from: drawn for this package (`ours`, `drawn`) or made by this package's own code (`generated`). Nothing is copied from another project. */
+export type EmblemSource = "ours" | "generated" | "drawn";
 /** What an emblem is: a flat object (a front and a back, to flip), a ball (a sphere or a solid, turned in 3D), a body of revolution (`lathe`), an icon (one drawing, not turned) or a piece of gear (a flat drawing, not turned). */
 export type EmblemKind = "flat" | "ball" | "lathe" | "icon" | "gear";
 export type Rgb = readonly [number, number, number];
@@ -58,6 +81,19 @@ export declare const hexOf: (rgb: Rgb) => string;
 export declare function mix(rgb: Rgb, amount: number): string;
 /** Text made safe to write between tags and inside a double-quoted attribute. */
 export declare const escape: (text: string) => string;
+/**
+ * The `<title>` of a finished drawing, as the options ask: a string is the title (escaped), `false` drops it and hides the drawing from a screen reader, and `locale: "ja"` writes the Japanese name. With none
+ * of the three the drawing is returned as it is.
+ */
+export declare function relabel(svg: string, en: string, ja: string, o: {
+    locale?: unknown;
+    title?: unknown;
+} | undefined): string;
+/** A drawing function whose result carries the title the options ask for. */
+export declare const labelled: <O extends {
+    locale?: unknown;
+    title?: unknown;
+}>(en: string, ja: string, draw: (options?: O) => string) => (options?: O) => string;
 /** A number written for a path: two decimals at most, and never `-0`. */
 export declare const n2: (value: number) => string;
 /** The options as the renderers use them. */
@@ -70,6 +106,16 @@ export interface Resolved {
     initials: string;
 }
 export declare function resolve(o: EmblemOptions | undefined): Resolved;
+/** What is to be cut into a face: the free text, or the label, year and rank, and the text of the back. A line is at most 24 letters and has no control character. */
+export interface Engraving {
+    free?: string;
+    label?: string;
+    year?: string;
+    rank?: string;
+    back?: string;
+}
+/** A text from outside made safe: control characters removed, at most 24 letters a line and `lines` lines, or `undefined` when nothing is left. */
+export declare const clean: (value: unknown, lines?: number) => string | undefined;
 /** The main colour of a metal, or the tint when there is one. */
 export declare const mainOf: (metal: Metal, tint: Rgb | undefined) => Rgb;
 /** The relative luminance of a colour, 0 to 1. */

package/dist/emblems/emblem.core.js

@@ -29,6 +29,24 @@ export function mix(rgb, amount) {
 }
 /** Text made safe to write between tags and inside a double-quoted attribute. */
 export const escape = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+/**
+ * The `<title>` of a finished drawing, as the options ask: a string is the title (escaped), `false` drops it and hides the drawing from a screen reader, and `locale: "ja"` writes the Japanese name. With none
+ * of the three the drawing is returned as it is.
+ */
+export function relabel(svg, en, ja, o) {
+    const title = o?.title;
+    const japanese = o?.locale === "ja";
+    if (title === false)
+        return svg.replace(/<title>[^<]*<\/title>/, "").replace(' role="img"', ' aria-hidden="true"');
+    const custom = typeof title === "string" && title.trim() !== "";
+    if (!custom && !japanese)
+        return svg;
+    const text = custom ? title.trim().slice(0, 300) : ja;
+    const titled = svg.replace(/<title>[^<]*<\/title>/, () => `<title>${escape(text)}</title>`);
+    return custom ? titled : titled.replace(' role="img"', ' role="img" lang="ja"');
+}
+/** A drawing function whose result carries the title the options ask for. */
+export const labelled = (en, ja, draw) => (options) => relabel(draw(options), en, ja, options);
 /** A number written for a path: two decimals at most, and never `-0`. */
 export const n2 = (value) => String(Math.round(value * 100) / 100 + 0);
 export function resolve(o) {
@@ -39,6 +57,18 @@ export function resolve(o) {
     const initials = typeof o?.initials === "string" ? [...o.initials.trim()].slice(0, 3).join("").toUpperCase() : "";
     return { style, size, theme, tint: readColour(o?.tint), accent: accent === undefined ? undefined : hexOf(accent), initials };
 }
+/** A text from outside made safe: control characters removed, at most 24 letters a line and `lines` lines, or `undefined` when nothing is left. */
+export const clean = (value, lines = 1) => {
+    if (typeof value !== "string" && typeof value !== "number")
+        return undefined;
+    const text = String(value)
+        .split(/\r?\n/)
+        .slice(0, lines)
+        .map((line) => [...line.replace(/\p{Cc}/gu, "").trim()].slice(0, 24).join(""))
+        .filter((line) => line !== "")
+        .join("\n");
+    return text === "" ? undefined : text;
+};
 /** The main colour of a metal, or the tint when there is one. */
 export const mainOf = (metal, tint) => tint ?? readColour(metal === "flat" ? "#8a949e" : METALS[metal]);
 /** The relative luminance of a colour, 0 to 1. */