@johnmorrisdotca/dougu-sports 0.28.1 → 0.30.0

package/dist/emblems/ball/ball.index.js

@@ -14,7 +14,7 @@ import { BALL_HAMMER } from "./ball.hammer.js";
 import { BALL_HANDBALL } from "./ball.handball.js";
 import { BALL_PADEL } from "./ball.padel.js";
 import { BALL_PICKLEBALL_OUTDOOR, BALL_PICKLEBALL_INDOOR } from "./ball.pickleball.js";
-import { BALL_PLASTIC_BASEBALL_SLOTTED } from "./ball.plastic.js";
+import { BALL_PLASTIC_BASEBALL_PRACTICE, BALL_PLASTIC_BASEBALL_PRACTICE_ORANGE, BALL_PLASTIC_BASEBALL_PRACTICE_WHITE, BALL_PLASTIC_BASEBALL_SLOTTED } from "./ball.plastic.js";
 import { BALL_PUCK } from "./ball.puck.js";
 import { PUCKS } from "./ball.puck.print.js";
 import { BALL_BASEBALL, BALL_SOCCER, BALL_SOCCER_COLOUR, BALL_SOCCER_ORANGE, BALL_SOCCER_YELLOW, BALL_SOFTBALL } from "./ball.printable.js";
@@ -37,7 +37,7 @@ import { BALL_TEQBALL } from "./ball.teqball.js";
 import { BALL_VOLLEYBALL, BALL_VOLLEYBALL_8, BALL_BEACH_VOLLEYBALL } from "./ball.volleyball.js";
 import { BALL_WATER_POLO } from "./ball.waterpolo.js";
 /** Every ball, in the order a gallery shows them. */
