@rydr/game-sdk 7.0.1 → 7.1.0

package/README.md

@@ -519,6 +519,25 @@ dia.cards.Z.keycap.setCooldown(0.4, 3); // depleting ring + countdown
 - **`mountDialogueCard`** — an NPC dialogue box (name + typewriter line + continue keycap). **`mountChoiceCard`** — a player menu (prompt + selectable list, ▲▼ + confirm). **`mountLabeledDiamond`** — a pip cluster with a card-seated label radiating from each active button.
 - **`createLabelKeycap(button, opts)`** — a keycap for a button printed with a WORD, not a letter (`OPTIONS` → "Menu"/"Options"/"+", `LT`/`RT`, the stick clicks): a pill instead of a pip, same state machine.
 - **`mountPauseMenu(host, opts)`** — **the shared in-game menu**, opened by the game's own `OPTIONS` button: the game's name big at the top *in the game's own font*, a free `Resume` row plus the game's own rows, each able to advertise the `shortcut` that does the same thing during play. It takes the controller over while up (`session.grabInput`) and declares `setActivity("menu")` so the trainer eases — but it **cannot** pause your loop; freeze that yourself in `onOpen`/`onClose`. Don't hand-roll a pause screen: [`src/ui/README.md`](src/ui/README.md) has the full contract.
+- **The controller family** — for showing a rider their whole control scheme. **`mountControllerPad`** draws the controller in their hands and lights it as they press (stick caps follow the real axes). **`mountControllerMap`** surrounds that pad with action callouts, each joined by a line to its button — the "Commandes" screen. **`mountComboDemo`** loops an animation of the combination one action requires. Describe your controls **once**, declaratively, and the SDK owns the rest:
+
+```ts
+import { mountControllerMap, type ControlAction } from "@rydr/game-sdk/ui";
+
+const CONTROLS: ControlAction[] = [
+  { label: "Se déplacer", combo: ["LSTICK"] },          // a whole stick = free movement
+  { label: "Freiner",     combo: ["LT"] },
+  { label: "Tir chargé",  combo: ["RT", "DIAMOND_DOWN"], hint: "Maintenir" },
+  { label: "Dash",        combo: ["LSTICK_PRESS", "LT"] },   // the line lands on the trigger
+];
+mountControllerMap(pauseOverlay, { press: session, actions: CONTROLS, title: "Commandes" });
+```
+
+  You never name a letter: you say `DIAMOND_DOWN` and the rider sees `A`, `✕` or `B` on the correct
+  physical button — on a Switch Pro the highlight stays on the *bottom* button while only the lettering
+  shifts — and it re-letters itself if they swap pads mid-screen. Six silhouettes ship, including a
+  **Zwift Play / Ride** shape whose absent controls (no joysticks, no triggers) simply aren't drawn.
+  Read [`src/ui/README.md`](src/ui/README.md) → "Showing your controls" before building a legend by hand.
 
 Wire any keycap to real input by passing the `session` — it structurally satisfies `ButtonSource`, and the keycap then shows its pressed sink while its button is held. The kit speaks the canonical `ButtonName`/`ButtonEdge` vocabulary.
 

package/dist/protocol/glyphs.d.ts

@@ -44,4 +44,11 @@ export declare function buttonLabel(set: GlyphSet, name: ButtonName): string;
  * positionally (keycaps, prompts) and treats everything else as a plain label.
  */
 export declare function isDiamondButton(name: ButtonName): boolean;
+/**
+ * The label printed on an upper shoulder button for `set` — `("playstation", "left")` → `"L1"`.
+ *
+ * Use it when naming the rider's resistance controls. Like {@link buttonLabel}, this is the only place
+ * allowed to know these strings; never hard-code `"L1"` in a prompt.
+ */
+export declare function bumperLabel(set: GlyphSet, side: "left" | "right"): string;
 //# sourceMappingURL=glyphs.d.ts.map

