@johnmorrisdotca/dougu-sports 0.1.0 → 0.2.0

package/dist/emblems/trophy/ring.js

@@ -0,0 +1,30 @@
+// A championship ring seen face on: a thick band, a wide faceted head with a gem in a bezel, and a flat on each shoulder of the head for the team and the year. It turns like a coin, with its rim, and shows
+// the plain back of the head. Drawn for this package: generic, no team's or league's ring.
+import { circlePath, defineFlat } from "../emblem.shapes.js";
+const poly = (...p) => `M${p.map((q) => q.join(" ")).join("L")}Z`;
+/** A band: a disc with a round hole, wound the other way so that it is cut out. */
+const annulus = (cx, cy, R, r) => `M${cx - R} ${cy}a${R} ${R} 0 1 0 ${2 * R} 0a${R} ${R} 0 1 0 ${-2 * R} 0ZM${cx - r} ${cy}a${r} ${r} 0 1 1 ${2 * r} 0a${r} ${r} 0 1 1 ${-2 * r} 0Z`;
+const HEAD = poly([16, 5], [48, 5], [58, 14], [58, 26], [48, 35], [16, 35], [6, 26], [6, 14]);
+const BEZEL = poly([17.5, 8], [46.5, 8], [54.5, 15], [54.5, 25], [46.5, 32], [17.5, 32], [9.5, 25], [9.5, 15]);
+const GEM = poly([24, 11], [40, 11], [47, 17], [47, 23], [40, 29], [24, 29], [17, 23], [17, 17]);
+/** The facets: the table, and a line from each corner of the gem to the nearest corner of the table. */
+const FACETS = `${poly([27.5, 15.5], [36.5, 15.5], [40.5, 18.5], [40.5, 21.5], [36.5, 24.5], [27.5, 24.5], [23.5, 21.5], [23.5, 18.5])}M24 11L27.5 15.5M40 11L36.5 15.5M47 17L40.5 18.5M47 23L40.5 21.5M40 29L36.5 24.5M24 29L27.5 24.5M17 23L23.5 21.5M17 17L23.5 18.5`;
+const front = [
+    ["o", annulus(32, 44, 19, 11)],
+    ["t", circlePath(32, 44, 15)],
+    ["o", HEAD],
+    ["e", BEZEL, "1.6"],
+    ["r", GEM],
+    ["t", FACETS],
+    ["l", "M24 11L40 11L36.5 15.5L27.5 15.5ZM17 17L24 11L27.5 15.5L23.5 18.5Z"],
+];
+const back = [["o", annulus(32, 44, 19, 11)], ["o", HEAD], ["e", BEZEL, "1.6"]];
+/** A championship ring. */
+export const TROPHY_RING = /* @__PURE__ */ defineFlat("trophy:ring", "Championship ring", "優勝リング", "ours", {
+    metal: "gold",
+    ribbon: "#b3262e",
+    front,
+    back,
+    rim: 5,
+    engrave: { front: { x: 12.4, y: 20, w: 19, h: 7, rot: -90 }, year: { x: 51.6, y: 20, w: 19, h: 7, rot: 90 }, back: { x: 32, y: 20, w: 30, h: 12 } },
+});

package/dist/emblems/trophy/rugby-cup.js

@@ -19,4 +19,5 @@ export const TROPHY_RUGBY_CUP = /* @__PURE__ */ defineLathe("trophy:rugby-cup",
         { a: 90, w: 1.5, pts: [[9.4, 28], [14.2, 26], [17.6, 20], [17.6, 12.6], [15.6, 10.4], [16.6, 8.6]] },
         { a: -90, w: 1.5, pts: [[9.4, 28], [14.2, 26], [17.6, 20], [17.6, 12.6], [15.6, 10.4], [16.6, 8.6]] },
     ],
+    plate: { y0: 43.4, y1: 51.2 },
 });

package/dist/emblems/trophy/salver.js