-export const BALLS = [BALL_SOCCER, BALL_SOCCER_COLOUR, BALL_SOCCER_26, BALL_SOCCER_18, BALL_SOCCER_14, BALL_SOCCER_12, BALL_SOCCER_6, BALL_SOCCER_ORANGE, BALL_SOCCER_26_ORANGE, BALL_SOCCER_18_ORANGE, BALL_SOCCER_14_ORANGE, BALL_SOCCER_12_ORANGE, BALL_SOCCER_6_ORANGE, BALL_SOCCER_YELLOW, BALL_SOCCER_26_YELLOW, BALL_SOCCER_18_YELLOW, BALL_SOCCER_14_YELLOW, BALL_SOCCER_12_YELLOW, BALL_SOCCER_6_YELLOW, BALL_FUTSAL, BALL_BEACH_SOCCER, BALL_SOCCER_1870_HAND_STITCHED, BALL_SOCCER_1900_LACED, BALL_SOCCER_1930_18_PANEL, BALL_SOCCER_1950_12_PANEL, BALL_SOCCER_1960_32_PANEL_LEATHER, BALL_SOCCER_RETRO_PENTAGONS, BALL_SOCCER_RETRO_LEAVES, BALL_SOCCER_RETRO_ROSETTE, BALL_SOCCER_RETRO_STAR, BALL_SOCCER_RETRO_PINWHEEL, BALL_SOCCER_RETRO_KITES, BALL_SOCCER_14_PANEL_DOUBLE_BORDER, BALL_SOCCER_8_PANEL_PLAIN, BALL_SOCCER_6_PANEL_BANDS, BALL_SOCCER_6_PANEL_DIAMONDS, BALL_SOCCER_20_PANEL_DOTS, BALL_SOCCER_TRAINING_HIGH_VIS, BALL_SOCCER_STARS_BLUE, BALL_SOCCER_STARS_RED, BALL_SOCCER_STARS_NIGHT, BALL_SOCCER_HEXAGONS_CYAN, BALL_SOCCER_HEXAGONS_MAGENTA, BALL_SOCCER_HEXAGONS_LIME, BALL_SOCCER_FLAMES_FIRE, BALL_SOCCER_FLAMES_ICE, BALL_SOCCER_FLAMES_TOXIC, BALL_SOCCER_CHEVRONS_RED, BALL_SOCCER_CHEVRONS_GREEN, BALL_SOCCER_CHEVRONS_BLUE, BALL_SOCCER_SWIRL_BLUE, BALL_SOCCER_SWIRL_RED, BALL_SOCCER_SWIRL_TEAL, BALL_SOCCER_METALLIC_GOLD, BALL_SOCCER_METALLIC_SILVER, BALL_SOCCER_METALLIC_COBALT, BALL_TEQBALL, BALL_BASKETBALL, BALL_BASKETBALL_6, BALL_BASKETBALL_3X3, BALL_BASEBALL, BALL_SOFTBALL, BALL_BASEBALL_LEMON_PEEL, BALL_BASEBALL_RED_BLUE, BALL_BASEBALL_BLACK_RED, BALL_BASEBALL_VINTAGE_LEATHER, BALL_SOFTBALL_11_OPTIC, BALL_TENNIS, BALL_PADEL, BALL_SLIOTAR, BALL_VOLLEYBALL, BALL_VOLLEYBALL_8, BALL_BEACH_VOLLEYBALL, BALL_VOLLEYBALL_COLOURS, BALL_VOLLEYBALL_BRAZIL, BALL_VOLLEYBALL_JAPAN, BALL_VOLLEYBALL_CANADA, BALL_VOLLEYBALL_USA, BALL_VOLLEYBALL_ITALY, BALL_VOLLEYBALL_POLAND, BALL_VOLLEYBALL_FRANCE, BALL_VOLLEYBALL_SERBIA, BALL_VOLLEYBALL_NETHERLANDS, BALL_VOLLEYBALL_GERMANY, 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_PLASTIC_BASEBALL_SLOTTED, BALL_SQUASH_DOUBLE_YELLOW, 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 const BALLS = [BALL_SOCCER, BALL_SOCCER_COLOUR, BALL_SOCCER_26, BALL_SOCCER_18, BALL_SOCCER_14, BALL_SOCCER_12, BALL_SOCCER_6, BALL_SOCCER_ORANGE, BALL_SOCCER_26_ORANGE, BALL_SOCCER_18_ORANGE, BALL_SOCCER_14_ORANGE, BALL_SOCCER_12_ORANGE, BALL_SOCCER_6_ORANGE, BALL_SOCCER_YELLOW, BALL_SOCCER_26_YELLOW, BALL_SOCCER_18_YELLOW, BALL_SOCCER_14_YELLOW, BALL_SOCCER_12_YELLOW, BALL_SOCCER_6_YELLOW, BALL_FUTSAL, BALL_BEACH_SOCCER, BALL_SOCCER_1870_HAND_STITCHED, BALL_SOCCER_1900_LACED, BALL_SOCCER_1930_18_PANEL, BALL_SOCCER_1950_12_PANEL, BALL_SOCCER_1960_32_PANEL_LEATHER, BALL_SOCCER_RETRO_PENTAGONS, BALL_SOCCER_RETRO_LEAVES, BALL_SOCCER_RETRO_ROSETTE, BALL_SOCCER_RETRO_STAR, BALL_SOCCER_RETRO_PINWHEEL, BALL_SOCCER_RETRO_KITES, BALL_SOCCER_14_PANEL_DOUBLE_BORDER, BALL_SOCCER_8_PANEL_PLAIN, BALL_SOCCER_6_PANEL_BANDS, BALL_SOCCER_6_PANEL_DIAMONDS, BALL_SOCCER_20_PANEL_DOTS, BALL_SOCCER_TRAINING_HIGH_VIS, BALL_SOCCER_STARS_BLUE, BALL_SOCCER_STARS_RED, BALL_SOCCER_STARS_NIGHT, BALL_SOCCER_HEXAGONS_CYAN, BALL_SOCCER_HEXAGONS_MAGENTA, BALL_SOCCER_HEXAGONS_LIME, BALL_SOCCER_FLAMES_FIRE, BALL_SOCCER_FLAMES_ICE, BALL_SOCCER_FLAMES_TOXIC, BALL_SOCCER_CHEVRONS_RED, BALL_SOCCER_CHEVRONS_GREEN, BALL_SOCCER_CHEVRONS_BLUE, BALL_SOCCER_SWIRL_BLUE, BALL_SOCCER_SWIRL_RED, BALL_SOCCER_SWIRL_TEAL, BALL_SOCCER_METALLIC_GOLD, BALL_SOCCER_METALLIC_SILVER, BALL_SOCCER_METALLIC_COBALT, BALL_TEQBALL, BALL_BASKETBALL, BALL_BASKETBALL_6, BALL_BASKETBALL_3X3, BALL_BASEBALL, BALL_SOFTBALL, BALL_BASEBALL_LEMON_PEEL, BALL_BASEBALL_RED_BLUE, BALL_BASEBALL_BLACK_RED, BALL_BASEBALL_VINTAGE_LEATHER, BALL_SOFTBALL_11_OPTIC, BALL_TENNIS, BALL_PADEL, BALL_SLIOTAR, BALL_VOLLEYBALL, BALL_VOLLEYBALL_8, BALL_BEACH_VOLLEYBALL, BALL_VOLLEYBALL_COLOURS, BALL_VOLLEYBALL_BRAZIL, BALL_VOLLEYBALL_JAPAN, BALL_VOLLEYBALL_CANADA, BALL_VOLLEYBALL_USA, BALL_VOLLEYBALL_ITALY, BALL_VOLLEYBALL_POLAND, BALL_VOLLEYBALL_FRANCE, BALL_VOLLEYBALL_SERBIA, BALL_VOLLEYBALL_NETHERLANDS, BALL_VOLLEYBALL_GERMANY, 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_PLASTIC_BASEBALL_SLOTTED, BALL_PLASTIC_BASEBALL_PRACTICE, BALL_PLASTIC_BASEBALL_PRACTICE_WHITE, BALL_PLASTIC_BASEBALL_PRACTICE_ORANGE, BALL_SQUASH_DOUBLE_YELLOW, 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];
 /** The id of every ball: `"ball:soccer"`, `"ball:cricket-red"`. */
 export const BALL_IDS = BALLS.map((b) => b.id);
 const TABLE = new Map([...BALLS, ...PUCKS].map((b) => [b.id, b]));
@@ -75,12 +75,14 @@ export function ballSize(name) {
 /**
  * Several balls side by side. At the true scale each ball is as big, next to the others, as the rulebook makes it: a puck beside a basketball looks right. `extentMm` is what a ball's drawing is
  * scaled by (the ball's largest size in a box of 92 units), so the sizes are the rules' sizes, not a guess. The result is one document of SVG.
+ * @param names - Ball ids (`ball:golf`), in the order they stand.
+ * @param options - The scale, height, gap and alignment.
+ * @returns One document of SVG with all the balls.
  * @example
  * ```ts
- * import { lineup } from "@johnmorrisdotca/kyogijo-stadiums/balls";
- * const svg = lineup(["golf", "tennis", "soccer", "puck"], { scale: "true", height: 80 });
- * console.log(svg.includes("<title>"));
- * // true
+ * import { lineup } from "@johnmorrisdotca/dougu-sports/emblems";
+ * const svg = lineup(["ball:golf", "ball:tennis", "ball:soccer"], { scale: "true", height: 80 });
+ * console.log(svg.startsWith("<svg"));
  * ```
  */
 export function lineup(names, options) {

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

@@ -1 +1,9 @@
+/**
+ * The Padel ball emblem (パデルボール in Japanese): id `ball:padel`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PADEL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PADEL.id, BALL_PADEL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_PADEL: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;

package/dist/emblems/ball/ball.padel.js

@@ -1,5 +1,13 @@
 // Padel ball: a yellow felt ball a little larger than a tennis ball's, with a seam of its own proportions.
 import { seamedBall } from "./ball.family.seamed.js";
+/**
+ * The Padel ball emblem (パデルボール in Japanese): id `ball:padel`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PADEL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PADEL.id, BALL_PADEL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_PADEL = /* @__PURE__ */ seamedBall({
     id: "ball:padel",
     en: "Padel ball",

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

@@ -1,2 +1,18 @@
+/**
+ * The Pickleball, outdoor emblem (ピックルボール（屋外用） in Japanese): id `ball:pickleball-outdoor`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PICKLEBALL_OUTDOOR } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PICKLEBALL_OUTDOOR.id, BALL_PICKLEBALL_OUTDOOR.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_PICKLEBALL_OUTDOOR: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/**
+ * The Pickleball, indoor emblem (ピックルボール（屋内用） in Japanese): id `ball:pickleball-indoor`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PICKLEBALL_INDOOR } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PICKLEBALL_INDOOR.id, BALL_PICKLEBALL_INDOOR.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_PICKLEBALL_INDOOR: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;

package/dist/emblems/ball/ball.pickleball.js

@@ -1,6 +1,14 @@
 // Pickleball: a perforated plastic ball. The outdoor ball has 40 small holes; the indoor ball has 26 larger ones (the rulebook gives 26 to 40 holes; the split is how balls are sold).
 import { dottedBall } from "./ball.family.dotted.js";
 import { holeLayers } from "./ball.holes.js";
+/**
+ * The Pickleball, outdoor emblem (ピックルボール（屋外用） in Japanese): id `ball:pickleball-outdoor`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PICKLEBALL_OUTDOOR } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PICKLEBALL_OUTDOOR.id, BALL_PICKLEBALL_OUTDOOR.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_PICKLEBALL_OUTDOOR = /* @__PURE__ */ dottedBall({
     id: "ball:pickleball-outdoor",
     en: "Pickleball, outdoor",
@@ -14,6 +22,14 @@ export const BALL_PICKLEBALL_OUTDOOR = /* @__PURE__ */ dottedBall({
     depth: 0.75,
     hollow: holeLayers,
 });
+/**
+ * The Pickleball, indoor emblem (ピックルボール（屋内用） in Japanese): id `ball:pickleball-indoor`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PICKLEBALL_INDOOR } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PICKLEBALL_INDOOR.id, BALL_PICKLEBALL_INDOOR.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_PICKLEBALL_INDOOR = /* @__PURE__ */ dottedBall({
     id: "ball:pickleball-indoor",
     en: "Pickleball, indoor",

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

@@ -1 +1,38 @@
-export declare const BALL_PLASTIC_BASEBALL_SLOTTED: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+import type { Piece } from "./ball.core.ts";
+import type { BallSpec } from "./ball.engine.ts";
+/**
+ * The Plastic baseball, slotted emblem (野球の穴あき練習球 in Japanese): id `ball:plastic-baseball-slotted`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PLASTIC_BASEBALL_SLOTTED } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PLASTIC_BASEBALL_SLOTTED.id, BALL_PLASTIC_BASEBALL_SLOTTED.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
+export declare const BALL_PLASTIC_BASEBALL_SLOTTED: Piece<BallSpec>;
+/**
+ * The Practice ball, two-tone emblem (穴あき練習球(二色)): id `ball:plastic-baseball-practice`, the high-visibility yellow and black two-tone ball with slots on both halves, turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PLASTIC_BASEBALL_PRACTICE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PLASTIC_BASEBALL_PRACTICE.id, BALL_PLASTIC_BASEBALL_PRACTICE.svg({ size: 48 }).includes("<mask"));
+ * ```
+ */
+export declare const BALL_PLASTIC_BASEBALL_PRACTICE: Piece<BallSpec>;
+/**
+ * The Practice ball, white emblem (穴あき練習球(白)): id `ball:plastic-baseball-practice-white`, one colour, with slots on both halves, turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PLASTIC_BASEBALL_PRACTICE_WHITE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PLASTIC_BASEBALL_PRACTICE_WHITE.id, BALL_PLASTIC_BASEBALL_PRACTICE_WHITE.svg({ size: 48 }).includes("<mask"));
+ * ```
+ */
+export declare const BALL_PLASTIC_BASEBALL_PRACTICE_WHITE: Piece<BallSpec>;
+/**
+ * The Practice ball, orange emblem (穴あき練習球(橙)): id `ball:plastic-baseball-practice-orange`, one colour, with slots on both halves, turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PLASTIC_BASEBALL_PRACTICE_ORANGE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PLASTIC_BASEBALL_PRACTICE_ORANGE.id, BALL_PLASTIC_BASEBALL_PRACTICE_ORANGE.svg({ size: 48 }).includes("<mask"));
+ * ```
+ */
+export declare const BALL_PLASTIC_BASEBALL_PRACTICE_ORANGE: Piece<BallSpec>;

package/dist/emblems/ball/ball.plastic.js

@@ -4,6 +4,8 @@
 // No maker's name is in this package: it is a generic ball.
 import { defineBall } from "./ball.engine.js";
 import { holeLayers, slotRing } from "./ball.holes.js";
+import { greatCircle } from "./ball.math.js";
+import { region } from "./ball.region.js";
 /** The axis of the perforated half: its pole, the middle of the solid-free half's ring of slots. */
 const POLE = [0, 0, 1];
 /** Eight slots in a ring round the pole at 36 degrees from it (the ring is about half way out in a picture of the ball seen from its pole), each running along the line to the pole. */
@@ -17,6 +19,14 @@ const CENTRES = Array.from({ length: SLOTS }, (_, i) => {
     return [Math.sin(COLATITUDE) * Math.cos(a), Math.sin(COLATITUDE) * Math.sin(a), Math.cos(COLATITUDE)];
 });
 const DIRS = CENTRES.map((m) => [POLE[0] - m[0] * m[2], POLE[1] - m[1] * m[2], POLE[2] - m[2] * m[2]]);
+/**
+ * The Plastic baseball, slotted emblem (野球の穴あき練習球 in Japanese): id `ball:plastic-baseball-slotted`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PLASTIC_BASEBALL_SLOTTED } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PLASTIC_BASEBALL_SLOTTED.id, BALL_PLASTIC_BASEBALL_SLOTTED.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_PLASTIC_BASEBALL_SLOTTED = /* @__PURE__ */ defineBall({
     id: "ball:plastic-baseball-slotted",
     en: "Plastic baseball, slotted",
@@ -30,3 +40,66 @@ export const BALL_PLASTIC_BASEBALL_SLOTTED = /* @__PURE__ */ defineBall({
         holes: (s, id, base, shape, minWidth) => holeLayers(s, id, { centres: CENTRES, radius: HALF_WIDTH, long: HALF_LONG, dirs: DIRS }, base, shape, minWidth),
     },
 });
+/**
+ * The common hollow plastic practice baseball with slots all over it (the other, the one-sided ball above, is the first): one ring of five large oval slots on each half, running toward the pole, the two rings
+ * turned half a step apart so that no slot faces another across the seam, and often two-tone, the halves split along the seam. A slot is about 22 mm long and 14 mm wide on a ball of the size of a baseball, an oval
+ * and not a slit (larger than the 19 mm of the one-sided ball, as the photographs show); the other figures are the same facts as above, and the number and the layout of the slots are drawn from photographs looked at and never copied. No maker's name is in this package.
+ */
+const PRACTICE_HALF_LONG = 0.3;
+const PRACTICE_HALF_WIDTH = 0.19;
+const PRACTICE_PER_HALF = 6;
+const PRACTICE_COLATITUDE = 56;
+const ALL = [1, -1].flatMap((sign) => Array.from({ length: PRACTICE_PER_HALF }, (_, i) => {
+    const a = (((sign === 1 ? 0 : 180 / PRACTICE_PER_HALF) + (i / PRACTICE_PER_HALF) * 360) * Math.PI) / 180;
+    const t = (PRACTICE_COLATITUDE * Math.PI) / 180;
+    const m = [Math.sin(t) * Math.cos(a), Math.sin(t) * Math.sin(a), sign * Math.cos(t)];
+    const along = [-m[0] * m[2] * sign, -m[1] * m[2] * sign, sign - m[2] * m[2] * sign];
+    return { m, dir: along };
+}));
+const PRACTICE_CENTRES = ALL.map((one) => one.m);
+const PRACTICE_DIRS = ALL.map((one) => one.dir);
+function practice(id, en, ja, colours) {
+    const seam = greatCircle([0, 0, 1], 120).reverse();
+    return defineBall({
+        id,
+        en,
+        ja,
+        size: { extentMm: 73.8, diameterMm: 73.8, rule: "English Wikipedia, the article on the perforated plastic practice ball (accessed 2026-10-21): hollow plastic, wall at most 3.2 mm; size taken from Official Baseball Rules, Rule 3.01 (the middle of the circumference range). The count and layout of the slots are drawn from photographs looked at, not copied.", note: "The size of a slot on this ball is not given by the article (19 mm is the one-sided ball's): it is drawn about 22 by 14 mm, an oval, to match the photographs. The mass is not stated. " },
+        spec: {
+            view: { yaw: -22, pitch: 26, roll: 0 },
+            base: colours.second ?? colours.first,
+            ...(colours.second === undefined ? {} : { ground: colours.first }),
+            mat: { gloss: 0.5, shade: "#2b2e36", grain: { f: 1.4, a: 0.08 } },
+            draw: (s, base) => (colours.second === undefined ? "" : region(s, seam, base)) +
+                (s.line ? s.strokes(PRACTICE_CENTRES.map((m, i) => slotRing(m, PRACTICE_DIRS[i], PRACTICE_HALF_WIDTH, PRACTICE_HALF_LONG)), "#000", 1, { closed: true }) : ""),
+            holes: (s, hid, base, shape, minWidth) => holeLayers(s, hid, { centres: PRACTICE_CENTRES, radius: PRACTICE_HALF_WIDTH, long: PRACTICE_HALF_LONG, dirs: PRACTICE_DIRS }, base, shape, minWidth),
+        },
+    });
+}
+/**
+ * The Practice ball, two-tone emblem (穴あき練習球(二色)): id `ball:plastic-baseball-practice`, the high-visibility yellow and black two-tone ball with slots on both halves, turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PLASTIC_BASEBALL_PRACTICE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PLASTIC_BASEBALL_PRACTICE.id, BALL_PLASTIC_BASEBALL_PRACTICE.svg({ size: 48 }).includes("<mask"));
+ * ```
+ */
+export const BALL_PLASTIC_BASEBALL_PRACTICE = /* @__PURE__ */ practice("ball:plastic-baseball-practice", "Practice ball, two-tone", "穴あき練習球(二色)", { first: "#d4ee1a", second: "#1d1f24" });
+/**
+ * The Practice ball, white emblem (穴あき練習球(白)): id `ball:plastic-baseball-practice-white`, one colour, with slots on both halves, turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PLASTIC_BASEBALL_PRACTICE_WHITE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PLASTIC_BASEBALL_PRACTICE_WHITE.id, BALL_PLASTIC_BASEBALL_PRACTICE_WHITE.svg({ size: 48 }).includes("<mask"));
+ * ```
+ */
+export const BALL_PLASTIC_BASEBALL_PRACTICE_WHITE = /* @__PURE__ */ practice("ball:plastic-baseball-practice-white", "Practice ball, white", "穴あき練習球(白)", { first: "#f4f4f0" });
+/**
+ * The Practice ball, orange emblem (穴あき練習球(橙)): id `ball:plastic-baseball-practice-orange`, one colour, with slots on both halves, turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PLASTIC_BASEBALL_PRACTICE_ORANGE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PLASTIC_BASEBALL_PRACTICE_ORANGE.id, BALL_PLASTIC_BASEBALL_PRACTICE_ORANGE.svg({ size: 48 }).includes("<mask"));
+ * ```
+ */
+export const BALL_PLASTIC_BASEBALL_PRACTICE_ORANGE = /* @__PURE__ */ practice("ball:plastic-baseball-practice-orange", "Practice ball, orange", "穴あき練習球(橙)", { first: "#f07a1c" });

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

@@ -1,7 +1,15 @@
 import { type Piece } from "./ball.core.ts";
 import { type PrintOptions } from "./ball.core.ts";
 import type { BallSpec, Surface } from "./ball.engine.ts";
-/** The colours of a painted ball: `body` is the ball (or a soccer ball's hexagons), `second` the other half of a two-tone ball (or a soccer ball's pentagons). */
+/**
+ * The colours of a painted ball: `body` is the ball (or a soccer ball's hexagons), `second` the other half of a two-tone ball (or a soccer ball's pentagons).
+ * @example
+ * ```ts
+ * import type { BallPaint } from "@johnmorrisdotca/dougu-sports/emblems";
+ * const paint: BallPaint = { body: "#f2c230", second: "#1f2228", split: "half", angle: 20 };
+ * console.log(paint.split);
+ * ```
+ */
 export interface BallPaint {
     /** The ball's colour: `#rgb`, `#rrggbb` or `rgb()`; anything else is ignored. */
     body?: string;
@@ -14,17 +22,41 @@ export interface BallPaint {
     /** The colour of the stitches. By default one that shows against the ball (red, cream or navy; on a two-tone ball each stitch's legs are the colour that shows on their own side). */
     stitch?: string;
 }
-/** A place on the ball in degrees from the middle of its default view: `lon` toward the right, `lat` toward the top, in the ball's own frame (it turns with the ball). */
+/**
+ * A place on the ball in degrees from the middle of its default view: `lon` toward the right, `lat` toward the top, in the ball's own frame (it turns with the ball).
+ * @example
+ * ```ts
+ * import type { Spot } from "@johnmorrisdotca/dougu-sports/emblems";
+ * const spot: Spot = { lon: 20, lat: -10 };
+ * console.log(spot.lon);
+ * ```
+ */
 export interface Spot {
     lon?: number;
     lat?: number;
 }
-/** Where the logo and the lettering go, as a place on the ball in degrees from the middle of its default view. By default the logo is there and so is the lettering, or the lettering is on the far side of the ball (`lon: 180`) when there is a logo. */
+/**
+ * Where the logo and the lettering go, as a place on the ball in degrees from the middle of its default view. By default the logo is there and so is the lettering, or the lettering is on the far side of the ball (`lon: 180`) when there is a logo.
+ * @example
+ * ```ts
+ * import type { BallSpots } from "@johnmorrisdotca/dougu-sports/emblems";
+ * const spots: BallSpots = { decal: { lon: -20, lat: 10 }, label: { lon: 25 } };
+ * console.log(spots.decal?.lon);
+ * ```
+ */
 export interface BallSpots {
     decal?: Spot;
     label?: Spot;
 }
-/** A logo printed on the ball. */
+/**
+ * A logo printed on the ball.
+ * @example
+ * ```ts
+ * import type { BallDecal } from "@johnmorrisdotca/dougu-sports/emblems";
+ * const decal: BallDecal = { svg: '<svg viewBox="0 0 10 10"><circle cx="5" cy="5" r="4"/></svg>', size: 40, turn: 15 };
+ * console.log(decal.size);
+ * ```
+ */
 export interface BallDecal {
     /** An SVG string. It is made safe first (only shapes, gradients and groups survive; no script, text, image, style or address), a gradient is its mean colour, and it is wrapped exactly onto the sphere. */
     svg?: string;
@@ -35,7 +67,15 @@ export interface BallDecal {
     /** A turn of the logo on the ball, in degrees. */
     turn?: number;
 }
-/** The stamp: lines of bold block lettering, the first with a small star on each side, and an optional signature-style line under them. */
+/**
+ * The stamp: lines of bold block lettering, the first with a small star on each side, and an optional signature-style line under them.
+ * @example
+ * ```ts
+ * import type { BallStamp } from "@johnmorrisdotca/dougu-sports/emblems";
+ * const stamp: BallStamp = { lines: ["PRACTICE", "BASEBALL"], stars: true, sign: 7 };
+ * console.log(stamp.lines?.length);
+ * ```
+ */
 export interface BallStamp {
     /** The lines (up to three, 24 letters each, any letter, digit or `- . , ' / : &`; the ball's own default is `UNOFFICIAL` and `DIGITAL BASEBALL`). */
     lines?: readonly string[];
@@ -49,13 +89,29 @@ export interface BallStamp {
     /** The ink, `#rgb`, `#rrggbb` or `rgb()`. Navy by default, or white or black where navy would not show on the ball. */
     colour?: string;
 }
-/** The cursive word where a maker's mark would sit. */
+/**
+ * The cursive word where a maker's mark would sit.
+ * @example
+ * ```ts
+ * import type { BallScript } from "@johnmorrisdotca/dougu-sports/emblems";
+ * const script: BallScript = { text: "Practice", colour: "#1f4e8c" };
+ * console.log(script.text);
+ * ```
+ */
 export interface BallScript {
     /** The word (up to 16 letters; a-z and a space; a capital without a drawing of its own is a tall small letter). By default the ball's own: `Baseball`, `Softball` or `Soccer`. */
     text?: string;
     colour?: string;
 }
-/** The small mark under the script: a letter in a circle, or a mark of your own. */
+/**
+ * The small mark under the script: a letter in a circle, or a mark of your own.
+ * @example
+ * ```ts
+ * import type { BallMark } from "@johnmorrisdotca/dougu-sports/emblems";
+ * const mark: BallMark = { letter: "D", colour: "#c4202e" };
+ * console.log(mark.letter);
+ * ```
+ */
 export interface BallMark {
     /** The letter in the circle (one letter or digit). By default the first letter of the script. */
     letter?: string;
@@ -77,5 +133,13 @@ export declare const printKey: (p: PrintOptions | undefined) => string;
 /**
  * A ball that can be printed. The balls themselves carry no printing code (a ball bundled alone stays small): `renderEmblem` and the registry use this, and so can you for one ball taken from its own module:
  * `const ball = printed(BALL_BASEBALL); ball.svg({ stamp: true })`. The same ball with the printer in its options; options that ask for no print draw exactly what the plain ball draws.
+ * @param piece - A ball taken from its own module.
+ * @returns The same ball with the printer in its options.
+ * @example
+ * ```ts
+ * import { BALL_BASEBALL, printed } from "@johnmorrisdotca/dougu-sports";
+ * const ball = printed(BALL_BASEBALL);
+ * console.log(ball.svg({ stamp: true }).startsWith("<svg"));
+ * ```
  */
 export declare const printed: <P extends Piece<BallSpec>>(piece: P) => P;

package/dist/emblems/ball/ball.print.js

@@ -260,6 +260,14 @@ export const printKey = (p) => (p === undefined ? "" : escape(hashOf(JSON.string
 /**
  * A ball that can be printed. The balls themselves carry no printing code (a ball bundled alone stays small): `renderEmblem` and the registry use this, and so can you for one ball taken from its own module:
  * `const ball = printed(BALL_BASEBALL); ball.svg({ stamp: true })`. The same ball with the printer in its options; options that ask for no print draw exactly what the plain ball draws.
+ * @param piece - A ball taken from its own module.
+ * @returns The same ball with the printer in its options.
+ * @example
+ * ```ts
+ * import { BALL_BASEBALL, printed } from "@johnmorrisdotca/dougu-sports";
+ * const ball = printed(BALL_BASEBALL);
+ * console.log(ball.svg({ stamp: true }).startsWith("<svg"));
+ * ```
  */
 export const printed = (piece) => ({
     ...piece,

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

@@ -1,6 +1,54 @@
+/**
+ * The Baseball emblem (野球のボール in Japanese): id `ball:baseball`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_BASEBALL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_BASEBALL.id, BALL_BASEBALL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_BASEBALL: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/**
+ * The Softball emblem (ソフトボール in Japanese): id `ball:softball`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SOFTBALL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOFTBALL.id, BALL_SOFTBALL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SOFTBALL: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/**
+ * The Soccer ball emblem (サッカーボール in Japanese): id `ball:soccer`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER.id, BALL_SOCCER.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SOCCER: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/**
+ * The Soccer ball, coloured emblem (サッカーボール（カラー） in Japanese): id `ball:soccer-colour`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_COLOUR } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_COLOUR.id, BALL_SOCCER_COLOUR.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SOCCER_COLOUR: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/**
+ * The Soccer ball, orange emblem (32枚貼り・オレンジ in Japanese): id `ball:soccer-orange`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_ORANGE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_ORANGE.id, BALL_SOCCER_ORANGE.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SOCCER_ORANGE: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/**
+ * The Soccer ball, yellow emblem (32枚貼り・蛍光イエロー in Japanese): id `ball:soccer-yellow`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_YELLOW } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_YELLOW.id, BALL_SOCCER_YELLOW.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SOCCER_YELLOW: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;

package/dist/emblems/ball/ball.printable.js

@@ -5,9 +5,57 @@ import { printed } from "./ball.print.js";
 import { BALL_SOCCER_ORANGE as PLAIN_SOCCER_ORANGE, BALL_SOCCER_YELLOW as PLAIN_SOCCER_YELLOW } from "./ball.soccer.panels.js";
 import { BALL_SOCCER as PLAIN_SOCCER, BALL_SOCCER_COLOUR as PLAIN_SOCCER_COLOUR } from "./ball.soccer.js";
 import { BALL_SOFTBALL as PLAIN_SOFTBALL } from "./ball.softball.js";
+/**
+ * The Baseball emblem (野球のボール in Japanese): id `ball:baseball`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_BASEBALL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_BASEBALL.id, BALL_BASEBALL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_BASEBALL = /* @__PURE__ */ printed(PLAIN_BASEBALL);
+/**
+ * The Softball emblem (ソフトボール in Japanese): id `ball:softball`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SOFTBALL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOFTBALL.id, BALL_SOFTBALL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SOFTBALL = /* @__PURE__ */ printed(PLAIN_SOFTBALL);
+/**
+ * The Soccer ball emblem (サッカーボール in Japanese): id `ball:soccer`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER.id, BALL_SOCCER.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SOCCER = /* @__PURE__ */ printed(PLAIN_SOCCER);
+/**
+ * The Soccer ball, coloured emblem (サッカーボール（カラー） in Japanese): id `ball:soccer-colour`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_COLOUR } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_COLOUR.id, BALL_SOCCER_COLOUR.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SOCCER_COLOUR = /* @__PURE__ */ printed(PLAIN_SOCCER_COLOUR);
+/**
+ * The Soccer ball, orange emblem (32枚貼り・オレンジ in Japanese): id `ball:soccer-orange`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_ORANGE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_ORANGE.id, BALL_SOCCER_ORANGE.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SOCCER_ORANGE = /* @__PURE__ */ printed(PLAIN_SOCCER_ORANGE);
+/**
+ * The Soccer ball, yellow emblem (32枚貼り・蛍光イエロー in Japanese): id `ball:soccer-yellow`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_YELLOW } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_YELLOW.id, BALL_SOCCER_YELLOW.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SOCCER_YELLOW = /* @__PURE__ */ printed(PLAIN_SOCCER_YELLOW);

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

@@ -6,6 +6,14 @@ export declare const PUCK_H: number;
 export declare const PUCK_SIZE: PieceSize;
 /** The plain puck's drawing: black rubber, a ridged edge, and the ring a moulded top face has. A printed puck is this drawing with its print laid over the ring's place (ball.puck.print.ts). */
 export declare const puckSpec: (extra?: Partial<StackSpec>) => StackSpec;
+/**
+ * The Hockey puck emblem (アイスホッケーのパック in Japanese): id `ball:puck`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PUCK } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PUCK.id, BALL_PUCK.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_PUCK: import("./ball.core.ts").Piece<{
     slices: number;
 } & {

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

@@ -18,6 +18,14 @@ export const puckSpec = (extra) => ({
     topRing: { r: 0.9, colour: "#4a4d56" },
     ...extra,
 });
+/**
+ * The Hockey puck emblem (アイスホッケーのパック in Japanese): id `ball:puck`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_PUCK } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_PUCK.id, BALL_PUCK.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_PUCK = /* @__PURE__ */ defineObject({
     id: "ball:puck",
     en: "Hockey puck",

package/dist/emblems/ball/ball.puck.print.d.ts

@@ -1,5 +1,13 @@
 import { type Piece } from "./ball.core.ts";
 import { type PuckDesign } from "./ball.face.ts";
+/**
+ * The Canada flag puck emblem (カナダ国旗のパック in Japanese): id `puck:canada`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { PUCK_CANADA } from "@johnmorrisdotca/dougu-sports";
+ * console.log(PUCK_CANADA.id, PUCK_CANADA.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const PUCK_CANADA: Piece<{
     slices: number;
     design: PuckDesign;
@@ -9,6 +17,14 @@ export declare const PUCK_CANADA: Piece<{
         roll: number;
     };
 }>;
+/**
+ * The Canada red puck emblem (カナダ赤地のパック in Japanese): id `puck:canada-red`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { PUCK_CANADA_RED } from "@johnmorrisdotca/dougu-sports";
+ * console.log(PUCK_CANADA_RED.id, PUCK_CANADA_RED.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const PUCK_CANADA_RED: Piece<{
     slices: number;
     design: PuckDesign;
@@ -18,6 +34,14 @@ export declare const PUCK_CANADA_RED: Piece<{
         roll: number;
     };
 }>;
+/**
+ * The Canada white puck emblem (カナダ白地のパック in Japanese): id `puck:canada-white`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { PUCK_CANADA_WHITE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(PUCK_CANADA_WHITE.id, PUCK_CANADA_WHITE.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const PUCK_CANADA_WHITE: Piece<{
     slices: number;
     design: PuckDesign;
@@ -27,6 +51,14 @@ export declare const PUCK_CANADA_WHITE: Piece<{
         roll: number;
     };
 }>;
+/**
+ * The USA stripes puck emblem (アメリカ星条旗のパック in Japanese): id `puck:usa`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { PUCK_USA } from "@johnmorrisdotca/dougu-sports";
+ * console.log(PUCK_USA.id, PUCK_USA.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const PUCK_USA: Piece<{
     slices: number;
     design: PuckDesign;
@@ -36,6 +68,14 @@ export declare const PUCK_USA: Piece<{
         roll: number;
     };
 }>;
+/**
+ * The USA navy puck emblem (アメリカ紺地のパック in Japanese): id `puck:usa-navy`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { PUCK_USA_NAVY } from "@johnmorrisdotca/dougu-sports";
+ * console.log(PUCK_USA_NAVY.id, PUCK_USA_NAVY.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const PUCK_USA_NAVY: Piece<{
     slices: number;
     design: PuckDesign;
@@ -45,6 +85,14 @@ export declare const PUCK_USA_NAVY: Piece<{
         roll: number;
     };
 }>;
+/**
+ * The Player number puck emblem (選手名と背番号のパック in Japanese): id `puck:player`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { PUCK_PLAYER } from "@johnmorrisdotca/dougu-sports";
+ * console.log(PUCK_PLAYER.id, PUCK_PLAYER.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const PUCK_PLAYER: Piece<{
     slices: number;
     design: PuckDesign;
@@ -54,6 +102,14 @@ export declare const PUCK_PLAYER: Piece<{
         roll: number;
     };
 }>;
+/**
+ * The Signed puck emblem (サイン入りパック in Japanese): id `puck:signed`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { PUCK_SIGNED } from "@johnmorrisdotca/dougu-sports";
+ * console.log(PUCK_SIGNED.id, PUCK_SIGNED.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const PUCK_SIGNED: Piece<{
     slices: number;
     design: PuckDesign;
@@ -63,6 +119,14 @@ export declare const PUCK_SIGNED: Piece<{
         roll: number;
     };
 }>;
+/**
+ * The Souvenir puck emblem (記念パック in Japanese): id `puck:souvenir`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { PUCK_SOUVENIR } from "@johnmorrisdotca/dougu-sports";
+ * console.log(PUCK_SOUVENIR.id, PUCK_SOUVENIR.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const PUCK_SOUVENIR: Piece<{
     slices: number;
     design: PuckDesign;