@johnmorrisdotca/dougu-sports 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -6,6 +6,56 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-10-14
+
+Eleven balls and implements drawn to the rulebook's proportions, flat emblems turning with the hand, and the gallery as one page per language.
+
+### Fixed
+
+- **Eleven balls and implements were drawn out of proportion to the rulebook, the puck by half.** The puck was drawn 1 : 6 (thickness to diameter) where IIHF Rule 13 makes it 1 : 3, because the half thickness was divided by two twice; the curling stone's body was 0.200 of its diameter where the rules (a 914 mm circumference, a height of at least 114 mm) make it 0.392, and its handle now stands on the taller body; the feather shuttlecocks' feathers were 50 mm long where the Law gives 62 to 70 mm (now 66 mm); the discus was 2.2% too thin; the American, Canadian and IFAF footballs were 9% too slim and the rugby ball 6% too slim, with their outlines 4 to 7% too short; the Australian football was 12% too fat. The footballs and the rugby ball now take their width from the girth (the circumference over pi) and their `point` from the long girth, and the Australian football is an ellipsoid of its two girths. Nothing in the `size` metadata changed. A new test, `test/proportions.test.ts`, draws every ball and implement edge-on, measures the drawing itself (not the constants it was made from) and holds its ratio, size and, for the pointed balls, outline to the figures in `size` within 2%; it also checks that only a ball or an implement claims a real size, and that `lineup` at the true scale gives every piece the same pixels per millimetre. The ball contact sheets in `docs/pieces` are redrawn.
+
+- **A flat thing turned the other way from a ball and a cup.** A ball rolls and a cup slides its light so that a positive yaw carries the front toward the right (and a drag to the right, or the Right arrow, is a positive yaw), but the coin turn of a medal, a crest, a pictogram, a piece of gear and a pennant showed its rim on the right, as if the front went left, so that dragging a medal to the right turned it against the hand. The rim is now on the left for a positive yaw (and on the right for a negative one), the edge that comes toward the eye, in the still and the line style alike. Only the side of the rim changes: the squeeze, the back and every angle are as before, `yaw` and `setAngles` mean the same, and `bindTurn` keeps its signs (right is more yaw, up is more pitch). A unit test holds the rim's side for every flat emblem and the ball's roll, and the demo's tests drag a ball, a cup and a medal to the right and measure which way each goes.
+
+### Changed
+
+- **The gallery is two pages, one language each.** `docs/gallery.md` (English) and `docs/gallery.ja.md` (日本語) are both written by `scripts/make-gallery.mjs`, linked to each other at the top, with the columns Id, name, kind, source and description. The Constant and Import columns are gone (the long paths made GitHub squeeze the Japanese column to one character wide, so the names stacked): each page states once that the constant is the id in capitals (`trophy:lidded-cup` becomes `TROPHY_LIDDED_CUP`) and that it is imported from `@johnmorrisdotca/dougu-sports/trophy/lidded-cup`, and the generator stops if the rule fails for any emblem. `pnpm test:readme` checks both pages and accepts the rule as naming each emblem's constant.
+
+## [0.2.0] - 2026-10-14
+
+The package is now 167 emblems (24 trophies, 5 awards, 6 medals, 4 crests, 38 sports, 47 balls, 42 gear and a pennant) and every one is its own drawing: the copied art and its licences are gone, the five Japanese sports and budo (sumo, kendo, judo, kyudo, karate) are in, text can be engraved on medals, plaques, cups, a ring, a banner and a pennant, every emblem turns through one coin-flip turn, and there are labels in two languages, data addresses, sprites, a podium, an award case, `sportEquipment` for all 38 sports and `bindTurn` to turn an emblem with a drag, the keys or a clock.
+
+### Added
+
+- **Japanese sports and budō** ([docs/japanese-sports.md](docs/japanese-sports.md)), all original drawings with generic ids and no real trophy's name: `trophy:sumo-cup` (a tall silver cup on a tall stepped stand with phoenix-crested handles, a body of revolution), `trophy:championship-banner` (a fringed banner on a pole with a gilt finial and an embroidered border, no lettering unless `initials` gives up to three letters; `tint` is the cloth, `accent` the trim), and the gear `gear:gunbai` (the referee's war fan with its tassel), `gear:mawashi`, `gear:shinai`, `gear:kendo-men`, `gear:judogi`, `gear:obi` (with `OBI_RANKS`, white to black, and `obi(rank, options)`), `gear:yumi`, `gear:ya` and `gear:karate-gi`. Five sports are added to `SPORT_NAMES` (now 38) with a pictogram each: `sumo`, `kendo`, `judo`, `kyudo`, `karate`. `JAPANESE_IDS` lists the 16 together, and the gallery page shows them in a section of their own. 
+- **Japanese names are first-class**, read by a reviewer and using the governing bodies' words (柔道衣, 空手衣, 廻し, 軍配, 竹刀, 剣道の面, 優勝旗, 弓, 矢); `emblemInfo(id).description` and `EMBLEM_DESCRIPTIONS` hold a longer description in English and Japanese for the docs and the gallery.
+- Gear has the `color` style (flat fills) as well as `metal` and `line`, and a part can be shaded across its width (`cyl`) as a round shaft is.
+- **Labels.** `EmblemOptions` takes `locale` (`"en"` or `"ja"`: the `<title>` is the emblem's Japanese name, with `lang="ja"` on the drawing) and `title` (a string is written, escaped; `false` drops the `<title>` and marks the drawing `aria-hidden="true"`). Both work for every emblem in every style, still and turned, and in `crest()` and `medal()`.
+- **`emblemDataUri(ref, options)`**: a percent-encoded `data:image/svg+xml;utf8,…` address for an `<img>`, a CSS background or a canvas, with `currentColor` made a concrete colour (`color` for the line, else the theme's ink; the default is dark ink), and a browser test that loads it in an `<img>` and on a canvas.
+- **`emblemSprite(ids, options)`**: one hidden `<svg>` of `<symbol>`s with the definitions shared and every id unique across the sheet, and `use(id, { size, class, title })` for the markup of each use. Sixty-four soccer balls are 2,304 nodes and 530 kB inline and 228 nodes and 15 kB from a sheet; sixty-four medals 1,792 nodes and 115 kB against 220 and 8.7 kB.
+- **`sportEquipment(sport)`**: `{ sport, ball?, gear[], trophy, medal? }` for each of the 38 sports (the five Japanese ones with their gear and `trophy:sumo-cup`), typed, with every id an id of the registry, and a test that every id exists and every sport is covered.
+- **`podium(places, options)`** and **`awardCase(items, options)`**: a podium of first, second and third on tiered steps, with medals or trophies, names, flags (SVG markup or a URL, drawn as an inert image) and lines of text; and a team's trophies on a shelf or in a row with `×N` badges, wrapping into rows. Both are one SVG string in the page's text colour, light and dark, with `role="img"`, a title and a description, in English and Japanese.
+- **`bindTurn(element, ref, options)`** in the `./turn` entry, in a module of its own: a drag, the arrow keys, Home and Space turn an emblem drawn with `emblemFrame`, with `sensitivity`, `pitchRange`, `keyStep` and `onTurn`; a controller with `angles`, `setAngles`, `update` and `destroy`. An emblem that cannot turn (read from the registry's frames, or one that says `turnable: false`) is drawn as it is; every emblem of the package turns, so only a custom one is. An auto-turn (`autoPlay`, `speed`, `pauseOnInteract`, `onPlayChange`, `play`, `pause`, `togglePlay`, `playing`) runs on `requestAnimationFrame` with a clamped time step, stops while the page is hidden, and only starts when asked: under `prefers-reduced-motion` `autoPlay: true` starts paused unless it is `"force"`.
+- The demo's playground turns its emblem with `bindTurn`, synced with the yaw, tilt and roll sliders, with an auto-turn button and speed choice and a hint in English and Japanese, and has a trophy case of turnable emblems; a new compose page draws the podium, the award case, a sprite sheet, a data address and a sport's equipment, each with a copy button.
+- `docs/compose.md`, a `bindTurn` section in `docs/turning.md`, README examples, and tests (`test/api.test.ts`, `test/turn-control.test.ts`, `e2e/turn.demo.mjs`, `e2e/compose.demo.mjs`).
+- **Engraving.** Text cut into a face, from `engrave` (one string, up to three lines of 24 letters, Japanese included) or `label`, `year` and `rank`, with `engraveBack` for a back: on the medals and place badges (replacing the star or the numeral), `trophy:plaque` (the words on the plate, the year on the nameplate), `trophy:belt`, `trophy:ring`, `trophy:banner`, `pennant:championship`, and the plinth of each of the 16 cups and stands that are bodies of revolution. The lines are fitted to the plate (the biggest size that fits, a space may break a line), escaped, and cut in the ink that reads at 4.5 to 1 on the metal (a tone of it, black or white; the page's ink in the line style). Turned, the text goes with its face: squeezed on a medal, hidden on its back or another text there, and set letter by letter round a plinth so that it foreshortens and goes behind the edge.
+- **`pennant()` and `pennant:championship`**: a felt championship pennant on a dowel with a stitched edge, lettered with its words and its year, in metal (felt fibres), color and line; its back is plain felt with the dowel on the other side. The new group `pennant`, and the `./pennant/*` export.
+- **`trophy:ring`** (a championship ring: a band, a wide faceted head with a gem, the team and the year on its shoulders) and **`trophy:banner`** (a rafter banner on a rod, in the tint and accent, with its words and year). With the sumo cup and the championship banner the `trophy` group has 24 emblems.
+- **Every emblem turns, through one turn.** Gear, the awards and the sport pictograms flip like a coin (`src/emblems/emblem.flip.ts`, the only turn of flat drawings: it takes any finished drawing, squeezes it by the cosine, shows it mirrored and a little darker on the back, and gives it a thin rim that is widest edge on). The Japanese gear and pictograms use it too, so there is no second turn for gear. `test/turn.test.ts` holds every id to a finite, well-formed frame at every yaw and pitch, and every flat one to a turn that differs, repeats at 360 and has a back.
+- **Two pictograms redrawn to read at 16 pixels.** `sport:sumo` is two rikishi in the shikiri crouch (the stance before the charge), belts on, facing each other on the edge of the ring (it was a war fan that read as a frying pan; the fan is `gear:gunbai`), and `sport:handball` is a hand throwing the ball, with lines of speed (it was a goal and a ball that read as basketball).
+- Options `engrave`, `label`, `year`, `rank`, `engraveBack`, `numberColor` (a pennant's lettering) and `view`; the playground has an Engrave field, and the gallery shows an engraved example, turned and from behind, for each emblem that takes one.
+
+### Changed
+
+- **No third-party art is left.** The 11 gear pieces that were copied (`gear:hockey-stick`, `field-hockey-stick`, `lacrosse-stick`, `cricket-bat`, `table-tennis-paddle`, `badminton-racket`, `tennis-racket`, `goal-net`, `football-helmet`, `goalie-mask`, `baseball-glove`; from Noto Emoji, Wikimedia Commons and game-icons.net) and the 18 Material Symbols items (`trophy:cup`, the five `award:*` and the twelve pictograms `sport:nfl`, `cfl`, `ifaf`, `nhl`, `nba`, `mlb`, `soccer`, `tennis`, `volleyball`, `cricket`, `rugby`, `handball`) are redrawn as clean vector geometry in the package's own style (metal, color and line, light and dark), and the third-party art is removed with the scripts that only served it (`scripts/fetch-material-symbols.mjs`, `scripts/dougu/fetch-gear.mjs`, `build-gear.mjs`, `svgmin.mjs`, `gear-assets.json`), `LICENSES/Apache-2.0.txt`, `LICENSES/CC-BY-3.0.txt`, `LICENSES/upstream/` and every NOTICE entry for them. `NOTICE.md` keeps the rulebook table the balls' sizes come from; `LICENSES/` holds the MIT text. The `material`, `noto`, `mdi`, `commons` and `gameicons` values of `EmblemSource` and `PieceSource` are gone (every emblem is `ours`, `generated` or `drawn`), and so is the `MaterialModel` type.
+- **Sizes.** The 11 gear pieces are 7.5 kB gzipped in the metal style and 4.4 kB as lines, from 28.2 kB and 17.0 kB (27% and 26%), and their modules 14.5 kB from 82.8 kB (4.3 kB from 29.2 kB gzipped). The 18 Material items are 8.5 kB in metal (from 7.5 kB, because they now have bevels, glints and a second colour) and 5.8 kB as lines (from 7.8 kB), and their sources 12.8 kB from 23.1 kB (3.7 kB from 6.5 kB gzipped). The built `dist` is 137 kB gzipped as a tarball, from 158 kB, with 16 emblems more.
+- **Every emblem has a short accessible name** (the `<title>`): English 26 characters at most and Japanese 12 or a little over where the established word is longer (`ダブルイエロー`, `バスケットボールのトロフィー`); the longer text moved to the descriptions. 41 names were shortened, among them `trophy:tennis-cup` (`Pineapple cup`), `trophy:hockey-cup`, `sport:ifaf`, the squash balls, `gear:badminton-racket`, `gear:hurley` (`ハーリングのスティック`). Football in Japanese is `アメフト…` for American football and bare `ホッケー` means field hockey (ice hockey is always `アイスホッケー`).
+- **Gaelic football is spelled `ゲーリックフットボール`** on both `sport:gaelic` and `ball:gaelic-football` (the pictogram had a middle dot).
+- The rugby, volleyball, baseball, basketball, soccer, tennis, cricket and handball pictograms now show the equipment, with a grey sheet in the metal style like the other pictograms, instead of a solid glyph.
+- `playwright.config.mjs` takes `TEST_PORT` (default 7201), so a worktree can test on its own port.
+- The demo's playground keeps the turn when the emblem, style, tint or look changes, instead of putting the emblem back at rest.
+- The playground and the gallery turn every emblem (the gear and the icons had no turn controls).
+- Item sizes grew with the new code (gzipped, one item bundled by itself): a medal 3.2 to 4.5 kB, a flat emblem 3.0 to 4.3 kB, a cup 5.6 to 6.9 kB, a pictogram or an award 1.8 to 3.7 kB (the sumo and handball outlines 4.1 and 3.8 kB), a piece of gear 2.6 to 3.7 kB, the pennant 3.3 kB; the limits in `test/size.test.ts` are 4.6, 7.1 and 4.3 kB for a flat emblem, a cup and an icon. The engraving code is left out of a bundle that does not draw a medal, a plaque or a cup, and the turn code is the only addition to an icon's.
+
 ## [0.1.0] - 2026-10-14
 
 The art arrives: 148 emblems (the trophies, awards, medals, crests, the pictogram of each of the 33 sports, the balls and the gear), moved here from Kyogijo Stadiums and, for the trophies, medals and crests, redrawn.
@@ -39,6 +89,8 @@ 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.1.0...HEAD
+[Unreleased]: https://github.com/johnmorrisdotca/dougu-sports/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/johnmorrisdotca/dougu-sports/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/johnmorrisdotca/dougu-sports/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/johnmorrisdotca/dougu-sports/compare/v0.0.1...v0.1.0
 [0.0.1]: https://github.com/johnmorrisdotca/dougu-sports/releases/tag/v0.0.1

package/NOTICE.md

@@ -1,68 +1,19 @@
 # Notice: where the art comes from
 
-The code of this package is under the MIT licence (see [LICENSE](LICENSE) and [LICENSES/MIT.txt](LICENSES/MIT.txt)). Every emblem is either drawn for this package (`source: "ours"`, `"generated"` or `"drawn"` in `emblemInfo`) or made from one of the sources below, and each emblem made from a source has a row in the second table. The licence text of each source is in [LICENSES/](LICENSES/).
+The code of this package is under the MIT licence (see [LICENSE](LICENSE) and [LICENSES/MIT.txt](LICENSES/MIT.txt)). **Every emblem is drawn for this package** (`source: "ours"`, `"generated"` or `"drawn"` in `emblemInfo`) or made by its own code, and so is under the same MIT licence. Nothing is copied from another project: no icon set, no emoji font, no clip art and no photograph is in the package, so there is no third-party licence to carry and none is shipped (`LICENSES/` holds the MIT text and nothing else).
 
-No emblem carries the name, mark or logo of a league, a team, a federation or an event: the trophies, crests and balls are descriptive and generic.
+No emblem carries the name, mark or logo of a league, a team, a federation or an event: the trophies, crests, balls and gear are descriptive and generic. That includes the Japanese items (`trophy:sumo-cup`, `trophy:championship-banner` and the `gear:*` of sumo, kendo, judo, kyudo and karate): they are original drawings of what such an object looks like, with generic ids, and carry no trophy's name, no federation's mark and no lettering unless the caller gives some.
 
-## The sources the art may come from
+## How the art is made
 
-| Source | What it is | Licence | Text kept in | Credit it asks for |
-| --- | --- | --- | --- | --- |
-| Material Symbols, Google (https://fonts.google.com/icons) | Icons as paths | Apache License 2.0 | [LICENSES/Apache-2.0.txt](LICENSES/Apache-2.0.txt) | None required; named here |
-| Noto Emoji and Noto Color Emoji, Google (https://github.com/googlefonts/noto-emoji) | Emoji drawings | Apache License 2.0 (the emoji; the fonts are under the SIL OFL 1.1, and none is used) | [LICENSES/Apache-2.0.txt](LICENSES/Apache-2.0.txt) | None required; named here |
-| Material Design Icons, Pictogrammers (https://pictogrammers.com/library/mdi/) | Icons as paths | Apache License 2.0 | [LICENSES/Apache-2.0.txt](LICENSES/Apache-2.0.txt) | None required; named here |
-| game-icons.net (https://game-icons.net/) | Icons by many authors | Creative Commons Attribution 3.0 | [LICENSES/CC-BY-3.0.txt](LICENSES/CC-BY-3.0.txt) | The author of each icon, with a link to the licence, and a note that it was changed |
-| Drawn for this package | Everything marked `ours` | MIT | [LICENSES/MIT.txt](LICENSES/MIT.txt) | None |
+- 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 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.
 
-## The emblems made from a source
+## The balls' sizes
 
-Sixteen emblems are Material Symbols (Google, Apache License 2.0), fetched at a pinned commit by `scripts/fetch-material-symbols.mjs` (`src/emblems/emblem.material.data.ts` is its output) and not changed, except that the metal style paints the filled symbol with a gradient and a darker edge, and the line style draws the outlined symbol. The package has no runtime dependency on them. Copyright Google LLC; the licence text is [LICENSES/Apache-2.0.txt](LICENSES/Apache-2.0.txt).
-
-| Emblem | Made from | Author | How it was changed | Licence |
-| --- | --- | --- | --- | --- |
-| `trophy:cup` | Material Symbols `emoji_events` | Google | Painted by the metal style | Apache-2.0 |
-| `award:medal` | Material Symbols `military_tech` | Google | Painted by the metal style | Apache-2.0 |
-| `award:badge` | Material Symbols `workspace_premium` | Google | Painted by the metal style | Apache-2.0 |
-| `award:crown` | Material Symbols `crown` | Google | Painted by the metal style | Apache-2.0 |
-| `award:star` | Material Symbols `star` | Google | Painted by the metal style | Apache-2.0 |
-| `award:shield` | Material Symbols `shield` | Google | Painted by the metal style | Apache-2.0 |
-| `sport:nfl`, `sport:cfl`, `sport:ifaf` | Material Symbols `sports_football` | Google | Drawn in the page's ink | Apache-2.0 |
-| `sport:nhl` | Material Symbols `sports_hockey` | Google | Drawn in the page's ink | Apache-2.0 |
-| `sport:nba` | Material Symbols `sports_basketball` | Google | Drawn in the page's ink | Apache-2.0 |
-| `sport:mlb` | Material Symbols `sports_baseball` | Google | Drawn in the page's ink | Apache-2.0 |
-| `sport:soccer` | Material Symbols `sports_soccer` | Google | Drawn in the page's ink | Apache-2.0 |
-| `sport:tennis` | Material Symbols `sports_tennis` | Google | Drawn in the page's ink | Apache-2.0 |
-| `sport:volleyball` | Material Symbols `sports_volleyball` | Google | Drawn in the page's ink | Apache-2.0 |
-| `sport:cricket` | Material Symbols `sports_cricket` | Google | Drawn in the page's ink | Apache-2.0 |
-| `sport:rugby` | Material Symbols `sports_rugby` | Google | Drawn in the page's ink | Apache-2.0 |
-| `sport:handball` | Material Symbols `sports_handball` | Google | Drawn in the page's ink | Apache-2.0 |
-
-The other trophies, the medals, the place badges, the crests, the other sport pictograms and every ball are drawn for this package, under its MIT licence. The trophies 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 and the gear
-
-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). No picture is copied for them. The sizes they carry (`size` on each ball: the diameter or length, the circumference and the mass, with the rule they come from) are facts read from the rulebooks listed below; no text, table or drawing of a rulebook is copied.
-
-Some of the gear (`src/emblems/gear/`) is drawn by us (22 pieces: rackets, sticks, skates, the athletics and pool gear, the nets and posts: `source: "drawn"`). The rest is copied, with changes, from the open artwork below, each module naming its source, its pinned version and the SHA-256 of the file as published in its header, and each drawing carrying its credit in a `<desc>`. The changes are the ones the Apache-2.0 licence asks to have marked: the editors' wrappers and metadata removed, the coordinates written absolute and rounded, the ids renamed; for the glove, the black background square left out and the shape filled with leather and shaded; for the goalie mask, a pale face laid under the ink. `scripts/dougu/fetch-gear.mjs` fetches the files again from the pinned versions and checks their hashes; `scripts/dougu/build-gear.mjs` writes the modules from them. The full licence texts are in [LICENSES/](LICENSES/): [Apache-2.0](LICENSES/Apache-2.0.txt), [MIT](LICENSES/MIT.txt) (this package) and [CC BY 3.0](LICENSES/CC-BY-3.0.txt), and each upstream's own licence file as found in [LICENSES/upstream/](LICENSES/upstream/).
-
-| Gear | Artwork | Licence | Copyright or credit, as read | Line style from |
-| --- | --- | --- | --- | --- |
-| `gear:hockey-stick` | Noto Emoji: [`2D/svg/emoji_u1f3d2.svg`](https://github.com/googlefonts/noto-emoji/blob/e20cbc2bbec1926686be9f9bee7d1d2cfa1fea0e/2D/svg/emoji_u1f3d2.svg) | Apache-2.0 | Copyright 2013 Google, Inc. All Rights Reserved. | Pictogrammers MDI `svg/hockey-sticks.svg` (Apache-2.0, icon by Google) |
-| `gear:field-hockey-stick` | Noto Emoji: [`2D/svg/emoji_u1f3d1.svg`](https://github.com/googlefonts/noto-emoji/blob/e20cbc2bbec1926686be9f9bee7d1d2cfa1fea0e/2D/svg/emoji_u1f3d1.svg) | Apache-2.0 | Copyright 2013 Google, Inc. All Rights Reserved. | Commons `Field_hockey_stick_with_ball_Pinhead_icon.svg` (CC0) |
-| `gear:lacrosse-stick` | Noto Emoji: [`2D/svg/emoji_u1f94d.svg`](https://github.com/googlefonts/noto-emoji/blob/e20cbc2bbec1926686be9f9bee7d1d2cfa1fea0e/2D/svg/emoji_u1f94d.svg) | Apache-2.0 | Copyright 2013 Google, Inc. All Rights Reserved. | worked out from the colour artwork |
-| `gear:cricket-bat` | Noto Emoji: [`2D/svg/emoji_u1f3cf.svg`](https://github.com/googlefonts/noto-emoji/blob/e20cbc2bbec1926686be9f9bee7d1d2cfa1fea0e/2D/svg/emoji_u1f3cf.svg) | Apache-2.0 | Copyright 2013 Google, Inc. All Rights Reserved. | Pictogrammers MDI `svg/cricket.svg` (Apache-2.0, icon by Google) |
-| `gear:table-tennis-paddle` | Noto Emoji: [`2D/svg/emoji_u1f3d3.svg`](https://github.com/googlefonts/noto-emoji/blob/e20cbc2bbec1926686be9f9bee7d1d2cfa1fea0e/2D/svg/emoji_u1f3d3.svg) | Apache-2.0 | Copyright 2013 Google, Inc. All Rights Reserved. | Pictogrammers MDI `svg/table-tennis.svg` (Apache-2.0, icon by Google) |
-| `gear:badminton-racket` | Noto Emoji: [`2D/svg/emoji_u1f3f8.svg`](https://github.com/googlefonts/noto-emoji/blob/e20cbc2bbec1926686be9f9bee7d1d2cfa1fea0e/2D/svg/emoji_u1f3f8.svg) | Apache-2.0 | Copyright 2013 Google, Inc. All Rights Reserved. | Pictogrammers MDI `svg/badminton.svg` (Apache-2.0, icon by Nick) |
-| `gear:tennis-racket` | Noto Emoji: [`2D/svg/emoji_u1f3be.svg`](https://github.com/googlefonts/noto-emoji/blob/e20cbc2bbec1926686be9f9bee7d1d2cfa1fea0e/2D/svg/emoji_u1f3be.svg) | Apache-2.0 | Copyright 2013 Google, Inc. All Rights Reserved. | Pictogrammers MDI `svg/tennis.svg` (Apache-2.0, icon by Google) |
-| `gear:goal-net` | Noto Emoji: [`2D/svg/emoji_u1f945.svg`](https://github.com/googlefonts/noto-emoji/blob/e20cbc2bbec1926686be9f9bee7d1d2cfa1fea0e/2D/svg/emoji_u1f945.svg) | Apache-2.0 | Copyright 2013 Google, Inc. All Rights Reserved. | worked out from the colour artwork |
-| `gear:football-helmet` | Wikimedia Commons: [`FootballHelmet.svg`](https://commons.wikimedia.org/wiki/File:FootballHelmet.svg) | CC0 | Author: Simanek / Credit: https://openclipart.org/detail/86827/football-helmet | Pictogrammers MDI `svg/football-helmet.svg` (Apache-2.0, icon by Austin Andrews) |
-| `gear:goalie-mask` | Wikimedia Commons: [`Hockey Mask (188584) - The Noun Project.svg`](https://commons.wikimedia.org/wiki/File:Hockey_Mask_(188584)_-_The_Noun_Project.svg) | CC0 | Author: Philippe Tardif / Credit: Noun Project - https://thenounproject.com/icon/188584 | worked out from the colour artwork |
-| `gear:baseball-glove` | game-icons.net: [`delapouite/baseball-glove.svg`](https://game-icons.net/1x1/delapouite/baseball-glove.html) | CC BY 3.0 | Baseball glove icon by Delapouite under CC BY 3.0 | the same artwork as ink |
-
-- **Noto Emoji** ([googlefonts/noto-emoji](https://github.com/googlefonts/noto-emoji), read at commit `e20cbc2bbec1926686be9f9bee7d1d2cfa1fea0e`): the files under `2D/svg/` only. Their licence is `2D/svg/LICENSE`, the Apache License 2.0, whose copyright line reads "Copyright 2013 Google, Inc. All Rights Reserved." The repository's root `LICENSE` is the SIL Open Font License 1.1 ("Copyright 2013 Google LLC") and governs the fonts, not these images; `2D/fonts/LICENSE` is also the OFL and has no copyright line. None of the fonts is used.
-- **Pictogrammers Material Design Icons** ([Templarian/MaterialDesign-SVG](https://github.com/Templarian/MaterialDesign-SVG), read at commit `9e04201d4557e729822fb57f62a316c3dea1d4a8`): used only for the one-path line versions. The repository's `LICENSE` is the "Pictogrammers Free License", which has no copyright line and says the icons are redistributed under the Apache License 2.0 or their respective licences; the repository's `package.json` names Austin Andrews as author and Apache-2.0 as the licence, and each icon's author is in its `meta.json` (Google, Nick, Austin Andrews). Treated as Apache-2.0, with the icon's author credited.
-- **Wikimedia Commons**: only files whose own file page says CC0 or Public domain, read on 2026-10-14 with the MediaWiki API and the page itself: `FootballHelmet.svg` (CC0, Simanek, via Openclipart), `Field hockey stick with ball Pinhead icon.svg` (CC0, Quincy Morgan and the Temaki contributors, Pinhead v12.0.0) and `Hockey Mask (188584) - The Noun Project.svg` (CC0, Philippe Tardif). The revisions are in `scripts/dougu/gear-assets.json`.
-- **game-icons.net** ([game-icons/icons](https://github.com/game-icons/icons), read at commit `82d948812bfe3f269ef8f731dcdb07b08160edc4`): "Baseball glove icon by Delapouite under CC BY 3.0" (https://delapouite.com; licence https://creativecommons.org/licenses/by/3.0/). The repository has no `LICENSE`; its `license.txt` says "Icons provided under the Creative Commons 3.0 BY or CC0 if mentioned below" and asks for a mention such as "Icons made by {author}"; the credit is in the drawing's `<desc>` and here: Icons made by Delapouite. Available on https://game-icons.net.
+The sizes the balls carry (`size` on each ball: the diameter or length, the circumference and the mass, with the rule they come from) are facts read from the rulebooks listed below; no text, table or drawing of a rulebook is copied.
 
 ### The rulebooks the balls' sizes are read from