package/dist/protocol/glyphs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glyphs.d.ts","sourceRoot":"","sources":["../../src/protocol/glyphs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC;AAErE,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,EAAE,QAAiB,CAAC;AA4DlD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAGnE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEzD"}
+{"version":3,"file":"glyphs.d.ts","sourceRoot":"","sources":["../../src/protocol/glyphs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC;AAErE,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,EAAE,QAAiB,CAAC;AA4DlD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAGnE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEzD;AAoBD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAEzE"}

package/dist/protocol/glyphs.js

@@ -93,4 +93,30 @@ export function buttonLabel(set, name) {
 export function isDiamondButton(name) {
     return name in FACE[DEFAULT_GLYPH_SET];
 }
+/**
+ * The UPPER shoulder buttons — the ones that are NOT game input.
+ *
+ * They deliberately have no {@link ButtonName}: on this platform the upper shoulders are the rider's
+ * trainer resistance − / + and are handled by the shell, never delivered to a game (see the shell-owned
+ * keys in `protocol/buttons.ts`). They still need lettering, though, because the shell has to *name*
+ * them when teaching a rider where they are — and because the controller drawing prints them.
+ *
+ * Separate from {@link SHOULDERS}, which covers the lower triggers a game DOES receive (`LT`/`RT`).
+ */
+const BUMPERS = {
+    xbox: { left: "LB", right: "RB" },
+    playstation: { left: "L1", right: "R1" },
+    nintendo: { left: "L", right: "R" },
+    // Zwift Play has no lettering on its paddles at all, so say what they DO.
+    zwift: { left: "−", right: "+" },
+};
+/**
+ * The label printed on an upper shoulder button for `set` — `("playstation", "left")` → `"L1"`.
+ *
+ * Use it when naming the rider's resistance controls. Like {@link buttonLabel}, this is the only place
+ * allowed to know these strings; never hard-code `"L1"` in a prompt.
+ */
+export function bumperLabel(set, side) {
+    return (BUMPERS[set] ?? BUMPERS[DEFAULT_GLYPH_SET])[side];
+}
 //# sourceMappingURL=glyphs.js.map

package/dist/protocol/glyphs.js.map

@@ -1 +1 @@
-{"version":3,"file":"glyphs.js","sourceRoot":"","sources":["../../src/protocol/glyphs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAcH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAa,MAAM,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,IAAI,GAAiE;IACzE,2DAA2D;IAC3D,IAAI,EAAE,YAAY,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;IAChG,WAAW,EAAE,KAAK,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;IAChG,QAAQ,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;IAChG,KAAK,EAAE,WAAW,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;CACjG,CAAC;AAEF,gGAAgG;AAChG,MAAM,SAAS,GAAiE;IAC9E,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;IACpE,WAAW,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;IAC3E,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE;IACtE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;CACtE,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,GAAiE;IAC3E,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;IACzB,WAAW,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;IACnC,QAAQ,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE;IAC1B,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;CAC3B,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,GAAqC;IACnD,EAAE,EAAE,GAAG;IACP,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,GAAG,EAAE,GAAG;IACR,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,GAAG;IACV,MAAM,EAAE,GAAG;CACZ,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,GAAa,EAAE,IAAgB;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACnD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC3G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,OAAO,IAAI,IAAI,IAAI,CAAC,iBAAiB,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"glyphs.js","sourceRoot":"","sources":["../../src/protocol/glyphs.ts"],"names":[],"mappings":"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"}

package/dist/protocol/version.d.ts

@@ -9,5 +9,5 @@
 export declare const RYDR_PROTOCOL_VERSION: 30;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging.
  *  (Bumped to 2.0.0 by `npm version major` on release — see CHANGELOG [Unreleased].) */
-export declare const RYDR_SDK_VERSION = "7.0.1";
+export declare const RYDR_SDK_VERSION = "7.1.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/protocol/version.js

@@ -176,5 +176,5 @@
 export const RYDR_PROTOCOL_VERSION = 30;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging.
  *  (Bumped to 2.0.0 by `npm version major` on release — see CHANGELOG [Unreleased].) */
-export const RYDR_SDK_VERSION = "7.0.1";
+export const RYDR_SDK_VERSION = "7.1.0";
 //# sourceMappingURL=version.js.map

package/dist/ui/README.md

@@ -53,6 +53,13 @@ feed its `{x, y, onScreen}` into `setScreenPos`/`setVisible` — don't compute p
 | `mountOverheatHudBar(host, opts)` | fn | **The whole overheat package**: centred inferno bar + label + COOLING DOWN countdown, composing the vignette and glitch above. One `update(heat01, locked, lockoutRemaining)` per frame. |
 | `createLabelKeycap(button, opts)` | fn | A keycap for a button printed with a WORD, not a letter — `OPTIONS` ("Menu"/"Options"/"+"), `LT`/`RT`, the stick clicks. A pill, not a pip. |
 | `mountPauseMenu(host, opts)` | fn | **The in-game menu**, opened by the game's own `OPTIONS` button: game name big in YOUR font, a free `Resume` row + your own rows, each able to advertise its in-game `shortcut`. Takes the controller over while up and eases the trainer. See below. |
+| `mountControllerPad(host, opts)` | fn | **The rider's controller, drawn live** — buttons light while held, stick caps follow the real axes. Pass `press: session`. |
+| `mountControllerMap(host, opts)` | fn | **The controls screen** — that pad flanked by action callouts, each joined by a line to its button. Takes a declarative `ControlAction[]`. |
+| `mountComboDemo(host, opts)` | fn | **"Do this" animation** — loops the combination one action requires: buttons sink in, the stick swings, release, repeat. |
+| `mountControlTrainer(host, opts)` | fn | **Guided lesson** — a title, one panel per step side by side, one shared controller below. Watches the rider: white "do this" → blue "doing it" → green ✓. Fires `onComplete` when every step is done. |
+| `createComboStrip(action, opts)` | fn | Just the chip row for one action (`[L2] + [✕]`), for embedding in your own layout. |
+| `createInputChip(token, opts)` | fn | One control's pictogram, for embedding in your own layout. Delegates to `createKeycap` / `createDpadKeycap` / `createLabelKeycap` for the buttons, and draws its own stick pictograms. The atom the two views are built from. |
+| `DEFAULT_STICK_STYLE` | const | The joystick drawing convention the kit uses (`"profile"`). Override per-call with `stickStyle`. |
 | `injectCss()` | fn | Force the `.rydr-ui-*` CSS into `<head>` early (components call it for you). |
 
 Types: `DiamondButton` (`"DIAMOND_UP"\|"DIAMOND_DOWN"\|"DIAMOND_LEFT"\|"DIAMOND_RIGHT"`), `DirButton`, `KeycapVariant` (`"full"\|"solo"`),
@@ -100,6 +107,118 @@ freeze them in `onOpen`/`onClose`. What it *guarantees* is that a game which kee
 handlers go quiet, `isDown`/`stick` read resting, and anything held is released first. It also declares
 `setActivity("menu")` while up and `"playing"` on close, so trainer resistance eases like on any other
 non-racing screen.
+`LabeledDiamond`, `ActionDiamond`, `Rarity`, `RarityCard`,
+`ControlAction`, `ComboToken`, `StickDir`, `StickPictogramStyle`, `PadInputSource`, `PadBrandKey`, `PadPart`, `PadLayout`,
+`ControllerPad`, `ControllerMap`, `ComboDemo`, `InputChip`, `ComboStrip`.
+
+---
+
+## Showing your controls
+
+**Don't hand-build a control legend.** Describe your scheme once and pass it in; the SDK owns which
+physical button that is on the rider's pad, the letter printed on it, the layout, the callout lines and
+the animation.
+
+```ts
+import { mountControllerMap, mountComboDemo, type ControlAction } from "@rydr/game-sdk/ui";
+
+const CONTROLS: ControlAction[] = [
+  { label: "Se déplacer", combo: ["LSTICK"], hint: "Stick gauche" },
+  { label: "Freiner",     combo: ["LT"] },
+  { label: "Sauter",      combo: ["DIAMOND_DOWN"] },
+  { label: "Tir chargé",  combo: ["RT", "DIAMOND_DOWN"], hint: "Maintenir" },
+  { label: "Dash",        combo: ["LSTICK_PRESS", "LT"] },
+  { label: "Ultime",      combo: ["DIAMOND_UP", "DIAMOND_LEFT"], disabled: true },
+];
+
+// STATIC — the whole scheme at once. An inline widget: you own the host.
+mountControllerMap(pauseOverlay, { press: session, actions: CONTROLS, title: "Commandes" });
+
+// DYNAMIC — "here's how you do this one", looping.
+const demo = mountComboDemo(tutorialHost, { press: session, action: CONTROLS[4] });
+demo.setAction(CONTROLS[3]);   // swaps cleanly mid-loop
+```
+
+A **combo token** is a `ButtonName` (`"LT"`, `"DIAMOND_DOWN"`, `"UP"`), a whole stick (`"LSTICK"` —
+free movement), or a stick pushed one way (`"LSTICK:left"`). One token is a simple control; several
+render as `[L2] + [✕]`, or `[L2] → [✕]` with `sequence: true`.
+
+**The callout line points at the first *non-generic* token** — sticks and the d-pad are "generic"
+because many actions share them, so `["LSTICK_PRESS", "LT"]` points at the trigger, not at the stick
+every other action also mentions. Set `anchor` on the action to override. Sides and column order are
+derived from where each button physically sits on the layout, so they stay right across Xbox,
+PlayStation, Switch Pro, Joy-Con and Zwift shapes; set `side` to override.
+
+**It's an inline widget, not a screen** — no backdrop, no close button, no fixed positioning. You decide
+whether the host is a pause overlay, a pre-race panel or a settings tab:
+
+```ts
+const overlay = document.createElement("div");
+overlay.style.cssText = "position:fixed;inset:0;display:grid;place-items:center;background:rgba(4,8,14,.72)";
+document.body.appendChild(overlay);
+mountControllerMap(overlay, { press: session, actions: CONTROLS });
+```
+
+Notes worth knowing:
+
+- **Never name a letter.** You say `DIAMOND_DOWN`; the rider sees `A`, `✕` or `B` on the right physical
+  button. On a Switch Pro the highlight stays on the *bottom* button while the letters shift — that's
+  the whole point of the positional vocabulary. The views also **re-letter themselves** if the rider
+  swaps pads mid-screen (pass `press: session`), so you never rebuild them.
+- **`LT`/`RT` are your shoulder buttons**, and they letter as `LT` / `L2` / `ZL`. The upper `L1`/`R1`
+  bumpers are the shell's resistance − / +, and `View`/`Guide` are the shell's too — all of them are
+  drawn faint and can never light, so a rider can tell "this game doesn't use that" from "that isn't
+  the game's to use".
+- **Devices differ.** A Zwift Play has no joysticks and no triggers, so they aren't drawn at all. A
+  phone exposes only the confirm/back pair — the protocol can't tell us which buttons a device has, so
+  pass `available: [...]` if your game knows, and don't gate a required flow behind a rare control.
+- **The joysticks are pictures, not letters.** `LSTICK` draws a well ringed by four arrows (move any
+  way), `LSTICK:left` slides the cap that way with one arrow, and `LSTICK_PRESS` draws a **side view** of
+  the stick being pushed down — because a click is motion straight at the viewer, which a top-down
+  drawing cannot show, and because "L3" tells a rider nothing about what to do with their thumb (the
+  brand letter is still in the chip's tooltip). Three conventions exist via `stickStyle`: `"profile"`
+  (the default — use it), `"topdown"`, `"glyph"`. Every *button* shape comes from the keycap factories, so
+  a trigger or OPTIONS reads identically in a legend and in an in-game prompt.
+- Tuned for up to **5 callouts per side**; past that it warns rather than dropping one.
+- Live catalog: `npm run showcase` in the SDK repo, or the platform's `/game-ui` route.
+
+### Teaching a control — `mountControlTrainer`
+
+For a lesson the rider has to *perform*, not just watch. Built for paired controls: one concept, two
+linked halves, **one shared controller drawing** below both panels.
+
+```ts
+mountControlTrainer(modalBody, {
+  title: "Changer la résistance",
+  press: shellInput,
+  steps: [
+    { label: "Réduire la résistance",   combo: ["LSTICK_PRESS", "LB"] },
+    { label: "Augmenter la résistance", combo: ["LSTICK_PRESS", "RB"] },
+  ],
+  onComplete: () => closeModal(),   // the component never closes itself
+});
+```
+
+Each step walks three states, on both its chips and the shared pad: **whitish + pulsing** ("do this"),
+**accent, pulse stops** ("you're doing it"), **green + ✓** ("done"). The prompt shows **one step at a
+time, alternating**, and builds each combination **cumulatively** — the stick click lights, stays lit, and
+the shoulder joins it a beat later; then the other half takes its turn, and it loops. **The two surfaces speak different languages.** The
+**pad** is physical — white = *press this*, blue = *you're pressing it*, and **never green**; white and blue
+have already taught the rider that colour there means *now*, so progress as a third colour reads as "and this
+one too". The **panels** are logical — grey = to do, green + ✓ = done, and that stays for the rest of the
+lesson. The confirmation still lands on the controls the rider just pressed, because a panel's chips picture
+the same combination one line up. Nothing special happens to the pad at completion: blue persists while the
+controls are held and clears when they let go, which is simply the truth of the hardware. A step goes green **the moment its whole
+combination is held** — holding all of it *is* doing it, so there is nothing to wait for, and it stays green
+whether or not the rider keeps the controls down. Blue is the state in between: on a two-control step, after
+the first control and before the second. Focus also lingers on a step that has just gone green before the
+rotation moves on, so "you did it" lands before "now this one".
+
+> **⚠️ `LB` / `RB` (the upper shoulders) are shell-owned and a game cannot observe them.** The SDK client turns those
+> keys into `trainer.adjustResistance` intents; `session.onButton` never fires for them. A game can train
+> its *own* buttons, but a resistance lesson has to be driven by the shell — which is also the only place
+> that lesson belongs. `mountControllerMap` may still *point at* them; only the interactive trainer needs
+> a source that sees them.
 
 ---
 

package/dist/ui/controller/combo-demo.d.ts

@@ -0,0 +1,74 @@
+/**
+ * COMBO DEMO — the dynamic view: a looping animation of the combination a rider must perform.
+ *
+ * ```ts
+ * const demo = mountComboDemo(host, {
+ *   press: session,                                    // for the rider's lettering, NOT for input
+ *   action: { label: "Dash", combo: ["LT", "LSTICK:left"] },
+ * });
+ * demo.setAction(next);   // swaps cleanly mid-loop
+ * ```
+ *
+ * The timeline is **derived from the combo**, never authored per action, which is what keeps it generic:
+ *
+ *  - *hold* (default) — idle, then each control engages in turn 200 ms apart (a stick eases to full
+ *    deflection rather than snapping), everything holds together for a beat, releases, and repeats. The
+ *    stagger is the point: it shows that the controls are held *simultaneously*, which a single
+ *    all-at-once flash does not.
+ *  - *sequence* (`action.sequence`) — each control presses, holds and releases in turn, with the strip's
+ *    `→` separators filling in behind the current step.
+ *  - a stick token with no direction sweeps once around its travel circle: "any direction".
+ *
+ * It drives exactly the same `PadDriver.setPart` / `setStick` and `ComboStrip.setPressed` that real input
+ * drives in the static view, so the demo and the live pad cannot drift apart — there is one renderer.
+ *
+ * **Self-driving, unlike `createPowerRace`.** This is an attract animation with no gameplay coupling, so
+ * it owns its own `requestAnimationFrame` rather than asking the game for a `tick(dt)`. It pauses while
+ * the tab is hidden, and `play()`/`pause()` are there for the caller.
+ *
+ * **`prefers-reduced-motion` is honoured by not animating at all**: the demo renders the fully-engaged end
+ * state statically. A looping motion graphic is precisely what that media query exists to suppress, and a
+ * still frame of "all of this, held together" still answers the rider's question.
+ */
+import type { GlyphSet } from "../../protocol/glyphs.js";
+import { type ControllerPad, type PadInputSource } from "./controller-pad.js";
+import type { StickPictogramStyle } from "./input-chip.js";
+import { type ControlAction } from "./tokens.js";
+import type { PadBrandKey } from "./types.js";
+export interface ComboDemoOptions {
+    /** The single action to demonstrate. */
+    action: ControlAction;
+    /**
+     * A session, used ONLY to learn the rider's lettering and to follow pad swaps — the demo deliberately
+     * does not wire it to input. The animation is the sole writer of the drawing's state; letting real
+     * presses write it too would make the two fight for the same classes every frame.
+     */
+    press?: PadInputSource;
+    brand?: PadBrandKey;
+    glyphSet?: GlyphSet;
+    /** Draw the controller. Default true; `false` gives a compact chips-only cue. */
+    showPad?: boolean;
+    /** Show the action's label above the animation. Default true. */
+    showLabel?: boolean;
+    size?: "sm" | "md" | "lg";
+    labels?: boolean;
+    colored?: boolean;
+    accent?: string;
+    /** Drawing convention for the joystick pictograms in the chips. See {@link StickPictogramStyle}. */
+    stickStyle?: StickPictogramStyle;
+    /** Playback rate. `1` = normal, `0.5` = half speed for a slow walkthrough. */
+    speed?: number;
+    /** Called each time the loop completes a full cycle. */
+    onCycle?: () => void;
+}
+export interface ComboDemo {
+    readonly root: HTMLDivElement;
+    readonly pad: ControllerPad | undefined;
+    setAction(action: ControlAction): void;
+    play(): void;
+    pause(): void;
+    setSpeed(mult: number): void;
+    dispose(): void;
+}
+export declare function mountComboDemo(host: HTMLElement, opts: ComboDemoOptions): ComboDemo;
+//# sourceMappingURL=combo-demo.d.ts.map

package/dist/ui/controller/combo-demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combo-demo.d.ts","sourceRoot":"","sources":["../../../src/ui/controller/combo-demo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAsB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAClG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EAAgC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,MAAM,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oGAAoG;IACpG,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,CAAC;IACxC,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB;AA4CD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,GAAG,SAAS,CA4OnF"}

package/dist/ui/controller/combo-demo.js

@@ -0,0 +1,295 @@
+/**
+ * COMBO DEMO — the dynamic view: a looping animation of the combination a rider must perform.
+ *
+ * ```ts
+ * const demo = mountComboDemo(host, {
+ *   press: session,                                    // for the rider's lettering, NOT for input
+ *   action: { label: "Dash", combo: ["LT", "LSTICK:left"] },
+ * });
+ * demo.setAction(next);   // swaps cleanly mid-loop
+ * ```
+ *
+ * The timeline is **derived from the combo**, never authored per action, which is what keeps it generic:
+ *
+ *  - *hold* (default) — idle, then each control engages in turn 200 ms apart (a stick eases to full
+ *    deflection rather than snapping), everything holds together for a beat, releases, and repeats. The
+ *    stagger is the point: it shows that the controls are held *simultaneously*, which a single
+ *    all-at-once flash does not.
+ *  - *sequence* (`action.sequence`) — each control presses, holds and releases in turn, with the strip's
+ *    `→` separators filling in behind the current step.
+ *  - a stick token with no direction sweeps once around its travel circle: "any direction".
+ *
+ * It drives exactly the same `PadDriver.setPart` / `setStick` and `ComboStrip.setPressed` that real input
+ * drives in the static view, so the demo and the live pad cannot drift apart — there is one renderer.
+ *
+ * **Self-driving, unlike `createPowerRace`.** This is an attract animation with no gameplay coupling, so
+ * it owns its own `requestAnimationFrame` rather than asking the game for a `tick(dt)`. It pauses while
+ * the tab is hidden, and `play()`/`pause()` are there for the caller.
+ *
+ * **`prefers-reduced-motion` is honoured by not animating at all**: the demo renders the fully-engaged end
+ * state statically. A looping motion graphic is precisely what that media query exists to suppress, and a
+ * still frame of "all of this, held together" still answers the rider's question.
+ */
+import { createComboStrip } from "./combo-strip.js";
+import { mountControllerPad } from "./controller-pad.js";
+import { litPartOfControl } from "./parts-map.js";
+import { injectPadCss } from "./styles.js";
+import { parseToken, STICK_DIR_VECTOR } from "./tokens.js";
+// Timings in seconds. Tuned to read at a glance from a few feet away, not to be brisk.
+const HOLD_IDLE = 0.4;
+const HOLD_STAGGER = 0.2;
+const HOLD_RAMP = 0.2;
+const HOLD_SUSTAIN = 0.7;
+const HOLD_RELEASE = 0.25;
+const HOLD_TAIL = 0.5;
+const SEQ_IDLE = 0.4;
+const SEQ_PRESS = 0.35;
+const SEQ_GAP = 0.15;
+const SEQ_TAIL = 0.4;
+/** One full revolution of an undirected stick sweep. */
+const SWEEP_PERIOD = 1.2;
+const smoothstep = (t) => {
+    const c = Math.max(0, Math.min(1, t));
+    return c * c * (3 - 2 * c);
+};
+function channelsOf(action) {
+    return action.combo.map((token, index) => {
+        const t = parseToken(token);
+        if (t.kind === "stick") {
+            return {
+                index,
+                stick: {
+                    side: t.stick === "LSTICK" ? "l" : "r",
+                    vec: t.dir ? STICK_DIR_VECTOR[t.dir] : null, // null = undirected → sweep
+                },
+            };
+        }
+        return { index, part: litPartOfControl(t.name) };
+    });
+}
+export function mountComboDemo(host, opts) {
+    injectPadCss();
+    const root = document.createElement("div");
+    root.className = "rydr-paddemo";
+    host.appendChild(root);
+    const showPad = opts.showPad ?? true;
+    const showLabel = opts.showLabel ?? true;
+    let speed = opts.speed ?? 1;
+    let labelEl;
+    let hintEl;
+    if (showLabel) {
+        labelEl = document.createElement("div");
+        labelEl.className = "rydr-paddemo-label";
+        root.appendChild(labelEl);
+        hintEl = document.createElement("div");
+        hintEl.className = "rydr-paddemo-hint";
+        root.appendChild(hintEl);
+    }
+    const padCell = document.createElement("div");
+    const stripCell = document.createElement("div");
+    if (showPad)
+        root.appendChild(padCell);
+    root.appendChild(stripCell);
+    // Glyph-only shim: gives the pad the rider's lettering and pad-swap notifications, while its inert
+    // `onButton` guarantees real presses never write the drawing the animation owns.
+    const glyphOnly = opts.press && {
+        onButton: () => () => { },
+        hardware: opts.press.hardware,
+    };
+    const pad = showPad
+        ? mountControllerPad(padCell, {
+            press: glyphOnly,
+            brand: opts.brand,
+            glyphSet: opts.glyphSet,
+            size: opts.size ?? "md",
+            labels: opts.labels,
+            accent: opts.accent,
+        })
+        : undefined;
+    let action = opts.action;
+    let channels = channelsOf(action);
+    let strip;
+    function buildStrip() {
+        strip = createComboStrip(action, {
+            glyphSet: opts.glyphSet ?? pad?.glyphSet() ?? undefined,
+            colored: opts.colored,
+            stickStyle: opts.stickStyle,
+        });
+        stripCell.textContent = "";
+        stripCell.appendChild(strip.el);
+    }
+    function syncLabel() {
+        if (labelEl)
+            labelEl.textContent = action.label;
+        if (hintEl) {
+            hintEl.textContent = action.hint ?? "";
+            hintEl.style.display = action.hint ? "" : "none";
+        }
+    }
+    buildStrip();
+    syncLabel();
+    /** Total cycle length, in seconds at speed 1. */
+    function cycleLength() {
+        const n = Math.max(1, action.combo.length);
+        if (action.sequence)
+            return SEQ_IDLE + n * (SEQ_PRESS + SEQ_GAP) + SEQ_TAIL;
+        return HOLD_IDLE + (n - 1) * HOLD_STAGGER + HOLD_RAMP + HOLD_SUSTAIN + HOLD_RELEASE + HOLD_TAIL;
+    }
+    /**
+     * Write the state of the whole combination at cycle time `t` (seconds).
+     *
+     * One function for both modes and for the reduced-motion still, so there is exactly one place that
+     * decides what "engaged" looks like.
+     */
+    function renderAt(t) {
+        const driver = pad?.driver();
+        if (action.sequence) {
+            let completed = 0;
+            channels.forEach((ch) => {
+                const start = SEQ_IDLE + ch.index * (SEQ_PRESS + SEQ_GAP);
+                const end = start + SEQ_PRESS;
+                if (t >= end)
+                    completed++;
+                const on = t >= start && t < end;
+                const ramp = on ? smoothstep((t - start) / Math.min(0.12, SEQ_PRESS / 3)) : 0;
+                applyChannel(ch, on, ramp, t - start, driver);
+            });
+            strip.setStep(completed);
+            return;
+        }
+        const n = Math.max(1, action.combo.length);
+        const allDown = HOLD_IDLE + (n - 1) * HOLD_STAGGER + HOLD_RAMP;
+        const sustainEnd = allDown + HOLD_SUSTAIN;
+        const releaseEnd = sustainEnd + HOLD_RELEASE;
+        for (const ch of channels) {
+            const onset = HOLD_IDLE + ch.index * HOLD_STAGGER;
+            const on = t >= onset && t < sustainEnd;
+            let ramp = 0;
+            if (t >= onset && t < sustainEnd)
+                ramp = smoothstep((t - onset) / HOLD_RAMP);
+            else if (t >= sustainEnd && t < releaseEnd)
+                ramp = 1 - smoothstep((t - sustainEnd) / HOLD_RELEASE);
+            applyChannel(ch, on, ramp, t - onset, driver);
+        }
+    }
+    function applyChannel(ch, on, ramp, since, driver) {
+        if (ch.stick) {
+            let x;
+            let y;
+            if (ch.stick.vec) {
+                x = ch.stick.vec[0] * ramp;
+                y = ch.stick.vec[1] * ramp;
+            }
+            else {
+                // Undirected: sweep the cap around its circle so it reads as "any direction".
+                const angle = (Math.max(0, since) / SWEEP_PERIOD) * Math.PI * 2;
+                x = Math.cos(angle) * ramp;
+                y = Math.sin(angle) * ramp;
+            }
+            driver?.setStick(ch.stick.side, x, y);
+            strip.setDeflectionAt(ch.index, x, y);
+            // A stick is "pressed" in the strip once it's meaningfully deflected — matches the pad's own glow.
+            strip.setPressedAt(ch.index, ramp > 0.35);
+            return;
+        }
+        strip.setPressedAt(ch.index, on);
+        if (ch.part && driver) {
+            driver.setPart(ch.part, on);
+            if (ch.part === "lt")
+                driver.setMeter("l", on ? 1 : 0);
+            if (ch.part === "rt")
+                driver.setMeter("r", on ? 1 : 0);
+        }
+    }
+    /** The still frame for reduced motion: everything engaged, sticks at full deflection. */
+    function renderStill() {
+        const driver = pad?.driver();
+        for (const ch of channels)
+            applyChannel(ch, true, 1, 0, driver);
+        strip.setStep(action.combo.length);
+    }
+    // ── the loop ────────────────────────────────────────────────────────────────────────────────────
+    const reduceMotion = typeof matchMedia === "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
+    let raf = 0;
+    let elapsed = 0;
+    let lastTs = 0;
+    let wantPlaying = true;
+    function frame(ts) {
+        raf = requestAnimationFrame(frame);
+        const dt = lastTs ? Math.min(0.05, (ts - lastTs) / 1000) : 0;
+        lastTs = ts;
+        elapsed += dt * speed;
+        const len = cycleLength();
+        if (elapsed >= len) {
+            elapsed -= len * Math.floor(elapsed / len);
+            opts.onCycle?.();
+        }
+        renderAt(elapsed);
+    }
+    function start() {
+        if (raf || reduceMotion)
+            return;
+        lastTs = 0;
+        raf = requestAnimationFrame(frame);
+    }
+    function stop() {
+        if (raf)
+            cancelAnimationFrame(raf);
+        raf = 0;
+    }
+    const onVisibility = () => {
+        if (document.visibilityState === "hidden")
+            stop();
+        else if (wantPlaying)
+            start();
+    };
+    document.addEventListener("visibilitychange", onVisibility);
+    if (reduceMotion)
+        renderStill();
+    else
+        start();
+    // A pad swap rebuilds the drawing (new nodes, new driver) and re-letters, so the chips must follow.
+    const offRebuild = pad?.onRebuild(() => {
+        buildStrip();
+        if (reduceMotion)
+            renderStill();
+    });
+    function reset(next) {
+        action = next;
+        channels = channelsOf(action);
+        // Release the previous combination before the new one draws, or a part the old action lit and the
+        // new one doesn't would stay lit forever.
+        pad?.driver().clearAll();
+        buildStrip();
+        syncLabel();
+        elapsed = 0;
+        lastTs = 0;
+        if (reduceMotion)
+            renderStill();
+    }
+    return {
+        root,
+        pad,
+        setAction: reset,
+        play() {
+            wantPlaying = true;
+            start();
+        },
+        pause() {
+            wantPlaying = false;
+            stop();
+        },
+        setSpeed(mult) {
+            speed = Math.max(0.05, mult);
+        },
+        dispose() {
+            stop();
+            document.removeEventListener("visibilitychange", onVisibility);
+            offRebuild?.();
+            strip.dispose();
+            pad?.dispose();
+            root.remove();
+        },
+    };
+}
+//# sourceMappingURL=combo-demo.js.map

package/dist/ui/controller/combo-demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combo-demo.js","sourceRoot":"","sources":["../../../src/ui/controller/combo-demo.ts"],"names":[],"mappings":"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"}