@@ -5,4 +5,5 @@ export const TROPHY_SALVER = /* @__PURE__ */ defineLathe("trophy:salver", "Salve
     metal: "gold",
     tilt: 24,
     solids: [{ open: true, p: [[22, 30, 1], [24.4, 30, 1], [29, 22, 1], [34, 8, 1], [34, 4.8, 1], [42, 3.8, 1], [42, 9.4, 1], [46, 10.4, 1], [48, 12.6, 1], [51, 12.6, 1]], decor: [["disc", 26.4, "main"]] }],
+    plate: { y0: 48.2, y1: 50.8 },
 });

package/dist/emblems/trophy/soccer-ball.js

@@ -1,8 +1,9 @@
 // A gold soccer ball held up on a tapering stand with a stepped base. Drawn for this package.
 import { defineLathe } from "../emblem.lathe.js";
 /** A soccer ball held up on a tapering stand. */
-export const TROPHY_SOCCER_BALL = /* @__PURE__ */ defineLathe("trophy:soccer-ball", "Soccer ball trophy", "サッカーボールのトロフィー", "ours", {
+export const TROPHY_SOCCER_BALL = /* @__PURE__ */ defineLathe("trophy:soccer-ball", "Soccer ball trophy", "サッカーのトロフィー", "ours", {
     metal: "gold",
     solids: [{ p: [[27, 4.4, 1], [38, 3.4], [47, 5.4, 1], [47, 8, 1], [51, 8, 1], [51, 12.4, 1], [55, 12.4, 1], [55, 15, 1], [59, 15, 1]] }],
     balls: [{ kind: "soccer", cy: 16, r: 11.4 }],
+    plate: { y0: 55.2, y1: 58.8 },
 });

package/dist/emblems/trophy/soccer-globe.js

@@ -14,4 +14,5 @@ export const TROPHY_SOCCER_GLOBE = /* @__PURE__ */ defineLathe("trophy:soccer-gl
         },
     ],
     balls: [{ kind: "globe", cy: 11, r: 10 }],
+    plate: { y0: 52.4, y1: 56.8, tone: "green" },
 });

package/dist/emblems/trophy/sumo-cup.d.ts

@@ -0,0 +1,2 @@
+/** A tall silver cup with phoenix-crested handles on a tall stand. */
+export declare const TROPHY_SUMO_CUP: import("../emblem.core.ts").Emblem<import("../emblem.lathe.ts").LatheModel>;

package/dist/emblems/trophy/sumo-cup.js

@@ -0,0 +1,28 @@
+// A tall silver cup on a tall stepped stand: a wide bell of a bowl with a gilt rim, a knopped stem, and on each side an ornate handle that sweeps up past the rim and ends in a crested curl like a bird's
+// head, with a trailing plume below it. Drawn for this package from what such a cup is known to look like; a generic trophy that carries no name, mark or engraving.
+import { defineLathe } from "../emblem.lathe.js";
+/** The handle of one side: it swings out from the bowl, rises past the rim, and ends in a crest that curls over like a bird's head. */
+const side = (a) => ({ a, w: 2.4, tone: "gilt", pts: [[8.4, 27], [14, 25], [18.4, 18], [17.6, 10], [15.2, 3.8], [18, 1.6], [20.2, 3.6]] });
+/** A tall silver cup with phoenix-crested handles on a tall stand. */
+export const TROPHY_SUMO_CUP = /* @__PURE__ */ defineLathe("trophy:sumo-cup", "Phoenix-handle cup", "鳳凰飾りの銀杯", "ours", {
+    metal: "silver",
+    tones: { dark: "#2b2f36", gilt: "#d9a620" },
+    solids: [
+        {
+            open: true,
+            p: [
+                [8, 11.6, 1, "gilt"], [10.2, 11.2, 1, "gilt"],
+                [10.2, 10.6, 1], [14, 9.8], [20, 8.4], [25.4, 6.6], [28.6, 5, 1],
+                [28.6, 5.4, 1, "gilt"], [30.4, 5.4, 1, "gilt"],
+                [30.4, 3.2, 1], [33, 3.2], [35.4, 4.8], [37.2, 3.6], [39.4, 3.2, 1],
+                [39.4, 6, 1, "gilt"], [41.2, 6, 1, "gilt"],
+                [41.2, 8, 1], [43.4, 8.4, 1],
+                [43.4, 9.6, 1, "dark"], [47, 9.6, 1, "dark"],
+                [47, 11.6, 1, "gilt"], [48.6, 11.6, 1, "gilt"],
+                [48.6, 13.2, 1, "dark"], [58, 13.2, 1, "dark"],
+            ],
+        },
+    ],
+    handles: [side(90), side(-90)],
+    plate: { y0: 50.4, y1: 56.6, tone: "dark" },
+});

