@johnmorrisdotca/dougu-sports 0.28.0 → 0.29.0

package/dist/emblems/ball/ball.soccer.vintage.d.ts

@@ -1,11 +1,46 @@
 import { type BallSpec } from "./ball.engine.ts";
-/** The late 1800s: eight long panels sewn by hand with a visible cross of thread, and a button where they meet at each end. */
+/**
+ * The late 1800s: eight long panels sewn by hand with a visible cross of thread, and a button where they meet at each end.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_1870_HAND_STITCHED } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_1870_HAND_STITCHED.id, BALL_SOCCER_1870_HAND_STITCHED.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SOCCER_1870_HAND_STITCHED: import("./ball.core.ts").Piece<BallSpec>;
-/** The 1900s: eight panels, a round cap at each end, and a slit across which a lace is drawn to shut the casing once the bladder is in. */
+/**
+ * The 1900s: eight panels, a round cap at each end, and a slit across which a lace is drawn to shut the casing once the bladder is in.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_1900_LACED } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_1900_LACED.id, BALL_SOCCER_1900_LACED.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SOCCER_1900_LACED: import("./ball.core.ts").Piece<BallSpec>;
-/** The 1930s: eighteen strips, six panels of three, in two tones of leather, the seams stitched in two rows. */
+/**
+ * The 1930s: eighteen strips, six panels of three, in two tones of leather, the seams stitched in two rows.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_1930_18_PANEL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_1930_18_PANEL.id, BALL_SOCCER_1930_18_PANEL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SOCCER_1930_18_PANEL: import("./ball.core.ts").Piece<BallSpec>;
-/** The 1950s: twelve pentagons, in four tones of chestnut leather so that no two that touch match, the seams stitched. */
+/**
+ * The 1950s: twelve pentagons, in four tones of chestnut leather so that no two that touch match, the seams stitched.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_1950_12_PANEL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_1950_12_PANEL.id, BALL_SOCCER_1950_12_PANEL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SOCCER_1950_12_PANEL: import("./ball.core.ts").Piece<BallSpec>;
-/** The 1960s: the 32 panels (twelve pentagons and twenty hexagons) in leather, tan hexagons and chestnut pentagons, stitched along the seams. */
+/**
+ * The 1960s: the 32 panels (twelve pentagons and twenty hexagons) in leather, tan hexagons and chestnut pentagons, stitched along the seams.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_1960_32_PANEL_LEATHER } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_1960_32_PANEL_LEATHER.id, BALL_SOCCER_1960_32_PANEL_LEATHER.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SOCCER_1960_32_PANEL_LEATHER: import("./ball.core.ts").Piece<BallSpec>;

package/dist/emblems/ball/ball.soccer.vintage.js

@@ -33,7 +33,14 @@ function paintGores(s, g, base) {
     return out;
 }
 const POLES = [(g) => g.seams[0][0], (g) => g.seams[0][g.seams[0].length - 1]];
-/** The late 1800s: eight long panels sewn by hand with a visible cross of thread, and a button where they meet at each end. */
+/**
+ * The late 1800s: eight long panels sewn by hand with a visible cross of thread, and a button where they meet at each end.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_1870_HAND_STITCHED } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_1870_HAND_STITCHED.id, BALL_SOCCER_1870_HAND_STITCHED.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SOCCER_1870_HAND_STITCHED = /* @__PURE__ */ defineBall({
     id: "ball:soccer-1870-hand-stitched",
     en: "Soccer ball, hand-stitched",
@@ -52,7 +59,14 @@ export const BALL_SOCCER_1870_HAND_STITCHED = /* @__PURE__ */ defineBall({
         return out;
     }),
 });
-/** The 1900s: eight panels, a round cap at each end, and a slit across which a lace is drawn to shut the casing once the bladder is in. */
+/**
+ * The 1900s: eight panels, a round cap at each end, and a slit across which a lace is drawn to shut the casing once the bladder is in.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_1900_LACED } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_1900_LACED.id, BALL_SOCCER_1900_LACED.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SOCCER_1900_LACED = /* @__PURE__ */ defineBall({
     id: "ball:soccer-1900-laced",
     en: "Soccer ball, laced",
@@ -78,7 +92,14 @@ export const BALL_SOCCER_1900_LACED = /* @__PURE__ */ defineBall({
         return out;
     }),
 });
