@johnmorrisdotca/dougu-sports 0.16.1 → 0.25.3

package/CHANGELOG.md

@@ -6,6 +6,128 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.25.3] - 2026-10-28
+
+### Fixed
+
+- **A drag up (and Arrow Up) in `bindTurn` lifts the FRONT of the emblem**, as if its near edge were held and raised, and a drag down lowers it. It did the opposite (a drag up tipped the front down and showed a cup from above). The `pitch` option and `angles.pitch` keep their meaning and sign (positive is the tilt toward the eye, seen more from above); only what the hand and the arrow keys do to it is reversed, so a drag up now makes `pitch` go down, and a program that read `angles.pitch` to mirror a drag sees the opposite sign. Left and right are unchanged. In the demo the Tilt slider is the opposite sign of `pitch` (its top is a drag up), and the address and the code line still say `pitch`, so `?pitch=` from before means the same thing. Tests: `test/turn-control.test.ts`, `e2e/turn.demo.ts`.
+
+## [0.25.2] - 2026-10-28
+
+### Changed
+
+- The lathe's extra decorations, `mesh` (the etched net of many diamonds, which was `net` with a `rows` number), `patch` and `panel`, are drawn by `src/emblems/lathe.extras.ts`, which a model asks for with `extras: LATHE_EXTRAS` (the Bill Russell Trophy and the Relief Man Award do). A cup that uses none of them no longer carries their code: the hockey cup alone bundles to 7213 bytes gzipped again (it was 7450 with them in the renderer, over the 7.1 kB limit, which `pnpm check` caught only in `scripts/check-package.ts`), and `test/size.test.ts` now holds that it leaves them out. The pictures do not change.
+
+## [0.25.1] - 2026-10-28
+
+### Fixed
+
+- The Japanese name and description of `trophy:bill-russell-trophy` and the description of `trophy:hank-aaron-award` read as the awards are named in Japanese (the name `ビル・ラッセル・トロフィー`, `NBAファイナル` for the finals, `最優秀打者` for the best hitter); reviewed.
+
+## [0.25.0] - 2026-10-28
+
+Two of baseball's awards, redrawn from photographs of the real ones. The earlier Hank Aaron Award, a silver batter, was a different object: the real award is a block of mahogany cut as home plate.
+
+### Added
+
+- **`trophy:hank-aaron-award`**: the Hank Aaron Award, a mahogany block in the shape of home plate with a grey metal face, a bat laid across it and two ribbons over the bat, in the flat plaque style of the Cy Young and MLB MVP awards, with a back and a coin-flip turn. Measured on a Wikimedia Commons photograph (CC BY 2.0; looked at, never copied). No lettering, league mark or engraving. 330 emblems, 74 trophies, 50 named with the Relief Man Award.
+- **`trophy:relief-man-award`**: the Relief Man Award (the fireman trophy given from 1976 to 2012), a silver fire helmet with a gilt shield on a short chrome column, over a walnut block with a brass nameplate and a stepped walnut base, built on the lathe like the Stanley Cup. Measured on an auction photograph of a 1981 trophy (looked at, never copied). Approximate: the helmet is drawn round. The shield, the plate and every mark and word are left blank, the plate taking the engraving option. 330 emblems, 74 trophies, 50 named.
+- The lathe's decorations `patch` (a tone laid on a round body between two angles and two heights, a shield on a helmet) and `panel` (a tone laid on one flat face of a body with flat sides, a nameplate on a block).
+
+## [0.24.0] - 2026-10-28
+
+A baseball cap, redrawn from two photographs of plain caps.
+
+### Added
+
+- **`gear:baseball-cap`**: a baseball cap in three-quarter view, with a dome crown, button, front seam and three eyelets, and a curved brim with its edge and rows of stitching, in the same flat layered style as the package's helmet and glove, with a coin-flip turn. Measured on two public-domain and CC0 photographs of plain caps (looked at, never copied). No team mark, lettering or brand. It is in the gear list and with baseball's bat and glove. 328 emblems, 71 pieces of gear.
+
+## [0.23.0] - 2026-10-28
+
+The NBA's Finals MVP trophy, redrawn from a photograph of the real one.
+
+### Added
+
+- **`trophy:bill-russell-trophy`**: the Bill Russell NBA Finals Most Valuable Player Trophy, a gold basketball seated on the flared rim of a net-patterned goblet that narrows in a long concave curve to a slim waist, over a round foot of two tiers. Measured on a press photograph of the 2022 design standing beside the championship trophy (looked at, never copied; no freely licensed photograph exists), and built with the same lathe as the Stanley Cup and the Larry O'Brien Trophy. No lettering. 327 emblems, 72 trophies, 48 named.
+- The lathe's `net` decoration takes a fifth number, `rows`: strands that wind a column to the side at each row, one way and the other, make a net of many diamonds down a body (a trophy's etched net) in a pale line. Without it `net` draws one row of diamonds as before.
+
+## [0.22.0] - 2026-10-28
+
+The award trophies and the cap of 0.17.0 to 0.21.0, which were never published, are taken out. Drawn from written descriptions, they did not match the real objects and were far below the Stanley Cup and the Larry O'Brien Trophy. A site that asks for these awards draws the plain cup, which is honest; each comes back only when it can be drawn from a photograph of the real thing and passes beside the Stanley Cup.
+
+### Removed
+
+- The trophies `jackie-robinson-award`, `mlb-manager-award`, `relief-man-award`, `hank-aaron-award`, `michael-jordan-trophy`, `bill-russell-trophy`, `olajuwon-trophy`, `chamberlain-trophy`, `havlicek-trophy`, `auerbach-trophy`, `mikan-trophy`, `rozelle-trophy`, `halas-trophy` and `gregory-trophy`, and `gear:baseball-cap`. None was ever on npm. 326 emblems again: 71 trophies, 70 pieces of gear.
+
+### Changed
+
+- `docs/trophy-audit.md` says, for each of these awards, what the real object is and why it has no emblem yet.
+
+## [0.21.0] - 2026-10-23
+
+A baseball cap. The Canadian and writers' football awards stay the plain cup: no photograph or measured description of those objects was found, so nothing new was drawn for them.
+
+### Added
+
+- **`gear:baseball-cap`**: a baseball cap in three-quarter view (crown, button, panel seams, eyelets and a brim with an edge), in the gear list and with baseball's bat and glove. 341 emblems, 71 pieces of gear.
+
+### Fixed
+
+- **`trophy:gregory-trophy`**: from behind, the three skaters stay on the trophy. The back had kept only the metal, so it was thinner than the front.
+
+## [0.20.0] - 2026-10-23
+
+The National Hockey League's general-manager award that a site still drew as a plain cup.
+
+### Added
+
+- **`trophy:gregory-trophy`**: the Jim Gregory General Manager of the Year Award, a silver bowl over three bronze skaters on a tall silver block. Drawn for this package from a Hockey Hall of Fame collection photograph that was looked at and never copied; Wikimedia Commons had no freely licensed photograph (searched 2026-10-23), so it is marked approximate. No shield, lettering or nameplates. 340 emblems, 85 trophies, 61 named.
+
+## [0.19.0] - 2026-10-23
+
+Two National Football League awards that a site still drew as a plain cup.
+
+### Added
+
+- **`trophy:rozelle-trophy`** and **`trophy:halas-trophy`**: the Pete Rozelle Trophy (the championship-game most valuable player; a silver football on a short disc) and the George Halas Trophy (the National Football Conference champion; a hollow silver football on a short three-sided stand, the counterpart of the Lamar Hunt Trophy). Each is this package's own drawing from a published description of the object; Wikimedia Commons had no freely licensed photograph (searched 2026-10-23), so they are marked approximate. No lettering, logo or conference mark. The Associated Press awards have no famous trophy and keep the generic plaque. 339 emblems, 84 trophies, 60 named.
+
+## [0.18.0] - 2026-10-23
+
+Seven National Basketball Association awards that a site still drew as a plain cup.
+
+### Added
+
+- **`trophy:michael-jordan-trophy`**, **`trophy:bill-russell-trophy`**, **`trophy:olajuwon-trophy`**, **`trophy:chamberlain-trophy`**, **`trophy:havlicek-trophy`**, **`trophy:auerbach-trophy`** and **`trophy:mikan-trophy`**: the Michael Jordan Trophy (regular-season most valuable player), the Bill Russell Trophy (championship-series most valuable player), the Hakeem Olajuwon, Wilt Chamberlain, John Havlicek and George Mikan trophies (defensive player, rookie, sixth man and most improved) and the Red Auerbach Trophy (coach of the year). Each is this package's own drawing from a published description of the object; Wikimedia Commons had no freely licensed photograph (searched 2026-10-23), so they are marked approximate. No lettering, logo or sponsor name. The MVP trophy's id is the current name, not the old commissioner's cup. 337 emblems, 82 trophies, 58 named.
+
+## [0.17.0] - 2026-10-23
+
+Four Major League Baseball awards that a site still drew as a plain cup.
+
+### Added
+
+- **`trophy:jackie-robinson-award`**, **`trophy:mlb-manager-award`**, **`trophy:relief-man-award`** and **`trophy:hank-aaron-award`**: the Jackie Robinson Award (Rookie of the Year of each league), the Manager of the Year Award, the Relief Man Award (the fireman trophy given 1976 to 2012) and the Hank Aaron Award. Each is this package's own drawing from a public description of the object; Wikimedia Commons had no freely licensed photograph (searched 2026-10-23), so they are marked approximate. No lettering, logo or sponsor name (the Relief Man's id is not the old sponsor's). 330 emblems, 75 trophies, 51 named.
+
+## [0.16.2] - 2026-10-21
+
+Every piece that flips or turns has a body at every angle: a solid edge, a back of its own, and what hangs from it still there.
+
+### Fixed
+
+- **Medals, crests, banners, belts, plaques, pennants, gear and the pictograms are slabs, not sheets** (`flipSvg`, and `defineFlat`, which now turns through it): a solid edge, in the face's own colours darkened, runs behind the squeezed face and stays as wide on the screen as the piece is thick, never under about 2.4 pixels whatever the size, so edge on (a quarter turn, either way) a medal is a band and no longer a hairline. The edge is eight slices of the face made opaque again (a thin part such as a stick or a strap keeps its edge when the squeeze would have thinned it away) and the slab is centred, so it does not slide as it turns; it lies on the other side once the back is toward you.
+- **A medal seen from behind keeps its ribbon** (it lost it), a championship banner its pole and a crest pennant its staff, on the other side, as a real turn mirrors them. The plain parts of a piece with no back of its own (a plaque's board, a belt's strap) are drawn behind it too, so the back is as big as the front.
+- **The hockey puck is a straight cylinder** (`drawStack`): the wall ends in the curve of the lower rim, a crisp edge, and no longer in the soft edge of the bottom cap; its edge is knurled with diamonds all round the wall (it covered only part of it), and the knurl slides round the wall as the puck spins. The curling stone's walls end the same way. Seen from the side the puck is one third as thick as it is wide, at 0, 30, 60 and 90 degrees of tilt.
+- **The golf ball reads as a golf ball at every size and tint**: about 330 dimples (it had 190, faint), each a bowl with a shadow on its upper left wall and a bright edge on the lower right, white by default. **A golf ball and a baseball ignore `tint`** (their colour is fixed by the rules of their sports; a baseball takes `paint`); every other ball takes it. `BallSpec.fixed`, `DottedOptions.fixed` and `SeamedOptions.fixed` say so.
+- **The demo's Auto-turn button** (Stop) is an ordinary button beside Reverse again; a class name it shared with the playground's section had stretched it across the row.
+
+### Changed
+
+- **README pictures**: the balls row's centre ball, the one that rolls, is the outdoor pickleball with its see-through holes (it was the rugby ball); the flips row and the pickleball picture are redrawn (`pnpm animations`), still half speed and only the centre one turning.
+
+### Tests
+
+- `test/thickness.test.ts`: the edge's width in pixels for every flat piece at 24, 64 and 256 pixels, its sides, the back of every flat piece, the puck's wall; `test/golf.test.ts`; `e2e/silhouette.demo.ts` counts real pixels in Chromium (edge on every flat piece is a band at least two pixels wide, from behind it is as solid as its front, the puck is one third as thick as wide at 0, 30, 60 and 90 degrees); an e2e test of the Auto-turn button.
+- Size limits: a medal, a crest or a plaque bundled alone is held to 5.8 kB gzipped (was 4.6), the cost of the one turn they now share.
+
 ## [0.16.1] - 2026-10-21
 
 The turning pictures show one thing moving: in a row, only the centre one turns.