package/dist/emblems/trophy/tennis-cup.js

@@ -1,7 +1,7 @@
 // A gilded two-handled cup with a domed lid and a small pineapple on top, on a stem and a round plinth. Drawn for this package; a generic trophy.
 import { defineLathe } from "../emblem.lathe.js";
 /** A two-handled cup with a lid and a small pineapple finial. */
-export const TROPHY_TENNIS_CUP = /* @__PURE__ */ defineLathe("trophy:tennis-cup", "Two-handled cup with a pineapple", "取っ手が二つあり、ふたにパイナップルの飾りが付いたカップ", "ours", {
+export const TROPHY_TENNIS_CUP = /* @__PURE__ */ defineLathe("trophy:tennis-cup", "Pineapple cup", "パイナップル飾りのカップ", "ours", {
     metal: "gold",
     tones: { dark: "#2b2f36" },
     solids: [
@@ -20,4 +20,5 @@ export const TROPHY_TENNIS_CUP = /* @__PURE__ */ defineLathe("trophy:tennis-cup"
         { a: 90, w: 1.8, pts: [[10.8, 26], [14.8, 24.6], [17.6, 19], [17, 14], [15.2, 12.4]] },
         { a: -90, w: 1.8, pts: [[10.8, 26], [14.8, 24.6], [17.6, 19], [17, 14], [15.2, 12.4]] },
     ],
+    plate: { y0: 45.8, y1: 52.6 },
 });

package/dist/emblems/trophy/tennis-plate.js

@@ -12,4 +12,5 @@ export const TROPHY_TENNIS_PLATE = /* @__PURE__ */ defineLathe("trophy:tennis-pl
             decor: [["disc", 28, "gilt"], ["disc", 25.6, "main"], ["pills", 22.6, 10, 22, 3.6, "plain"], ["disc", 18.6, "gilt"], ["disc", 15.6, "main"], ["pills", 11, 4, 36, 3.6, "plain"], ["disc", 6.4, "gilt"], ["disc", 3.8, "main"]],
         },
     ],
+    plate: { y0: 50.2, y1: 53.8 },
 });

package/dist/emblems-entry.d.ts