-/** The 1930s: eighteen strips, six panels of three, in two tones of leather, the seams stitched in two rows. */
+/**
+ * The 1930s: eighteen strips, six panels of three, in two tones of leather, the seams stitched in two rows.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_1930_18_PANEL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_1930_18_PANEL.id, BALL_SOCCER_1930_18_PANEL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SOCCER_1930_18_PANEL = /* @__PURE__ */ defineBall({
     id: "ball:soccer-1930-18-panel",
     en: "Soccer ball, 18 strips",
@@ -94,7 +115,14 @@ export const BALL_SOCCER_1930_18_PANEL = /* @__PURE__ */ defineBall({
         return out;
     }),
 });
-/** The 1950s: twelve pentagons, in four tones of chestnut leather so that no two that touch match, the seams stitched. */
+/**
+ * The 1950s: twelve pentagons, in four tones of chestnut leather so that no two that touch match, the seams stitched.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_1950_12_PANEL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_1950_12_PANEL.id, BALL_SOCCER_1950_12_PANEL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SOCCER_1950_12_PANEL = /* @__PURE__ */ defineBall({
     id: "ball:soccer-1950-12-panel",
     en: "Soccer ball, 12 panels",
@@ -113,7 +141,14 @@ export const BALL_SOCCER_1950_12_PANEL = /* @__PURE__ */ defineBall({
         return out;
     }),
 });