package/README.md

@@ -61,7 +61,7 @@ The ball and the gear of every sport, trophies, medals, crests and the icon of e
 
 ## The best of it
 
-- **47 famous trophies**, each a close likeness measured on a photograph and carrying no lettering, logo or mark: the Stanley Cup, the FIFA World Cup, the Lombardi Trophy, the Larry O'Brien trophy, the Grey Cup and the rest ([famous trophies](./docs/famous-trophies.md)).
+- **50 famous trophies**, each a close likeness measured on a photograph and carrying no lettering, logo or mark: the Stanley Cup, the FIFA World Cup, the Lombardi Trophy, the Larry O'Brien trophy, the Grey Cup and the rest ([famous trophies](./docs/famous-trophies.md)).
 
 <p align="center">
 <picture>
@@ -75,7 +75,7 @@ The ball and the gear of every sport, trophies, medals, crests and the icon of e
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/dougu-sports/main/docs/images/balls-turn-dark.webp">
-<img alt="Seven balls under floodlights: a soccer ball, a basketball, a baseball, a rugby ball, a volleyball, a tennis ball and a golf ball. Six stand still and only the rugby ball in the centre rolls, so that its stripes and panels travel across it." src="https://raw.githubusercontent.com/johnmorrisdotca/dougu-sports/main/docs/images/balls-turn-light.webp" width="760">
+<img alt="Seven balls under floodlights: a soccer ball, a basketball, a baseball, an outdoor pickleball, a volleyball, a tennis ball and a golf ball. Six stand still and only the pickleball in the centre rolls, its holes showing the dark inside and the floodlights through as they line up." src="https://raw.githubusercontent.com/johnmorrisdotca/dougu-sports/main/docs/images/balls-turn-light.webp" width="760">
 </picture>
 </p>
 
@@ -102,15 +102,15 @@ The ball and the gear of every sport, trophies, medals, crests and the icon of e
 <p align="center">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/dougu-sports/main/docs/images/flips-turn-dark.webp">
-<img alt="A crest, a hockey skate, a silver medal, a gold medal, a championship banner, a baseball glove and a football helmet on royal purple: six stand still and only the gold medal in the centre flips like a coin, showing its face, then its edge, then its plain back." src="https://raw.githubusercontent.com/johnmorrisdotca/dougu-sports/main/docs/images/flips-turn-light.webp" width="760">
+<img alt="A crest, a hockey skate, a silver medal, a gold medal, a championship banner, a baseball glove and a football helmet on royal purple: six stand still and only the gold medal in the centre flips like a coin, showing its face, then its solid edge, then its back, with the ribbon still hanging from it." src="https://raw.githubusercontent.com/johnmorrisdotca/dougu-sports/main/docs/images/flips-turn-light.webp" width="760">
 </picture>
 </p>
 