@@ -1,12 +1,21 @@
-export { EMBLEMS, crest, emblemInfo, emblemModel, emblemName, emblemOf, emblemSvg, isBallId, isEmblemId, medal, parseEmblem, renderEmblem, sportIcon } from "./emblems/emblem.api.ts";
-export type { CrestOptions, EmblemInfo, EmblemRef } from "./emblems/emblem.api.ts";
-export { AWARD_IDS, BALL_IDS, CREST_IDS, CREST_SHAPES, EMBLEM_ALIASES, EMBLEM_FOLDERS, EMBLEM_GROUPS, EMBLEM_IDS, GEAR_IDS, MEDAL_IDS, MEDAL_KINDS, SPORT_IDS, SPORT_NAMES, TROPHY_IDS } from "./emblems/emblem.ids.ts";
-export type { AwardId, BallId, CrestId, CrestShape, EmblemGroup, EmblemId, GearId, MedalId, MedalKind, SportEmblemId, SportName, TrophyId } from "./emblems/emblem.ids.ts";
+export { EMBLEM_DESCRIPTIONS } from "./emblems/emblem.descriptions.ts";
+export type { EmblemDescription } from "./emblems/emblem.descriptions.ts";
+export { EMBLEMS, crest, emblemInfo, emblemModel, emblemName, emblemOf, emblemSvg, isBallId, isEmblemId, medal, parseEmblem, pennant, renderEmblem, sportIcon } from "./emblems/emblem.api.ts";
+export type { CrestOptions, EmblemInfo, EmblemRef, PennantOptions } from "./emblems/emblem.api.ts";
+export { AWARD_IDS, BALL_IDS, CREST_IDS, CREST_SHAPES, EMBLEM_ALIASES, EMBLEM_FOLDERS, EMBLEM_GROUPS, EMBLEM_IDS, GEAR_IDS, JAPANESE_IDS, MEDAL_IDS, MEDAL_KINDS, PENNANT_IDS, SPORT_IDS, SPORT_NAMES, TROPHY_IDS } from "./emblems/emblem.ids.ts";
+export type { AwardId, BallId, CrestId, CrestShape, EmblemGroup, EmblemId, GearId, JapaneseId, MedalId, MedalKind, PennantId, SportEmblemId, SportName, TrophyId } from "./emblems/emblem.ids.ts";
 export { EMBLEM_INK, EMBLEM_PAGE, EMBLEM_STYLES, METALS } from "./emblems/emblem.core.ts";
-export type { Emblem, EmblemKind, EmblemOptions, EmblemSource, EmblemStyle, EmblemTheme, FrameOptions } from "./emblems/emblem.core.ts";
+export type { Emblem, EmblemKind, EmblemLocale, EmblemOptions, EmblemSource, EmblemStyle, EmblemTheme, FrameOptions } from "./emblems/emblem.core.ts";
 export { lineup } from "./emblems/ball/ball.index.ts";
 export type { LineupOptions } from "./emblems/ball/ball.index.ts";
 export type { PieceSize } from "./emblems/ball/ball.core.ts";
 export type { Ball, BallKind, Decor, Handle, LatheModel, Poles, Pt, Solid } from "./emblems/emblem.lathe.ts";
-export type { MaterialModel } from "./emblems/emblem.material.ts";
 export type { FlatModel, Role, Shape } from "./emblems/emblem.shapes.ts";
+export { emblemSprite } from "./emblems/emblem.sprite.ts";
+export type { Sprite, SpriteOptions, UseOptions } from "./emblems/emblem.sprite.ts";
+export { emblemDataUri } from "./emblems/emblem.uri.ts";
+export type { DataUriOptions } from "./emblems/emblem.uri.ts";
+export { sportEquipment } from "./emblems/emblem.equipment.ts";
+export type { SportEquipment } from "./emblems/emblem.equipment.ts";
+export { awardCase, podium } from "./emblems/emblem.display.ts";
+export type { AwardCaseOptions, AwardItem, DisplayOptions, PodiumOptions, PodiumPlace } from "./emblems/emblem.display.ts";

package/dist/emblems-entry.js

@@ -1,6 +1,11 @@
 // The emblems entry point: `renderEmblem(id, options)` draws any emblem from its id, and the ids and types say which there are. Nothing here imports a single drawing's module directly, so for one
 // emblem and nothing else import its own module (`@johnmorrisdotca/dougu-sports/ball/soccer`).