-/** The 1960s: the 32 panels (twelve pentagons and twenty hexagons) in leather, tan hexagons and chestnut pentagons, stitched along the seams. */
+/**
+ * The 1960s: the 32 panels (twelve pentagons and twenty hexagons) in leather, tan hexagons and chestnut pentagons, stitched along the seams.
+ * @example
+ * ```ts
+ * import { BALL_SOCCER_1960_32_PANEL_LEATHER } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SOCCER_1960_32_PANEL_LEATHER.id, BALL_SOCCER_1960_32_PANEL_LEATHER.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SOCCER_1960_32_PANEL_LEATHER = /* @__PURE__ */ defineBall({
     id: "ball:soccer-1960-32-panel-leather",
     en: "Soccer ball, 32 leather",

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

@@ -1,7 +1,47 @@
 import type { Piece } from "./ball.core.ts";
 import type { BallSpec } from "./ball.engine.ts";
+/**
+ * The Squash ball, 2 yellow dots emblem (スカッシュ球（ダブルイエロー） in Japanese): id `ball:squash`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SQUASH_DOUBLE_YELLOW } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SQUASH_DOUBLE_YELLOW.id, BALL_SQUASH_DOUBLE_YELLOW.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SQUASH_DOUBLE_YELLOW: Piece<BallSpec>;
+/**
+ * The Squash ball, yellow dot emblem (スカッシュ球（黄色） in Japanese): id `ball:squash-yellow`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SQUASH_YELLOW } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SQUASH_YELLOW.id, BALL_SQUASH_YELLOW.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SQUASH_YELLOW: Piece<BallSpec>;
+/**
+ * The Squash ball, red dot emblem (スカッシュ球（赤） in Japanese): id `ball:squash-red`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SQUASH_RED } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SQUASH_RED.id, BALL_SQUASH_RED.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SQUASH_RED: Piece<BallSpec>;
+/**
+ * The Squash ball, blue dot emblem (スカッシュ球（青） in Japanese): id `ball:squash-blue`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SQUASH_BLUE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SQUASH_BLUE.id, BALL_SQUASH_BLUE.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SQUASH_BLUE: Piece<BallSpec>;
+/**
+ * The Squash ball, green dot emblem (スカッシュ球（緑） in Japanese): id `ball:squash-green`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SQUASH_GREEN } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SQUASH_GREEN.id, BALL_SQUASH_GREEN.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_SQUASH_GREEN: Piece<BallSpec>;

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

@@ -20,8 +20,48 @@ 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." };
+/**
+ * The Squash ball, 2 yellow dots emblem (スカッシュ球（ダブルイエロー） in Japanese): id `ball:squash`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SQUASH_DOUBLE_YELLOW } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SQUASH_DOUBLE_YELLOW.id, BALL_SQUASH_DOUBLE_YELLOW.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SQUASH_DOUBLE_YELLOW = /* @__PURE__ */ squash("ball:squash", "Squash ball, 2 yellow dots", "スカッシュ球（ダブルイエロー）", "#f4d41c", 2, SIZE);
+/**
+ * The Squash ball, yellow dot emblem (スカッシュ球（黄色） in Japanese): id `ball:squash-yellow`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SQUASH_YELLOW } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SQUASH_YELLOW.id, BALL_SQUASH_YELLOW.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SQUASH_YELLOW = /* @__PURE__ */ squash("ball:squash-yellow", "Squash ball, yellow dot", "スカッシュ球（黄色）", "#f4d41c", 1, SIZE);
+/**
+ * The Squash ball, red dot emblem (スカッシュ球（赤） in Japanese): id `ball:squash-red`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SQUASH_RED } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SQUASH_RED.id, BALL_SQUASH_RED.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SQUASH_RED = /* @__PURE__ */ squash("ball:squash-red", "Squash ball, red dot", "スカッシュ球（赤）", "#d9262c", 1, SIZE);
+/**
+ * The Squash ball, blue dot emblem (スカッシュ球（青） in Japanese): id `ball:squash-blue`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SQUASH_BLUE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SQUASH_BLUE.id, BALL_SQUASH_BLUE.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SQUASH_BLUE = /* @__PURE__ */ squash("ball:squash-blue", "Squash ball, blue dot", "スカッシュ球（青）", "#2b6fd6", 1, SIZE);
+/**
+ * The Squash ball, green dot emblem (スカッシュ球（緑） in Japanese): id `ball:squash-green`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_SQUASH_GREEN } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_SQUASH_GREEN.id, BALL_SQUASH_GREEN.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_SQUASH_GREEN = /* @__PURE__ */ squash("ball:squash-green", "Squash ball, green dot", "スカッシュ球（緑）", "#2aa84a", 1, SIZE);

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

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

package/dist/emblems/ball/ball.tennis.js

@@ -1,5 +1,13 @@
 // Tennis ball: optic-yellow felt with a white strip of rubber along the seam. The felt's fuzz is the grain.
 import { seamedBall } from "./ball.family.seamed.js";
+/**
+ * The Tennis ball emblem (テニスボール in Japanese): id `ball:tennis`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_TENNIS } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_TENNIS.id, BALL_TENNIS.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_TENNIS = /* @__PURE__ */ seamedBall({
     id: "ball:tennis",
     en: "Tennis ball",

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

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

package/dist/emblems/ball/ball.teqball.js

@@ -2,6 +2,14 @@
 import { defineBall } from "./ball.engine.js";
 import { shrink, truncatedIcosahedron } from "./ball.polyhedra.js";
 import { blend, mix } from "./ball.core.js";
+/**
+ * The Teqball ball emblem (テックボール用ボール in Japanese): id `ball:teqball`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_TEQBALL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_TEQBALL.id, BALL_TEQBALL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_TEQBALL = /* @__PURE__ */ defineBall({
     id: "ball:teqball",
     en: "Teqball ball",

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

@@ -1,3 +1,27 @@
+/**
+ * The Volleyball emblem (バレーボール in Japanese): id `ball:volleyball`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL.id, BALL_VOLLEYBALL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/**
+ * The Volleyball, 8 panels emblem (バレーボール（8枚貼り） in Japanese): id `ball:volleyball-8`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_8 } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_8.id, BALL_VOLLEYBALL_8.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_8: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/**
+ * The Beach volleyball emblem (ビーチバレーボール in Japanese): id `ball:beach-volleyball`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_BEACH_VOLLEYBALL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_BEACH_VOLLEYBALL.id, BALL_BEACH_VOLLEYBALL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_BEACH_VOLLEYBALL: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;

package/dist/emblems/ball/ball.volleyball.flag.d.ts

@@ -23,15 +23,103 @@ export declare const VOLLEYBALL_PLANS: {
     readonly netherlands: VolleyballPlan;
     readonly germany: VolleyballPlan;
 };
+/**
+ * The Volleyball, three colours emblem (三色のバレーボール in Japanese): id `ball:volleyball-colours`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_COLOURS } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_COLOURS.id, BALL_VOLLEYBALL_COLOURS.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_COLOURS: import("./ball.core.ts").Piece<BallSpec>;
+/**
+ * The Volleyball, Brazil emblem (バレー（ブラジル） in Japanese): id `ball:volleyball-brazil`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_BRAZIL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_BRAZIL.id, BALL_VOLLEYBALL_BRAZIL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_BRAZIL: import("./ball.core.ts").Piece<BallSpec>;
+/**
+ * The Volleyball, Japan emblem (バレー（日本） in Japanese): id `ball:volleyball-japan`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_JAPAN } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_JAPAN.id, BALL_VOLLEYBALL_JAPAN.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_JAPAN: import("./ball.core.ts").Piece<BallSpec>;
+/**
+ * The Volleyball, Canada emblem (バレー（カナダ） in Japanese): id `ball:volleyball-canada`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_CANADA } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_CANADA.id, BALL_VOLLEYBALL_CANADA.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_CANADA: import("./ball.core.ts").Piece<BallSpec>;
+/**
+ * The Volleyball, USA emblem (バレー（アメリカ） in Japanese): id `ball:volleyball-usa`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_USA } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_USA.id, BALL_VOLLEYBALL_USA.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_USA: import("./ball.core.ts").Piece<BallSpec>;
+/**
+ * The Volleyball, Italy emblem (バレー（イタリア） in Japanese): id `ball:volleyball-italy`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_ITALY } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_ITALY.id, BALL_VOLLEYBALL_ITALY.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_ITALY: import("./ball.core.ts").Piece<BallSpec>;
+/**
+ * The Volleyball, Poland emblem (バレー（ポーランド） in Japanese): id `ball:volleyball-poland`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_POLAND } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_POLAND.id, BALL_VOLLEYBALL_POLAND.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_POLAND: import("./ball.core.ts").Piece<BallSpec>;
+/**
+ * The Volleyball, France emblem (バレー（フランス） in Japanese): id `ball:volleyball-france`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_FRANCE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_FRANCE.id, BALL_VOLLEYBALL_FRANCE.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_FRANCE: import("./ball.core.ts").Piece<BallSpec>;
+/**
+ * The Volleyball, Serbia emblem (バレー（セルビア） in Japanese): id `ball:volleyball-serbia`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_SERBIA } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_SERBIA.id, BALL_VOLLEYBALL_SERBIA.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_SERBIA: import("./ball.core.ts").Piece<BallSpec>;
+/**
+ * The Volleyball, Netherlands emblem (バレー（オランダ） in Japanese): id `ball:volleyball-netherlands`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_NETHERLANDS } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_NETHERLANDS.id, BALL_VOLLEYBALL_NETHERLANDS.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_NETHERLANDS: import("./ball.core.ts").Piece<BallSpec>;
+/**
+ * The Volleyball, Germany emblem (バレー（ドイツ） in Japanese): id `ball:volleyball-germany`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_GERMANY } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_GERMANY.id, BALL_VOLLEYBALL_GERMANY.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const BALL_VOLLEYBALL_GERMANY: import("./ball.core.ts").Piece<BallSpec>;
 export {};

package/dist/emblems/ball/ball.volleyball.flag.js

@@ -49,14 +49,102 @@ function nation(id, en, ja, laid, view = laid.corner === true ? { yaw: 20, pitch
         },
     });
 }
+/**
+ * The Volleyball, three colours emblem (三色のバレーボール in Japanese): id `ball:volleyball-colours`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_COLOURS } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_COLOURS.id, BALL_VOLLEYBALL_COLOURS.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_COLOURS = /* @__PURE__ */ nation("ball:volleyball-colours", "Volleyball, three colours", "三色のバレーボール", plan(["#f3c81c", "#1f5fbf", WHITE], "aba bcb cac aca bab cbc"));
+/**
+ * The Volleyball, Brazil emblem (バレー（ブラジル） in Japanese): id `ball:volleyball-brazil`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_BRAZIL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_BRAZIL.id, BALL_VOLLEYBALL_BRAZIL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_BRAZIL = /* @__PURE__ */ nation("ball:volleyball-brazil", "Volleyball, Brazil", "バレー（ブラジル）", VOLLEYBALL_PLANS.brazil);
+/**
+ * The Volleyball, Japan emblem (バレー（日本） in Japanese): id `ball:volleyball-japan`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_JAPAN } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_JAPAN.id, BALL_VOLLEYBALL_JAPAN.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_JAPAN = /* @__PURE__ */ nation("ball:volleyball-japan", "Volleyball, Japan", "バレー（日本）", VOLLEYBALL_PLANS.japan);
+/**
+ * The Volleyball, Canada emblem (バレー（カナダ） in Japanese): id `ball:volleyball-canada`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_CANADA } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_CANADA.id, BALL_VOLLEYBALL_CANADA.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_CANADA = /* @__PURE__ */ nation("ball:volleyball-canada", "Volleyball, Canada", "バレー（カナダ）", VOLLEYBALL_PLANS.canada);
+/**
+ * The Volleyball, USA emblem (バレー（アメリカ） in Japanese): id `ball:volleyball-usa`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_USA } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_USA.id, BALL_VOLLEYBALL_USA.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_USA = /* @__PURE__ */ nation("ball:volleyball-usa", "Volleyball, USA", "バレー（アメリカ）", VOLLEYBALL_PLANS.usa);
+/**
+ * The Volleyball, Italy emblem (バレー（イタリア） in Japanese): id `ball:volleyball-italy`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_ITALY } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_ITALY.id, BALL_VOLLEYBALL_ITALY.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_ITALY = /* @__PURE__ */ nation("ball:volleyball-italy", "Volleyball, Italy", "バレー（イタリア）", VOLLEYBALL_PLANS.italy);
+/**
+ * The Volleyball, Poland emblem (バレー（ポーランド） in Japanese): id `ball:volleyball-poland`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_POLAND } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_POLAND.id, BALL_VOLLEYBALL_POLAND.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_POLAND = /* @__PURE__ */ nation("ball:volleyball-poland", "Volleyball, Poland", "バレー（ポーランド）", VOLLEYBALL_PLANS.poland);
+/**
+ * The Volleyball, France emblem (バレー（フランス） in Japanese): id `ball:volleyball-france`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_FRANCE } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_FRANCE.id, BALL_VOLLEYBALL_FRANCE.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_FRANCE = /* @__PURE__ */ nation("ball:volleyball-france", "Volleyball, France", "バレー（フランス）", VOLLEYBALL_PLANS.france);
+/**
+ * The Volleyball, Serbia emblem (バレー（セルビア） in Japanese): id `ball:volleyball-serbia`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_SERBIA } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_SERBIA.id, BALL_VOLLEYBALL_SERBIA.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_SERBIA = /* @__PURE__ */ nation("ball:volleyball-serbia", "Volleyball, Serbia", "バレー（セルビア）", VOLLEYBALL_PLANS.serbia);
+/**
+ * The Volleyball, Netherlands emblem (バレー（オランダ） in Japanese): id `ball:volleyball-netherlands`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_NETHERLANDS } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_NETHERLANDS.id, BALL_VOLLEYBALL_NETHERLANDS.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_NETHERLANDS = /* @__PURE__ */ nation("ball:volleyball-netherlands", "Volleyball, Netherlands", "バレー（オランダ）", VOLLEYBALL_PLANS.netherlands);
+/**
+ * The Volleyball, Germany emblem (バレー（ドイツ） in Japanese): id `ball:volleyball-germany`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_GERMANY } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_GERMANY.id, BALL_VOLLEYBALL_GERMANY.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_GERMANY = /* @__PURE__ */ nation("ball:volleyball-germany", "Volleyball, Germany", "バレー（ドイツ）", VOLLEYBALL_PLANS.germany);

package/dist/emblems/ball/ball.volleyball.js

@@ -4,6 +4,14 @@ import { octants8, strips18 } from "./ball.family.panelled.js";
 const YELLOW = "#f3c81c";
 const BLUE = "#1f5fbf";
 const WHITE = "#f6f4ee";
+/**
+ * The Volleyball emblem (バレーボール in Japanese): id `ball:volleyball`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL.id, BALL_VOLLEYBALL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL = /* @__PURE__ */ defineBall({
     id: "ball:volleyball",
     en: "Volleyball",
@@ -23,6 +31,14 @@ export const BALL_VOLLEYBALL = /* @__PURE__ */ defineBall({
         ], "#3a4560"),
     },
 });
+/**
+ * The Volleyball, 8 panels emblem (バレーボール（8枚貼り） in Japanese): id `ball:volleyball-8`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_VOLLEYBALL_8 } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_VOLLEYBALL_8.id, BALL_VOLLEYBALL_8.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_VOLLEYBALL_8 = /* @__PURE__ */ defineBall({
     id: "ball:volleyball-8",
     en: "Volleyball, 8 panels",
@@ -35,6 +51,14 @@ export const BALL_VOLLEYBALL_8 = /* @__PURE__ */ defineBall({
         draw: (s, base) => octants8(s, (sx, sy, sz) => (sy > 0 ? (sx * sz > 0 ? base : BLUE) : sx * sz > 0 ? WHITE : BLUE), "#3a4560"),
     },
 });
+/**
+ * The Beach volleyball emblem (ビーチバレーボール in Japanese): id `ball:beach-volleyball`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_BEACH_VOLLEYBALL } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_BEACH_VOLLEYBALL.id, BALL_BEACH_VOLLEYBALL.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_BEACH_VOLLEYBALL = /* @__PURE__ */ defineBall({
     id: "ball:beach-volleyball",
     en: "Beach volleyball",

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

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

package/dist/emblems/ball/ball.waterpolo.js

@@ -6,6 +6,14 @@ import { mix } from "./ball.core.js";
 const AXES = [[1, 0, 0], [0, 1, 0], [0, 0, 1]];
 /** How far the grooves run from a seam, in radians. */
 const OFFSETS = [0.17];
+/**
+ * The Water polo ball emblem (水球ボール in Japanese): id `ball:water-polo`, a ball turned in 3D.
+ * @example
+ * ```ts
+ * import { BALL_WATER_POLO } from "@johnmorrisdotca/dougu-sports";
+ * console.log(BALL_WATER_POLO.id, BALL_WATER_POLO.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const BALL_WATER_POLO = /* @__PURE__ */ defineBall({
     id: "ball:water-polo",
     en: "Water polo ball",

package/dist/emblems/crest/diamond.d.ts

@@ -1,2 +1,9 @@
-/** A diamond with a thin diamond inside it. */
+/**
+ * A diamond with a thin diamond inside it.
+ * @example
+ * ```ts
+ * import { CREST_DIAMOND } from "@johnmorrisdotca/dougu-sports";
+ * console.log(CREST_DIAMOND.id, CREST_DIAMOND.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const CREST_DIAMOND: import("../emblem.core.ts").Emblem<import("../emblem.shapes.ts").FlatModel>;

package/dist/emblems/crest/diamond.js

@@ -1,6 +1,13 @@
 // A diamond with a thin diamond inside it, tinted by a team's colours, with the team's letters on it or a star. Drawn for this package.
 import { defineFlat, starPath } from "../emblem.shapes.js";
-/** A diamond with a thin diamond inside it. */
+/**
+ * A diamond with a thin diamond inside it.
+ * @example
+ * ```ts
+ * import { CREST_DIAMOND } from "@johnmorrisdotca/dougu-sports";
+ * console.log(CREST_DIAMOND.id, CREST_DIAMOND.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const CREST_DIAMOND = /* @__PURE__ */ defineFlat("crest:diamond", "Diamond crest", "ひし形のエンブレム", "ours", {
     metal: "flat",
     color: "#2d5a8c",

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

@@ -1,2 +1,9 @@
-/** A pennant on a pole. */
+/**
+ * A pennant on a pole.
+ * @example
+ * ```ts
+ * import { CREST_PENNANT } from "@johnmorrisdotca/dougu-sports";
+ * console.log(CREST_PENNANT.id, CREST_PENNANT.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export declare const CREST_PENNANT: import("../emblem.core.ts").Emblem<import("../emblem.shapes.ts").FlatModel>;

package/dist/emblems/crest/pennant.js

@@ -1,6 +1,13 @@
 // A pennant on a pole, tinted by a team's colours, with the team's letters on it or a star. Drawn for this package.
 import { defineFlat, starPath } from "../emblem.shapes.js";
-/** A pennant on a pole. */
+/**
+ * A pennant on a pole.
+ * @example
+ * ```ts
+ * import { CREST_PENNANT } from "@johnmorrisdotca/dougu-sports";
+ * console.log(CREST_PENNANT.id, CREST_PENNANT.svg({ size: 48 }).startsWith("<svg"));
+ * ```
+ */
 export const CREST_PENNANT = /* @__PURE__ */ defineFlat("crest:pennant", "Pennant crest", "ペナント形のエンブレム", "ours", {
     metal: "flat",
     color: "#2d5a8c",