@johnmorrisdotca/dougu-sports 0.1.0 → 0.2.1

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.curlingstone.d.ts

@@ -1,3 +1,5 @@
 export declare const BALL_CURLING_STONE: import("./ball.core.ts").Piece<{
     slices: number;
+} & {
+    view: import("./ball.object.ts").ObjectView;
 }>;

package/dist/emblems/ball/ball.curlingstone.js

@@ -7,6 +7,10 @@ import { num } from "./ball.core.js";
 const GRANITE = "#8d929a";
 const POLISHED = "#4d525b";
 const HANDLE = "#d4202c";
+// The stack's y is in units of the radius, so the half height is the height of the stone (114 mm at least) over its largest diameter (291 mm, a 914 mm circumference): 0.392, and the stone runs from -H to H. The slices
+// below are where the profile changes, as a fraction of H.
+const H = 114 / 290.9;
+const y = (t) => t * H;
 export const BALL_CURLING_STONE = /* @__PURE__ */ defineObject({
     id: "ball:curling-stone",
     en: "Curling stone",
@@ -16,11 +20,11 @@ export const BALL_CURLING_STONE = /* @__PURE__ */ defineObject({
     model: { slices: 6 },
     draw: (c) => drawStack(c, {
         slices: [
-            { y0: -0.2, y1: -0.15, r: [0.74, 0.8], colour: POLISHED, outline: true },
-            { y0: -0.15, y1: -0.04, r: [0.8, 0.94], colour: GRANITE },
-            { y0: -0.04, y1: 0.08, r: 1, colour: POLISHED, outline: true },
-            { y0: 0.08, y1: 0.15, r: [1, 0.9], colour: GRANITE },
-            { y0: 0.15, y1: 0.2, r: [0.9, 0.78], colour: GRANITE, outline: true },
+            { y0: y(-1), y1: y(-0.75), r: [0.74, 0.8], colour: POLISHED, outline: true },
+            { y0: y(-0.75), y1: y(-0.2), r: [0.8, 0.94], colour: GRANITE },
+            { y0: y(-0.2), y1: y(0.4), r: 1, colour: POLISHED, outline: true },
+            { y0: y(0.4), y1: y(0.75), r: [1, 0.9], colour: GRANITE },
+            { y0: y(0.75), y1: y(1), r: [0.9, 0.78], colour: GRANITE, outline: true },
         ],
         top: "#9a9fa7",
         bottom: "#6a6f78",
@@ -30,8 +34,8 @@ export const BALL_CURLING_STONE = /* @__PURE__ */ defineObject({
         dish: { r: 0.74, colour: "#555a63" },
         extra: (ctx) => {
             // The handle: a post and a bar, a capsule in 3D (a thick line with round ends).
-            const post0 = ctx.at([0, 0.2, 0]), post1 = ctx.at([0, 0.34, 0]);
-            const a = [-0.42, 0.4, 0], b = [0.42, 0.4, 0];
+            const post0 = ctx.at([0, H, 0]), post1 = ctx.at([0, H + 0.14, 0]);
+            const a = [-0.42, H + 0.2, 0], b = [0.42, H + 0.2, 0];
             const p = ctx.at(a), q = ctx.at(b);
             const colour = ctx.opts.style === "line" ? "currentColor" : (ctx.opts.tint ?? HANDLE);
             const line = ctx.opts.style === "line";

package/dist/emblems/ball/ball.discus.js

@@ -7,7 +7,7 @@ export const BALL_DISCUS = /* @__PURE__ */ defineBall({
     ja: "円盤",
     size: { extentMm: 220, diameterMm: 220, thicknessMm: 45, massG: [2000, 2000], rule: "World Athletics Technical Rules (C2.1), Rule 34 Discus Throw - 'The discus shall conform to the following specifications'", note: "Men's discus, 219 to 221 mm across the rim and 44 to 46 mm thick at the middle; 2 kg is a minimum." },
     spec: {
-        axes: [1, 0.2, 1],
+        axes: [1, 45 / 220, 1],
         view: { yaw: 25, pitch: 52, roll: -12 },
         base: "#3b3f48",
         mat: { gloss: 0.7, shade: "#050608", grain: { f: 1.4, a: 0.12 } },

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

@@ -14,18 +14,19 @@ const upperArc = (ring) => {
     return run;
 };
 const BROWN = "#8b4a21";
-const AXES = [1, 0.55, 0.55];
+// The shape is worked out from the rule's figures (see test/proportions.test.ts): the width over the length is the girth over pi over the length, and `point` is chosen so that the outline, tip round to tip,
+// is the long girth.
 const VIEW = { yaw: -20, pitch: 35, roll: -35 };
 const MAT = { gloss: 0.5, shade: "#2a1006", grain: { f: 0.95, a: 0.42 } };
-function football(id, en, ja, size, stripes, colour) {
+function football(id, en, ja, size, shape, stripes, colour) {
     return defineBall({
         id,
         en,
         ja,
         size,
         spec: {
-            axes: AXES,
-            point: 0.85,
+            axes: [1, shape.width, shape.width],
+            point: shape.point,
             view: VIEW,
             base: colour,
             mat: MAT,
@@ -45,7 +46,8 @@ function football(id, en, ja, size, stripes, colour) {
         },
     });
 }
+const NFL_SHAPE = { width: 0.6044, point: 0.541 };
 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, NFL_SHAPE, "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" }, NFL_SHAPE, "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." }, { width: 0.599, point: 0.567 }, "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.d.ts

@@ -18,7 +18,7 @@ export interface ObjectContext {
     /** A point of the object in its own space to the box: x, y and depth (positive toward you); one unit is 46 box units. */
     at(p: V3): [number, number, number];
 }
-export interface ObjectDef<Model> {
+export interface ObjectDef<Model extends object> {
     id: string;
     en: string;
     ja: string;
@@ -35,4 +35,7 @@ export interface ObjectDef<Model> {
         body: string;
     };
 }
-export declare function defineObject<Model>(def: ObjectDef<Model>): Piece<Model>;
+/** An object as a piece. Its `model` is the def's model with the default `view` added, so that a view of it (or a test) can turn it to any aspect from there. */
+export declare function defineObject<Model extends object>(def: ObjectDef<Model>): Piece<Model & {
+    view: ObjectView;
+}>;

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

@@ -1,7 +1,8 @@
 // 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);
+/** An object as a piece. Its `model` is the def's model with the default `view` added, so that a view of it (or a test) can turn it to any aspect from there. */
 export function defineObject(def) {
     const render = (o, turning) => {
         const opts = resolveOptions(o);
@@ -16,5 +17,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, view: def.view }, 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.puck.d.ts

@@ -1,3 +1,5 @@
 export declare const BALL_PUCK: import("./ball.core.ts").Piece<{
     slices: number;
+} & {
+    view: import("./ball.object.ts").ObjectView;
 }>;

package/dist/emblems/ball/ball.puck.js

@@ -1,7 +1,7 @@
-// Ice hockey puck: vulcanised black rubber, 76.2 mm across and 25.4 mm thick (so 1 : 3), with a ridged edge. Drawn as a cylinder in true 3D, so it turns.
+// Ice hockey puck: vulcanised black rubber, 76.2 mm across and 25.4 mm thick (so 1 : 3), with a ridged edge. Drawn as a cylinder in true 3D, so it turns. The stack's y is in units of the radius, so the half thickness is 12.7 / 38.1, one third.
 import { drawStack } from "./ball.stack.js";
 import { defineObject } from "./ball.object.js";
-const H = 25.4 / 76.2 / 2;
+const H = 25.4 / 76.2;
 export const BALL_PUCK = /* @__PURE__ */ defineObject({
     id: "ball:puck",
     en: "Hockey puck",

package/dist/emblems/ball/ball.rugby.js

@@ -13,8 +13,9 @@ export const BALL_RUGBY = /* @__PURE__ */ defineBall({
     ja: "ラグビーボール",
     size: { extentMm: 290.0, lengthMm: 290.0, circumferenceMm: 600.0, longCircumferenceMm: 755.0, massG: [410, 460], rule: "World Rugby Laws of the Game (Rugby Union), Law 2 The ball, clauses 1-7" },
     spec: {
-        axes: [1, 0.62, 0.62],
-        point: 0.72,
+        // Worked out from the Laws' 600 mm girth, 290 mm length and 755 mm long girth.
+        axes: [1, 0.6586, 0.6586],
+        point: 0.561,
         view: { yaw: -30, pitch: 20, roll: -30 },
         base: "#1f4e9c",
         ground: WHITE,

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

@@ -1,6 +1,10 @@
 export declare const BALL_SHUTTLECOCK_FEATHER: import("./ball.core.ts").Piece<{
     feathers: number;
+} & {
+    view: import("./ball.object.ts").ObjectView;
 }>;
 export declare const BALL_SHUTTLECOCK_NYLON: import("./ball.core.ts").Piece<{
     feathers: number;
+} & {
+    view: import("./ball.object.ts").ObjectView;
 }>;

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

@@ -4,12 +4,13 @@ import { defineObject } from "./ball.object.js";
 import {} from "./ball.math.js";
 import { blend, mix, num } from "./ball.core.js";
 const FEATHERS = 16;
-// One unit is 32 mm: the skirt is 2 units across at the top, the base 0.84 across and the whole 2.06 long.
+// One unit is 32 mm (the scale below makes 92 box units 150 mm): the skirt is 2 units across at the tips (63 mm), the base 0.84 across (27 mm) and the feathers 2.05 long from the tips to the top of the base
+// (66 mm; the Law measures a feather's length that way, 62 to 70 mm).
 const ROOT_R = 0.42;
 const TIP_R = 1;
-const ROOT_Y = -0.56;
+const ROOT_Y = -1.05;
 const TIP_Y = 1.0;
-const SLOPE = 0.4;
+const SLOPE = 0.56;
 const drawShuttle = (c, p) => {
     const line = c.opts.style === "line";
     const tip = (a, r, y, k = 0) => [Math.cos(a) * r, y, Math.sin(a) * r + k];
@@ -72,7 +73,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 +84,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>`;
+}