-export { EMBLEMS, crest, emblemInfo, emblemModel, emblemName, emblemOf, emblemSvg, isBallId, isEmblemId, medal, parseEmblem, renderEmblem, sportIcon } from "./emblems/emblem.api.js";
-export { AWARD_IDS, BALL_IDS, CREST_IDS, CREST_SHAPES, EMBLEM_ALIASES, EMBLEM_FOLDERS, EMBLEM_GROUPS, EMBLEM_IDS, GEAR_IDS, MEDAL_IDS, MEDAL_KINDS, SPORT_IDS, SPORT_NAMES, TROPHY_IDS } from "./emblems/emblem.ids.js";
+export { EMBLEM_DESCRIPTIONS } from "./emblems/emblem.descriptions.js";
+export { EMBLEMS, crest, emblemInfo, emblemModel, emblemName, emblemOf, emblemSvg, isBallId, isEmblemId, medal, parseEmblem, pennant, renderEmblem, sportIcon } from "./emblems/emblem.api.js";
+export { AWARD_IDS, BALL_IDS, CREST_IDS, CREST_SHAPES, EMBLEM_ALIASES, EMBLEM_FOLDERS, EMBLEM_GROUPS, EMBLEM_IDS, GEAR_IDS, JAPANESE_IDS, MEDAL_IDS, MEDAL_KINDS, PENNANT_IDS, SPORT_IDS, SPORT_NAMES, TROPHY_IDS } from "./emblems/emblem.ids.js";
 export { EMBLEM_INK, EMBLEM_PAGE, EMBLEM_STYLES, METALS } from "./emblems/emblem.core.js";
 export { lineup } from "./emblems/ball/ball.index.js";
+export { emblemSprite } from "./emblems/emblem.sprite.js";
+export { emblemDataUri } from "./emblems/emblem.uri.js";
+export { sportEquipment } from "./emblems/emblem.equipment.js";
+export { awardCase, podium } from "./emblems/emblem.display.js";

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./emblems-entry.ts";
 export { ballFrame, emblemFrame } from "./emblems/emblem.api.ts";
+export { bindTurn } from "./turn-control.ts";
+export type { TurnAngles, TurnContainer, TurnControlOptions, TurnController, TurnEvent } from "./turn-control.ts";
 export { EMBLEM_TABLE } from "./emblems/emblem.registry.ts";
 export { AWARD_MEDAL } from "./emblems/award/medal.ts";
 export { AWARD_BADGE } from "./emblems/award/badge.ts";
@@ -26,6 +28,10 @@ export { TROPHY_PLAQUE } from "./emblems/trophy/plaque.ts";
 export { TROPHY_BELT } from "./emblems/trophy/belt.ts";
 export { TROPHY_LAUREL } from "./emblems/trophy/laurel.ts";
 export { TROPHY_ROSETTE } from "./emblems/trophy/rosette.ts";
+export { TROPHY_SUMO_CUP } from "./emblems/trophy/sumo-cup.ts";
+export { TROPHY_CHAMPIONSHIP_BANNER } from "./emblems/trophy/championship-banner.ts";
+export { TROPHY_RING } from "./emblems/trophy/ring.ts";
+export { TROPHY_BANNER } from "./emblems/trophy/banner.ts";
 export { MEDAL_GOLD } from "./emblems/medal/gold.ts";
 export { MEDAL_SILVER } from "./emblems/medal/silver.ts";
 export { MEDAL_BRONZE } from "./emblems/medal/bronze.ts";
@@ -36,6 +42,7 @@ export { CREST_SHIELD } from "./emblems/crest/shield.ts";
 export { CREST_ROUNDEL } from "./emblems/crest/roundel.ts";
 export { CREST_DIAMOND } from "./emblems/crest/diamond.ts";
 export { CREST_PENNANT } from "./emblems/crest/pennant.ts";
+export { PENNANT_CHAMPIONSHIP } from "./emblems/pennant/championship.ts";
 export { SPORT_NFL } from "./emblems/sport/nfl.ts";
 export { SPORT_CFL } from "./emblems/sport/cfl.ts";
 export { SPORT_IFAF } from "./emblems/sport/ifaf.ts";
@@ -69,6 +76,11 @@ export { SPORT_FIELDHOCKEY } from "./emblems/sport/fieldhockey.ts";
 export { SPORT_HANDBALL } from "./emblems/sport/handball.ts";
 export { SPORT_ATHLETICS } from "./emblems/sport/athletics.ts";
 export { SPORT_SKATING } from "./emblems/sport/skating.ts";
