@johnmorrisdotca/dougu-sports 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -6,6 +6,32 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-10-14
+
+Fifty balls in true 3D: vintage leather soccer balls, soccer balls in the style of an era, patterns of a shop wall, baseballs of other threads and volleyballs in national colours. 244 emblems.
+
+### Added
+
+- **Five vintage soccer balls** ([docs/vintage-balls.md](docs/vintage-balls.md), [日本語](docs/vintage-balls.ja.md)), in worn tan, brown and chestnut leather with scuffs and stitch lines, each on the construction of its period: `ball:soccer-1870-hand-stitched` (eight long panels, a button at each end, cross-stitched), `ball:soccer-1900-laced` (eight panels, a round cap at each end and a criss-crossed lace across a slit), `ball:soccer-1930-18-panel` (eighteen strips, six panels of three), `ball:soccer-1950-12-panel` (twelve pentagons in four tones) and `ball:soccer-1960-32-panel-leather`. The four older balls carry the 27 to 28 inch circumference of the 1872 Laws.
+- **Eleven soccer balls in the style of an era**, with graphics of our own on the construction of the time and no real design, mark or name: `ball:soccer-1970-black-white`, `-1978-triad` (three curved triangles in a pinwheel on each hexagon), `-1986-decorated-triad`, `-1998-coloured-triad`, `-2002-triangle-sweep`, `-2006-propeller` (14 panels), `-2010-grooved` (8 panels), `-2014-ribbon` (6 panels), `-2018-pixel`, `-2022-speed-shell` (20 panels) and `ball:soccer-training-high-vis`.
+- **Eighteen shop-wall soccer balls**, six generic patterns in three colourways each: stars (`-blue`, `-red`, `-night`), hexagon outlines (`-cyan`, `-magenta`, `-lime`), flames (`-fire`, `-ice`, `-toxic`), chevrons (`-red`, `-green`, `-blue`), a two-tone swirl (`-blue`, `-red`, `-teal`) and a metallic glossy finish (`-gold`, `-silver`, `-cobalt`), as `ball:soccer-stars-blue` and so on.
+- **Five baseballs and softballs**: `ball:baseball-lemon-peel` (the early four-seam ball), `ball:baseball-red-blue` and `ball:baseball-black-red` (the figure-8 seam stitched in two colours, the laces of the two leagues in a 1930s player's account), `ball:baseball-vintage-leather` and `ball:softball-11-optic` (the 27.9 cm optic yellow ball of the WBSC Slow Pitch rules, 166.5 to 173.6 g). The red figure-8 stitch is the existing `ball:baseball`.
+- **Eleven volleyballs in national colours**: `ball:volleyball-brazil`, `-japan`, `-canada`, `-usa`, `-italy`, `-poland`, `-france`, `-serbia`, `-netherlands` and `-germany`, the 18-panel indoor ball with its panels in three colours of the flag (colours only, no flag drawn), and `ball:volleyball-colours`. A new **`colors` option** (`renderEmblem`, `emblemFrame`, `ballFrame`) takes any three colours for any of them.
+- **New tilings and tools**: `octahedron8` (an octahedron whose edges are bent into S curves), `icosahedron`, `gorePoint` and `colourCentres` in `ball.tilings.ts`; `ball.decal.ts` (shapes laid on the sphere with `frameAt`, `tongue` leaves and ribbons, rows of stitches, a lace, scuffs); `paint18` and `seams18` in the panelled family; `panels` on the engine's surface (several polygons of one fill as one path); `wear` and a second thread colour in the seamed balls.
+- Tests (`test/vintage.test.ts`) for the new ids, names and descriptions, the sizes, the `colors` option, the new tilings and the decal tools. The contact sheets in `docs/pieces`, the README's ball picture (now with a row of vintage balls) and both gallery pages are redrawn and rewritten.
+
+### Changed
+
+- The `ball:soccer` family is now 55 balls in the proportions test (the 21 of 0.3.0, the five vintage, eleven era-style and eighteen patterned), and the balls hold their size budget (14 kB in colour, 13 kB as a line drawing; 8.5 kB on average).
+
+## [0.4.1] - 2026-10-14
+
+The printed pucks take the same flag renderer as taisen-brackets.
+
+### Changed
+
+- **The puck's flag renderer is the one taisen-brackets takes.** `flags` is now an option of the call (`renderEmblem`, `emblemFrame`, `ballFrame`), beside `face`, and no longer a field of `face`; it is called `flags(code, { shape: "round" | "square" | "rect", size, theme: "inherit" | "light" | "dark" })` (the puck asks for `"rect"`), may return `null` or `undefined` for a code it has no flag for, and is synchronous, so one adapter over hata serves every package. New types `FlagRequest` and `FlagShape`. `FlagRenderer` changed accordingly; the 0.4.0 form (`face.flags`, shapes `4:3`/`1:1`/`round`) is gone.
+
 ## [0.4.0] - 2026-10-14
 
 Printed pucks: eight souvenir pucks with a print on the top face that turns with the puck, and a `face` option that takes any picture, emblem or flag code. 194 emblems.
@@ -132,7 +158,9 @@ First preview: the name, the API and two sample emblems. The full set of trophie
 - Tests for the drawing, the ids, the turns and the bundle size of one item; a package check that installs the packed tarball and bundles one item from it.
 - The demo (a playground with a turn slider, and a gallery page), `docs/layout.md`, `docs/turning.md`, `docs/gallery.md`, the family header and footer, the CI, Pages and Release workflows, and `LICENSES/` and `NOTICE.md` ready for third-party art.
 
-[Unreleased]: https://github.com/johnmorrisdotca/dougu-sports/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/johnmorrisdotca/dougu-sports/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/johnmorrisdotca/dougu-sports/compare/v0.4.1...v0.5.0
+[0.4.1]: https://github.com/johnmorrisdotca/dougu-sports/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/johnmorrisdotca/dougu-sports/compare/v0.3.2...v0.4.0
 [0.3.2]: https://github.com/johnmorrisdotca/dougu-sports/compare/v0.3.1...v0.3.2
 [0.3.1]: https://github.com/johnmorrisdotca/dougu-sports/compare/v0.3.0...v0.3.1

package/NOTICE.md

@@ -7,7 +7,7 @@ No emblem carries the name, mark or logo of a league, a team, a federation or an
 ## How the art is made
 
 - The trophies, medals, crests, awards and sport pictograms are drawn in SVG by hand in a simplified, generic form. No real trophy, medal, logo, mark or engraving was copied or traced, and no photograph was traced (photographs were looked at, never copied).
-- The balls (`src/emblems/ball/`) are drawn by this package's own code: a rotation, a projection and our own geometry (a seam curve, the truncated icosahedron, a layout of curved panels, a fitted basketball channel).
+- The balls (`src/emblems/ball/`) are drawn by this package's own code: a rotation, a projection and our own geometry (a seam curve, the truncated icosahedron, an octahedron and an icosahedron, a layout of curved panels, a fitted basketball channel). The vintage, era-style and patterned balls ([docs/vintage-balls.md](docs/vintage-balls.md)) are our own graphics laid on those constructions (shapes placed on the sphere, rows of stitches, a lace, scuffs): the shop-wall patterns and the era styles were suggested by photographs the package's author supplied, which were looked at and not copied or traced, and no real ball's pattern, mark or name is used. The volleyballs take only three colours from a country's flag, and draw no flag.
 - The printed pucks (`puck:*`, `src/emblems/ball/ball.puck.print.ts`) are our own drawings: the maple leaf, the flags of the Canadian and United States patterns and the stars are drawn from simple geometry, the lettering is a stroke alphabet adapted from the block letters of the author's own senshu-jerseys (same author, same MIT licence, no font file), and the signature is made by a seeded pen, so it is no real person's. Photographs of souvenir pucks were looked at for what such a puck shows (a flag, a name, a number, a signature, a ring of words) and nothing was copied or traced. No team's or league's logo or wordmark, no maker's mark and no real player's name is used.
 - The gear (`src/emblems/gear/`) is drawn by us from a list of parts (a path, a colour, how it reads as a line); the bow, the arrow and the other tapering shapes are made by a small function of ours (`swell`), and the rest are paths written for this package.
 - The Japanese words for the Japanese items are the ones the sports' governing bodies use in their own rules and equipment lists (kendo, judo, kyudo and karate federations and the sumo association); the bodies' names and marks are not used in any id, title or drawing.
@@ -22,19 +22,21 @@ Each ball's `size.rule` names the rule; the table gives the document and where i
 
 | Balls | Rulebook and rule | Read at |
 | --- | --- | --- |
-| `ball:soccer`, `ball:soccer-colour`, `ball:soccer-26`, `ball:soccer-18`, `ball:soccer-14`, `ball:soccer-12`, `ball:soccer-6`, `ball:soccer-orange`, `ball:soccer-26-orange`, `ball:soccer-18-orange`, `ball:soccer-14-orange`, `ball:soccer-12-orange`, `ball:soccer-6-orange`, `ball:soccer-yellow`, `ball:soccer-26-yellow`, `ball:soccer-18-yellow`, `ball:soccer-14-yellow`, `ball:soccer-12-yellow`, `ball:soccer-6-yellow` | IFAB Laws of the Game, Law 2 The Ball, section 2.1 Qualities and measurements | https://www.theifab.com/laws/latest/the-ball/ |
+| `ball:soccer`, `ball:soccer-colour`, `ball:soccer-26`, `ball:soccer-18`, `ball:soccer-14`, `ball:soccer-12`, `ball:soccer-6`, `ball:soccer-orange`, `ball:soccer-26-orange`, `ball:soccer-18-orange`, `ball:soccer-14-orange`, `ball:soccer-12-orange`, `ball:soccer-6-orange`, `ball:soccer-yellow`, `ball:soccer-26-yellow`, `ball:soccer-18-yellow`, `ball:soccer-14-yellow`, `ball:soccer-12-yellow`, `ball:soccer-6-yellow`, `ball:soccer-1960-32-panel-leather`, `ball:soccer-1970-black-white`, `ball:soccer-1978-triad`, `ball:soccer-1986-decorated-triad`, `ball:soccer-1998-coloured-triad`, `ball:soccer-2002-triangle-sweep`, `ball:soccer-2006-propeller`, `ball:soccer-2010-grooved`, `ball:soccer-2014-ribbon`, `ball:soccer-2018-pixel`, `ball:soccer-2022-speed-shell`, `ball:soccer-training-high-vis`, `ball:soccer-stars-blue`, `ball:soccer-stars-red`, `ball:soccer-stars-night`, `ball:soccer-hexagons-cyan`, `ball:soccer-hexagons-magenta`, `ball:soccer-hexagons-lime`, `ball:soccer-flames-fire`, `ball:soccer-flames-ice`, `ball:soccer-flames-toxic`, `ball:soccer-chevrons-red`, `ball:soccer-chevrons-green`, `ball:soccer-chevrons-blue`, `ball:soccer-swirl-blue`, `ball:soccer-swirl-red`, `ball:soccer-swirl-teal`, `ball:soccer-metallic-gold`, `ball:soccer-metallic-silver`, `ball:soccer-metallic-cobalt` | IFAB Laws of the Game, Law 2 The Ball, section 2.1 Qualities and measurements | https://www.theifab.com/laws/latest/the-ball/ |
 | `ball:futsal` | Futsal Laws of the Game 2025/26, Law 2 The Ball, section 1 Qualities and measurements (circumference 62-64 cm, 400-440 g, 0.6-0.9 atm, bounce 50-65 cm from 2 m) | https://digitalhub.fifa.com/m/20d52e6779b53321/original/FUTSAL-Laws-of-the-Game-2025-2026.pdf |
 | `ball:beach-soccer` | Beach Soccer Laws of the Game 2024-25, Law 2 The Ball, section 1 Qualities and measurements (circumference 68-70 cm, 400-440 g, 0.4-0.6 atm); the 2021/22 edition has the same figures | https://www.the-aiff.com/media/uploads/2024/11/Beach-Soccer-Laws-of-the-Game-2024-25.pdf |
+| `ball:soccer-1870-hand-stitched`, `ball:soccer-1900-laced`, `ball:soccer-1930-18-panel`, `ball:soccer-1950-12-panel` | Laws of the Game of the Football Association, revised 1872: a sphere 27 to 28 inches round (no mass given: the early figures could not be confirmed in a primary text); read in Wikipedia's account of the 1872 revision (secondary) | https://en.wikipedia.org/wiki/Ball_(association_football) |
 | `ball:teqball` | FITEQ Official Rules and Regulations of Teqball 2026, Rule 3 The Official Ball, 3.1.1-3.1.6 | https://cdn.buttercms.com/s6Mb1gRkRJuFP38kpMTh |
 | `ball:basketball` | FIBA Basketball Equipment 2026, Rule 2 Basketballs, 2.4 and Table 1 (size 7 = men's competitions) | https://assets.fiba.basketball/image/upload/documents-corporate-fiba-official-rules-2026-equipment-v1-0.pdf |
 | `ball:basketball-6` | FIBA Basketball Equipment 2026, Rule 2 Basketballs, 2.4 and Table 1 (size 6 = women's competitions) | https://assets.fiba.basketball/image/upload/documents-corporate-fiba-official-rules-2026-equipment-v1-0.pdf |
 | `ball:basketball-3x3` | FIBA 3x3 Official Equipment & Software Appendix to the 3x3 Official Rules (Dec 2024 update), Table 1 and section 5.7 (as quoted by balls.com) (not read in the primary text: see the ball's note) | https://fiba3x3.com/docs/equipment-and-software-appendix-to-the-3x3-official-rules.pdf |
-| `ball:baseball` | Official Baseball Rules, Rule 3.01 The Ball | https://mktg.mlbstatic.com/mlb/official-information/2026-official-baseball-rules.pdf |
+| `ball:baseball`, `ball:baseball-lemon-peel`, `ball:baseball-red-blue`, `ball:baseball-black-red`, `ball:baseball-vintage-leather` | Official Baseball Rules, Rule 3.01 The Ball (the lemon-peel ball is drawn at today's size: no rule fixed the ball in the 1850s and 1860s) | https://mktg.mlbstatic.com/mlb/official-information/2026-official-baseball-rules.pdf |
+| `ball:softball-11-optic` | WBSC Official Rules of Softball Slow Pitch 2026-2029, Appendix 3 (Ball Standards), B.2 and the 'Ball standards' table: the 27.9 cm (11 in) ball, circumference 27.6 to 28.3 cm, 166.5 to 173.6 g, white or yellow optic, red stitch (read in the full text, 2026-10-14) | https://static.wbsc.org/uploads/federations/0/cms/documents/5f45c5e4-54ed-3659-8116-4d7cb5051f69.pdf |
 | `ball:softball` | WBSC Official Rules of Softball Slow Pitch 2026-2029, Appendix 3 (Ball Specifications), B. Dimensions and Specifications and 'Ball standards' table; Fast Pitch 2026-2029 Appendix 3 gives the same 12 in ball | https://static.wbsc.org/uploads/federations/0/cms/documents/5f45c5e4-54ed-3659-8116-4d7cb5051f69.pdf |
 | `ball:tennis` | ITF Rules of Tennis, Rule 3 The Ball and Appendix I The Ball (a)-(c) | https://www.itftennis.com/media/7221/2026-rules-of-tennis-english.pdf |
 | `ball:padel` | FIP Rules of Padel, 'The Ball' article (as extracted in FIP Game Ball Certification Process, section B) and Appendix 'Technical specifications of the padel ball' | https://www.padelfip.com/wp-content/uploads/2026/04/Game-Ball-Certification-Process-3-1.pdf |
 | `ball:sliotar` | GAA Official Guide Part 2, Rules of Specification, Rule 4.4(i) | https://www.galwaygaa.ie/wp-content/uploads/2026/02/Official-Guide-Part-2.pdf |
-| `ball:volleyball`, `ball:volleyball-8` | FIVB Official Volleyball Rules 2025-2028, Rule 3 Balls, 3.1 Standards | https://www.fivb.com/wp-content/uploads/2025/01/FIVB-Volleyball_Rules2025_2028-EN-v05.pdf |
+| `ball:volleyball`, `ball:volleyball-8`, `ball:volleyball-colours`, `ball:volleyball-brazil`, `ball:volleyball-japan`, `ball:volleyball-canada`, `ball:volleyball-usa`, `ball:volleyball-italy`, `ball:volleyball-poland`, `ball:volleyball-france`, `ball:volleyball-serbia`, `ball:volleyball-netherlands`, `ball:volleyball-germany` | FIVB Official Volleyball Rules 2025-2028, Rule 3 Balls, 3.1 Standards | https://www.fivb.com/wp-content/uploads/2025/01/FIVB-Volleyball_Rules2025_2028-EN-v05.pdf |
 | `ball:beach-volleyball` | FIVB Official Beach Volleyball Rules 2025-2028, Rule 3 Balls, 3.1 Standards | https://www.fivb.com/wp-content/uploads/2025/02/FIVB-BeachVolleyball_Rules2025_2028-EN-v01.pdf |
 | `ball:cricket-red`, `ball:cricket-white`, `ball:cricket-pink` | Laws of Cricket, Law 4 The Ball, 4.1 Weight and size (Size 1, Size 2, Size 3) | https://www.lords.org/getmedia/1d908298-5c44-468d-b6a7-e1414a1296e0/Laws-of-Cricket-2017-Code-4th-Edition-(2026)_3.pdf |
 | `ball:football` | NFL Rulebook, Rule 2 The Ball, Section 1 (Dimensions) | https://operations.nfl.com/rules-officiating/2026-nfl-rulebook |

package/README.md

@@ -16,7 +16,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-desk-dark.webp">
-<img alt="Thirty-six balls and pucks drawn in 3D, in four rows of nine: soccer balls of several constructions and colours, then basketball, the 3x3 ball, baseball, softball, a football, a rugby ball, an Australian football and two volleyballs, then tennis, padel, pickleball with its holes, squash with its two dots, racquetball, golf, red and pink cricket and water polo, then sepak takraw, a shuttlecock, a puck, a curling stone, lacrosse, handball, table tennis, a sliotar and a roundnet ball." src="https://raw.githubusercontent.com/johnmorrisdotca/dougu-sports/main/docs/images/balls-desk-light.webp" width="760">
+<img alt="Forty-five balls and pucks drawn in 3D, in five rows of nine: soccer balls of several constructions and colours, then basketball, the 3x3 ball, baseball, softball, a football, a rugby ball, an Australian football and two volleyballs, then tennis, padel, pickleball with its holes, squash with its two dots, racquetball, golf, red and pink cricket and water polo, then sepak takraw, a shuttlecock, a puck, a curling stone, lacrosse, handball, table tennis, a sliotar and a roundnet ball, and last a row of vintage leather balls (hand-stitched, laced, 18 strips, 12 panels, 32 panels), a lemon-peel baseball and an aged baseball, and soccer balls in the style of the late 1970s and the early 2020s." src="https://raw.githubusercontent.com/johnmorrisdotca/dougu-sports/main/docs/images/balls-desk-light.webp" width="760">
 </picture>
 </p>
 
@@ -45,7 +45,7 @@ The ball and the gear of every sport, trophies, medals, crests and the icon of e
 </tr>
 </table>
 
-> **Status: preview.** 194 emblems: 24 trophies, 5 awards, 6 medals, 4 crests, a pictogram for each of the 38 sports, 66 balls and implements drawn in 3D, 8 printed pucks ([docs/pucks.md](./docs/pucks.md)), 42 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.** 244 emblems: 24 trophies, 5 awards, 6 medals, 4 crests, a pictogram for each of the 38 sports, 116 balls and implements drawn in 3D, 8 printed pucks ([docs/pucks.md](./docs/pucks.md)), 42 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
 
@@ -73,7 +73,7 @@ Put the string in a page (`element.innerHTML = svg`), write it to a file, or sen
 
 ## Features
 
-- **Equipment first (道具 is the word for it)**: 66 balls and implements drawn in 3D, from the 32-panel soccer ball to the 26, 18, 14, 12 and 6 panel constructions, 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).
+- **Equipment first (道具 is the word for it)**: 116 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).
@@ -407,7 +407,7 @@ An emblem is a small object: `id`, `en` and `ja` names, a `source` (who drew it)
 | `trophy` | Twenty-four trophies: ten that stand for a league's cup in a generic form (a tall banded cup, a ring of pennants round a baseball, a football on a stand, a ball over a net, a wide two-handled bowl, a globe held up by spiral figures, a gilt dish, a lidded cup with a pineapple, an urn, a gilded cup), plain cups, bowls and dishes, a plaque, a belt, a wreath, a rosette, a championship ring, a rafter banner, a phoenix-handled sumo cup and a championship banner | `src/emblems/trophy/` |
 | `medal` | Gold, silver and bronze medals on a ribbon of five stripes, and a badge for each of the first three places | `src/emblems/medal/` |
 | `crest` | Four generic crests, tinted by a team's colours, with its letters | `src/emblems/crest/` |
-| `ball` | 66 balls and implements, in 3D, each with its official size: soccer (in 32, 26, 18, 14, 12 and 6 panels, in three colourways, with futsal and beach soccer; [docs/soccer-balls.md](./docs/soccer-balls.md)), basketball, baseball, tennis, rugby, the footballs, golf, the puck, the curling stone and the rest | `src/emblems/ball/` |
+| `ball` | 116 balls and implements, in 3D, each with its official size: soccer (in 32, 26, 18, 14, 12 and 6 panels, in three colourways, with futsal and beach soccer; [docs/soccer-balls.md](./docs/soccer-balls.md); and vintage leather, era-style and patterned balls, [docs/vintage-balls.md](./docs/vintage-balls.md)), basketball, baseball, tennis, rugby, the footballs, golf, the puck, the curling stone and the rest | `src/emblems/ball/` |
 | `puck` | 8 printed pucks: the same puck with a print on its top face that turns with it (a flag and CANADA, a red leaf, stars and stripes, a player's name and number, a made-up signature, a souvenir), and a `face` option for any picture, emblem or flag code; [docs/pucks.md](./docs/pucks.md) | `src/emblems/ball/ball.puck.print.ts` |
 | `gear` | 42 pieces of equipment: sticks, rackets, skates, a glove, a helmet, nets and posts, a javelin, starting blocks, and for the Japanese sports a war fan, a sumo belt, a bamboo sword, a kendo helmet, a judo suit, a belt, a long bow, an arrow and a karate suit | `src/emblems/gear/` |
 | `sport` | One pictogram for each of the thirty-eight sports | `src/emblems/sport/` |
@@ -459,6 +459,7 @@ The thirty-eight sports the ball, gear and sport emblems are made for are `SPORT
 | `size` | A number of pixels, 4096 at most | `64` |
 | `tint` | `#rgb`, `#rrggbb` or `rgb(r, g, b)` | the emblem's own colour |
 | `accent` | `#rgb`, `#rrggbb` or `rgb(r, g, b)` | the emblem's second colour (a ribbon, a band, pennants) |
+| `colors` | Three colours, each `#rgb`, `#rrggbb` or `rgb(r, g, b)` (a volleyball in national colours: [docs/vintage-balls.md](./docs/vintage-balls.md#volleyballs-in-national-colours-11)); fewer are repeated, and what is not a colour is dropped | the ball's own three |
 | `initials` | Up to three letters (a crest, or the championship banner) | none: the crest has a star, the banner a ring and a star |
 | `theme` | `"inherit"`, `"auto"`, `"light"`, `"dark"` | `"inherit"` |
 | `grain` | `true` or `false` (a ball only) | on for a ball of 48 pixels or more that is not turning |
@@ -593,7 +594,7 @@ Bug reports and ideas go in the [issues](https://github.com/johnmorrisdotca/doug
 
 ## Changes
 
-See [CHANGELOG.md](./CHANGELOG.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.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.vintage.d.ts

@@ -0,0 +1,10 @@
+/** The 1850s and 1860s: a cover of four pieces sewn along four seams that run from one point to the opposite one, like the peel of a lemon, in aged leather with a dark thread. No rule fixed the ball then, so it is drawn at the size of today's. */
+export declare const BALL_BASEBALL_LEMON_PEEL: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/** The figure-8 seam stitched with alternate red and blue stitches (the American League's laces, in the recollection of a 1930s player). */
+export declare const BALL_BASEBALL_RED_BLUE: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/** The figure-8 seam stitched with alternate black and red stitches (the National League's laces, in the same recollection). */
+export declare const BALL_BASEBALL_BLACK_RED: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/** An old ball: the leather gone the colour of tea and scuffed, the red thread faded. */
+export declare const BALL_BASEBALL_VINTAGE_LEATHER: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+/** The optic yellow 11 inch softball: 27.9 cm (circumference 27.6 to 28.3 cm, 166.5 to 173.6 g), red stitch, as the WBSC's Slow Pitch rules set it for women and girls. */
+export declare const BALL_SOFTBALL_11_OPTIC: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;

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

@@ -0,0 +1,70 @@
+// Baseballs of other times and threads: the early "lemon-peel" ball (four lines of stitching that meet at two points), the figure-8 ball with a seam stitched in red and blue and in black and red (the
+// colours of the two leagues' laces in the 1930s), an aged leather one, and an optic yellow 11 inch softball. The figure-8 seam is the parametric curve of ball.math.ts, as for the modern baseball.
+import { defineBall } from "./ball.engine.js";
+import { mix } from "./ball.core.js";
+import { across, scuffs } from "./ball.decal.js";
+import { seamedBall } from "./ball.family.seamed.js";
+import { gores } from "./ball.tilings.js";
+import { BALL_BASEBALL } from "./ball.baseball.js";
+const SIZE = BALL_BASEBALL.size;
+/** The 1850s and 1860s: a cover of four pieces sewn along four seams that run from one point to the opposite one, like the peel of a lemon, in aged leather with a dark thread. No rule fixed the ball then, so it is drawn at the size of today's. */
+export const BALL_BASEBALL_LEMON_PEEL = /* @__PURE__ */ defineBall({
+    id: "ball:baseball-lemon-peel",
+    en: "Baseball, lemon-peel",
+    ja: "レモンピール型野球ボール",
+    size: { ...SIZE, rule: "Official Baseball Rules, Rule 3.01 The Ball (today's size; no rule fixed the ball in the 1850s and 1860s)", note: "Drawn at the size of today's ball. Diameter worked out from the middle of the circumference range." },
+    spec: {
+        view: { yaw: 18, pitch: 30, roll: -10 },
+        base: "#e1cfa6",
+        mat: { gloss: 0.25, shade: "#4a3a2a", grain: { f: 1.6, a: 0.2 } },
+        draw: (s, base, accent) => {
+            const g = gores(4, 0, [0, 28, 0], 24, 4);
+            let out = "";
+            for (let i = 0; i < 4; i += 2)
+                out += s.panel(g.panels[i], mix(base, -0.07), { n: 1 });
+            out += scuffs(s, mix(base, -0.55), mix(base, 0.5), { dark: 10, pale: 5, seed: 4 });
+            out += s.strokes(g.seams, "#8a7452", 0.9);
+            out += s.strokes(across(g.seams, 0.06, 0.03, 0.012), accent ?? "#5a3a24", 0.85, { ink: false });
+            return out;
+        },
+    },
+});
+const STITCH = { count: 108, half: 0.075, width: 0.85, lean: 0.032 };
+const WHITE = "#f4f0e6";
+const common = { size: SIZE, base: WHITE, b: 0.4, view: { yaw: 18, pitch: 28, roll: -10 }, mat: { gloss: 0.3, shade: "#4a3a2a", grain: { f: 1.4, a: 0.12 } }, groove: "#8a7a62" };
+/** The figure-8 seam stitched with alternate red and blue stitches (the American League's laces, in the recollection of a 1930s player). */
+export const BALL_BASEBALL_RED_BLUE = /* @__PURE__ */ seamedBall({ ...common, id: "ball:baseball-red-blue", en: "Baseball, red and blue", ja: "赤青の縫い糸の野球ボール", stitch: { ...STITCH, colour: "#c4262e", colour2: "#2257a8" } });
+/** The figure-8 seam stitched with alternate black and red stitches (the National League's laces, in the same recollection). */
+export const BALL_BASEBALL_BLACK_RED = /* @__PURE__ */ seamedBall({ ...common, id: "ball:baseball-black-red", en: "Baseball, black and red", ja: "黒赤の縫い糸の野球ボール", stitch: { ...STITCH, colour: "#c4262e", colour2: "#1d1d20" } });
+/** An old ball: the leather gone the colour of tea and scuffed, the red thread faded. */
+export const BALL_BASEBALL_VINTAGE_LEATHER = /* @__PURE__ */ seamedBall({
+    ...common,
+    id: "ball:baseball-vintage-leather",
+    en: "Baseball, aged leather",
+    ja: "古びた革の野球ボール",
+    base: "#d8c08e",
+    mat: { gloss: 0.2, shade: "#43301c", grain: { f: 1.7, a: 0.26 } },
+    groove: "#7a6240",
+    stitch: { ...STITCH, colour: "#a23a2c" },
+    wear: { dark: 16, pale: 8, seed: 6 },
+});
+/** The optic yellow 11 inch softball: 27.9 cm (circumference 27.6 to 28.3 cm, 166.5 to 173.6 g), red stitch, as the WBSC's Slow Pitch rules set it for women and girls. */
+export const BALL_SOFTBALL_11_OPTIC = /* @__PURE__ */ seamedBall({
+    id: "ball:softball-11-optic",
+    en: "Softball, 11 in, optic",
+    ja: "11インチ蛍光ソフト",
+    size: {
+        extentMm: 279.5 / Math.PI,
+        diameterMm: 279.5 / Math.PI,
+        circumferenceMm: 279.5,
+        massG: [166.5, 173.6],
+        rule: "WBSC Official Rules of Softball Slow Pitch 2026-2029, Appendix 3 (Ball Standards), B.2 and the 'Ball standards' table: the 27.9 cm (11 in) ball, white or yellow optic cover, red stitch",
+        note: "Circumference 27.6 to 28.3 cm. Diameter worked out from the middle of the range. The rule asks for at least 80 stitches in each cover on a flat-seam ball (88 on the 12 in ball); 80 are drawn.",
+    },
+    base: "#d8e22a",
+    b: 0.4,
+    view: { yaw: 18, pitch: 28, roll: -10 },
+    mat: { gloss: 0.35, shade: "#4c5a10", grain: { f: 1.4, a: 0.12 } },
+    groove: "#8a9420",
+    stitch: { colour: "#d0262c", count: 80, half: 0.085, width: 0.95, lean: 0.04 },
+});

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

@@ -1,4 +1,4 @@
-import type { PuckFace } from "./ball.face.ts";
+import type { FlagRenderer, PuckFace } from "./ball.face.ts";
 /** `metal` (also written `colour`): full colour, with shading. `line`: one outline in `currentColor`. */
 export type PieceStyle = "metal" | "colour" | "color" | "line";
 /** `inherit` (the default): the page's text colour. `auto`: dark ink on a light device and pale ink on a dark one. `light` and `dark` force one. */
@@ -19,8 +19,12 @@ export interface PieceOptions {
     locale?: "en" | "ja";
     /** A string is the `<title>` (escaped); `false` drops it and marks the drawing `aria-hidden="true"`. */
     title?: string | false;
+    /** A ball with panels in several colours (the national volleyballs): the colours of its panels, three of them, each a hex colour or `rgb()` (any that is not is dropped; one or two are repeated to make three). Anything else ignores it. */
+    colors?: readonly string[];
     /** A puck: the print on its top face (see `PuckFace`). The printed pucks (`puck:*`) take it, and so does `ball:puck` through `renderEmblem`, `emblemFrame` and `ballFrame`. Anything else ignores it. */
     face?: PuckFace;
+    /** A puck: a renderer for the flag codes this package does not draw (`face.flag`), `(code, { shape, size, theme }) => svg`, the one taisen-brackets takes. Synchronous. */
+    flags?: FlagRenderer;
 }
 /** A turn: `yaw` degrees about the vertical axis (0 is the default view), `pitch` the tilt toward you, `roll` the turn about the line of sight. */
 export interface BallFrameOptions extends PieceOptions {
@@ -87,8 +91,11 @@ export interface ResolvedOptions {
     theme: PieceTheme;
     tint: string | undefined;
     accent: string | undefined;
+    /** Three colours for the panels, or undefined. */
+    colors: readonly [string, string, string] | undefined;
     grain: boolean | undefined;
     face: PuckFace | undefined;
+    flags: FlagRenderer | undefined;
     /** A string that tells two faces apart, for the ids of a drawing. */
     faceKey: string;
 }

package/dist/emblems/ball/ball.core.js

@@ -53,12 +53,22 @@ function faceKeyOf(face) {
         return "?";
     }
 }
+/** Up to three colours from a list, any that is not a colour dropped and the rest repeated to make three; undefined when none is one. */
+function coloursOf(list) {
+    if (!Array.isArray(list))
+        return undefined;
+    const ok = list.slice(0, 3).flatMap((c) => {
+        const rgb = typeof c === "string" ? readColour(c) : undefined;
+        return rgb === undefined ? [] : [hexOf(rgb)];
+    });
+    return ok.length === 0 ? undefined : [ok[0], ok[1 % ok.length], ok[2 % ok.length]];
+}
 export function resolveOptions(o) {
     const size = typeof o?.size === "number" && Number.isFinite(o.size) && o.size > 0 ? Math.min(Math.round(o.size * 100) / 100, 4096) : 64;
     const theme = o?.theme === "auto" || o?.theme === "light" || o?.theme === "dark" ? o.theme : "inherit";
     const tint = readColour(o?.tint);
     const accent = readColour(o?.accent);
-    return { style: o?.style === "line" ? "line" : "colour", size, theme, tint: tint === undefined ? undefined : hexOf(tint), accent: accent === undefined ? undefined : hexOf(accent), grain: typeof o?.grain === "boolean" ? o.grain : undefined, face: typeof o?.face === "object" && o.face !== null ? o.face : undefined, faceKey: faceKeyOf(o?.face) };
+    return { style: o?.style === "line" ? "line" : "colour", size, theme, tint: tint === undefined ? undefined : hexOf(tint), accent: accent === undefined ? undefined : hexOf(accent), colors: coloursOf(o?.colors), grain: typeof o?.grain === "boolean" ? o.grain : undefined, face: typeof o?.face === "object" && o.face !== null ? o.face : undefined, flags: typeof o?.flags === "function" ? o.flags : undefined, faceKey: faceKeyOf(o?.face) + (typeof o?.flags === "function" ? `|fn:${o.flags.name}` : "") };
 }
 /** The ink of a drawing when a theme sets it, and the page it is made to read on. */
 export const PIECE_INK = { light: "#20262d", dark: "#eef1f3" };

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

@@ -0,0 +1,56 @@
+import type { Surface } from "./ball.engine.ts";
+import { type V3 } from "./ball.math.ts";
+type P2 = readonly [number, number];
+/** A frame on the sphere at `c`: `(x, y)` is a point of the plane that touches the sphere there (x toward `toward`, y a quarter turn from it), carried onto the sphere. */
+export declare function frameAt(c: V3, toward?: V3): (x: number, y: number) => V3;
+/** A flat shape put on the sphere. */
+export declare const place: (frame: (x: number, y: number) => V3, shape: readonly P2[]) => V3[];
+/** The shape turned by `angle` radians about the middle and scaled. */
+export declare function turned(shape: readonly P2[], angle: number, scale?: number): P2[];
+/** A regular polygon of `n` sides with a corner at angle `start`. */
+export declare const ngon: (n: number, r: number, start?: number) => P2[];
+/** A star of `n` points, corners alternately at `outer` and `inner`. */
+export declare const star: (n: number, outer: number, inner: number, start?: number) => P2[];
+/**
+ * A tongue: a shape along a spine, `spine(u)` for u from 0 to 1, as wide as `width(u)` (to each side of the spine, so twice that across). It is a leaf, a flame, a blade, a ribbon or a shard according to the
+ * spine and the width given. The result is a closed outline of `2 (steps + 1)` points.
+ */
+export declare function tongue(spine: (u: number) => P2, width: (u: number) => number, steps?: number): P2[];
+/** A spiral spine from radius `r0` to `r1` that turns through `sweep` radians, starting at angle `a`. */
+export declare const spiral: (r0: number, r1: number, a: number, sweep: number) => (u: number) => P2;
+/** A straight spine from one point to another. */
+export declare const line: (a: P2, b: P2) => (u: number) => P2;
+/** A bump that is 0 at both ends and `h` in the middle; `p` below 1 makes it fuller. */
+export declare const lens: (h: number, p?: number) => (u: number) => number;
+/** A taper from `h` at the start to 0 at the end. */
+export declare const taper: (h: number, p?: number) => (u: number) => number;
+/** The length of a curve on the sphere, in radians. */
+export declare function lengthOf(pts: readonly V3[]): number;
+/** A curve resampled at points a fixed distance apart along it (radians), the ends included. */
+export declare function resample(pts: readonly V3[], step: number): V3[];
+/** A curve moved sideways along the sphere by `d` radians (to the left of its direction for a positive `d`). */
+export declare function offset(pts: readonly V3[], d: number): V3[];
+/** Short stitches along a seam, running with it: a dash and a gap of `step / 2` each. `side` moves the row to one side of the seam. */
+export declare function running(curves: ReadonlyArray<readonly V3[]>, step?: number, side?: number): V3[][];
+/** Stitches across a seam: a short mark every `step` radians, `half` to each side of the seam, leaning along it by `lean` (a hand stitch's cross). */
+export declare function across(curves: ReadonlyArray<readonly V3[]>, step?: number, half?: number, lean?: number): V3[][];
+/** A small deterministic number in [0, 1) from two integers, for scuffs and pixels that must be the same every time. */
+export declare function noise(a: number, b?: number): number;
+/** The scuffs of worn leather: soft dark patches and a few pale ones, spread over the ball. */
+export declare function scuffs(s: Surface, dark: string, pale: string, o?: {
+    dark?: number;
+    pale?: number;
+    seed?: number;
+    size?: number;
+}): string;
+/**
+ * A lace across a slit: the slit along `along` from the middle `c` (`length` radians long), a row of eyelets down each side and a lace that crosses from side to side, tied off with two ends. Returns the
+ * slit, the eyelet centres, the crossing strokes and the ends, for the caller to draw.
+ */
+export declare function lacing(c: V3, along: V3, length: number, pairs: number, gap?: number): {
+    slit: V3[];
+    eyelets: V3[];
+    crossings: V3[][];
+    ends: V3[][];
+};
+export {};

package/dist/emblems/ball/ball.decal.js

@@ -0,0 +1,146 @@
+import { add, basis, cross, dot, mul, norm, slerp, spread, sub } from "./ball.math.js";
+/** A frame on the sphere at `c`: `(x, y)` is a point of the plane that touches the sphere there (x toward `toward`, y a quarter turn from it), carried onto the sphere. */
+export function frameAt(c, toward) {
+    let ex;
+    if (toward === undefined)
+        ex = basis(c)[0];
+    else
+        ex = norm(sub(toward, mul(c, dot(toward, c))));
+    const ey = cross(c, ex);
+    return (x, y) => norm(add(c, add(mul(ex, x), mul(ey, y))));
+}
+/** A flat shape put on the sphere. */
+export const place = (frame, shape) => shape.map(([x, y]) => frame(x, y));
+/** The shape turned by `angle` radians about the middle and scaled. */
+export function turned(shape, angle, scale = 1) {
+    const c = Math.cos(angle), s = Math.sin(angle);
+    return shape.map(([x, y]) => [(x * c - y * s) * scale, (x * s + y * c) * scale]);
+}
+/** A regular polygon of `n` sides with a corner at angle `start`. */
+export const ngon = (n, r, start = 0) => Array.from({ length: n }, (_, i) => [r * Math.cos(start + (2 * Math.PI * i) / n), r * Math.sin(start + (2 * Math.PI * i) / n)]);
+/** A star of `n` points, corners alternately at `outer` and `inner`. */
+export const star = (n, outer, inner, start = -Math.PI / 2) => Array.from({ length: 2 * n }, (_, i) => {
+    const r = i % 2 === 0 ? outer : inner;
+    const a = start + (Math.PI * i) / n;
+    return [r * Math.cos(a), r * Math.sin(a)];
+});
+/**
+ * A tongue: a shape along a spine, `spine(u)` for u from 0 to 1, as wide as `width(u)` (to each side of the spine, so twice that across). It is a leaf, a flame, a blade, a ribbon or a shard according to the
+ * spine and the width given. The result is a closed outline of `2 (steps + 1)` points.
+ */
+export function tongue(spine, width, steps = 10) {
+    const left = [], right = [];
+    for (let i = 0; i <= steps; i++) {
+        const u = i / steps;
+        const [x, y] = spine(u);
+        const [x2, y2] = spine(Math.min(1, u + 0.01));
+        const [x1, y1] = spine(Math.max(0, u - 0.01));
+        const l = Math.hypot(x2 - x1, y2 - y1) || 1;
+        const nx = -(y2 - y1) / l, ny = (x2 - x1) / l;
+        const w = width(u);
+        left.push([x + nx * w, y + ny * w]);
+        right.push([x - nx * w, y - ny * w]);
+    }
+    return [...left, ...right.reverse()];
+}
+/** A spiral spine from radius `r0` to `r1` that turns through `sweep` radians, starting at angle `a`. */
+export const spiral = (r0, r1, a, sweep) => (u) => [(r0 + (r1 - r0) * u) * Math.cos(a + sweep * u), (r0 + (r1 - r0) * u) * Math.sin(a + sweep * u)];
+/** A straight spine from one point to another. */
+export const line = (a, b) => (u) => [a[0] + (b[0] - a[0]) * u, a[1] + (b[1] - a[1]) * u];
+/** A bump that is 0 at both ends and `h` in the middle; `p` below 1 makes it fuller. */
+export const lens = (h, p = 1) => (u) => h * Math.sin(Math.PI * u) ** p;
+/** A taper from `h` at the start to 0 at the end. */
+export const taper = (h, p = 1) => (u) => h * (1 - u) ** p;
+/** The length of a curve on the sphere, in radians. */
+export function lengthOf(pts) {
+    let total = 0;
+    for (let i = 0; i + 1 < pts.length; i++)
+        total += Math.acos(Math.max(-1, Math.min(1, dot(pts[i], pts[i + 1]))));
+    return total;
+}
+/** A curve resampled at points a fixed distance apart along it (radians), the ends included. */
+export function resample(pts, step) {
+    const total = lengthOf(pts);
+    const n = Math.max(1, Math.round(total / step));
+    const out = [pts[0]];
+    let walked = 0;
+    let k = 0;
+    for (let i = 1; i <= n; i++) {
+        const target = (total * i) / n;
+        while (k + 1 < pts.length - 1 && walked + Math.acos(Math.max(-1, Math.min(1, dot(pts[k], pts[k + 1])))) < target) {
+            walked += Math.acos(Math.max(-1, Math.min(1, dot(pts[k], pts[k + 1]))));
+            k++;
+        }
+        const seg = Math.acos(Math.max(-1, Math.min(1, dot(pts[k], pts[k + 1])))) || 1e-9;
+        out.push(slerp(pts[k], pts[k + 1], Math.max(0, Math.min(1, (target - walked) / seg))));
+    }
+    return out;
+}
+/** A curve moved sideways along the sphere by `d` radians (to the left of its direction for a positive `d`). */
+export function offset(pts, d) {
+    return pts.map((p, i) => {
+        const t = sub(pts[Math.min(pts.length - 1, i + 1)], pts[Math.max(0, i - 1)]);
+        return norm(add(p, mul(norm(cross(p, t)), d)));
+    });
+}
+/** Short stitches along a seam, running with it: a dash and a gap of `step / 2` each. `side` moves the row to one side of the seam. */
+export function running(curves, step = 0.07, side = 0) {
+    const out = [];
+    for (const curve of curves) {
+        const pts = resample(side === 0 ? curve : offset(curve, side), step / 2);
+        for (let i = 0; i + 1 < pts.length; i += 2)
+            out.push([pts[i], pts[i + 1]]);
+    }
+    return out;
+}
+/** Stitches across a seam: a short mark every `step` radians, `half` to each side of the seam, leaning along it by `lean` (a hand stitch's cross). */
+export function across(curves, step = 0.09, half = 0.022, lean = 0) {
+    const out = [];
+    for (const curve of curves) {
+        const pts = resample(curve, step);
+        for (let i = 1; i + 1 < pts.length; i++) {
+            const t = norm(sub(pts[i + 1], pts[i - 1]));
+            const side = norm(cross(pts[i], t));
+            out.push([norm(add(add(pts[i], mul(side, half)), mul(t, -lean))), norm(add(sub(pts[i], mul(side, half)), mul(t, lean)))]);
+        }
+    }
+    return out;
+}
+/** A small deterministic number in [0, 1) from two integers, for scuffs and pixels that must be the same every time. */
+export function noise(a, b = 0) {
+    let h = Math.imul(a + 374761393, 668265263) ^ Math.imul(b + 1274126177, 2246822519);
+    h = Math.imul(h ^ (h >>> 13), 1274126177);
+    return ((h ^ (h >>> 16)) >>> 0) / 4294967296;
+}
+/** The scuffs of worn leather: soft dark patches and a few pale ones, spread over the ball. */
+export function scuffs(s, dark, pale, o) {
+    const seed = o?.seed ?? 1;
+    const k = o?.size ?? 1;
+    const mark = (pts, base, fill, opacity) => {
+        let out = "";
+        pts.forEach((p, i) => {
+            const r = (base + 0.07 * noise(i, seed)) * k;
+            out += s.dots([p], r, fill, { opacity: opacity * (0.6 + 0.8 * noise(i, seed + 9)), light: false });
+        });
+        return out;
+    };
+    return mark(spread(o?.dark ?? 16, seed), 0.075, dark, 0.13) + mark(spread(o?.pale ?? 9, seed + 3), 0.05, pale, 0.2);
+}
+/**
+ * A lace across a slit: the slit along `along` from the middle `c` (`length` radians long), a row of eyelets down each side and a lace that crosses from side to side, tied off with two ends. Returns the
+ * slit, the eyelet centres, the crossing strokes and the ends, for the caller to draw.
+ */
+export function lacing(c, along, length, pairs, gap = 0.03) {
+    const f = frameAt(c, along);
+    const at = (x, y) => f(x, y);
+    const slit = Array.from({ length: 7 }, (_, j) => at(-length / 2 + (length * j) / 6, 0));
+    const xs = Array.from({ length: pairs }, (_, i) => -length / 2 + (length * (i + 0.5)) / pairs);
+    const eyelets = xs.flatMap((x) => [at(x, gap), at(x, -gap)]);
+    const crossings = [];
+    for (let i = 0; i + 1 < pairs; i++) {
+        crossings.push([at(xs[i], gap), at(xs[i + 1], -gap)], [at(xs[i], -gap), at(xs[i + 1], gap)]);
+    }
+    const last = xs[pairs - 1];
+    const ends = [[at(last, gap), at(last + gap * 1.4, gap * 2.2)], [at(last, -gap), at(last + gap * 1.8, -gap * 1.8)]];
+    return { slit, eyelets, crossings, ends };
+}

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

@@ -33,6 +33,12 @@ export interface Surface {
         opacity?: number;
         n?: number;
     }): string;
+    /** Several closed polygons of one fill, drawn as one path (a smaller document than a path for each). */
+    panels(rings: ReadonlyArray<readonly V3[]>, fill: string, o?: {
+        ink?: boolean;
+        opacity?: number;
+        n?: number;
+    }): string;
     /** A curve on the surface: only what faces you. `closed` joins its ends; `deco` marks a line that is not part of the ball's form (a highlight), which the line style leaves out. */
     stroke(pts: readonly V3[], colour: string, width: number, o?: StrokeOptions): string;
     /** Several curves drawn as one path. */
@@ -83,7 +89,7 @@ export interface BallSpec {
     ground?: string;
     mat: Material;
     /** Lays the panels and seams. `base` is the main colour, or the tint; `accent` is the second colour or undefined. */
-    draw: (s: Surface, base: string, accent: string | undefined) => string;
+    draw: (s: Surface, base: string, accent: string | undefined, colors?: readonly [string, string, string]) => string;
     /** Where the ball's centre is in the 100 by 100 box (50, 50 by default): a hammer's head sits in a corner to leave room for the wire. */
     centre?: readonly [number, number];
     /** Where the ball is in space, in units of its radius from the middle of the whole (0, 0, 0 by default), turned with it: a hammer's head is at one end of the hammer, which turns about its middle. */

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

@@ -183,6 +183,14 @@ function surfaceOf(g, line, minWidth) {
                 return "";
             return `<path d="${d}" fill="${line ? INK : fill}"${o?.opacity === undefined ? "" : ` opacity="${o.opacity}"`}/>`;
         },
+        panels(rings, fill, o) {
+            if (line && o?.ink !== true)
+                return "";
+            const d = rings.map((ring) => ringPath(g, sampleRing(ring, o?.n ?? 4))).join("");
+            if (d === "")
+                return "";
+            return `<path d="${d}" fill="${line ? INK : fill}"${o?.opacity === undefined ? "" : ` opacity="${o.opacity}"`}/>`;
+        },
         stroke: (pts, colour, width, o) => s.strokes([pts], colour, width, o),
         strokes(curves, colour, width, o) {
             if (line && (o?.deco === true || o?.ink === false))
@@ -291,9 +299,9 @@ export function drawBall(title, key, spec, opts, turn, turning) {
     const minWidth = 80 / opts.size;
     const base = opts.tint ?? spec.base;
     const surface = surfaceOf(g, line, minWidth);
-    const layers = spec.draw(surface, base, opts.accent);
+    const layers = spec.draw(surface, base, opts.accent, opts.colors);
     const sil = silhouette(g);
-    const id = `k${hashOf(`${key}|${opts.style}|${opts.tint ?? ""}|${opts.accent ?? ""}|${sil.tag}${sil.d}`)}`;
+    const id = `k${hashOf(`${key}|${opts.style}|${opts.tint ?? ""}|${opts.accent ?? ""}${opts.colors === undefined ? "" : `|${opts.colors.join("")}`}|${sil.tag}${sil.d}`)}`;
     // 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.face.d.ts

@@ -1,11 +1,18 @@
 /** The designs a face starts from. */
 export type PuckDesign = "canada" | "canada-red" | "canada-white" | "usa" | "usa-navy" | "player" | "souvenir";
-/** What the renderer a caller supplies for a flag is asked: the code, the shape (`"4:3"`, `"1:1"` or `"round"`, the shapes hata draws), a size in pixels and the theme. It returns an SVG document. */
-export type FlagRenderer = (code: string, options: {
-    shape: "4:3" | "1:1" | "round";
+/** How a flag is framed: `round` in a circle, `square`, or `rect` in its own proportions (the puck asks for `rect`). */
+export type FlagShape = "round" | "square" | "rect";
+/** What a drawing asks a `flags` renderer for: the shape, a width and height in pixels, and the look (`inherit` for a page whose ink is its own). */
+export interface FlagRequest {
+    shape: FlagShape;
     size: number;
-    theme: "light" | "dark" | "auto" | "inherit";
-}) => string;
+    theme: "inherit" | "light" | "dark";
+}
+/**
+ * A function from a country code and a request to an SVG string, or `null` or `undefined` for a code it has no flag for: the same renderer taisen-brackets and kyogijo take, so one adapter over hata serves them
+ * all. It must be synchronous (a drawing is a pure function of its options): hata's `flag()` is asynchronous, so load the flags first and pass `(code) => loaded[code]`. Pass it as the `flags` option of the call.
+ */
+export type FlagRenderer = (code: string, request: FlagRequest) => string | null | undefined;
 /** The colours of a face, by name. The array form is the same list in this order: field, ring, ink, accent, signature. */
 export interface FaceColors {
     /** The disc's own colour. */
@@ -28,10 +35,8 @@ export interface PuckFace {
     design?: PuckDesign;
     /** Any SVG: a logo, a crest, a drawing. Made safe first (see `safeImage`): shapes, gradients and clip paths only. It is fitted into the middle of the face and replaces the design's own picture. */
     image?: string;
-    /** A country code (`"ca"` and `"us"` are drawn by this package; another needs `flags`). It replaces the design's own picture. */
+    /** A country code (`"ca"` and `"us"` are drawn by this package; another needs the `flags` option of the call). It replaces the design's own picture. */
     flag?: string;
-    /** A renderer for the flag codes this package does not draw: `(code, { shape, size, theme }) => svg`, the shape of the function hata exports. */
-    flags?: FlagRenderer;
     /** The id of a dougu emblem (`"trophy:cup"`, `"sport:nhl"`), drawn small in the middle. Resolved by `renderEmblem`, `emblemFrame` and `ballFrame`. */
     emblem?: string;
     /** The words under the picture (`"CANADA"`), one line. */
@@ -48,7 +53,7 @@ export interface PuckFace {
     colors?: FaceColors | readonly (string | undefined)[];
 }
 /** The face of a design, in the face's units (a disc of radius 1, up is up): its definitions and its drawing. `prefix` makes every id unique to this puck. */
-export declare function faceMarkup(face: PuckFace | undefined, design: PuckDesign, own: PuckFace | undefined, prefix: string): {
+export declare function faceMarkup(face: PuckFace | undefined, design: PuckDesign, own: PuckFace | undefined, prefix: string, flags?: FlagRenderer, theme?: FlagRequest["theme"]): {
     defs: string;
     body: string;
 };