-- **70 pieces of gear**, among them the Japanese sports and budo ([Japanese sports](./docs/japanese-sports.md)).
+- **71 pieces of gear**, among them the Japanese sports and budo ([Japanese sports](./docs/japanese-sports.md)).
 
 - **On a phone**, and **turned by hand**: drag, arrow keys or the automatic turn ([turning](./docs/turning.md)).
 
-> **Status: preview.** 326 emblems: 71 trophies, 6 awards, 6 medals, 4 crests, a pictogram for each of the 42 sports, 118 balls and implements drawn in 3D, 8 printed pucks ([docs/pucks.md](./docs/pucks.md)), 70 pieces of gear (among them the Japanese sports and budo, [docs/japanese-sports.md](./docs/japanese-sports.md)) and a championship pennant; [docs/layout.md](./docs/layout.md) says where each goes. All of it is drawn for this package: no art is copied from another project.
+> **Status: preview.** 330 emblems: 74 trophies, 6 awards, 6 medals, 4 crests, a pictogram for each of the 42 sports, 118 balls and implements drawn in 3D, 8 printed pucks ([docs/pucks.md](./docs/pucks.md)), 71 pieces of gear (among them the Japanese sports and budo, [docs/japanese-sports.md](./docs/japanese-sports.md)) and a championship pennant; [docs/layout.md](./docs/layout.md) says where each goes. All of it is drawn for this package: no art is copied from another project.
 
 ## In 30 seconds
 