+export { SPORT_SUMO } from "./emblems/sport/sumo.ts";
+export { SPORT_KENDO } from "./emblems/sport/kendo.ts";
+export { SPORT_JUDO } from "./emblems/sport/judo.ts";
+export { SPORT_KYUDO } from "./emblems/sport/kyudo.ts";
+export { SPORT_KARATE } from "./emblems/sport/karate.ts";
 export { BALL_AFL } from "./emblems/ball/ball.afl.ts";
 export { BALL_BASEBALL } from "./emblems/ball/ball.baseball.ts";
 export { BALL_BASKETBALL } from "./emblems/ball/ball.basketball.ts";
@@ -116,4 +128,9 @@ export { GEAR_TABLE_TENNIS_PADDLE } from "./emblems/gear/gear.tabletennispaddle.
 export { GEAR_TENNIS_RACKET } from "./emblems/gear/gear.tennisracket.ts";
 export { GEAR_STARTING_BLOCKS, GEAR_RELAY_BATON, GEAR_JAVELIN, GEAR_HURDLES } from "./emblems/gear/gear.track.ts";
 export { GEAR_DIVING_BOARD, GEAR_SWIM_GOGGLES } from "./emblems/gear/gear.water.ts";
+export { GEAR_GUNBAI, GEAR_MAWASHI } from "./emblems/gear/gear.sumo.ts";
+export { GEAR_SHINAI, GEAR_KENDO_MEN } from "./emblems/gear/gear.kendo.ts";
+export { GEAR_JUDOGI, GEAR_KARATE_GI, GEAR_OBI, OBI_RANKS, obi } from "./emblems/gear/gear.budo.ts";
+export type { ObiRank } from "./emblems/gear/gear.budo.ts";
+export { GEAR_YUMI, GEAR_YA } from "./emblems/gear/gear.kyudo.ts";
 export { VERSION } from "./version.ts";

package/dist/index.js

@@ -2,6 +2,7 @@
 // its own module (`@johnmorrisdotca/dougu-sports/trophy/hockey-cup`), and for the functions alone `@johnmorrisdotca/dougu-sports/emblems`.
 export * from "./emblems-entry.js";
 export { ballFrame, emblemFrame } from "./emblems/emblem.api.js";
+export { bindTurn } from "./turn-control.js";
 export { EMBLEM_TABLE } from "./emblems/emblem.registry.js";
 export { AWARD_MEDAL } from "./emblems/award/medal.js";
 export { AWARD_BADGE } from "./emblems/award/badge.js";
@@ -28,6 +29,10 @@ export { TROPHY_PLAQUE } from "./emblems/trophy/plaque.js";
 export { TROPHY_BELT } from "./emblems/trophy/belt.js";
 export { TROPHY_LAUREL } from "./emblems/trophy/laurel.js";
 export { TROPHY_ROSETTE } from "./emblems/trophy/rosette.js";
+export { TROPHY_SUMO_CUP } from "./emblems/trophy/sumo-cup.js";
+export { TROPHY_CHAMPIONSHIP_BANNER } from "./emblems/trophy/championship-banner.js";
+export { TROPHY_RING } from "./emblems/trophy/ring.js";
+export { TROPHY_BANNER } from "./emblems/trophy/banner.js";
 export { MEDAL_GOLD } from "./emblems/medal/gold.js";
 export { MEDAL_SILVER } from "./emblems/medal/silver.js";
 export { MEDAL_BRONZE } from "./emblems/medal/bronze.js";
@@ -38,6 +43,7 @@ export { CREST_SHIELD } from "./emblems/crest/shield.js";
 export { CREST_ROUNDEL } from "./emblems/crest/roundel.js";
 export { CREST_DIAMOND } from "./emblems/crest/diamond.js";
 export { CREST_PENNANT } from "./emblems/crest/pennant.js";
+export { PENNANT_CHAMPIONSHIP } from "./emblems/pennant/championship.js";
 export { SPORT_NFL } from "./emblems/sport/nfl.js";
 export { SPORT_CFL } from "./emblems/sport/cfl.js";
 export { SPORT_IFAF } from "./emblems/sport/ifaf.js";
