@johnmorrisdotca/dougu-sports 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -6,6 +6,31 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-10-14
+
+Nineteen more soccer balls (26, 18, 14, 12 and 6 panels, winter orange and high-visibility yellow, futsal and beach soccer), 186 emblems in all.
+
+### Added
+
+- **Nineteen more soccer balls** ([docs/soccer-balls.md](docs/soccer-balls.md), [日本語](docs/soccer-balls.ja.md)), all in true 3D like `ball:soccer`, turning with `ballFrame`, with their seams on the sphere and every construction a generic derivation (no brand's or tournament's ball is used; the sources are in [docs/references.md](docs/references.md#soccer-balls)): `ball:soccer-26` (the rhombicuboctahedron: 8 triangles and 18 squares), `ball:soccer-18` (three strips on each face of a cube), `ball:soccer-14` (6 propellers and 8 triangles: a truncated cube whose 12 long edges are bent into S-curves), `ball:soccer-12` (the dodecahedron) and `ball:soccer-6` (thermobonded: six twisted gores with long curved seams, our own design).
+- **Winter orange and high-visibility yellow** of the classic ball and of each new construction, as ids of their own (`ball:soccer-orange`, `ball:soccer-26-yellow`... twelve in all): `tint` replaces the colour and `accent` the dark panels.
+- **Futsal and beach soccer**: `ball:futsal` (size 4, circumference 62 to 64 cm, 400 to 440 g, 0.6 to 0.9 atm, a 50 to 65 cm first bounce from 2 m: Futsal Laws of the Game 2025/26, Law 2) and `ball:beach-soccer` (size 5, 68 to 70 cm, 400 to 440 g, 0.4 to 0.6 atm: Beach Soccer Laws of the Game 2024-25, Law 2). Their rules are in `size.rule` and `size.note`, and `test/proportions.test.ts` holds every new ball to its rule's size.
+- The package is now 186 emblems, 66 of them balls and implements.
+
+## [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.
@@ -75,7 +100,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.2.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

@@ -21,7 +21,9 @@ 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` | 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` | 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: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 |

package/README.md

@@ -31,7 +31,7 @@ Trophies, medals, crests, the icon of every sport, and the ball and gear of the
 </tr>
 </table>
 
-> **Status: preview.** 167 emblems: 24 trophies, 5 awards, 6 medals, 4 crests, a pictogram for each of the 38 sports, 47 balls and implements drawn in 3D, 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.** 186 emblems: 24 trophies, 5 awards, 6 medals, 4 crests, a pictogram for each of the 38 sports, 66 balls and implements drawn in 3D, 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
 
@@ -83,7 +83,7 @@ Put the string in a page (`element.innerHTML = svg`), write it to a file, or sen
 </tr>
 </table>
 
-Every emblem, with its id in both styles and a button that copies it, is on the [gallery page](https://johnmorrisdotca.github.io/dougu-sports/gallery.html); the same list as text, with its names, kind, source and the import that takes it alone, is [docs/gallery.md](./docs/gallery.md), made from the built package. [docs/emblems.md](./docs/emblems.md) says how the art is drawn.
+Every emblem, with its id in both styles and a button that copies it, is on the [gallery page](https://johnmorrisdotca.github.io/dougu-sports/gallery.html); the same list as text, with its name, kind, source and description, is [docs/gallery.md](./docs/gallery.md) ([日本語](./docs/gallery.ja.md)), made from the built package. [docs/emblems.md](./docs/emblems.md) says how the art is drawn.
 
 ## Use it in your project
 
@@ -392,7 +392,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` | 47 balls and implements, in 3D, each with its official size: soccer, basketball, baseball, tennis, rugby, the footballs, golf, the puck, the curling stone and the rest | `src/emblems/ball/` |
+| `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/` |
 | `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/` |
 | `pennant` | A felt championship pennant on a dowel, with a stitched edge, lettered with its words and its year | `src/emblems/pennant/` |
@@ -424,7 +424,7 @@ The thirty-eight sports the ball, gear and sport emblems are made for are `SPORT
 | `emblemInfo(id)`, `emblemName(id, language?)`, `emblemModel(id)` | What an emblem is: its short names (which are its accessible names), kind and source, a longer `description` where it has one, and the data it is drawn from |
 | `EMBLEMS` | Every emblem as markup in the metal style at 64 pixels, by id |
 | `EMBLEM_TABLE` | Every emblem object, by id |
-| `TROPHY_HOCKEY_CUP`, `MEDAL_GOLD`, `CREST_SHIELD`, `SPORT_NHL`, `BALL_SOCCER`, `GEAR_HURLEY`... | Each emblem as a constant, named by its id in capitals (`trophy:hockey-cup`); [docs/gallery.md](./docs/gallery.md) lists every constant with its id and the module that takes it alone |
+| `TROPHY_HOCKEY_CUP`, `MEDAL_GOLD`, `CREST_SHIELD`, `SPORT_NHL`, `BALL_SOCCER`, `GEAR_HURLEY`... | Each emblem as a constant, named by its id in capitals (`trophy:hockey-cup`); [docs/gallery.md](./docs/gallery.md) ([日本語](./docs/gallery.ja.md)) lists every emblem and states the rule for its constant and the module that takes it alone |
 | `EMBLEM_IDS`, `EMBLEM_GROUPS`, `EMBLEM_FOLDERS`, `EMBLEM_ALIASES` | Every id, the groups, the folder of each group's art, and the short names (`cup` for `trophy:cup`) |
 | `AWARD_IDS`, `TROPHY_IDS`, `MEDAL_IDS`, `CREST_IDS`, `BALL_IDS`, `GEAR_IDS`, `SPORT_IDS`, `PENNANT_IDS` | The ids of each group |
 | `MEDAL_KINDS`, `CREST_SHAPES` | The kinds of medal, and the shapes of crest |
@@ -523,7 +523,7 @@ Every emblem is drawn for this package, and nothing is copied from another proje
 ### The family
 
 <!-- family:start (made by scripts/family-readme.mjs from scripts/family-template.mjs; change those, not this) -->
-Dougu Sports is one of twenty-seven packages, each made for the same site, each at
+Dougu Sports is one of twenty-eight packages, each made for the same site, each at
 [github.com/johnmorrisdotca](https://github.com/johnmorrisdotca). The code of every one is MIT.
 
 - [Korokoro](https://github.com/johnmorrisdotca/korokoro) (コロコロ): dice, with notation, exact odds, real sounds and the dice of many games. [Demo](https://johnmorrisdotca.github.io/korokoro/).
@@ -553,8 +553,9 @@ Dougu Sports is one of twenty-seven packages, each made for the same site, each
 - [Kyogijo Stadiums](https://github.com/johnmorrisdotca/kyogijo-stadiums) (競技場): sports fields, rinks, courts and ballparks drawn to scale as SVG, with each team and the score on them. [Demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/).
 - [Taisen Brackets](https://github.com/johnmorrisdotca/taisen-brackets) (対戦): a sport-agnostic tournament bracket, drawn as SVG, from a list of ties. [Demo](https://johnmorrisdotca.github.io/taisen-brackets/).
 - [Dougu Sports](https://github.com/johnmorrisdotca/dougu-sports) (道具): sports emblems as SVG: trophies, medals, crests, and the ball and gear of every sport, with optional 3D turning. [Demo](https://johnmorrisdotca.github.io/dougu-sports/).
+- [Senshu Jerseys](https://github.com/johnmorrisdotca/senshu-jerseys) (選手): sports jerseys, sweaters, kits, caps, helmets and retired-number banners as SVG, front and back, with optional 2.5D turning. [Demo](https://johnmorrisdotca.github.io/senshu-jerseys/).
 
-**This package is Dougu Sports.** The demos of all twenty-seven share one header and footer, so each links the rest.
+**This package is Dougu Sports.** The demos of all twenty-eight share one header and footer, so each links the rest.
 <!-- family:end -->
 
 ## Development
@@ -564,7 +565,7 @@ pnpm install
 pnpm check          # lint, types, tests, the build and the packed package
 pnpm dev            # the demo on http://127.0.0.1:7200/
 pnpm test:demo      # the demo in a real browser
-pnpm test:readme    # the README's and the docs' examples, and docs/gallery.md
+pnpm test:readme    # the README's and the docs' examples, and docs/gallery.md and docs/gallery.ja.md
 pnpm screenshots    # retake the README's pictures
 ```
 
@@ -576,7 +577,7 @@ Bug reports and ideas go in the [issues](https://github.com/johnmorrisdotca/doug
 
 ## Changes
 
-See [CHANGELOG.md](./CHANGELOG.md). 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.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.afl.js

@@ -9,7 +9,8 @@ export const BALL_AFL = /* @__PURE__ */ defineBall({
     ja: "オージーボール",
     size: { extentMm: 280, lengthMm: 280, circumferenceMm: 550.0, longCircumferenceMm: 725.0, rule: "Laws of Australian Football 2026, Law 4 The Football, 4.1 Specifications", note: "The Laws give the two circumferences (720-730 mm and 545-555 mm) and no length: 280 mm is the length of an ellipse of those two girths." },
     spec: {
-        axes: [1, 0.7, 0.7],
+        // An ellipsoid of the Laws' two girths: 550 mm round the middle makes it 175 mm across, 280 mm long.
+        axes: [1, 0.6253, 0.6253],
         view: { yaw: -30, pitch: 20, roll: -25 },
         base: "#b4202b",
         mat: { gloss: 0.55, shade: "#2a0408", grain: { f: 1.0, a: 0.34 } },

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

@@ -1,3 +1,5 @@
 export declare const BALL_CURLING_STONE: import("./ball.core.ts").Piece<{
     slices: number;
+} & {
+    view: import("./ball.object.ts").ObjectView;
 }>;

package/dist/emblems/ball/ball.curlingstone.js

@@ -7,6 +7,10 @@ import { num } from "./ball.core.js";
 const GRANITE = "#8d929a";
 const POLISHED = "#4d525b";
 const HANDLE = "#d4202c";
+// The stack's y is in units of the radius, so the half height is the height of the stone (114 mm at least) over its largest diameter (291 mm, a 914 mm circumference): 0.392, and the stone runs from -H to H. The slices
+// below are where the profile changes, as a fraction of H.
+const H = 114 / 290.9;
+const y = (t) => t * H;
 export const BALL_CURLING_STONE = /* @__PURE__ */ defineObject({
     id: "ball:curling-stone",
     en: "Curling stone",
@@ -16,11 +20,11 @@ export const BALL_CURLING_STONE = /* @__PURE__ */ defineObject({
     model: { slices: 6 },
     draw: (c) => drawStack(c, {
         slices: [
-            { y0: -0.2, y1: -0.15, r: [0.74, 0.8], colour: POLISHED, outline: true },
-            { y0: -0.15, y1: -0.04, r: [0.8, 0.94], colour: GRANITE },
-            { y0: -0.04, y1: 0.08, r: 1, colour: POLISHED, outline: true },
-            { y0: 0.08, y1: 0.15, r: [1, 0.9], colour: GRANITE },
-            { y0: 0.15, y1: 0.2, r: [0.9, 0.78], colour: GRANITE, outline: true },
+            { y0: y(-1), y1: y(-0.75), r: [0.74, 0.8], colour: POLISHED, outline: true },
+            { y0: y(-0.75), y1: y(-0.2), r: [0.8, 0.94], colour: GRANITE },
+            { y0: y(-0.2), y1: y(0.4), r: 1, colour: POLISHED, outline: true },
+            { y0: y(0.4), y1: y(0.75), r: [1, 0.9], colour: GRANITE },
+            { y0: y(0.75), y1: y(1), r: [0.9, 0.78], colour: GRANITE, outline: true },
         ],
         top: "#9a9fa7",
         bottom: "#6a6f78",
@@ -30,8 +34,8 @@ export const BALL_CURLING_STONE = /* @__PURE__ */ defineObject({
         dish: { r: 0.74, colour: "#555a63" },
         extra: (ctx) => {
             // The handle: a post and a bar, a capsule in 3D (a thick line with round ends).
-            const post0 = ctx.at([0, 0.2, 0]), post1 = ctx.at([0, 0.34, 0]);
-            const a = [-0.42, 0.4, 0], b = [0.42, 0.4, 0];
+            const post0 = ctx.at([0, H, 0]), post1 = ctx.at([0, H + 0.14, 0]);
+            const a = [-0.42, H + 0.2, 0], b = [0.42, H + 0.2, 0];
             const p = ctx.at(a), q = ctx.at(b);
             const colour = ctx.opts.style === "line" ? "currentColor" : (ctx.opts.tint ?? HANDLE);
             const line = ctx.opts.style === "line";

package/dist/emblems/ball/ball.discus.js

@@ -7,7 +7,7 @@ export const BALL_DISCUS = /* @__PURE__ */ defineBall({
     ja: "円盤",
     size: { extentMm: 220, diameterMm: 220, thicknessMm: 45, massG: [2000, 2000], rule: "World Athletics Technical Rules (C2.1), Rule 34 Discus Throw - 'The discus shall conform to the following specifications'", note: "Men's discus, 219 to 221 mm across the rim and 44 to 46 mm thick at the middle; 2 kg is a minimum." },
     spec: {
-        axes: [1, 0.2, 1],
+        axes: [1, 45 / 220, 1],
         view: { yaw: 25, pitch: 52, roll: -12 },
         base: "#3b3f48",
         mat: { gloss: 0.7, shade: "#050608", grain: { f: 1.4, a: 0.12 } },

package/dist/emblems/ball/ball.football.js

@@ -14,18 +14,19 @@ const upperArc = (ring) => {
     return run;
 };
 const BROWN = "#8b4a21";
-const AXES = [1, 0.55, 0.55];
+// The shape is worked out from the rule's figures (see test/proportions.test.ts): the width over the length is the girth over pi over the length, and `point` is chosen so that the outline, tip round to tip,
+// is the long girth.
 const VIEW = { yaw: -20, pitch: 35, roll: -35 };
 const MAT = { gloss: 0.5, shade: "#2a1006", grain: { f: 0.95, a: 0.42 } };
-function football(id, en, ja, size, stripes, colour) {
+function football(id, en, ja, size, shape, stripes, colour) {
     return defineBall({
         id,
         en,
         ja,
         size,
         spec: {
-            axes: AXES,
-            point: 0.85,
+            axes: [1, shape.width, shape.width],
+            point: shape.point,
             view: VIEW,
             base: colour,
             mat: MAT,
@@ -45,7 +46,8 @@ function football(id, en, ja, size, stripes, colour) {
         },
     });
 }
+const NFL_SHAPE = { width: 0.6044, point: 0.541 };
 const SIZE = { extentMm: 282.6, lengthMm: 282.6, circumferenceMm: 536.58, longCircumferenceMm: 717.55, massG: [396.89, 425.24], rule: "NFL Rulebook, Rule 2 The Ball, Section 1 (Dimensions)" };
-export const BALL_FOOTBALL = /* @__PURE__ */ football("ball:football", "Football (NFL)", "アメフトボール（NFL）", SIZE, "none", BROWN);
-export const BALL_FOOTBALL_CFL = /* @__PURE__ */ football("ball:football-cfl", "Football (CFL)", "フットボール（CFL）", { extentMm: 282.6, lengthMm: 282.6, circumferenceMm: 536.58, longCircumferenceMm: 717.55, massG: [396.89, 425.24], rule: "CFL Official Playing Rules, Rule 1 Conduct of the Game, Section 2 The Ball" }, "ring", BROWN);
-export const BALL_FOOTBALL_IFAF = /* @__PURE__ */ football("ball:football-ifaf", "Football (IFAF)", "アメフトボール（IFAF）", { extentMm: 283.4, lengthMm: 283.4, circumferenceMm: 533.4, longCircumferenceMm: 714.38, massG: [396.89, 425.24], rule: "IFAF Football Rules and Interpretations 2026, Rule 1 (The Game, Field, Players and Equipment), Section 3 The Ball, Article 1 a-i", note: "The IFAF figures are in a diagram of the rules, read from the rendered page." }, "top", "#a8693a");
+export const BALL_FOOTBALL = /* @__PURE__ */ football("ball:football", "Football (NFL)", "アメフトボール（NFL）", SIZE, NFL_SHAPE, "none", BROWN);
+export const BALL_FOOTBALL_CFL = /* @__PURE__ */ football("ball:football-cfl", "Football (CFL)", "フットボール（CFL）", { extentMm: 282.6, lengthMm: 282.6, circumferenceMm: 536.58, longCircumferenceMm: 717.55, massG: [396.89, 425.24], rule: "CFL Official Playing Rules, Rule 1 Conduct of the Game, Section 2 The Ball" }, NFL_SHAPE, "ring", BROWN);
+export const BALL_FOOTBALL_IFAF = /* @__PURE__ */ football("ball:football-ifaf", "Football (IFAF)", "アメフトボール（IFAF）", { extentMm: 283.4, lengthMm: 283.4, circumferenceMm: 533.4, longCircumferenceMm: 714.38, massG: [396.89, 425.24], rule: "IFAF Football Rules and Interpretations 2026, Rule 1 (The Game, Field, Players and Equipment), Section 3 The Ball, Article 1 a-i", note: "The IFAF figures are in a diagram of the rules, read from the rendered page." }, { width: 0.599, point: 0.567 }, "top", "#a8693a");

package/dist/emblems/ball/ball.index.js

@@ -23,6 +23,8 @@ import { BALL_SHUTTLECOCK_FEATHER, BALL_SHUTTLECOCK_NYLON } from "./ball.shuttle
 import { BALL_SLIOTAR } from "./ball.sliotar.js";
 import { BALL_LACROSSE, BALL_RACQUETBALL, BALL_TABLE_TENNIS, BALL_SHOT } from "./ball.smooth.js";
 import { BALL_SOCCER, BALL_SOCCER_COLOUR } from "./ball.soccer.js";
+import { 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 } from "./ball.soccer.panels.js";
+import { BALL_FUTSAL, BALL_BEACH_SOCCER } from "./ball.soccer.indoor.js";
 import { BALL_SOFTBALL } from "./ball.softball.js";
 import { BALL_SQUASH_DOUBLE_YELLOW, BALL_SQUASH_YELLOW, BALL_SQUASH_RED, BALL_SQUASH_BLUE, BALL_SQUASH_GREEN } from "./ball.squash.js";
 import { BALL_TENNIS } from "./ball.tennis.js";
@@ -30,7 +32,7 @@ import { BALL_TEQBALL } from "./ball.teqball.js";
 import { BALL_VOLLEYBALL, BALL_VOLLEYBALL_8, BALL_BEACH_VOLLEYBALL } from "./ball.volleyball.js";
 import { BALL_WATER_POLO } from "./ball.waterpolo.js";
 /** Every ball, in the order a gallery shows them. */
-export const BALLS = [BALL_SOCCER, BALL_SOCCER_COLOUR, BALL_TEQBALL, BALL_BASKETBALL, BALL_BASKETBALL_6, BALL_BASKETBALL_3X3, BALL_BASEBALL, BALL_SOFTBALL, BALL_TENNIS, BALL_PADEL, BALL_SLIOTAR, BALL_VOLLEYBALL, BALL_VOLLEYBALL_8, BALL_BEACH_VOLLEYBALL, BALL_CRICKET_RED, BALL_CRICKET_WHITE, BALL_CRICKET_PINK, BALL_FOOTBALL, BALL_FOOTBALL_CFL, BALL_FOOTBALL_IFAF, BALL_RUGBY, BALL_AFL, BALL_GAELIC_FOOTBALL, BALL_NETBALL, BALL_PICKLEBALL_OUTDOOR, BALL_PICKLEBALL_INDOOR, BALL_SQUASH_DOUBLE_YELLOW, BALL_SQUASH_YELLOW, BALL_SQUASH_GREEN, BALL_SQUASH_RED, BALL_SQUASH_BLUE, BALL_RACQUETBALL, BALL_LACROSSE, BALL_FIELD_HOCKEY, BALL_TABLE_TENNIS, BALL_HANDBALL, BALL_WATER_POLO, BALL_GOLF, BALL_PUCK, BALL_CURLING_STONE, BALL_SHOT, BALL_DISCUS, BALL_HAMMER, BALL_SEPAK_TAKRAW, BALL_ROUNDNET, BALL_SHUTTLECOCK_FEATHER, BALL_SHUTTLECOCK_NYLON];
+export const BALLS = [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_FUTSAL, BALL_BEACH_SOCCER, BALL_TEQBALL, BALL_BASKETBALL, BALL_BASKETBALL_6, BALL_BASKETBALL_3X3, BALL_BASEBALL, BALL_SOFTBALL, BALL_TENNIS, BALL_PADEL, BALL_SLIOTAR, BALL_VOLLEYBALL, BALL_VOLLEYBALL_8, BALL_BEACH_VOLLEYBALL, BALL_CRICKET_RED, BALL_CRICKET_WHITE, BALL_CRICKET_PINK, BALL_FOOTBALL, BALL_FOOTBALL_CFL, BALL_FOOTBALL_IFAF, BALL_RUGBY, BALL_AFL, BALL_GAELIC_FOOTBALL, BALL_NETBALL, BALL_PICKLEBALL_OUTDOOR, BALL_PICKLEBALL_INDOOR, BALL_SQUASH_DOUBLE_YELLOW, BALL_SQUASH_YELLOW, BALL_SQUASH_GREEN, BALL_SQUASH_RED, BALL_SQUASH_BLUE, BALL_RACQUETBALL, BALL_LACROSSE, BALL_FIELD_HOCKEY, BALL_TABLE_TENNIS, BALL_HANDBALL, BALL_WATER_POLO, BALL_GOLF, BALL_PUCK, BALL_CURLING_STONE, BALL_SHOT, BALL_DISCUS, BALL_HAMMER, BALL_SEPAK_TAKRAW, BALL_ROUNDNET, BALL_SHUTTLECOCK_FEATHER, BALL_SHUTTLECOCK_NYLON];
 /** The id of every ball: `"ball:soccer"`, `"ball:cricket-red"`. */
 export const BALL_IDS = BALLS.map((b) => b.id);
 const TABLE = new Map(BALLS.map((b) => [b.id, b]));

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

@@ -18,7 +18,7 @@ export interface ObjectContext {
     /** 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. */
     at(p: V3): [number, number, number];
 }
-export interface ObjectDef<Model> {
+export interface ObjectDef<Model extends object> {
     id: string;
     en: string;
     ja: string;
@@ -35,4 +35,7 @@ export interface ObjectDef<Model> {
         body: string;
     };
 }
-export declare function defineObject<Model>(def: ObjectDef<Model>): Piece<Model>;
+/** An object as a piece. Its `model` is the def's model with the default `view` added, so that a view of it (or a test) can turn it to any aspect from there. */
+export declare function defineObject<Model extends object>(def: ObjectDef<Model>): Piece<Model & {
+    view: ObjectView;
+}>;

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

@@ -2,6 +2,7 @@
 import { escape, hashOf, labelled, radians, resolveOptions, wrapPiece } from "./ball.core.js";
 import { apply, rotation } from "./ball.math.js";
 const finite = (v) => (typeof v === "number" && Number.isFinite(v) ? v : 0);
+/** An object as a piece. Its `model` is the def's model with the default `view` added, so that a view of it (or a test) can turn it to any aspect from there. */
 export function defineObject(def) {
     const render = (o, turning) => {
         const opts = resolveOptions(o);
@@ -16,5 +17,5 @@ export function defineObject(def) {
         const { defs, body } = def.draw({ rot, opts, turning, id, 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, size: def.size, svg: labelled(def.en, def.ja, (o) => render(o, false)), frame: labelled(def.en, def.ja, (o) => render(o, true)) };
+    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.d.ts

@@ -1,3 +1,5 @@
 export declare const BALL_PUCK: import("./ball.core.ts").Piece<{
     slices: number;
+} & {
+    view: import("./ball.object.ts").ObjectView;
 }>;

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

@@ -1,7 +1,7 @@
-// Ice hockey puck: vulcanised black rubber, 76.2 mm across and 25.4 mm thick (so 1 : 3), with a ridged edge. Drawn as a cylinder in true 3D, so it turns.
+// Ice hockey puck: vulcanised black rubber, 76.2 mm across and 25.4 mm thick (so 1 : 3), with a ridged edge. Drawn as a cylinder in true 3D, so it turns. The stack's y is in units of the radius, so the half thickness is 12.7 / 38.1, one third.
 import { drawStack } from "./ball.stack.js";
 import { defineObject } from "./ball.object.js";
-const H = 25.4 / 76.2 / 2;
+const H = 25.4 / 76.2;
 export const BALL_PUCK = /* @__PURE__ */ defineObject({
     id: "ball:puck",
     en: "Hockey puck",

package/dist/emblems/ball/ball.rugby.js

@@ -13,8 +13,9 @@ export const BALL_RUGBY = /* @__PURE__ */ defineBall({
     ja: "ラグビーボール",
     size: { extentMm: 290.0, lengthMm: 290.0, circumferenceMm: 600.0, longCircumferenceMm: 755.0, massG: [410, 460], rule: "World Rugby Laws of the Game (Rugby Union), Law 2 The ball, clauses 1-7" },
     spec: {
-        axes: [1, 0.62, 0.62],
-        point: 0.72,
+        // Worked out from the Laws' 600 mm girth, 290 mm length and 755 mm long girth.
+        axes: [1, 0.6586, 0.6586],
+        point: 0.561,
         view: { yaw: -30, pitch: 20, roll: -30 },
         base: "#1f4e9c",
         ground: WHITE,

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

@@ -1,6 +1,10 @@
 export declare const BALL_SHUTTLECOCK_FEATHER: import("./ball.core.ts").Piece<{
     feathers: number;
+} & {
+    view: import("./ball.object.ts").ObjectView;
 }>;
 export declare const BALL_SHUTTLECOCK_NYLON: import("./ball.core.ts").Piece<{
     feathers: number;
+} & {
+    view: import("./ball.object.ts").ObjectView;
 }>;

package/dist/emblems/ball/ball.shuttlecock.js

@@ -4,12 +4,13 @@ import { defineObject } from "./ball.object.js";
 import {} from "./ball.math.js";
 import { blend, mix, num } from "./ball.core.js";
 const FEATHERS = 16;
-// One unit is 32 mm: the skirt is 2 units across at the top, the base 0.84 across and the whole 2.06 long.
+// One unit is 32 mm (the scale below makes 92 box units 150 mm): the skirt is 2 units across at the tips (63 mm), the base 0.84 across (27 mm) and the feathers 2.05 long from the tips to the top of the base
+// (66 mm; the Law measures a feather's length that way, 62 to 70 mm).
 const ROOT_R = 0.42;
 const TIP_R = 1;
-const ROOT_Y = -0.56;
+const ROOT_Y = -1.05;
 const TIP_Y = 1.0;
-const SLOPE = 0.4;
+const SLOPE = 0.56;
 const drawShuttle = (c, p) => {
     const line = c.opts.style === "line";
     const tip = (a, r, y, k = 0) => [Math.cos(a) * r, y, Math.sin(a) * r + k];

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

@@ -0,0 +1,2 @@
+export declare const BALL_FUTSAL: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;
+export declare const BALL_BEACH_SOCCER: import("./ball.core.ts").Piece<import("./ball.engine.ts").BallSpec>;

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

@@ -0,0 +1,58 @@
+// The soccer balls of the other two games the Laws of the Game cover: futsal (size 4, a low-bouncing ball, often brighter than the outdoor one) and beach soccer (size 5, softer, often bright). Both are drawn
+// on constructions of our own (the 32-panel and the 14-panel propeller layout), in colours of our own choosing: no brand's ball, no tournament's pattern.
+import { defineBall } from "./ball.engine.js";
+import { mix } from "./ball.core.js";
+import { shrink, truncatedIcosahedron } from "./ball.polyhedra.js";
+import { LAYOUTS } from "./ball.soccer.panels.js";
+import { SOCCER_SIZE } from "./ball.soccer.size.js";
+const FUTSAL_BLUE = "#1673e6";
+export const BALL_FUTSAL = /* @__PURE__ */ defineBall({
+    id: "ball:futsal",
+    en: "Futsal ball",
+    ja: "フットサルボール",
+    size: {
+        extentMm: 200.5,
+        diameterMm: 200.5,
+        circumferenceMm: 630.0,
+        massG: [400, 440],
+        rule: "Futsal Laws of the Game 2025/26, Law 2 The Ball, section 1 Qualities and measurements",
+        note: "Size 4. Diameter worked out from the middle of the circumference range (62 to 64 cm). Pressure 0.6 to 0.9 atm (600 to 900 g/cm2) at sea level; the first rebound from a 2 m drop must be between 50 cm and 65 cm, which is what makes it a low-bounce ball. The Laws let associations change the size and weight for youth and other categories.",
+    },
+    spec: {
+        view: { yaw: 30, pitch: 24, roll: 8 },
+        base: FUTSAL_BLUE,
+        ground: "#f6f8fb",
+        mat: { gloss: 0.4, shade: "#16305a", grain: { f: 1.4, a: 0.24 } },
+        draw(s, base, accent) {
+            const t = truncatedIcosahedron();
+            let out = "";
+            for (const p of t.pentagons)
+                out += s.panel(p, base, { ink: true });
+            // A smaller pentagon of the second colour inside each one.
+            t.pentagons.forEach((p, i) => {
+                out += s.panel(shrink(p, t.pentagonCentres[i], 0.5), accent ?? "#ffd21f", { n: 2 });
+            });
+            out += s.strokes(t.edges, mix(base, -0.4), 1.1);
+            out += s.strokes(t.edges, "#fff", 0.4, { deco: true, opacity: 0.4, dx: 0.3, dy: 0.35 });
+            return out;
+        },
+    },
+});
+export const BALL_BEACH_SOCCER = /* @__PURE__ */ defineBall({
+    id: "ball:beach-soccer",
+    en: "Beach soccer ball",
+    ja: "ビーチサッカーボール",
+    size: {
+        ...SOCCER_SIZE,
+        massG: [400, 440],
+        rule: "Beach Soccer Laws of the Game 2024-25, Law 2 The Ball, section 1 Qualities and measurements",
+        note: "Size 5. Diameter worked out from the middle of the circumference range (68 to 70 cm). Pressure 0.4 to 0.6 atm (400 to 600 g/cm2) at sea level, lower than an 11-a-side ball's, so the ball is softer; the mass is 400 to 440 g, 10 g under the 11-a-side minimum.",
+    },
+    spec: {
+        view: { yaw: 16, pitch: 14, roll: 0 },
+        base: "#f5b81c",
+        ground: "#f5b81c",
+        mat: { gloss: 0.55, shade: "#4a2a10", grain: { f: 1.2, a: 0.1 } },
+        draw: (s, base, accent) => LAYOUTS[14](s, { light: base, mid: accent ?? "#f0661e", deep: "#12a8d8", dark: "#1b2a66", seam: mix(base, -0.55) }),
+    },
+});

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

@@ -4,12 +4,13 @@ import { defineBall } from "./ball.engine.js";
 import { truncatedIcosahedron } from "./ball.polyhedra.js";
 import { add, mul, norm } from "./ball.math.js";
 import { blend, mix } from "./ball.core.js";
+import { SOCCER_SIZE } from "./ball.soccer.size.js";
 const SEAM = "#6b7180";
 export const BALL_SOCCER = /* @__PURE__ */ defineBall({
     id: "ball:soccer",
     en: "Soccer ball",
     ja: "サッカーボール",
-    size: { extentMm: 219.6, diameterMm: 219.6, circumferenceMm: 690.0, massG: [410, 450], rule: "IFAB Laws of the Game, Law 2 The Ball, section 2.1 Qualities and measurements", note: "Diameter worked out from the middle of the circumference range." },
+    size: SOCCER_SIZE,
     spec: {
         view: { yaw: 30, pitch: 24, roll: 8 },
         base: "#1e2025",
@@ -30,7 +31,7 @@ export const BALL_SOCCER_COLOUR = /* @__PURE__ */ defineBall({
     id: "ball:soccer-colour",
     en: "Soccer ball, coloured",
     ja: "サッカーボール（カラー）",
-    size: { extentMm: 219.6, diameterMm: 219.6, circumferenceMm: 690.0, massG: [410, 450], rule: "IFAB Laws of the Game, Law 2 The Ball, section 2.1 Qualities and measurements", note: "Diameter worked out from the middle of the circumference range." },
+    size: SOCCER_SIZE,
     spec: {
         view: { yaw: 30, pitch: 24, roll: 8 },
         base: "#d4283c",

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

@@ -0,0 +1,38 @@
+import { type BallSpec, type Surface } from "./ball.engine.ts";
+/** The tones a construction is laid in: the light panels, the dark ones, two in between, and the seam. */
+export interface Tones {
+    light: string;
+    dark: string;
+    mid: string;
+    /** A third tone between the light and the mid one, for a third kind of panel. */
+    deep: string;
+    seam: string;
+}
+export type Layout = (s: Surface, t: Tones) => string;
+export declare const classic: Layout;
+export declare const LAYOUTS: {
+    readonly classic: Layout;
+    readonly 26: Layout;
+    readonly 18: Layout;
+    readonly 14: Layout;
+    readonly 12: Layout;
+    readonly 6: Layout;
+};
+export type Construction = keyof typeof LAYOUTS;
+export declare const BALL_SOCCER_26: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_18: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_14: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_12: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_6: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_ORANGE: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_26_ORANGE: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_18_ORANGE: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_14_ORANGE: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_12_ORANGE: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_6_ORANGE: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_YELLOW: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_26_YELLOW: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_18_YELLOW: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_14_YELLOW: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_12_YELLOW: import("./ball.core.ts").Piece<BallSpec>;
+export declare const BALL_SOCCER_6_YELLOW: import("./ball.core.ts").Piece<BallSpec>;

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

@@ -0,0 +1,169 @@
+// Soccer balls with other panel counts than the classic 32, each worked out in true 3D from a tiling of the sphere (see ball.tilings.ts): 26 panels, 18, 14, 12 and a thermobonded 6; and the same
+// constructions, with the classic one, in winter orange and in high-visibility yellow. Generic constructions only: no brand's or tournament's ball or graphics.
+import { defineBall } from "./ball.engine.js";
+import { blend, mix } from "./ball.core.js";
+import { strips18 } from "./ball.family.panelled.js";
+import { truncatedIcosahedron } from "./ball.polyhedra.js";
+import { dodecahedron, gores, propellers14, rhombicuboctahedron } from "./ball.tilings.js";
+import { SOCCER_SIZE } from "./ball.soccer.size.js";
+const INK = "#1e2025";
+const WHITE = "#f8f8f6";
+const SEAM = "#6b7180";
+/** The highlight laid on a seam, so that it reads as a raised edge. */
+const lit = (s, seams, width = 0.45) => s.strokes(seams, "#fff", width, { deco: true, opacity: 0.45, dx: 0.3, dy: 0.35 });
+export const classic = (s, t) => {
+    const g = truncatedIcosahedron();
+    let out = "";
+    for (const p of g.pentagons)
+        out += s.panel(p, t.dark, { ink: true });
+    out += s.strokes(g.edges, t.seam, 1.15);
+    return out + lit(s, g.edges);
+};
+/** 26 panels: eight triangles dark, the six squares on the cube's faces mid, the twelve on its edges light. */
+const panels26 = (s, t) => {
+    const g = rhombicuboctahedron();
+    const fill = [t.dark, t.mid, t.light];
+    let out = "";
+    g.panels.forEach((p, i) => {
+        out += s.panel(p, fill[g.kinds[i]], { n: 6, ink: g.kinds[i] === 0 });
+    });
+    out += s.strokes(g.seams, t.seam, 1.15);
+    return out + lit(s, g.seams);
+};
+/** 18 panels: three strips on each face of a cube, the strips of neighbouring faces square to each other; dark and light in turn. */
+const panels18 = (s, t) => strips18(s, [
+    [t.light, t.dark],
+    [t.dark, t.light],
+    [t.light, t.dark],
+    [t.dark, t.light],
+    [t.light, t.dark],
+    [t.dark, t.light],
+], t.seam, 1.15);
+/** 14 panels: eight triangles dark and six propellers in three tones, one for each axis of the cube (so no two that touch match). */
+const panels14 = (s, t) => {
+    const g = propellers14();
+    const tone = [t.mid, t.deep, t.light];
+    let out = "";
+    g.propellers.forEach((p, i) => {
+        out += s.panel(p, tone[g.axis[i]], { n: 1 });
+    });
+    for (const p of g.triangles)
+        out += s.panel(p, t.dark, { n: 6, ink: true });
+    out += s.strokes(g.seams, t.seam, 1.15);
+    return out + lit(s, g.seams);
+};
+/** 12 panels: a dodecahedron, its pentagons in four tones so that no two neighbours match. */
+const panels12 = (s, t) => {
+    const g = dodecahedron();
+    const fill = [t.light, t.dark, t.light, t.mid];
+    let out = "";
+    g.panels.forEach((p, i) => {
+        out += s.panel(p, fill[g.colour[i]], { n: 6, ink: g.colour[i] === 1 });
+    });
+    out += s.strokes(g.seams, t.seam, 1.15);
+    return out + lit(s, g.seams);
+};
+/** 6 panels, thermobonded: six twisted gores whose long seams run pole to pole as shallow grooves, and no stitching. */
+const panels6 = (s, t) => {
+    const g = gores(6, 180, [0, 0, 28]);
+    const tone = [t.light, t.mid, t.dark];
+    let out = "";
+    // A gore is cut across into four pieces, each filled alike and edged in its own colour so that no hairline shows between them.
+    for (const { ring, gore } of g.pieces) {
+        const fill = tone[gore % 3];
+        out += s.panel(ring, fill, { n: 1, ink: gore % 3 === 2 });
+        out += s.strokes([ring], fill, 0.5, { closed: true, deco: true });
+    }
+    out += s.strokes(g.seams, t.seam, 0.85);
+    return out + lit(s, g.seams, 0.5);
+};
+export const LAYOUTS = { classic, 26: panels26, 18: panels18, 14: panels14, 12: panels12, 6: panels6 };
+/** The black-and-white ball, winter orange (an orange that shows against snow and in low light) and high-visibility yellow, with dark panels. */
+const COLOURWAYS = {
+    white: { base: INK, accent: "#d9dde6" },
+    orange: { base: "#ff6a13", accent: INK },
+    yellow: { base: "#e8f21c", accent: INK },
+};
+const gloss = { gloss: 0.8, shade: "#2a3450", grain: { f: 1.1, a: 0.16 } };
+/** The spec of a construction in a colourway. The black-and-white ball is laid on a white ground with `base` the dark panels; a coloured one is laid on `base`, with the dark panels `accent`. */
+function specOf(construction, way, view) {
+    const layout = LAYOUTS[construction];
+    if (way === "white") {
+        return {
+            view,
+            base: INK,
+            ground: WHITE,
+            mat: construction === 6 ? { ...gloss, gloss: 0.9, grain: { f: 0.7, a: 0.07 } } : gloss,
+            draw: (s, base, accent) => layout(s, { light: WHITE, dark: base, mid: accent ?? "#dfe2ea", deep: blend(accent ?? "#dfe2ea", base, 0.12), seam: SEAM }),
+        };
+    }
+    const c = COLOURWAYS[way];
+    return {
+        view,
+        base: c.base,
+        mat: { ...(construction === 6 ? { ...gloss, gloss: 0.9, grain: { f: 0.7, a: 0.07 } } : gloss), shade: mix(c.base, -0.65) },
+        draw: (s, base, accent) => layout(s, { light: base, dark: accent ?? c.accent, mid: blend(base, "#ffffff", 0.4), deep: blend(base, "#ffffff", 0.18), seam: mix(base, -0.5) }),
+    };
+}
+/** The id, and the English and Japanese names, of each construction in each colourway (short, because the name is the accessible name: 26 characters in English and 12 in Japanese at most). */
+const NAMES = {
+    classic: {
+        white: { id: "soccer", en: "Soccer ball", ja: "サッカーボール" },
+        orange: { id: "soccer-orange", en: "Soccer ball, orange", ja: "32枚貼り・オレンジ" },
+        yellow: { id: "soccer-yellow", en: "Soccer ball, yellow", ja: "32枚貼り・蛍光イエロー" },
+    },
+    26: {
+        white: { id: "soccer-26", en: "Soccer ball, 26 panels", ja: "26枚貼りサッカーボール" },
+        orange: { id: "soccer-26-orange", en: "Soccer 26 panels, orange", ja: "26枚貼り・オレンジ" },
+        yellow: { id: "soccer-26-yellow", en: "Soccer 26 panels, yellow", ja: "26枚貼り・蛍光イエロー" },
+    },
+    18: {
+        white: { id: "soccer-18", en: "Soccer ball, 18 panels", ja: "18枚貼りサッカーボール" },
+        orange: { id: "soccer-18-orange", en: "Soccer 18 panels, orange", ja: "18枚貼り・オレンジ" },
+        yellow: { id: "soccer-18-yellow", en: "Soccer 18 panels, yellow", ja: "18枚貼り・蛍光イエロー" },
+    },
+    14: {
+        white: { id: "soccer-14", en: "Soccer ball, 14 panels", ja: "14枚貼りサッカーボール" },
+        orange: { id: "soccer-14-orange", en: "Soccer 14 panels, orange", ja: "14枚貼り・オレンジ" },
+        yellow: { id: "soccer-14-yellow", en: "Soccer 14 panels, yellow", ja: "14枚貼り・蛍光イエロー" },
+    },
+    12: {
+        white: { id: "soccer-12", en: "Soccer ball, 12 panels", ja: "12枚貼りサッカーボール" },
+        orange: { id: "soccer-12-orange", en: "Soccer 12 panels, orange", ja: "12枚貼り・オレンジ" },
+        yellow: { id: "soccer-12-yellow", en: "Soccer 12 panels, yellow", ja: "12枚貼り・蛍光イエロー" },
+    },
+    6: {
+        white: { id: "soccer-6", en: "Soccer ball, 6 panels", ja: "6枚貼りサッカーボール" },
+        orange: { id: "soccer-6-orange", en: "Soccer 6 panels, orange", ja: "6枚貼り・オレンジ" },
+        yellow: { id: "soccer-6-yellow", en: "Soccer 6 panels, yellow", ja: "6枚貼り・蛍光イエロー" },
+    },
+};
+const VIEWS = {
+    classic: { yaw: 30, pitch: 24, roll: 8 },
+    26: { yaw: 30, pitch: 24, roll: 8 },
+    18: { yaw: 28, pitch: 22, roll: 0 },
+    14: { yaw: 16, pitch: 14, roll: 0 },
+    12: { yaw: 30, pitch: 24, roll: 8 },
+    6: { yaw: 20, pitch: 22, roll: 0 },
+};
+function make(construction, way) {
+    const n = NAMES[construction][way];
+    return defineBall({ id: `ball:${n.id}`, en: n.en, ja: n.ja, size: SOCCER_SIZE, spec: specOf(construction, way, VIEWS[construction]) });
+}
+export const BALL_SOCCER_26 = /* @__PURE__ */ make(26, "white");
+export const BALL_SOCCER_18 = /* @__PURE__ */ make(18, "white");
+export const BALL_SOCCER_14 = /* @__PURE__ */ make(14, "white");
+export const BALL_SOCCER_12 = /* @__PURE__ */ make(12, "white");
+export const BALL_SOCCER_6 = /* @__PURE__ */ make(6, "white");
+export const BALL_SOCCER_ORANGE = /* @__PURE__ */ make("classic", "orange");
+export const BALL_SOCCER_26_ORANGE = /* @__PURE__ */ make(26, "orange");
+export const BALL_SOCCER_18_ORANGE = /* @__PURE__ */ make(18, "orange");
+export const BALL_SOCCER_14_ORANGE = /* @__PURE__ */ make(14, "orange");
+export const BALL_SOCCER_12_ORANGE = /* @__PURE__ */ make(12, "orange");
+export const BALL_SOCCER_6_ORANGE = /* @__PURE__ */ make(6, "orange");
+export const BALL_SOCCER_YELLOW = /* @__PURE__ */ make("classic", "yellow");
+export const BALL_SOCCER_26_YELLOW = /* @__PURE__ */ make(26, "yellow");
+export const BALL_SOCCER_18_YELLOW = /* @__PURE__ */ make(18, "yellow");
+export const BALL_SOCCER_14_YELLOW = /* @__PURE__ */ make(14, "yellow");
+export const BALL_SOCCER_12_YELLOW = /* @__PURE__ */ make(12, "yellow");
+export const BALL_SOCCER_6_YELLOW = /* @__PURE__ */ make(6, "yellow");

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

@@ -0,0 +1,2 @@
+import type { PieceSize } from "./ball.core.ts";
+export declare const SOCCER_SIZE: PieceSize;

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

@@ -0,0 +1,8 @@
+export const SOCCER_SIZE = {
+    extentMm: 219.6,
+    diameterMm: 219.6,
+    circumferenceMm: 690.0,
+    massG: [410, 450],
+    rule: "IFAB Laws of the Game, Law 2 The Ball, section 2.1 Qualities and measurements",
+    note: "Diameter worked out from the middle of the circumference range (68 to 70 cm).",
+};

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

@@ -0,0 +1,61 @@
+import { type V3 } from "./ball.math.ts";
+/** A tiling: the panels with their centres, and every edge between two panels once. */
+export interface Tiling {
+    /** Each panel as a ring of unit vectors, in order round its centre. */
+    panels: V3[][];
+    centres: V3[];
+    /** Which kind each panel is (its position in `KINDS` of the tiling). */
+    kinds: number[];
+    /** Every seam once, as a curve on the sphere. */
+    seams: V3[][];
+}
+/**
+ * The 26-panel layout: a rhombicuboctahedron. Its 24 vertices are the permutations of (+-1, +-1, +-(1 + sqrt 2)); its faces are 8 triangles (about the corners of a cube, kind 0), 6 squares about the
+ * face directions (kind 1) and 12 squares about the edge directions (kind 2).
+ */
+export declare function rhombicuboctahedron(): Tiling;
+type Dodecahedron = Tiling & {
+    colour: number[];
+};
+/**
+ * The 12-panel layout: a dodecahedron. Its 20 vertices are (+-1, +-1, +-1) and the cyclic permutations of (0, +-1/phi, +-phi); its 12 pentagons are about the directions of an icosahedron's vertices,
+ * (+-1, 0, +-phi) and its cyclic permutations. `colour` gives each pentagon one of four colours so that no two neighbours share one (the icosahedron's vertices can be coloured with four).
+ */
+export declare function dodecahedron(): Dodecahedron;
+export interface Propellers {
+    /** The eight triangles, about the corners of a cube. */
+    triangles: V3[][];
+    /** The six propellers, about the faces of a cube, as dense rings (use them with one sample per edge). */
+    propellers: V3[][];
+    /** Every seam once: the 24 straight edges of the triangles and the 12 S-curves between propellers. */
+    seams: V3[][];
+    triangleCentres: V3[];
+    propellerCentres: V3[];
+    /** The axis of the cube each propeller is on (0 for x, 1 for y, 2 for z). */
+    axis: number[];
+}
+/**
+ * The 14-panel layout: a truncated cube (vertices the permutations of (+-xi, +-1, +-1); the regular one has xi = sqrt 2 - 1, and 0.42 here makes the triangles a little larger) has 8 triangles and
+ * 6 octagons, and the octagons meet each other along 12 edges. Each of those edges is bent into an S: `lift` times its length to the side a quarter of the way along and the same the other way
+ * three quarters of the way along (eased to meet the corners gently), so the curve is the same turned half a turn about the edge's middle, and the tiling keeps the cube's rotations (and loses its
+ * mirrors, so it has a hand). The octagons then have four straight sides, against the triangles, and four S-shaped ones: propellers.
+ */
+export declare function propellers14(lift?: number, steps?: number, xi?: number, ease?: number): Propellers;
+export interface Gores {
+    /** Each panel as a ring running up one seam and down the next. */
+    panels: V3[][];
+    centres: V3[];
+    /** The seams, each from one pole to the other. */
+    seams: V3[][];
+    /** Each panel cut across into `bands` pieces, so that every piece is small enough to be drawn as a plain polygon; `gore` is the panel a piece is of. */
+    pieces: Array<{
+        ring: V3[];
+        gore: number;
+    }>;
+}
+/**
+ * Six (or `count`) gores: panels between seams that each run from one pole to the other and turn through `twist` degrees of longitude on the way, so the seams are long S-like spirals. The
+ * whole is then tilted by the rotation `tilt` (yaw, pitch and roll in degrees) so that the poles are not on the ball's spin axis.
+ */
+export declare function gores(count?: number, twist?: number, tilt?: readonly [number, number, number], steps?: number, bands?: number): Gores;
+export {};

package/dist/emblems/ball/ball.tilings.js

@@ -0,0 +1,212 @@
+// Tilings of the sphere for the soccer balls with other panel counts than the 32 of the classic one. Each is worked out here from a polyhedron or a curve, never copied from a ball: the 26 panels are the
+// faces of a rhombicuboctahedron, the 12 the faces of a dodecahedron, the 14 a truncated cube whose twelve long edges are bent into an S (so the six octagons become propellers and the eight
+// corners stay triangles), and the 6 a ring of twisted gores. Every panel is a ring of unit vectors; the edges between vertices follow the sphere (spherical interpolation), as an inflated ball's do.
+import { add, apply, arc, cross, dot, len, lonLat, mul, norm, rotation, slerp, sub } from "./ball.math.js";
+const PHI = (1 + Math.sqrt(5)) / 2;
+const signs = [-1, 1];
+/** The vertices of a solid, each normalised onto the unit sphere, with no point twice. */
+function unique(points) {
+    const out = [];
+    for (const p of points)
+        if (!out.some((q) => len(sub(p, q)) < 1e-6))
+            out.push(p);
+    return out;
+}
+/** The three coordinates in every order. */
+const orders = (a, b, c) => [[a, b, c], [a, c, b], [b, a, c], [b, c, a], [c, a, b], [c, b, a]];
+/** Every vertex of a solid on a face: the ones farthest along the face's outward direction, in order round it. */
+function ringOf(verts, centre) {
+    const top = Math.max(...verts.map((v) => dot(v, centre)));
+    const on = verts.filter((v) => dot(v, centre) > top - 1e-6);
+    const ex = norm(sub(on[0], mul(centre, dot(on[0], centre))));
+    const ey = cross(centre, ex);
+    return on.sort((p, q) => Math.atan2(dot(p, ey), dot(p, ex)) - Math.atan2(dot(q, ey), dot(q, ex)));
+}
+const keyOf = (v) => v.map((x) => Math.round(x * 1000)).join(",");
+/** The seams of a set of rings: each edge once, as an arc of `samples` steps. */
+function seamsOf(rings, samples) {
+    const seen = new Set();
+    const out = [];
+    for (const ring of rings) {
+        for (let i = 0; i < ring.length; i++) {
+            const a = ring[i], b = ring[(i + 1) % ring.length];
+            const key = [keyOf(a), keyOf(b)].sort().join("|");
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(arc(a, b, samples));
+        }
+    }
+    return out;
+}
+const tiling = (verts, centres, kinds, samples) => {
+    const panels = centres.map((c) => ringOf(verts, c));
+    return { panels, centres: [...centres], kinds: [...kinds], seams: seamsOf(panels, samples) };
+};
+let rhombi;
+/**
+ * The 26-panel layout: a rhombicuboctahedron. Its 24 vertices are the permutations of (+-1, +-1, +-(1 + sqrt 2)); its faces are 8 triangles (about the corners of a cube, kind 0), 6 squares about the
+ * face directions (kind 1) and 12 squares about the edge directions (kind 2).
+ */
+export function rhombicuboctahedron() {
+    if (rhombi !== undefined)
+        return rhombi;
+    const L = 1 + Math.SQRT2;
+    const verts = unique(signs.flatMap((a) => signs.flatMap((b) => signs.flatMap((c) => orders(a, b, c * L)))).map(norm));
+    const corners = [];
+    const faces = [];
+    const edges = [];
+    for (const a of signs)
+        for (const b of signs)
+            for (const c of signs)
+                corners.push(norm([a, b, c]));
+    for (const a of signs)
+        faces.push([a, 0, 0], [0, a, 0], [0, 0, a]);
+    for (const a of signs)
+        for (const b of signs)
+            edges.push(norm([a, b, 0]), norm([a, 0, b]), norm([0, a, b]));
+    rhombi = tiling(verts, [...corners, ...faces, ...edges], [...corners.map(() => 0), ...faces.map(() => 1), ...edges.map(() => 2)], 5);
+    return rhombi;
+}
+let dodeca;
+/**
+ * The 12-panel layout: a dodecahedron. Its 20 vertices are (+-1, +-1, +-1) and the cyclic permutations of (0, +-1/phi, +-phi); its 12 pentagons are about the directions of an icosahedron's vertices,
+ * (+-1, 0, +-phi) and its cyclic permutations. `colour` gives each pentagon one of four colours so that no two neighbours share one (the icosahedron's vertices can be coloured with four).
+ */
+export function dodecahedron() {
+    if (dodeca !== undefined)
+        return dodeca;
+    const verts = [];
+    for (const a of signs)
+        for (const b of signs)
+            for (const c of signs)
+                verts.push(norm([a, b, c]));
+    for (const a of signs)
+        for (const b of signs)
+            verts.push(norm([0, a / PHI, b * PHI]), norm([a / PHI, b * PHI, 0]), norm([b * PHI, 0, a / PHI]));
+    const centres = [];
+    for (const a of signs)
+        for (const b of signs)
+            centres.push(norm([a, 0, b * PHI]), norm([0, b * PHI, a]), norm([b * PHI, a, 0]));
+    const t = tiling(verts, centres, centres.map(() => 0), 5);
+    // Neighbours are at the icosahedron's edge angle: cos = 1/sqrt 5.
+    const next = (i, j) => Math.abs(dot(centres[i], centres[j]) - 1 / Math.sqrt(5)) < 1e-6;
+    const colour = centres.map(() => -1);
+    const paint = (i) => {
+        if (i === centres.length)
+            return true;
+        for (let c = 0; c < 4; c++) {
+            if (centres.every((_, j) => j >= i || !next(i, j) || colour[j] !== c)) {
+                colour[i] = c;
+                if (paint(i + 1))
+                    return true;
+            }
+        }
+        colour[i] = -1;
+        return false;
+    };
+    paint(0);
+    dodeca = { ...t, colour };
+    return dodeca;
+}
+/** A point of the arc from `a` to `b`, `t` of the way along it, pushed sideways (along the sphere, square to the arc) by `lift` times the chord. */
+function bent(a, b, t, lift, ease = 0) {
+    const p = slerp(a, b, t);
+    const tangent = norm(sub(b, mul(p, dot(b, p))));
+    const side = cross(p, tangent);
+    return norm(add(p, mul(side, lift * len(sub(b, a)) * Math.sin(2 * Math.PI * t) * (1 - ease + ease * Math.sin(Math.PI * t)))));
+}
+let props;
+/**
+ * The 14-panel layout: a truncated cube (vertices the permutations of (+-xi, +-1, +-1); the regular one has xi = sqrt 2 - 1, and 0.42 here makes the triangles a little larger) has 8 triangles and
+ * 6 octagons, and the octagons meet each other along 12 edges. Each of those edges is bent into an S: `lift` times its length to the side a quarter of the way along and the same the other way
+ * three quarters of the way along (eased to meet the corners gently), so the curve is the same turned half a turn about the edge's middle, and the tiling keeps the cube's rotations (and loses its
+ * mirrors, so it has a hand). The octagons then have four straight sides, against the triangles, and four S-shaped ones: propellers.
+ */
+export function propellers14(lift = 0.2, steps = 14, xi = 0.42, ease = 0.5) {
+    props ??= new Map();
+    const key = lift * 1000 + steps + xi * 1e6 + ease * 1e9;
+    const hit = props.get(key);
+    if (hit !== undefined)
+        return hit;
+    const verts = unique(signs.flatMap((a) => signs.flatMap((b) => signs.flatMap((c) => orders(a * xi, b, c)))).map(norm));
+    const cornerDirs = [];
+    for (const a of signs)
+        for (const b of signs)
+            for (const c of signs)
+                cornerDirs.push(norm([a, b, c]));
+    const faceDirs = [];
+    for (const a of signs)
+        faceDirs.push([a, 0, 0], [0, a, 0], [0, 0, a]);
+    // Two vertices that differ in one coordinate only are the ends of an edge between two octagons.
+    const raw = (v) => {
+        const m = Math.max(...v.map(Math.abs));
+        return [v[0] / m, v[1] / m, v[2] / m];
+    };
+    const betweenOctagons = (a, b) => {
+        const x = raw(a), y = raw(b);
+        return [0, 1, 2].filter((i) => Math.abs(x[i] - y[i]) > 1e-6).length === 1;
+    };
+    const triangles = cornerDirs.map((c) => ringOf(verts, c));
+    const propellers = faceDirs.map((f) => {
+        const ring = ringOf(verts, f);
+        const out = [];
+        for (let i = 0; i < ring.length; i++) {
+            const a = ring[i], b = ring[(i + 1) % ring.length];
+            if (!betweenOctagons(a, b)) {
+                out.push(...arc(a, b, 4).slice(0, 4));
+                continue;
+            }
+            // The same curve from either octagon: it is defined from the end that comes first, and walked backwards from the other.
+            const forward = keyOf(a) < keyOf(b);
+            const [p, q] = forward ? [a, b] : [b, a];
+            for (let k = 0; k < steps; k++)
+                out.push(bent(p, q, forward ? k / steps : 1 - k / steps, lift, ease));
+        }
+        return out;
+    });
+    const seams = seamsOf(triangles, 6);
+    const seen = new Set();
+    for (const f of faceDirs) {
+        const ring = ringOf(verts, f);
+        for (let i = 0; i < ring.length; i++) {
+            const a = ring[i], b = ring[(i + 1) % ring.length];
+            if (!betweenOctagons(a, b))
+                continue;
+            const [p, q] = keyOf(a) < keyOf(b) ? [a, b] : [b, a];
+            const k = `${keyOf(p)}|${keyOf(q)}`;
+            if (seen.has(k))
+                continue;
+            seen.add(k);
+            seams.push(Array.from({ length: steps + 1 }, (_, j) => bent(p, q, j / steps, lift, ease)));
+        }
+    }
+    const result = { triangles, propellers, seams, triangleCentres: cornerDirs, propellerCentres: faceDirs, axis: faceDirs.map((f) => f.findIndex((x) => x !== 0)) };
+    props.set(key, result);
+    return result;
+}
+/**
+ * Six (or `count`) gores: panels between seams that each run from one pole to the other and turn through `twist` degrees of longitude on the way, so the seams are long S-like spirals. The
+ * whole is then tilted by the rotation `tilt` (yaw, pitch and roll in degrees) so that the poles are not on the ball's spin axis.
+ */
+export function gores(count = 6, twist = 150, tilt = [0, 0, 0], steps = 24, bands = 4) {
+    const m = rotation((tilt[0] * Math.PI) / 180, (tilt[1] * Math.PI) / 180, (tilt[2] * Math.PI) / 180);
+    const at = (i, s) => apply(m, lonLat((2 * Math.PI * i) / count + ((twist * Math.PI) / 180) * (s / 2), (s * Math.PI) / 2));
+    const seam = (i) => Array.from({ length: steps + 1 }, (_, k) => at(i, -1 + (2 * k) / steps));
+    const seams = Array.from({ length: count }, (_, i) => seam(i));
+    const panels = seams.map((up, i) => {
+        const down = [...seam((i + 1) % count)].reverse();
+        return [...up, ...down.slice(1, -1)];
+    });
+    const centres = panels.map((_, i) => apply(m, lonLat((2 * Math.PI * (i + 0.5)) / count, 0)));
+    const per = steps / bands;
+    const pieces = [];
+    for (let i = 0; i < count; i++) {
+        const left = seams[i], right = seams[(i + 1) % count];
+        for (let b = 0; b < bands; b++) {
+            const from = b * per, to = (b + 1) * per;
+            pieces.push({ ring: [...left.slice(from, to + 1), ...right.slice(from, to + 1).reverse()], gore: i });
+        }
+    }
+    return { panels, centres, seams, pieces };
+}

package/dist/emblems/emblem.descriptions.js

@@ -1,3 +1,24 @@
+const SOCCER_PANELS = {
+    "": { en: "The 32-panel soccer ball", ja: "32枚貼りのサッカーボール" },
+    "-26": { en: "The 26-panel soccer ball", ja: "26枚貼りのサッカーボール" },
+    "-18": { en: "The 18-panel soccer ball", ja: "18枚貼りのサッカーボール" },
+    "-14": { en: "The 14-panel soccer ball (6 propellers, 8 triangles)", ja: "14枚貼り（プロペラ形6枚、三角形8枚）のサッカーボール" },
+    "-12": { en: "The 12-panel soccer ball", ja: "12枚貼りのサッカーボール" },
+    "-6": { en: "The thermobonded 6-panel soccer ball", ja: "熱接着の6枚貼りサッカーボール" },
+};
+const SOCCER_COLOURS = {
+    orange: { en: "in winter orange, a bright orange that shows against snow and in low light, with dark panels", ja: "雪の上や暗がりでも見やすい明るいオレンジ色で、暗い色のパネルが入る" },
+    yellow: { en: "in high-visibility yellow, a fluorescent yellow that shows in low light, with dark panels", ja: "暗がりでも見やすい蛍光イエローで、暗い色のパネルが入る" },
+};
+/** The winter orange and high-visibility yellow balls of each construction: the construction's words and the colour's. */
+function soccerColourways() {
+    const out = {};
+    for (const [suffix, panels] of Object.entries(SOCCER_PANELS)) {
+        for (const [colour, words] of Object.entries(SOCCER_COLOURS))
+            out[`ball:soccer${suffix}-${colour}`] = { en: `${panels.en}, ${words.en}`, ja: `${panels.ja}。${words.ja}` };
+    }
+    return out;
+}
 export const EMBLEM_DESCRIPTIONS = {
     "trophy:hockey-cup": { en: "Tall banded silver cup", ja: "帯を何段も重ねた背の高い銀のカップ" },
     "trophy:basketball": { en: "Basketball trophy", ja: "バスケットボールのトロフィー" },
@@ -57,4 +78,12 @@ export const EMBLEM_DESCRIPTIONS = {
     "gear:yumi": { en: "The long asymmetric bow, held a third of the way up, with its string and wrapped grip", ja: "上が長い非対称の長弓。弦を張り、握り革と籐巻きが付く" },
     "gear:ya": { en: "A kyudo arrow with feather fletching, a nock and a steel point", ja: "弓道の矢。矢羽根、筈、矢尻が付く" },
     "gear:karate-gi": { en: "The karate suit: a jacket with crossed lapels, trousers and a belt", ja: "空手衣。上衣、ズボン、帯" },
+    "ball:soccer-26": { en: "26 panels: 8 triangles and 18 squares, the faces of a rhombicuboctahedron", ja: "三角形8枚と正方形18枚の26枚貼り。斜方立方八面体の26面と同じ構成" },
+    "ball:soccer-18": { en: "18 panels: three strips on each of the six faces of a cube, the strips of neighbouring faces square to each other", ja: "立方体の6面に3枚ずつ帯状のパネルを貼った18枚貼り。隣り合う面の帯は互いに直角" },
+    "ball:soccer-14": { en: "14 panels: 6 propellers and 8 triangles, on a truncated cube whose 12 long edges are bent into S curves", ja: "プロペラ形6枚と三角形8枚の14枚貼り。切頂立方体の長い辺12本をS字に曲げた形" },
+    "ball:soccer-12": { en: "12 panels: the 12 pentagons of a dodecahedron", ja: "正十二面体の五角形12枚で作った12枚貼り" },
+    "ball:soccer-6": { en: "6 panels, thermobonded (glued, not stitched): six twisted gores with a few long curved seams, and a smooth look", ja: "縫わずに貼り合わせる熱接着の6枚貼り。ねじれた細長いパネル6枚が、長く曲がった数本の継ぎ目でつながり、表面はなめらか" },
+    "ball:futsal": { en: "Futsal: size 4, 62 to 64 cm round, 400 to 440 g, low bounce; 32 panels, bright blue and white with a small yellow pentagon on each of the twelve", ja: "フットサル用の4号球。円周62〜64cm、重さ400〜440g、弾みにくい。32枚貼りで、明るい青と白の配色。12枚の五角形それぞれに、小さな黄色の五角形が入る" },
+    "ball:beach-soccer": { en: "Beach soccer: size 5, 68 to 70 cm round, 400 to 440 g, soft (low pressure); the 14-panel propeller layout in bright yellow, orange and blue", ja: "ビーチサッカー用の5号球。円周68〜70cm、重さ400〜440g、空気圧が低くやわらかい。14枚貼りのプロペラ形で、黄色、オレンジ、青の明るい配色" },
+    ...soccerColourways(),
 };

package/dist/emblems/emblem.flip.js

@@ -25,7 +25,8 @@ export function flipSvg(svg, o) {
     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);
-    const dx = thick * Math.sin(o.yaw * RAD);
+    // 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 mirror = showBack && own === undefined;
     const cx = x0 + w / 2;

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

@@ -18,7 +18,7 @@ export type CrestShape = (typeof CREST_SHAPES)[number];
 export declare const CREST_IDS: readonly ["crest:shield", "crest:roundel", "crest:diamond", "crest:pennant"];
 export type CrestId = (typeof CREST_IDS)[number];
 /** The balls: one for each ball and implement the sports use, in 3D, with the official size it comes from. The balls of one family (the three crickets, the five squash balls) share a module. */
-export declare const BALL_IDS: readonly ["ball:soccer", "ball:soccer-colour", "ball:teqball", "ball:basketball", "ball:basketball-6", "ball:basketball-3x3", "ball:baseball", "ball:softball", "ball:tennis", "ball:padel", "ball:sliotar", "ball:volleyball", "ball:volleyball-8", "ball:beach-volleyball", "ball:cricket-red", "ball:cricket-white", "ball:cricket-pink", "ball:football", "ball:football-cfl", "ball:football-ifaf", "ball:rugby", "ball:afl", "ball:gaelic-football", "ball:netball", "ball:pickleball-outdoor", "ball:pickleball-indoor", "ball:squash", "ball:squash-yellow", "ball:squash-green", "ball:squash-red", "ball:squash-blue", "ball:racquetball", "ball:lacrosse", "ball:field-hockey", "ball:table-tennis", "ball:handball", "ball:water-polo", "ball:golf", "ball:puck", "ball:curling-stone", "ball:shot", "ball:discus", "ball:hammer", "ball:sepak-takraw", "ball:roundnet", "ball:shuttlecock-feather", "ball:shuttlecock-nylon"];
+export declare const BALL_IDS: readonly ["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:futsal", "ball:beach-soccer", "ball:teqball", "ball:basketball", "ball:basketball-6", "ball:basketball-3x3", "ball:baseball", "ball:softball", "ball:tennis", "ball:padel", "ball:sliotar", "ball:volleyball", "ball:volleyball-8", "ball:beach-volleyball", "ball:cricket-red", "ball:cricket-white", "ball:cricket-pink", "ball:football", "ball:football-cfl", "ball:football-ifaf", "ball:rugby", "ball:afl", "ball:gaelic-football", "ball:netball", "ball:pickleball-outdoor", "ball:pickleball-indoor", "ball:squash", "ball:squash-yellow", "ball:squash-green", "ball:squash-red", "ball:squash-blue", "ball:racquetball", "ball:lacrosse", "ball:field-hockey", "ball:table-tennis", "ball:handball", "ball:water-polo", "ball:golf", "ball:puck", "ball:curling-stone", "ball:shot", "ball:discus", "ball:hammer", "ball:sepak-takraw", "ball:roundnet", "ball:shuttlecock-feather", "ball:shuttlecock-nylon"];
 export type BallId = (typeof BALL_IDS)[number];
 /** The pieces of gear: a piece of equipment for each sport, flat, drawn for this package, turning like a coin. */
 export declare const GEAR_IDS: readonly ["gear:hockey-stick", "gear:goalie-stick", "gear:hockey-skate", "gear:goalie-mask", "gear:goal-net", "gear:field-hockey-stick", "gear:lacrosse-stick", "gear:cricket-bat", "gear:wicket", "gear:table-tennis-paddle", "gear:badminton-racket", "gear:tennis-racket", "gear:squash-racket", "gear:racquetball-racket", "gear:padel-racket", "gear:pickleball-paddle", "gear:roundnet-set", "gear:volleyball-net", "gear:basketball-hoop", "gear:baseball-bat", "gear:baseball-glove", "gear:football-helmet", "gear:goalposts", "gear:hurley", "gear:curling-broom", "gear:figure-skate", "gear:speed-skate", "gear:diving-board", "gear:swim-goggles", "gear:starting-blocks", "gear:relay-baton", "gear:javelin", "gear:hurdles", "gear:gunbai", "gear:mawashi", "gear:shinai", "gear:kendo-men", "gear:judogi", "gear:obi", "gear:yumi", "gear:ya", "gear:karate-gi"];
@@ -40,7 +40,7 @@ export declare const EMBLEM_GROUPS: {
     readonly trophy: readonly ["trophy:cup", "trophy:lidded-cup", "trophy:bowl", "trophy:salver", "trophy:globe", "trophy:hockey-cup", "trophy:basketball", "trophy:baseball", "trophy:football", "trophy:canadian-bowl", "trophy:soccer-ball", "trophy:soccer-globe", "trophy:tennis-plate", "trophy:tennis-cup", "trophy:cricket-urn", "trophy:rugby-cup", "trophy:plaque", "trophy:belt", "trophy:laurel", "trophy:rosette", "trophy:ring", "trophy:banner", "trophy:sumo-cup", "trophy:championship-banner"];
     readonly medal: readonly ["medal:gold", "medal:silver", "medal:bronze", "medal:place-1", "medal:place-2", "medal:place-3"];
     readonly crest: readonly ["crest:shield", "crest:roundel", "crest:diamond", "crest:pennant"];
-    readonly ball: readonly ["ball:soccer", "ball:soccer-colour", "ball:teqball", "ball:basketball", "ball:basketball-6", "ball:basketball-3x3", "ball:baseball", "ball:softball", "ball:tennis", "ball:padel", "ball:sliotar", "ball:volleyball", "ball:volleyball-8", "ball:beach-volleyball", "ball:cricket-red", "ball:cricket-white", "ball:cricket-pink", "ball:football", "ball:football-cfl", "ball:football-ifaf", "ball:rugby", "ball:afl", "ball:gaelic-football", "ball:netball", "ball:pickleball-outdoor", "ball:pickleball-indoor", "ball:squash", "ball:squash-yellow", "ball:squash-green", "ball:squash-red", "ball:squash-blue", "ball:racquetball", "ball:lacrosse", "ball:field-hockey", "ball:table-tennis", "ball:handball", "ball:water-polo", "ball:golf", "ball:puck", "ball:curling-stone", "ball:shot", "ball:discus", "ball:hammer", "ball:sepak-takraw", "ball:roundnet", "ball:shuttlecock-feather", "ball:shuttlecock-nylon"];
+    readonly ball: readonly ["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:futsal", "ball:beach-soccer", "ball:teqball", "ball:basketball", "ball:basketball-6", "ball:basketball-3x3", "ball:baseball", "ball:softball", "ball:tennis", "ball:padel", "ball:sliotar", "ball:volleyball", "ball:volleyball-8", "ball:beach-volleyball", "ball:cricket-red", "ball:cricket-white", "ball:cricket-pink", "ball:football", "ball:football-cfl", "ball:football-ifaf", "ball:rugby", "ball:afl", "ball:gaelic-football", "ball:netball", "ball:pickleball-outdoor", "ball:pickleball-indoor", "ball:squash", "ball:squash-yellow", "ball:squash-green", "ball:squash-red", "ball:squash-blue", "ball:racquetball", "ball:lacrosse", "ball:field-hockey", "ball:table-tennis", "ball:handball", "ball:water-polo", "ball:golf", "ball:puck", "ball:curling-stone", "ball:shot", "ball:discus", "ball:hammer", "ball:sepak-takraw", "ball:roundnet", "ball:shuttlecock-feather", "ball:shuttlecock-nylon"];
     readonly gear: readonly ["gear:hockey-stick", "gear:goalie-stick", "gear:hockey-skate", "gear:goalie-mask", "gear:goal-net", "gear:field-hockey-stick", "gear:lacrosse-stick", "gear:cricket-bat", "gear:wicket", "gear:table-tennis-paddle", "gear:badminton-racket", "gear:tennis-racket", "gear:squash-racket", "gear:racquetball-racket", "gear:padel-racket", "gear:pickleball-paddle", "gear:roundnet-set", "gear:volleyball-net", "gear:basketball-hoop", "gear:baseball-bat", "gear:baseball-glove", "gear:football-helmet", "gear:goalposts", "gear:hurley", "gear:curling-broom", "gear:figure-skate", "gear:speed-skate", "gear:diving-board", "gear:swim-goggles", "gear:starting-blocks", "gear:relay-baton", "gear:javelin", "gear:hurdles", "gear:gunbai", "gear:mawashi", "gear:shinai", "gear:kendo-men", "gear:judogi", "gear:obi", "gear:yumi", "gear:ya", "gear:karate-gi"];
     readonly sport: readonly ("sport:sumo" | "sport:kendo" | "sport:judo" | "sport:kyudo" | "sport:karate" | "sport:nfl" | "sport:cfl" | "sport:ifaf" | "sport:nhl" | "sport:nba" | "sport:mlb" | "sport:soccer" | "sport:curling" | "sport:tennis" | "sport:volleyball" | "sport:badminton" | "sport:pickleball" | "sport:tabletennis" | "sport:padel" | "sport:squash" | "sport:racquetball" | "sport:sepaktakraw" | "sport:teqball" | "sport:roundnet" | "sport:netball" | "sport:swimming" | "sport:waterpolo" | "sport:diving" | "sport:artisticswimming" | "sport:lacrosse" | "sport:rugby" | "sport:afl" | "sport:gaelic" | "sport:cricket" | "sport:fieldhockey" | "sport:handball" | "sport:athletics" | "sport:skating")[];
     readonly pennant: readonly ["pennant:championship"];

package/dist/emblems/emblem.ids.js

@@ -24,7 +24,7 @@ export const CREST_SHAPES = ["shield", "roundel", "diamond", "pennant"];
 export const CREST_IDS = ["crest:shield", "crest:roundel", "crest:diamond", "crest:pennant"];
 /** The balls: one for each ball and implement the sports use, in 3D, with the official size it comes from. The balls of one family (the three crickets, the five squash balls) share a module. */
 export const BALL_IDS = [
-    "ball:soccer", "ball:soccer-colour", "ball:teqball", "ball:basketball", "ball:basketball-6", "ball:basketball-3x3", "ball:baseball", "ball:softball", "ball:tennis", "ball:padel",
+    "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:futsal", "ball:beach-soccer", "ball:teqball", "ball:basketball", "ball:basketball-6", "ball:basketball-3x3", "ball:baseball", "ball:softball", "ball:tennis", "ball:padel",
     "ball:sliotar", "ball:volleyball", "ball:volleyball-8", "ball:beach-volleyball", "ball:cricket-red", "ball:cricket-white", "ball:cricket-pink", "ball:football", "ball:football-cfl",
     "ball:football-ifaf", "ball:rugby", "ball:afl", "ball:gaelic-football", "ball:netball", "ball:pickleball-outdoor", "ball:pickleball-indoor", "ball:squash", "ball:squash-yellow",
     "ball:squash-green", "ball:squash-red", "ball:squash-blue", "ball:racquetball", "ball:lacrosse", "ball:field-hockey", "ball:table-tennis", "ball:handball", "ball:water-polo", "ball:golf",

package/dist/emblems/emblem.shapes.js

@@ -96,7 +96,8 @@ export function defineFlat(id, en, ja, source, model) {
         const shown = across >= 0 ? model.front : (model.back ?? model.front.filter((x) => x[0] === "m" || x[0] === "o" || x[0] === "s"));
         const sx = Math.max(Math.abs(across), 0.02);
         const sy = Math.max(Math.abs(tilt), 0.02);
-        const rim = (model.rim ?? 0) * Math.sin((yaw * Math.PI) / 180);
+        // The rim is on the left for a positive yaw, which carries the front toward the right (as it does for a ball, a cup and a drag to the right).
+        const rim = -(model.rim ?? 0) * Math.sin((yaw * Math.PI) / 180);
         const [x0, y0, w, h] = (model.box ?? "0 0 64 64").split(" ").map(Number);
         const thick = rim === 0 ? "" : `<g transform="translate(${n2(rim)} 0)">${shapesMarkup(model.front.filter((x) => x[0] === "m" || x[0] === "o").map((x) => ["s", x[1]]), ctx)}</g>`;
         return document(en, model, r, ctx, `<g transform="translate(${n2(x0 + w / 2)} ${n2(y0 + h / 2)}) scale(${n2(sx)} ${n2(sy)}) translate(${n2(-x0 - w / 2)} ${n2(-y0 - h / 2)})">${thick}${face(model, shown, ctx, engraved(model, ctx, across >= 0 ? "front" : "back"))}</g>`);

package/dist/index.d.ts

@@ -105,6 +105,8 @@ export { BALL_SHUTTLECOCK_FEATHER, BALL_SHUTTLECOCK_NYLON } from "./emblems/ball
 export { BALL_SLIOTAR } from "./emblems/ball/ball.sliotar.ts";
 export { BALL_LACROSSE, BALL_RACQUETBALL, BALL_TABLE_TENNIS, BALL_SHOT } from "./emblems/ball/ball.smooth.ts";
 export { BALL_SOCCER, BALL_SOCCER_COLOUR } from "./emblems/ball/ball.soccer.ts";
+export { 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 } from "./emblems/ball/ball.soccer.panels.ts";
+export { BALL_FUTSAL, BALL_BEACH_SOCCER } from "./emblems/ball/ball.soccer.indoor.ts";
 export { BALL_SOFTBALL } from "./emblems/ball/ball.softball.ts";
 export { BALL_SQUASH_DOUBLE_YELLOW, BALL_SQUASH_YELLOW, BALL_SQUASH_RED, BALL_SQUASH_BLUE, BALL_SQUASH_GREEN } from "./emblems/ball/ball.squash.ts";
 export { BALL_TENNIS } from "./emblems/ball/ball.tennis.ts";

package/dist/index.js

@@ -106,6 +106,8 @@ export { BALL_SHUTTLECOCK_FEATHER, BALL_SHUTTLECOCK_NYLON } from "./emblems/ball
 export { BALL_SLIOTAR } from "./emblems/ball/ball.sliotar.js";
 export { BALL_LACROSSE, BALL_RACQUETBALL, BALL_TABLE_TENNIS, BALL_SHOT } from "./emblems/ball/ball.smooth.js";
 export { BALL_SOCCER, BALL_SOCCER_COLOUR } from "./emblems/ball/ball.soccer.js";
+export { 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 } from "./emblems/ball/ball.soccer.panels.js";
+export { BALL_FUTSAL, BALL_BEACH_SOCCER } from "./emblems/ball/ball.soccer.indoor.js";
 export { BALL_SOFTBALL } from "./emblems/ball/ball.softball.js";
 export { BALL_SQUASH_DOUBLE_YELLOW, BALL_SQUASH_YELLOW, BALL_SQUASH_RED, BALL_SQUASH_BLUE, BALL_SQUASH_GREEN } from "./emblems/ball/ball.squash.js";
 export { BALL_TENNIS } from "./emblems/ball/ball.tennis.js";

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.2.0";
+export declare const VERSION = "0.3.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "0.2.0";
+export const VERSION = "0.3.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnmorrisdotca/dougu-sports",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Dougu Sports 道具, sports emblems as SVG strings: trophies, medals, crests, sport icons, and the ball and gear of every sport, in metal, line or flat colour, with optional 3D turning. Light and dark, accessible, tree-shakeable. Zero dependencies.",
   "keywords": [
     "sports",