@@ -140,8 +140,8 @@ Put the string in a page (`element.innerHTML = svg`), write it to a file, or sen
 
 - **Equipment first (道具 is the word for it)**: 118 balls and implements drawn in 3D, from the 32-panel soccer ball to the 26, 18, 14, 12 and 6 panel constructions, vintage leather balls, era-style and shop-wall soccer balls, baseballs of other threads, volleyballs in national colours ([docs/vintage-balls.md](./docs/vintage-balls.md)), futsal, beach soccer and the pucks and stones, each with its official size, 8 printed pucks (a flag, a leaf, stars and stripes, a player's number, a made-up signature, your own picture: [docs/pucks.md](./docs/pucks.md)), and 42 pieces of gear (sticks, rackets, helmets, skates, nets, and the Japanese budo kit) drawn to match; see [docs/gallery.md](./docs/gallery.md).
 - **Three styles** for every emblem: `metal` (polished metal: a gradient, a highlight and a soft rim of reflected light, edged in a darker tone of its own metal, with no heavy outline), `line` (one clean outline in the page's text colour, made to read at 14 pixels) and `color` (flat fills); see [Theming](#theming).
-- **Size, tint, accent and theme** as options: a tint recolours the main part (a medal's metal, a crest's colour, a ball's patches), an accent the second colour (a ribbon, a crest's band, the pennants), a theme sets the ink for light, dark or either.
-- **Turning**: `emblemFrame` and `ballFrame` return the emblem at an angle, in plain SVG: every emblem turns, a ball rolls, a cup keeps its outline and moves its light, and everything flat (gear, a bat, a crown, a sport's icon) flips like a coin; `bindTurn` lets a drag, the arrow keys or an auto-turn do the turning in a page; see [docs/turning.md](./docs/turning.md).
+- **Size, tint, accent and theme** as options: a tint recolours the main part (a medal's metal, a crest's colour, a ball's patches; not the body of a golf ball or a baseball, whose colour the sport fixes), an accent the second colour (a ribbon, a crest's band, the pennants), a theme sets the ink for light, dark or either.
+- **Turning**: `emblemFrame` and `ballFrame` return the emblem at an angle, in plain SVG: every emblem turns, a ball rolls, a cup keeps its outline and moves its light, and everything flat (a medal, a crest, a banner, gear, a bat, a crown, a sport's icon) flips like a coin with a solid edge, a back of its own and its ribbon or pole seen from behind; `bindTurn` lets a drag, the arrow keys or an auto-turn do the turning in a page; see [docs/turning.md](./docs/turning.md).
 - **Engraving**: text cut into a medal, a plaque, the belt, a ring, a banner, a pennant and the plinth of a cup, from `label`, `year` and `rank` or one `engrave` string, in the ink that reads at 4.5 to 1 on the metal, and it turns with the emblem; see [engraving](./docs/engraving.md).
 - **Custom balls**: a baseball, a softball and the classic soccer balls take `paint` (a solid colour, or two: along the seam or in halves, with stitches that still show), `decal` (your own SVG or image as a logo, wrapped onto the sphere so that it turns with the ball), `stamp` (condensed bold text between small stars, with an optional made-up signature), `script` (an original cursive word) and `mark` (a letter in a circle, or an SVG of your own); see [docs/custom-balls.md](./docs/custom-balls.md). The package carries no logo of anyone's: a logo or a mark is the one you pass.
 - **Labels in two languages**: the `<title>` is English or Japanese (`locale`), your own words (`title: "…"`), or left out for an emblem that sits beside text that says the same (`title: false`).
@@ -545,7 +545,7 @@ The metals are `METALS` (gold `#d9a620`, silver `#aeb6c0`, bronze `#b8733a`); ea
 ## Limits
 
 - A turn is drawn in plain SVG, not in 3D: a cup keeps its silhouette and moves its light, handles and seams; a medal is squeezed; a ball is projected from its own geometry, panel by panel, and has no grain while it turns. Gear, icons and pictograms flip like a coin, with the back as a mirror of the front and a thin rim; a pennant's back is its own drawing; one turn (`src/emblems/emblem.flip.ts`) does it for all of them.
-- A tint is one colour, the main one, and an accent a second. The pieces of a trophy that are another metal (the gilt of a plate, the green bands of a globe, the black foot of a cup) keep their own colour.
+- A tint is one colour, the main one, and an accent a second. A golf ball and a baseball are white by the rules of their sports, so they ignore `tint` (a baseball takes `paint`, as the custom balls do); every other ball takes it. The pieces of a trophy that are another metal (the gilt of a plate, the green bands of a globe, the black foot of a cup) keep their own colour.
 - The trophies are generic: each is drawn for this package in a simplified form that a reader knows at a glance, and none is traced from a photograph or carries a name, a mark or an engraving.
 - A trophy in the metal style is about 3 to 4.5 kB of markup, a medal or a crest about 1 to 2 kB, a line drawing about 1 to 2.5 kB; a ball in 3D is 5 to 13 kB, and a piece of gear is 1 to 4 kB, drawn in layers.
 - The size is a number of pixels up to 4096; the drawing is a vector at any size.
@@ -676,7 +676,7 @@ Bug reports and ideas go in the [issues](https://github.com/johnmorrisdotca/doug
 
 ## Changes
 
-See [CHANGELOG.md](./CHANGELOG.md). 0.16.0 adds a slotted plastic practice baseball (`ball:plastic-baseball-slotted`, 326 emblems: [docs/slotted-ball.md](./docs/slotted-ball.md)); 0.15.0 gives the pickleballs real holes, cut through the shell and drawn with the inside of the ball behind them, so the page shows through where two holes line up ([docs/pickleball.md](./docs/pickleball.md)); 0.14.0 lets the auto-turn go either way (`direction: "clockwise"` or `"counterclockwise"`, `setDirection()`); 0.13.0 adds a pictogram for each of four combat sports, MMA (a cage), boxing (a glove), wrestling (two wrestlers on the mat) and professional wrestling (a ring with ropes), in the three styles (326 emblems); 0.12.0 adds forty-seven named trophies, each a close likeness measured on a photograph (321 emblems); 0.11.0 gives the era soccer balls neutral ids (the old ones stay as aliases), new looks and a second 1980s ball (274 emblems); 0.10.0 adds a standalone ribbon and the nets and posts of sepak takraw, netball and teqball from their rulebooks' sizes (273 emblems); 0.9.0 lets the baseball, the softball and the classic soccer balls be painted and printed: solid and two-tone colours, a logo of your own wrapped onto the ball, stamped text, an original cursive word and a small mark, all turning with the ball ([docs/custom-balls.md](./docs/custom-balls.md)); 0.8.0 makes `bindTurn` light: it takes an emblem object and then needs no registry, so a turnable cup is about 9.4 kB gzipped instead of about 81 kB, and an id loads the registry on demand; 0.7.3 turns the build, docs and picture scripts, the browser tests and the demo's source from JavaScript into TypeScript, with no change to the package; 0.7.2 makes every docs page single-language (a page in Japanese beside each page that had Japanese words in it, and a test that holds them apart), with no change to the pictures; 0.7.1 puts real countries (Canada, Japan) in the crest and puck examples in place of made-up teams, with no change to the code; 0.7.0 gives the national volleyballs layouts that tell them apart (Japan a crimson band, Poland white above and red below, the USA a navy field), strengthens the 2010-style grooved soccer ball, and adds six pictures of how the judo belt is tied, `gear:obi-step-1` to `gear:obi-step-6` (269 emblems: [docs/obi-steps.md](./docs/obi-steps.md)); 0.6.0 gives the judo suit and the karate suit their sleeves (a judogi has no short ones: they reach the wrist) and adds the judogi seen from behind with the IJF-style back number, a family name and a country code on a patch, with a `backnumber` option (269 emblems: [docs/judogi-back.md](./docs/judogi-back.md)); 0.5.1 redraws the judo suit, the belt and the football pictograms and adds the blue and folded suits and the belts of every grade (261 emblems: [docs/japanese-sports.md](./docs/japanese-sports.md)); 0.5.0 adds fifty balls: vintage leather soccer balls, era-style and shop-wall soccer balls, baseballs of other threads and volleyballs in national colours, with a `colors` option (244 emblems: [docs/vintage-balls.md](./docs/vintage-balls.md)); 0.4.0 adds eight printed pucks and a `face` option (194 emblems: [docs/pucks.md](./docs/pucks.md)); 0.3.0 adds nineteen soccer balls (26, 18, 14, 12 and 6 panels, winter orange and high-visibility yellow, futsal and beach soccer: 186 emblems); 0.2.1 draws every ball and implement to the rulebook's proportions; 0.2.0 is 167 emblems, every one drawn here, with the Japanese sports, engraving, a turn for every emblem and the compose helpers; 0.1.0 brought the first full set of 148; 0.0.1 was the first preview.
+See [CHANGELOG.md](./CHANGELOG.md). 0.25.0 adds two of baseball's awards, drawn from photographs of the real ones: the Hank Aaron Award and the Relief Man Award (`trophy:hank-aaron-award`, `trophy:relief-man-award`, 330 emblems); 0.24.0 adds a baseball cap (`gear:baseball-cap`, 328 emblems); 0.23.0 adds the Bill Russell Finals MVP Trophy, drawn from a photograph of the real one (`trophy:bill-russell-trophy`, 327 emblems); 0.22.0 takes out the award cups and the cap of the unpublished 0.17.0 to 0.21.0, which did not match the real objects; 0.16.0 adds a slotted plastic practice baseball (`ball:plastic-baseball-slotted`, 326 emblems: [docs/slotted-ball.md](./docs/slotted-ball.md)); 0.15.0 gives the pickleballs real holes, cut through the shell and drawn with the inside of the ball behind them, so the page shows through where two holes line up ([docs/pickleball.md](./docs/pickleball.md)); 0.14.0 lets the auto-turn go either way (`direction: "clockwise"` or `"counterclockwise"`, `setDirection()`); 0.13.0 adds a pictogram for each of four combat sports, MMA (a cage), boxing (a glove), wrestling (two wrestlers on the mat) and professional wrestling (a ring with ropes), in the three styles (326 emblems); 0.12.0 adds forty-seven named trophies, each a close likeness measured on a photograph (321 emblems); 0.11.0 gives the era soccer balls neutral ids (the old ones stay as aliases), new looks and a second 1980s ball (274 emblems); 0.10.0 adds a standalone ribbon and the nets and posts of sepak takraw, netball and teqball from their rulebooks' sizes (273 emblems); 0.9.0 lets the baseball, the softball and the classic soccer balls be painted and printed: solid and two-tone colours, a logo of your own wrapped onto the ball, stamped text, an original cursive word and a small mark, all turning with the ball ([docs/custom-balls.md](./docs/custom-balls.md)); 0.8.0 makes `bindTurn` light: it takes an emblem object and then needs no registry, so a turnable cup is about 9.4 kB gzipped instead of about 81 kB, and an id loads the registry on demand; 0.7.3 turns the build, docs and picture scripts, the browser tests and the demo's source from JavaScript into TypeScript, with no change to the package; 0.7.2 makes every docs page single-language (a page in Japanese beside each page that had Japanese words in it, and a test that holds them apart), with no change to the pictures; 0.7.1 puts real countries (Canada, Japan) in the crest and puck examples in place of made-up teams, with no change to the code; 0.7.0 gives the national volleyballs layouts that tell them apart (Japan a crimson band, Poland white above and red below, the USA a navy field), strengthens the 2010-style grooved soccer ball, and adds six pictures of how the judo belt is tied, `gear:obi-step-1` to `gear:obi-step-6` (269 emblems: [docs/obi-steps.md](./docs/obi-steps.md)); 0.6.0 gives the judo suit and the karate suit their sleeves (a judogi has no short ones: they reach the wrist) and adds the judogi seen from behind with the IJF-style back number, a family name and a country code on a patch, with a `backnumber` option (269 emblems: [docs/judogi-back.md](./docs/judogi-back.md)); 0.5.1 redraws the judo suit, the belt and the football pictograms and adds the blue and folded suits and the belts of every grade (261 emblems: [docs/japanese-sports.md](./docs/japanese-sports.md)); 0.5.0 adds fifty balls: vintage leather soccer balls, era-style and shop-wall soccer balls, baseballs of other threads and volleyballs in national colours, with a `colors` option (244 emblems: [docs/vintage-balls.md](./docs/vintage-balls.md)); 0.4.0 adds eight printed pucks and a `face` option (194 emblems: [docs/pucks.md](./docs/pucks.md)); 0.3.0 adds nineteen soccer balls (26, 18, 14, 12 and 6 panels, winter orange and high-visibility yellow, futsal and beach soccer: 186 emblems); 0.2.1 draws every ball and implement to the rulebook's proportions; 0.2.0 is 167 emblems, every one drawn here, with the Japanese sports, engraving, a turn for every emblem and the compose helpers; 0.1.0 brought the first full set of 148; 0.0.1 was the first preview.
 
 ## Credits
 

package/dist/emblems/ball/ball.baseball.js

@@ -6,6 +6,7 @@ export const BALL_BASEBALL = /* @__PURE__ */ seamedBall({
     ja: "野球のボール",
     size: { extentMm: 73.8, diameterMm: 73.8, circumferenceMm: 231.77, massG: [141.75, 148.83], rule: "Official Baseball Rules, Rule 3.01 The Ball", note: "Diameter worked out from the middle of the circumference range." },
     base: "#f4f0e6",
+    fixed: true,
     b: 0.4,
     view: { yaw: 18, pitch: 28, roll: -10 },
     mat: { gloss: 0.3, shade: "#4a3a2a", grain: { f: 1.4, a: 0.12 } },

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

@@ -57,6 +57,7 @@ export interface Surface {
         opacity?: number;
         ink?: boolean;
         light?: boolean;
+        dimple?: string;
     }): string;
     /** The facing of a point: 1 straight at you, 0 on the limb. */
     facing(u: V3): number;
@@ -96,6 +97,8 @@ export interface BallSpec {
     };
     /** The main colour of the ball (what `tint` replaces). */
     base: string;
+    /** The ball's real colour is fixed (a golf ball, a baseball): `tint` does not recolour it. The ball's own `paint` still does, where it has one. */
+    fixed?: boolean;
     /** The colour the whole ball is filled with before its panels are laid on, where it is not `base` (a soccer ball is white, its pentagons are `base`). */
     ground?: string;
     mat: Material;

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

@@ -269,6 +269,16 @@ function surfaceOf(g, line, minWidth, home) {
             if (d.length === 0)
                 return "";
             const path = d.join("");
+            if (o?.dimple !== undefined && !line) {
+                // A dimple is a shallow bowl lit from the upper left: its upper left wall is in shadow, its lower right wall catches the light. Three layers for all of them: the whole mark in the shadow's colour, the same marks moved a little
+                // toward the lower right and filled with the ball's own colour (which leaves a crisp dark crescent on the upper left), and a bright edge along the lower right.
+                const r = s.radius * sr;
+                const dx = num(r * 0.2, 2), dy = num(r * 0.26, 2);
+                const w = num(Math.max(0.3, Math.min(r * 0.2, 0.9)), 2);
+                const key = `dm${hashOf(path)}`;
+                const at = `transform="translate(${dx} ${dy})"`;
+                return `<defs><path id="${key}" d="${path}"/></defs><use href="#${key}" fill="${fill}" opacity="${o.opacity ?? 0.55}"/><use href="#${key}" fill="${o.dimple}" ${at}/><use href="#${key}" fill="none" stroke="#fff" stroke-width="${w}" opacity=".7" ${at}/>`;
+            }
             const hi = o?.light === false || line ? "" : `<path d="${path}" fill="none" stroke="#fff" stroke-width="${num(Math.max(0.35, minWidth * 0.3), 2)}" opacity=".3" transform="translate(.25 .35)"/>`;
             return `${hi}<path d="${path}" fill="${line ? INK : fill}"${o?.opacity === undefined ? "" : ` opacity="${o.opacity}"`}/>`;
         },
@@ -333,12 +343,13 @@ export function drawBall(title, key, spec, opts, turn, turning) {
     // A ball with a second colour of its own (a soccer ball's panels on a white ground) paints the body as the ground and the second colour as the panels; one with a single colour takes the body as its main colour.
     const paint = opts.paint;
     const two = spec.ground !== undefined;
-    const base = opts.tint ?? (two ? paint?.second : paint?.body) ?? spec.base;
+    const tint = spec.fixed === true ? undefined : opts.tint;
+    const base = tint ?? (two ? paint?.second : paint?.body) ?? spec.base;
     const ground = two ? paint?.body ?? spec.ground : undefined;
     const surface = surfaceOf(g, line, minWidth, homeOf(spec));
     const layers = spec.draw(surface, base, opts.accent, opts.colors, { paint: opts.paint, print: opts.print, printer: opts.printer });
     const sil = silhouette(g);
-    const id = `k${hashOf(`${key}|${opts.style}|${opts.tint ?? ""}|${opts.accent ?? ""}${opts.colors === undefined ? "" : `|${opts.colors.join("")}`}|${sil.tag}${sil.d}${paint === undefined && (opts.print === undefined || opts.printer === undefined) ? "" : `|${JSON.stringify([paint, opts.printer === undefined ? undefined : opts.print])}`}`)}`;
+    const id = `k${hashOf(`${key}|${opts.style}|${tint ?? ""}|${opts.accent ?? ""}${opts.colors === undefined ? "" : `|${opts.colors.join("")}`}|${sil.tag}${sil.d}${paint === undefined && (opts.print === undefined || opts.printer === undefined) ? "" : `|${JSON.stringify([paint, opts.printer === undefined ? undefined : opts.print])}`}`)}`;
     // A long outline (the hull of a pointed ball) is written once, in the definitions, and used wherever the silhouette is.
     const long = sil.d.length > 400;
     const outline = long ? `<path id="${id}s" d="${sil.d}"/>` : "";

package/dist/emblems/ball/ball.family.dotted.d.ts

@@ -22,6 +22,10 @@ export interface DottedOptions {
     light?: boolean;
     /** Real holes through the shell, not marks on it (`holeLayers` from ball.holes.ts, taken by the pickleball only): the near ones are cut out and show the inside of the ball, and where two line up the page shows through. The line style still draws marks. */
     hollow?: Drill;
+    /** The ball's real colour is fixed, so `tint` does not recolour it (see `BallSpec.fixed`). */
+    fixed?: boolean;
+    /** Marks drawn as shallow bowls (dimples): a shadow on the upper left wall, a bright edge on the lower right, the ball's own colour inside. */
+    dimples?: boolean;
     /** Turns the spread, so a ball does not show its spiral's pole straight on. */
     phase?: number;
 }

package/dist/emblems/ball/ball.family.dotted.js

@@ -10,12 +10,13 @@ export function dottedBall(o) {
     const spec = {
         view: o.view ?? { yaw: 20, pitch: 25, roll: 0 },
         base: o.base,
+        fixed: o.fixed,
         mat: o.mat,
         draw: (s, base) => {
             const mark = o.mark ?? mix(base, -0.55);
             if (o.hollow !== undefined && !s.line)
                 return "";
-            return s.dots(centres, o.radius, mark, { opacity: o.depth ?? 0.55, ink: true, light: o.light ?? true });
+            return s.dots(centres, o.radius, mark, { opacity: o.depth ?? 0.55, ink: true, light: o.light ?? true, ...(o.dimples === true ? { dimple: mix(base, -0.04) } : {}) });
         },
         holes: o.hollow === undefined ? undefined : (s, id, base, shape, minWidth) => o.hollow(s, id, { centres, radius: o.radius }, base, shape, minWidth),
     };

package/dist/emblems/ball/ball.family.seamed.d.ts

@@ -9,6 +9,8 @@ export interface SeamedOptions {
     base: string;
     /** The seam's parameter b. */
     b: number;
+    /** The ball's real colour is fixed, so `tint` does not recolour it (see `BallSpec.fixed`). */
+    fixed?: boolean;
     view?: BallSpec["view"];
     mat: BallSpec["mat"];
     /** A strip along the seam: its colour and width. */

package/dist/emblems/ball/ball.family.seamed.js

@@ -19,6 +19,7 @@ export function seamedBall(o) {
     const spec = {
         view: o.view ?? { yaw: 0, pitch: 0, roll: 0 },
         base: o.base,
+        fixed: o.fixed,
         mat: o.mat,
         home: o.home,
         draw: (s, base, _accent, _colors, custom) => {

package/dist/emblems/ball/ball.golf.js

@@ -6,10 +6,12 @@ export const BALL_GOLF = /* @__PURE__ */ dottedBall({
     ja: "ゴルフボール",
     size: { extentMm: 42.67, diameterMm: 42.67, massG: [0, 45.93], rule: "Rules of Equipment (R&A / USGA), Part 4 Conformance of Balls, 4.2 Weight and 4.3 Size", note: "A minimum diameter and a maximum mass: the rules set no maximum size and no minimum weight." },
     base: "#f7f7f5",
-    count: 190,
-    radius: 0.066,
-    depth: 0.2,
+    fixed: true,
+    count: 330,
+    radius: 0.074,
+    depth: 0.62,
+    dimples: true,
     light: false,
-    mark: "#5a6070",
+    mark: "#7d8594",
     mat: { gloss: 0.85, shade: "#2a3350", grain: undefined },
 });

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

@@ -13,6 +13,8 @@ export interface ObjectContext {
     turning: boolean;
     /** An id prefix that no other drawing of this piece in the page shares. */
     id: string;
+    /** The turn about the object's own axis, in degrees (its resting view's and the turn's together): what a knurled edge slides by. */
+    spin: number;
     /** The thinnest line that shows at this size, in box units. */
     minWidth: number;
     /** A point of the object in its own space to the box: x, y and depth (positive toward you); one unit is 46 box units. */

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

@@ -14,7 +14,7 @@ export function defineObject(def) {
             const q = apply(rot, [(p[0] - sh[0]) * k, (p[1] - sh[1]) * k, (p[2] - sh[2]) * k]);
             return [50 + 46 * q[0], 50 - 46 * q[1], q[2]];
         };
-        const { defs, body } = def.draw({ rot, opts, turning, id, minWidth: 80 / opts.size, at });
+        const { defs, body } = def.draw({ rot, opts, turning, id, spin: def.view.yaw + finite(o?.yaw), minWidth: 80 / opts.size, at });
         return wrapPiece({ title: escape(def.en), size: opts.size, theme: opts.theme, defs, body });
     };
     return { id: def.id, en: def.en, ja: def.ja, source: "generated", kind: "ball", model: { ...def.model, view: def.view }, size: def.size, svg: labelled(def.en, def.ja, (o) => render(o, false)), frame: labelled(def.en, def.ja, (o) => render(o, true)) };

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

@@ -14,7 +14,7 @@ export const puckSpec = (extra) => ({
     gloss: 0.5,
     shade: "#000",
     grain: { f: 1.6, a: 0.25 },
-    grooves: { count: 30, slices: [0], colour: "#000", opacity: 0.5 },
+    knurl: { count: 44, slices: [0], colour: "#000", opacity: 0.7 },
     topRing: { r: 0.9, colour: "#4a4d56" },
     ...extra,
 });

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

@@ -25,6 +25,13 @@ export interface StackSpec {
         colour: string;
         opacity: number;
     };
+    /** A knurled band: diamonds cut across the whole wall of the slices named, `count` of them round the slice, in lines of `colour`. It follows the wall all round and to its crisp lower edge. */
+    knurl?: {
+        count: number;
+        slices: readonly number[];
+        colour: string;
+        opacity: number;
+    };
     /** A ring on the top face: radius as a fraction, colour. */
     topRing?: {
         r: number;

package/dist/emblems/ball/ball.stack.js

@@ -45,7 +45,6 @@ export function drawStack(c, spec) {
         const [x0, y0] = at(s.y0), [x1, y1] = at(s.y1);
         const rb = 46 * radius(s, 0), rt = 46 * radius(s, 1);
         const pts = [[x0 + perp[0] * rb, y0 + perp[1] * rb], [x1 + perp[0] * rt, y1 + perp[1] * rt], [x1 - perp[0] * rt, y1 - perp[1] * rt], [x0 - perp[0] * rb, y0 - perp[1] * rb]];
-        const d4 = `M${pts.map((p) => `${num(p[0], 2)} ${num(p[1], 2)}`).join("L")}Z`;
         if (line) {
             if (s.outline !== true)
                 return "";
@@ -57,9 +56,18 @@ export function drawStack(c, spec) {
             const near = topVisible ? -1 : 1;
             return `<path d="${lines}${rim(s.y0, radius(s, 0), near)}${i === slices.length - 1 ? "" : rim(s.y1, radius(s, 1), near)}" fill="none"/>`;
         }
-        let out = `<path d="${d4}" fill="url(#${gid})"/>`;
+        // The wall is the band between the two ends and the half of the far end's rim that bulges toward you, so it ends in a crisp curved edge like a real cylinder's, not in the soft edge of its cap.
+        const bulge = (y, r) => {
+            const [cx, cy] = at(y);
+            const rad = (perpDeg * Math.PI) / 180;
+            const ex = cx - Math.cos(rad) * 46 * r, ey = cy - Math.sin(rad) * 46 * r;
+            return `A${num(46 * r, 2)} ${num(Math.max(46 * r * Math.abs(nz), 0.02), 2)} ${num(perpDeg, 1)} 0 ${topVisible ? 1 : 0} ${num(ex, 2)} ${num(ey, 2)}`;
+        };
+        const p = (k) => `${num(pts[k][0], 2)} ${num(pts[k][1], 2)}`;
+        const wall = topVisible ? `M${p(1)}L${p(0)}${bulge(s.y0, radius(s, 0))}L${p(2)}Z` : `M${p(0)}L${p(1)}${bulge(s.y1, radius(s, 1))}L${p(3)}Z`;
+        let out = `<path d="${wall}" fill="url(#${gid})"/>`;
         const gr = spec.grooves;
-        if (!line && gr !== undefined && gr.slices.includes(i)) {
+        if (gr !== undefined && gr.slices.includes(i)) {
             let marks = "";
             for (let k = 0; k < gr.count; k++) {
                 const t = ((k + 0.5) / gr.count) * Math.PI;
@@ -71,6 +79,36 @@ export function drawStack(c, spec) {
             }
             out += `<path d="${marks}" stroke="${gr.colour}" stroke-width="${num(Math.max(0.5, c.minWidth * 0.5), 2)}" opacity="${gr.opacity}" fill="none"/>`;
         }
+        const kn = spec.knurl;
+        if (kn !== undefined && kn.slices.includes(i)) {
+            // Each line of the knurl runs up the wall as it goes round it, one family each way, and is cut where it would leave the half of the wall you can see.
+            const toward = topVisible ? -1 : 1;
+            const point = (theta, v) => {
+                const rr = rb + (rt - rb) * v;
+                const cx = x0 + (x1 - x0) * v, cy = y0 + (y1 - y0) * v;
+                return `${num(cx + perp[0] * rr * Math.cos(theta) + toward * d[0] * rr * Math.abs(nz) * Math.sin(theta), 1)} ${num(cy + perp[1] * rr * Math.cos(theta) + toward * d[1] * rr * Math.abs(nz) * Math.sin(theta), 1)}`;
+            };
+            const pitch = (2 * Math.PI) / kn.count;
+            // A turn about the axis slides the knurl round the wall (a positive turn carries its front to the right).
+            const slide = ((((-c.spin * Math.PI) / 180) % pitch) + pitch) % pitch;
+            let marks = "";
+            for (const way of [1, -1]) {
+                for (let k = -2; k <= kn.count / 2 + 2; k++) {
+                    let pen = false;
+                    for (let j = 0; j <= 4; j++) {
+                        const v = j / 4;
+                        const theta = k * pitch + slide + way * 2 * pitch * v;
+                        if (theta < 0 || theta > Math.PI) {
+                            pen = false;
+                            continue;
+                        }
+                        marks += `${pen ? "L" : "M"}${point(theta, v)}`;
+                        pen = true;
+                    }
+                }
+            }
+            out += `<path d="${marks}" stroke="${kn.colour}" stroke-width="${num(Math.max(0.5, c.minWidth * 0.55), 2)}" opacity="${kn.opacity}" fill="none" stroke-linecap="butt"/>`;
+        }
         return out;
     };
     const cap = (y, r, colour, i, topFace) => {

package/dist/emblems/emblem.descriptions.js

@@ -69,6 +69,7 @@ export const EMBLEM_DESCRIPTIONS = {
     "gear:table-tennis-paddle": { en: "Table-tennis paddle and ball", ja: "卓球のラケットとボール" },
     "gear:badminton-racket": { en: "Badminton racket and shuttlecock", ja: "バドミントンのラケットとシャトルコック" },
     "gear:football-helmet": { en: "Football helmet", ja: "アメリカンフットボールのヘルメット" },
+    "gear:baseball-cap": { en: "A baseball cap in three-quarter view: a dome crown with a button, a seam and three eyelets, and a curved brim with its edge and rows of stitching.", ja: "野球帽を斜め前から描いています。頭頂のボタン、縫い目、3つのはと目のあるドーム形のクラウンと、縁と何列もの縫い目のある湾曲したつばが見えます。" },
     "gear:hurley": { en: "Hurley", ja: "ハーリー（ハーリングのスティック）" },
     "trophy:sumo-cup": { en: "A tall silver cup on a tall stepped stand, with an ornate phoenix-crested handle on each side", ja: "段のある高い台に載った、背の高い銀の杯。両側の取っ手に鳳凰の飾りが付く" },
     "trophy:paterson-cup": { en: "The Paterson Cup: a wide silver bowl with a straight engraved band at the rim, two scrolled ear handles, a short stem and a dark wooden base. Given to the champion of the Pacific Coast Hockey Association from 1912", ja: "パターソン・カップ。縁にまっすぐな彫刻の帯がある幅広の銀のボウルで、渦巻き形の耳状の取っ手が2つ付き、短い脚と濃い色の木の台座があります。1912年から、パシフィック・コースト・ホッケー協会の優勝チームに贈られました。" },
@@ -96,6 +97,9 @@ export const EMBLEM_DESCRIPTIONS = {
     "trophy:commissioners-trophy": { en: "The Commissioner's Trophy: thirty slender poles with gilt pennants in a ring whose tops are higher at the back than at the front, over a wide round silver base.", ja: "コミッショナーズ・トロフィーは、30本の細い支柱が、それぞれ金色のペナントを付けて輪になり、輪の上端は後ろが高く手前が低く、幅広い丸い銀色の台の上に立つ姿を描いています。ワールドシリーズの優勝チームに贈られます。" },
     "trophy:grey-cup": { en: "The Grey Cup: a two-handled silver cup with a swirled stem on a tall flared cone of twelve panels crossed by dark bands.", ja: "グレイカップは、持ち手が2つで渦巻き模様の脚をもつ銀色のカップが、暗い帯の入った12面の背の高い広がる円錐形の台の上に載った姿を描いています。カナディアン・フットボール・リーグの優勝決定戦に勝ったチームに贈られます。" },
     "trophy:cy-young-award": { en: "The Cy Young Award: a dark plaque with a curved silver band, a V and a hand holding a baseball over a nameplate.", ja: "サイ・ヤング賞は、暗い色の飾り板に、曲線を描く銀色の帯とV字、銘板の上で野球のボールを握る手をあしらった姿を描いています。各リーグの最優秀投手に贈られます。" },
+    "trophy:relief-man-award": { en: "The Relief Man Award: a silver fire helmet with a gilt shield, on a short chrome column over a walnut block with a brass nameplate and a stepped walnut base.", ja: "リリーフマン賞は、金色の盾を付けた銀色の消防ヘルメットが、短いクロームの支柱の上に載り、真鍮の銘板を付けたクルミ材の角柱と、段のあるクルミ材の台の上に立つ姿を描いています。1976年から2012年まで、各リーグの最優秀救援投手に贈られました。" },
+    "trophy:hank-aaron-award": { en: "The Hank Aaron Award: a mahogany block cut in the shape of home plate, with a grey metal face, a bat laid across it from the upper left and two ribbons over the bat.", ja: "ハンク・アーロン賞は、ホームベースの形に削り出したマホガニーの台に、灰色の金属の面、左上がりに置かれたバット、その上に重なる2本のリボンをあしらった姿を描いています。各リーグの最優秀打者に贈られます。" },
+    "trophy:bill-russell-trophy": { en: "The Bill Russell Trophy: a gold basketball seated on the flared rim of a net-patterned goblet that narrows to a slim waist, over a round foot of two tiers.", ja: "ビル・ラッセル・トロフィーは、金色のバスケットボールが、ネット模様のゴブレットの広がった縁に載り、ゴブレットは細い脚へとすぼまり、二段の丸い台の上に立つ姿を描いています。NBAファイナルの最優秀選手に贈られます。" },
     "trophy:mlb-mvp-award": { en: "The Most Valuable Player Award: a dark octagonal plaque with a silver ring and diamond, a gilt medallion, a nameplate and crossed bats.", ja: "MVP賞は、銀色の輪とダイヤモンド、金色のメダリオン、銘板、交差した2本のバットを配した、暗い色の八角形の飾り板を描いています。各リーグの最優秀選手に贈られます。" },
     "trophy:walter-cup": { en: "The Walter Cup: a wide shallow silver bowl on a stem between two tall stick-shaped blades, over a heavy round base.", ja: "ウォルター・カップは、脚付きの幅広く浅い銀色のボウルが、スティック形の背の高い2枚のブレードの間に立ち、重厚な丸い台の上に載った姿を描いています。プロフェッショナル・ウィメンズ・ホッケー・リーグ(PWHL)の優勝チームに贈られます。" },
     "trophy:wnba-championship-trophy": { en: "The WNBA Championship Trophy: a silver basketball held on two slanting tubes over a low slab.", ja: "WNBA優勝トロフィーは、銀色のバスケットボールを、斜めに伸びる2本の管が支え、低い板状の台に載った姿を描いています。WNBAファイナルの優勝チームに贈られます。" },

package/dist/emblems/emblem.equipment.js

@@ -5,7 +5,7 @@ const TABLE = {
     ifaf: ["ball:football-ifaf", ["gear:football-helmet", "gear:goalposts"], "trophy:cup"],
     nhl: ["ball:puck", ["gear:hockey-stick", "gear:hockey-skate", "gear:goalie-mask", "gear:goal-net"], "trophy:hockey-cup"],
     nba: ["ball:basketball", ["gear:basketball-hoop"], "trophy:basketball"],
-    mlb: ["ball:baseball", ["gear:baseball-bat", "gear:baseball-glove"], "trophy:baseball"],
+    mlb: ["ball:baseball", ["gear:baseball-bat", "gear:baseball-glove", "gear:baseball-cap"], "trophy:baseball"],
     soccer: ["ball:soccer", ["gear:goal-net"], "trophy:soccer-globe", GOLD],
     curling: ["ball:curling-stone", ["gear:curling-broom"], "trophy:bowl", GOLD],
     tennis: ["ball:tennis", ["gear:tennis-racket"], "trophy:tennis-cup", GOLD],

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

@@ -6,5 +6,9 @@ export interface FlipOptions {
     back?: string;
     thick?: number;
 }
-/** A document turned by `yaw` and `pitch` degrees from its still drawing. With no turn it is the document itself. */
+/**
+ * A document turned by `yaw` and `pitch` degrees from its still drawing. With no turn it is the document itself.
+ * The piece is a slab: its face is squeezed by the cosine of the turn, and between the face and its other side runs a solid edge (the thickness) that stays the same width on the screen while the face
+ * narrows, so that edge on it is a band and never a hairline. The edge is the face's own colours darkened, and a thin part (a stick, a strap) keeps its edge because the squeezed face is made opaque again before it is moved.
+ */
 export declare function flipSvg(svg: string, o: FlipOptions): string;

package/dist/emblems/emblem.flip.js

@@ -11,7 +11,15 @@ function split(svg) {
     const box = (/viewBox="([^"]*)"/.exec(open)?.[1] ?? "0 0 64 64").split(/\s+/).map(Number);
     return { open, head, rest: after.slice(head.length), box: [box[0] ?? 0, box[1] ?? 0, box[2] || 64, box[3] || 64] };
 }
-/** A document turned by `yaw` and `pitch` degrees from its still drawing. With no turn it is the document itself. */
+/** The slices an edge is built from: each is the silhouette moved a little further along the thickness, so that together they are a solid band. */
+const SLICES = 8;
+/** The least thickness of the edge on the screen, in pixels, so that a piece edge on never thins to a hairline however small it is drawn. */
+const LEAST_PX = 2.4;
+/**
+ * A document turned by `yaw` and `pitch` degrees from its still drawing. With no turn it is the document itself.
+ * The piece is a slab: its face is squeezed by the cosine of the turn, and between the face and its other side runs a solid edge (the thickness) that stays the same width on the screen while the face
+ * narrows, so that edge on it is a band and never a hairline. The edge is the face's own colours darkened, and a thin part (a stick, a strap) keeps its edge because the squeezed face is made opaque again before it is moved.
+ */
 export function flipSvg(svg, o) {
     if (o.yaw === 0 && o.pitch === 0)
         return svg;
@@ -24,23 +32,32 @@ export function flipSvg(svg, o) {
     const [x0, y0, w, h] = front.box;
     const sx = Math.max(Math.abs(across), 0.02);
     const sy = Math.max(Math.abs(tilt), 0.02);
-    const thick = w * (o.thick ?? 0.035);
-    // A turn to a positive yaw carries the front toward the right, as it does for a ball and a cup (and for a drag to the right), so the rim is seen on the left, on the edge that comes toward the eye.
-    const dx = -thick * Math.sin(o.yaw * RAD);
-    const dy = -thick * Math.sin(o.pitch * RAD) * 0.6;
+    const pixels = Number(/\swidth="([\d.]+)"/.exec(front.open)?.[1]) || 64;
+    const thick = Math.min(Math.max(w * (o.thick ?? 0.035), (LEAST_PX * w) / pixels), w * 0.1);
+    // The edge runs from the face toward the far side. For a face that looks to the eye it is behind it (a positive yaw carries the front toward the right, as it does for a ball and a cup, so the edge is on the
+    // left); past a quarter turn the face seen is the back and the edge lies toward the front, on the other side. The whole slab is centred on the piece, so it does not slide as it turns.
+    const side = showBack ? -1 : 1;
+    const dx = -thick * Math.sin(o.yaw * RAD) * side;
+    const dy = -thick * Math.sin(o.pitch * RAD) * Math.abs(across) * 0.6;
     const mirror = showBack && own === undefined;
     const cx = x0 + w / 2;
     const cy = y0 + h / 2;
-    // The turned face, then the filter that adds the rim behind it (and dims a mirrored back).
+    const flat = Math.abs(dx) + Math.abs(dy) < 0.05;
     // The id names everything the definition depends on (its region comes from the box), so two drawings in one page that share an id share one filter.
-    const id = `dgf${o.line === true ? "l" : "c"}${mirror ? "b" : "f"}${Math.round(dx * 100)}_${Math.round(dy * 100)}_${[x0, y0, w, h].map((v) => Math.round(v)).join("_")}`;
-    const flood = o.line === true ? '<feFlood flood-color="currentColor" flood-opacity=".5"/>' : '<feFlood flood-color="#000" flood-opacity=".42"/>';
-    const steps = [1, 2, 3].map((k) => (Math.abs(dx) + Math.abs(dy) < 0.05 ? "" : `<feOffset in="s" dx="${n2((dx * k) / 3)}" dy="${n2((dy * k) / 3)}" result="o${k}"/>`)).join("");
-    const nodes = Math.abs(dx) + Math.abs(dy) < 0.05 ? "" : '<feMergeNode in="o3"/><feMergeNode in="o2"/><feMergeNode in="o1"/>';
-    const dim = mirror && o.line !== true ? '<feColorMatrix in="SourceGraphic" values=".8 0 0 0 0 0 .8 0 0 0 0 0 .8 0 0 0 0 0 1 0" result="d"/>' : "";
+    const lift = Math.round(Math.min(1 / sx, 24) * 10) / 10;
+    const dark = mirror && o.line !== true ? 0.8 : 1;
+    const id = `dgf${o.line === true ? "l" : "c"}${mirror ? "b" : "f"}${Math.round(dx * 100)}_${Math.round(dy * 100)}_${lift}_${[x0, y0, w, h].map((v) => Math.round(v)).join("_")}`;
+    const steps = flat ? "" : Array.from({ length: SLICES }, (_, k) => `<feOffset in="s" dx="${n2((dx * (k + 1)) / SLICES)}" dy="${n2((dy * (k + 1)) / SLICES)}" result="o${k + 1}"/>`).join("");
+    const nodes = flat ? "" : Array.from({ length: SLICES }, (_, k) => `<feMergeNode in="o${SLICES - k}"/>`).join("");
+    // The edge: the face's colours, darkened and made opaque again (the squeeze spread them thin); in the line style a flat dim ink.
+    const edge = o.line === true
+        ? `<feColorMatrix in="SourceGraphic" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 ${lift} 0" result="a"/><feFlood flood-color="currentColor"/><feComposite in2="a" operator="in" result="b"/><feComponentTransfer in="b" result="s"><feFuncA type="linear" slope=".5"/></feComponentTransfer>`
+        : `<feColorMatrix in="SourceGraphic" values=".58 0 0 0 0 0 .58 0 0 0 0 0 .58 0 0 0 0 0 ${lift} 0" result="s"/>`;
+    const dim = mirror && o.line !== true ? `<feColorMatrix in="SourceGraphic" values="${dark} 0 0 0 0 0 ${dark} 0 0 0 0 0 ${dark} 0 0 0 0 0 1 0" result="d"/>` : "";
     const filter = `<filter id="${id}" x="${n2(x0 - w * 0.15)}" y="${n2(y0 - h * 0.15)}" width="${n2(w * 1.3)}" height="${n2(h * 1.3)}" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">` +
-        `${flood}<feComposite in2="SourceAlpha" operator="in" result="s"/>${steps}${dim}<feMerge>${nodes}<feMergeNode in="${dim === "" ? "SourceGraphic" : "d"}"/></feMerge></filter>`;
+        `${flat ? "" : edge + steps}${dim}<feMerge>${nodes}<feMergeNode in="${dim === "" ? "SourceGraphic" : "d"}"/></feMerge></filter>`;
     const flip = mirror ? -1 : 1;
-    const group = `<g filter="url(#${id})"><g transform="translate(${n2(cx)} ${n2(cy)}) scale(${n2(sx * flip)} ${n2(sy)}) translate(${n2(-cx)} ${n2(-cy)})">${face.rest}</g></g>`;
+    const shift = flat ? "" : `translate(${n2(-dx / 2)} ${n2(-dy / 2)}) `;
+    const group = `<g filter="url(#${id})"><g transform="${shift}translate(${n2(cx)} ${n2(cy)}) scale(${n2(sx * flip)} ${n2(sy)}) translate(${n2(-cx)} ${n2(-cy)})">${face.rest}</g></g>`;
     return `${front.open}${front.head}<defs>${filter}</defs>${group}</svg>`;
 }