@@ -71,6 +77,11 @@ export { SPORT_FIELDHOCKEY } from "./emblems/sport/fieldhockey.js";
 export { SPORT_HANDBALL } from "./emblems/sport/handball.js";
 export { SPORT_ATHLETICS } from "./emblems/sport/athletics.js";
 export { SPORT_SKATING } from "./emblems/sport/skating.js";
+export { SPORT_SUMO } from "./emblems/sport/sumo.js";
+export { SPORT_KENDO } from "./emblems/sport/kendo.js";
+export { SPORT_JUDO } from "./emblems/sport/judo.js";
+export { SPORT_KYUDO } from "./emblems/sport/kyudo.js";
+export { SPORT_KARATE } from "./emblems/sport/karate.js";
 export { BALL_AFL } from "./emblems/ball/ball.afl.js";
 export { BALL_BASEBALL } from "./emblems/ball/ball.baseball.js";
 export { BALL_BASKETBALL } from "./emblems/ball/ball.basketball.js";
@@ -118,4 +129,8 @@ export { GEAR_TABLE_TENNIS_PADDLE } from "./emblems/gear/gear.tabletennispaddle.
 export { GEAR_TENNIS_RACKET } from "./emblems/gear/gear.tennisracket.js";
 export { GEAR_STARTING_BLOCKS, GEAR_RELAY_BATON, GEAR_JAVELIN, GEAR_HURDLES } from "./emblems/gear/gear.track.js";
 export { GEAR_DIVING_BOARD, GEAR_SWIM_GOGGLES } from "./emblems/gear/gear.water.js";
+export { GEAR_GUNBAI, GEAR_MAWASHI } from "./emblems/gear/gear.sumo.js";
+export { GEAR_SHINAI, GEAR_KENDO_MEN } from "./emblems/gear/gear.kendo.js";
+export { GEAR_JUDOGI, GEAR_KARATE_GI, GEAR_OBI, OBI_RANKS, obi } from "./emblems/gear/gear.budo.js";
+export { GEAR_YUMI, GEAR_YA } from "./emblems/gear/gear.kyudo.js";
 export { VERSION } from "./version.js";

package/dist/turn-control.d.ts

@@ -0,0 +1,101 @@
+import { type EmblemRef } from "./emblems/emblem.api.ts";
+import type { FrameOptions } from "./emblems/emblem.core.ts";
+/** The three angles of a turn, in degrees. */
+export interface TurnAngles {
+    /** About the vertical axis, from -180 (excluded) to 180. */
+    yaw: number;
+    /** The tilt toward the eye, within `pitchRange`. */
+    pitch: number;
+    /** A ball: the turn about the line of sight, from -180 (excluded) to 180. */
+    roll: number;
+}
+/** What `bindTurn` takes: the frame options (`style`, `size`, `tint`, `theme`, and the first `yaw`, `pitch` and `roll`) and how the turning behaves. */
+export interface TurnControlOptions extends FrameOptions {
+    /** Degrees of turn for each pixel the pointer moves (1.5 by default). */
+    sensitivity?: number;
+    /** The least and most tilt, in degrees (`[-60, 60]` by default). */
+    pitchRange?: readonly [number, number];
+    /** Degrees an arrow key turns (5 by default); with Shift it is three times as much (15). */
+    keyStep?: number;
+    /** Called after each turn the pointer, a key or the auto-turn makes, with the new angles. It is not called for `setAngles` or `update`, which the caller makes itself. */
+    onTurn?: (angles: TurnAngles) => void;
+    /**
+     * `true` starts the auto-turn when the emblem is bound, unless the reader prefers reduced motion, when it starts paused; `"force"` starts it anyway. By default (`false`) nothing turns until `play()` is called.
+     * Only read by `bindTurn`.
+     */
+    autoPlay?: boolean | "force";
+    /** Degrees of yaw each second the auto-turn advances (36 by default; negative turns the other way). */
+    speed?: number;
+    /** When true (the default), a drag holds the auto-turn while the pointer is down, and an arrow key, Home or `setAngles` pauses it. When false nothing but `pause()` stops it. */
+    pauseOnInteract?: boolean;
+    /** Called with `true` when the auto-turn starts and `false` when it stops, whatever stopped it. */
+    onPlayChange?: (playing: boolean) => void;
+}
+/** What `bindTurn` returns. */
+export interface TurnController {
+    /** The angles now (a copy). */
+    readonly angles: TurnAngles;
+    /** Whether the auto-turn is running. */
+    readonly playing: boolean;
+    /** Whether the emblem now drawn can be turned at all (read from the registry, so an emblem that gains a turn is turnable here without a change). */
+    readonly turnable: boolean;
+    /** Sets some of the angles (wrapped or clamped as a drag would) and draws. Pauses the auto-turn when `pauseOnInteract` is on. */
+    setAngles(angles: Partial<TurnAngles>): void;
+    /** Draws another emblem, or the same one with other options, and keeps the angles (unless the options carry some). */
+    update(ref: EmblemRef, options?: TurnControlOptions): void;
+    /** Starts the auto-turn. An emblem that cannot turn does nothing and gives `false`. */
+    play(): boolean;
+    /** Stops the auto-turn. */
+    pause(): void;
+    /** Starts or stops the auto-turn and gives the new state; `false` for an emblem that cannot turn. */
+    togglePlay(): boolean;
+    /** Removes the listeners and the attributes and styles `bindTurn` added; the last drawing stays. */
+    destroy(): void;
+}
+/** An event, as much of it as `bindTurn` reads: a pointer's or a key's. */
+export interface TurnEvent {
+    button?: number;
+    isPrimary?: boolean;
+    pointerId?: number;
+    clientX?: number;
+    clientY?: number;
+    shiftKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    altKey?: boolean;
+    key?: string;
+    preventDefault(): void;
+}
+/** What `bindTurn` needs of an element: any `HTMLElement` is one, and so is a small fake in a test. */
+export interface TurnContainer {
+    innerHTML: string;
+    style: {
+        touchAction: string;
+        userSelect: string;
+        cursor: string;
+        webkitUserSelect?: string;
+    };
+    addEventListener(type: string, listener: (event: TurnEvent) => void): void;
+    removeEventListener(type: string, listener: (event: TurnEvent) => void): void;
+    getAttribute(name: string): string | null;
+    setAttribute(name: string, value: string): void;
+    removeAttribute(name: string): void;
+    setPointerCapture?(pointerId: number): void;
+    releasePointerCapture?(pointerId: number): void;
+}
+/** An angle wrapped into -180 (excluded) to 180, as the demo's slider is. */
+export declare function wrapAngle(value: number): number;
+/**
+ * Binds an emblem to an element so that it can be turned: it draws `emblemFrame` into `container`, and a drag turns it (left and right are yaw, up and down are pitch, and Shift on a ball is roll), the arrow keys turn
+ * it, Home or 0 puts it back, and Space starts and stops an auto-turn. An emblem that cannot turn is drawn as it is, and nothing is listened to. Nothing moves by itself: `autoPlay` is off by default and, under
+ * `prefers-reduced-motion`, only starts when it is `"force"`. The element gets `touch-action: none`, `user-select: none`, a grab cursor, a tab stop, a role description and a hint; `destroy()` takes them away.
+ * @example
+ * ```ts
+ * import { bindTurn } from "@johnmorrisdotca/dougu-sports/turn";
+ * const turner = bindTurn(document.getElementById("cup")!, "trophy:tennis-cup", { size: 160 });
+ * turner.setAngles({ yaw: 40 });
+ * console.log(turner.angles.yaw);
+ * // 40
+ * ```
+ */
+export declare function bindTurn(container: TurnContainer, ref: EmblemRef, options?: TurnControlOptions): TurnController;