@rydr/game-sdk 3.27.0 → 5.0.0

package/README.md

@@ -131,8 +131,8 @@ exists but defaults to ALL; you don't set it.)
 - `hardware: HardwareStore` — `current: HardwareSnapshot`, and `subscribe(cb) => () => void` (fires immediately, then on every change).
 - `ready()` · `reportLoadProgress(0..100)` · `reportError(message)`.
 - `setSimulation(gradePercent)` · `setTargetPower(watts)` · `setErgMode(enabled)` — trainer control.
-- `setRoute(path)` · `createRouter({ onRoute })` · `setPowerBar(visible)` · `setMenu(true | false | "hidden")` · `requestExit()` · `requestHardwareModal()`.
-  - `setMenu`: `true` = shell chrome shown (menu screens) · `false` = immersive play (overlay collapses, but the hamburger **stays** so the rider can always exit) · `"hidden"` = full takeover, the hamburger + floating pills are **removed entirely** — use this in every editor/authoring tool (see [Build an in-game editor](#build-an-in-game-editor)).
+- `setRoute(path)` · `createRouter({ onRoute })` · `setPowerBar(visible)` · `requestExit()` · `requestHardwareModal()`.
+  - `setPowerBar`: default visible — leave it during gameplay **and** menus so a keyboard rider can always feed power. The one exception is an editor/authoring tool, which has nothing to pedal and calls `setPowerBar(false)` (see [Build an in-game editor](#build-an-in-game-editor)).
 
 > **Routing — use `createRouter`, not `setRoute` by hand.** `setRoute(path)` only *mirrors* your current route into the shell's top URL (shareable/refreshable). It does **nothing** for browser Back/Forward — those are driven by the history stack, and an iframe's own `history.pushState` entries join that stack, so a guest gets Back/Forward *for free* the moment it pushes one entry per navigation. `session.createRouter({ onRoute })` owns that wiring: `pushState` on `go()`, a `popstate` listener, dispatching the boot path from the real URL / `initialPath`, and re-mirroring via `setRoute` on every dispatch (including Back/Forward). You keep your own route *table* — parse the path in `onRoute` and mount your screen:
 >
@@ -191,6 +191,11 @@ const anyHeld = session.buttonsDown().length > 0;
 const throttle = session.axis("RT");            // 0..1 (0 on a plain, non-hall trigger until pressed)
 const move = session.stick("LSTICK");           // { x, y, magnitude, angle }, radially deadzoned
 player.x += move.x * speed;                      // smooth on hall sticks, clean 8-way on a d-pad
+const aim = session.stick("RSTICK");            // the SECOND stick: aim / camera (RX/RY)
+
+// The right stick is also readable digitally, and clicking a stick is a plain button:
+const aimX = (session.isDown("RRIGHT") ? 1 : 0) - (session.isDown("RLEFT") ? 1 : 0);
+session.onButton(({ name, edge }) => { if (name === "RSTICK_PRESS" && edge === "down") recentreCamera(); });
 ```
 
 - **Do NOT** add `window.addEventListener("keydown"/"keyup")`, read `e.key`/`e.code`/`keyCode`,
@@ -201,11 +206,12 @@ player.x += move.x * speed;                      // smooth on hall sticks, clean
   delivered per-frame and per-focus. `onButton`/`isDown`/`buttonsDown` are immune to all of that:
   the SDK normalises **keyboard, phone, and Zwift Play** into one stream and delivers it whether
   the shell or the game canvas holds focus.
-- **Canonical names:** `UP`/`DOWN`/`LEFT`/`RIGHT` + face buttons `A`/`B`/`Y`/`Z` + shoulder
-  triggers `LT`/`RT`. House convention: `A` = confirm/primary, `Z` = back/cancel; `B`/`Y` and
-  `LT`/`RT` are contextual (no built-in meaning). Show the actual glyph in prompts; never hard-code a
-  device. (Phones expose at least the `A`/`Z` pair, and not every controller has `LT`/`RT` — don't
-  require them for a flow that must work everywhere.)
+- **Canonical names:** `UP`/`DOWN`/`LEFT`/`RIGHT` (D-pad **and** left stick) + right-stick directions
+  `RUP`/`RDOWN`/`RLEFT`/`RRIGHT` + face diamond `DIAMOND_UP`/`DIAMOND_DOWN`/`DIAMOND_LEFT`/`DIAMOND_RIGHT` + shoulder triggers `LT`/`RT` + joystick
+  clicks `LSTICK_PRESS`/`RSTICK_PRESS`. House convention: `DIAMOND_DOWN` = confirm/primary, `DIAMOND_RIGHT` = back/cancel (as on Xbox/PlayStation/Nintendo). Never print a letter — resolve it per pad with `session.buttonLabel(name)`; every
+  other name is contextual (no built-in meaning). Show the actual glyph in prompts; never hard-code a
+  device. (Phones expose at least the `DIAMOND_DOWN`/`DIAMOND_RIGHT` pair, and most controllers have no `LT`/`RT`, no second
+  stick and no stick click — don't require them for a flow that must work everywhere.)
 - **Edges are real holds:** a held button emits exactly one `down` and one `up`. For "is it held
   right now?" use `isDown`/`buttonsDown` rather than tracking edges yourself.
 - **Analog is opt-in and additive:** when a controller has **hall-effect** sensors, read the
@@ -217,8 +223,10 @@ player.x += move.x * speed;                      // smooth on hall sticks, clean
   game uses either or both. And `axis()`/`stick()` are **always readable**: on a plain, non-hall
   controller the value is quantized to the endpoints (a trigger snaps `0`/`1`, a d-pad snaps
   `-1`/`0`/`+1`), so you never branch on "does this controller have hall?" — it rests at `0` until a
-  sample arrives. The **keyboard emulates axes too** (for local dev): the trigger keys drive `LT`/`RT`
-  and the arrow keys the left stick, so `axis()`/`stick()` work without a controller.
+  sample arrives. The **keyboard emulates axes too** (for local dev): the trigger keys drive `LT`/`RT`, the
+  arrow keys the left stick and `i`/`j`/`k`/`l` the right stick, so `axis()` and both `stick("LSTICK")` /
+  `stick("RSTICK")` work without a controller. The right stick is also readable digitally
+  (`RUP`/`RDOWN`/`RLEFT`/`RRIGHT`) and each stick's click is a plain button (`f`/`o` on the keyboard).
 - **The only legitimate exception is a non-gameplay authoring tool** — an admin-gated **world /
   level editor** or a dev-only showcase page that runs outside the rider flow. There, raw keyboard
   (Ctrl+Z, arrows to nudge, Delete) is the correct desktop UX. *Gameplay* never uses it.
@@ -292,7 +300,7 @@ if (r) spawnGhost(r.body.frames); // r = { body: ReplayBody, meta: ReplayMeta |
 > 2. **The URL carries only the `runId` — fetch everything else.** Do **not** gate replay entry on a level/track/difficulty/song param: you won't have one. `getReplay(runId)` returns the frames, and whatever the run was (which level, the chart, the player) must come from *inside* that replay (put it in the first frame's `customData`, or store it under the run via `saveRun`/`getRun`). This is why the route is the same for every game.
 > 3. **Handle "no replay" gracefully.** `getReplay` returns `null` when nothing was stored for that id (e.g. a pre-feature or non-PB run). Fall back to a menu — never hang on a blank screen.
 > 4. **Play it back read-only.** It's a viewer, not a run: **no** hardware input, **no** `startRun`, **no** `saveReplay`/recording. Drive your scene purely from `r.body.frames`.
-> 5. **Stay immersive and keep the URL stable.** Set your in-game chrome (e.g. `setMenu(false)`, `setPowerBar(false)`) and call `setRoute('replay/' + runId)` so a refresh stays on the replay. Derive the exit/back target from the fetched replay (e.g. that level's leaderboard), not from the URL.
+> 5. **Keep the URL stable.** A replay is read-only, so hide the power bar (`setPowerBar(false)`) and call `setRoute('replay/' + runId)` so a refresh stays on the replay. Derive the exit/back target from the fetched replay (e.g. that level's leaderboard), not from the URL.
 > 6. **Serve the path from your origin.** Like every projected route, a hard refresh of `…/replay/<id>` hits your origin as `/replay/<id>` — add the [SPA rewrite](#platformsession) so it falls back to `index.html` instead of 404ing.
 >
 > ```ts
@@ -303,8 +311,7 @@ if (r) spawnGhost(r.body.frames); // r = { body: ReplayBody, meta: ReplayMeta |
 >   const runId = m[1];
 >   const r = await session.getReplay(runId);     // null ⇒ nothing stored for this run
 >   if (!r) return goToMenu();                     // graceful fallback, no blank screen
->   session.setMenu(false);                        // immersive viewer chrome…
->   session.setPowerBar(false);                    // …no live power bar (this isn't a run)
+>   session.setPowerBar(false);                    // read-only viewer — no live power bar
 >   session.setRoute('replay/' + runId);           // keep the URL stable across refresh
 >   playReplayReadOnly(r.body.frames);             // no input, no startRun, no recording
 >   return;                                        // skip your normal "start a run" boot path
@@ -347,15 +354,14 @@ Any game can ship an **editor** for its own `shared` content (levels, tracks, ch
 
 1. **Gate your editor UI** on `session.identity.isAdmin` — show the "Edit" button / editor route only when it's `true`.
 2. **Call the normal session methods** — `saveContent` / `deleteContent` / `getUploadUrl`. The shell performs the write as the signed-in admin (Supabase RLS on their admin role; your iframe never authenticates). For a non-admin player these reject; for an admin they succeed.
-3. **Hide the shell chrome** — an editor is a full-screen tool with its own navigation, so on boot call **`session.setMenu("hidden")`** (removes the shell hamburger + floating resistance/FTP pills entirely) and **`session.setPowerBar(false)`**. Use `"hidden"`, **not** `false`: `false` is immersive *gameplay*, which keeps the hamburger so a rider can exit mid-ride — an editor has no rider to strand and its own back-nav, so the shell menu must not overlay it. This is mandatory for **any** editor (chart, level, world, voice-over, …).
+3. **Hide the power bar** — an editor is a full-screen authoring tool with nothing to pedal, so on boot call **`session.setPowerBar(false)`** to drop the trainerless power slider. (The shell draws no other per-game chrome — its platform menu is summoned on demand — so there's nothing else to hide.) This is the one place a guest should hide the power bar; gameplay and game menus always leave it visible.
 
 ```ts
 // in-game editor (embedded in the shell — the normal case)
 if (session.identity.isAdmin) {
   showEditorButton();
 }
-// …on editor boot, take over the screen — no shell chrome over an editor:
-session.setMenu("hidden");   // remove the hamburger + pills (NOT false, which keeps them for gameplay)
+// …on editor boot, drop the power slider — nothing to pedal in an editor:
 session.setPowerBar(false);
 // …when the author saves:
 const { uploadUrl, url } = await session.getUploadUrl({ collection: "songs", filename: "track.mp3" });
@@ -385,8 +391,7 @@ if (!session.identity.isAdmin) {
   // Not an admin — show "sign in to the platform as an admin", author nothing.
   return;
 }
-// Take over the screen — an editor shows no shell chrome (hamburger + pills gone).
-session.setMenu("hidden");
+// Drop the power slider — an editor has nothing to pedal.
 session.setPowerBar(false);
 // Admin: author through the session. The shell writes as the signed-in admin; this iframe never authenticates.
 const { uploadUrl, url } = await session.getUploadUrl({ collection: "levels", filename: "bg.png" });
@@ -489,16 +494,16 @@ A self-contained DOM/CSS kit for the **controller-button UI** — showing "which
 import { createKeycap, mountActionDiamond, mountDialogueCard } from "@rydr/game-sdk/ui";
 
 // a single A keycap that reflects real presses — pass the session (it satisfies `ButtonSource`)
-host.appendChild(createKeycap("A", { press: session }).el);
+host.appendChild(createKeycap("DIAMOND_DOWN", { press: session }).el);
 
-// the full A/B/Y/Z move diamond, wired to input
+// the full face-diamond move diamond, wired to input
 const dia = mountActionDiamond(host, { press: session, cards: { A: { label: "Séisme" } } });
 dia.cards.A.setActive(true);
 dia.cards.Z.keycap.setCooldown(0.4, 3); // depleting ring + countdown
 ```
 
-- **`createKeycap(button, opts)`** / **`createDpadKeycap(dir, opts)`** — a keycap of the A/B/Y/Z face buttons or the UP/DOWN/LEFT/RIGHT d-pad. A small state machine: `solo` vs `full` diamond, pulse, pressed, cooldown ring + countdown, colored vs mono, disabled, hidden.
-- **`mountCard`** — the dark glass container with a content slot. **`mountActionCard`** — that card + a keycap straddling its bottom edge. **`mountActionDiamond`** — the full A/B/Y/Z move diamond.
+- **`createKeycap(button, opts)`** / **`createDpadKeycap(dir, opts)`** — a keycap of the face-diamond face buttons or the UP/DOWN/LEFT/RIGHT d-pad. A small state machine: `solo` vs `full` diamond, pulse, pressed, cooldown ring + countdown, colored vs mono, disabled, hidden.
+- **`mountCard`** — the dark glass container with a content slot. **`mountActionCard`** — that card + a keycap straddling its bottom edge. **`mountActionDiamond`** — the full face-diamond move diamond.
 - **`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.
 
 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/client/HardwareStore.d.ts

@@ -6,6 +6,7 @@
  * Buttons are events (see `PlatformSession.onButton`), not state, so they live
  * on the client rather than here.
  */
+import { type GlyphSet } from "../protocol/glyphs.js";
 export interface HardwareSnapshot {
     /**
      * Raw trainer power, watts — the exact last reading, updated only when a power message
@@ -45,6 +46,15 @@ export interface HardwareSnapshot {
      * setup; button events themselves stay source-agnostic. Requires the `buttons` capability.
      */
     controllerConnected: boolean;
+    /**
+     * Which lettering the paired controller carries, for rendering button prompts. Prefer
+     * `session.buttonLabel(name)` over reading this directly; it's exposed here so a UI that already
+     * subscribes to hardware re-renders its prompts when the rider swaps pads mid-session.
+     *
+     * A *rendering* hint, never a device identity — several brands share a set, and gameplay must not
+     * branch on it. Defaults to {@link DEFAULT_GLYPH_SET} until the shell says otherwise.
+     */
+    glyphSet: GlyphSet;
     /** ms timestamp of the most recent update (0 before any data). */
     updatedAt: number;
 }

package/dist/client/HardwareStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HardwareStore.d.ts","sourceRoot":"","sources":["../../src/client/HardwareStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;OAYG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,YAAY,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAcD,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAMxC,6EAA6E;AAC7E,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAEzD,uFAAuF;IACvF,OAAO,CAAC,IAAI,CAAS;IACrB,kFAAkF;IAClF,OAAO,CAAC,UAAU,CAAK;gBAEX,UAAU,GAAE,MAA4B;IAIpD;iFAC6E;IAC7E,IAAI,OAAO,IAAI,gBAAgB,CAG9B;IAED,oGAAoG;IACpG,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAQjD;;;;OAIG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI1C;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAO9C;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;CAazB"}
+{"version":3,"file":"HardwareStore.d.ts","sourceRoot":"","sources":["../../src/client/HardwareStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;OAYG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,YAAY,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAC7B;;;;;;;OAOG;IACH,QAAQ,EAAE,QAAQ,CAAC;IACnB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAeD,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAMxC,6EAA6E;AAC7E,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAEzD,uFAAuF;IACvF,OAAO,CAAC,IAAI,CAAS;IACrB,kFAAkF;IAClF,OAAO,CAAC,UAAU,CAAK;gBAEX,UAAU,GAAE,MAA4B;IAIpD;iFAC6E;IAC7E,IAAI,OAAO,IAAI,gBAAgB,CAG9B;IAED,oGAAoG;IACpG,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAQjD;;;;OAIG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI1C;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAO9C;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/client/HardwareStore.js

@@ -1,3 +1,12 @@
+/**
+ * Reactive snapshot of bridged hardware state for a game.
+ *
+ * A game never owns hardware; it observes this store, which the
+ * {@link PlatformClient} keeps current from the platform's `hw.*` messages.
+ * Buttons are events (see `PlatformSession.onButton`), not state, so they live
+ * on the client rather than here.
+ */
+import { DEFAULT_GLYPH_SET } from "../protocol/glyphs.js";
 const EMPTY = {
     power: 0,
     smoothedPower: 0,
@@ -7,6 +16,7 @@ const EMPTY = {
     trainerConnected: false,
     ergSupported: false,
     controllerConnected: false,
+    glyphSet: DEFAULT_GLYPH_SET,
     updatedAt: 0,
 };
 /**

package/dist/client/HardwareStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"HardwareStore.js","sourceRoot":"","sources":["../../src/client/HardwareStore.ts"],"names":[],"mappings":"AAmDA,MAAM,KAAK,GAAqB;IAC9B,KAAK,EAAE,CAAC;IACR,aAAa,EAAE,CAAC;IAChB,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,CAAC;IACZ,KAAK,EAAE,CAAC;IACR,gBAAgB,EAAE,KAAK;IACvB,YAAY,EAAE,KAAK;IACnB,mBAAmB,EAAE,KAAK;IAC1B,SAAS,EAAE,CAAC;CACb,CAAC;AAIF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC;gFACgF;AAChF,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,6EAA6E;AAC7E,MAAM,OAAO,aAAa;IAChB,QAAQ,GAAqB,KAAK,CAAC;IAC1B,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEzD,uFAAuF;IAC/E,IAAI,CAAS;IACrB,kFAAkF;IAC1E,UAAU,GAAG,CAAC,CAAC;IAEvB,YAAY,aAAqB,mBAAmB;QAClD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC;IAED;iFAC6E;IAC7E,IAAI,OAAO;QACT,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,oGAAoG;IACpG,SAAS,CAAC,QAA0B;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,UAAkB;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAgC;QACrC,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;QAC/C,6FAA6F;QAC7F,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED;;;;;OAKG;IACK,gBAAgB;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAClD,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;YACtB,OAAO;QACT,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1E,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;QACtB,IAAI,EAAE,IAAI,CAAC;YAAE,OAAO;QACpB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACzF,CAAC;CACF"}
+{"version":3,"file":"HardwareStore.js","sourceRoot":"","sources":["../../src/client/HardwareStore.ts"],"names":[],"mappings":"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"}

package/dist/client/PlatformClient.d.ts

@@ -174,13 +174,15 @@ export interface PlatformSession {
     }): Promise<RankResult>;
     /**
      * Begin a new run/attempt. The shell mints a fresh {@link runId} (rotating the id used by the
-     * run's `saveRun`/`saveReplay`) AND opens a named effort window on its ride recording — pass
-     * `name` (e.g. `Level "Crazy Song"`) for the activity Breakdown. Call at the start of each attempt
-     * so its score/breakdown/replay are stored under their own id. A restart (calling `startRun`
-     * again) discards the previous still-open *unsaved* window. Resolves with the new id + a
-     * platform-clock start time. Throws against an older shell that doesn't support it.
+     * run's `saveRun`/`saveReplay`) AND opens a named effort window on its ride recording. Pass the
+     * run's `name` (e.g. `"Through the Fire and Flames"`) and optional `tags` (e.g. `["Expert", "No Fail"]`)
+     * — these label the run in the activity Breakdown AND on the leaderboard board it submits to; the
+     * platform stores + shows them verbatim and never parses them. Call at the start of each attempt so
+     * its score/breakdown/replay are stored under their own id. A restart (calling `startRun` again)
+     * discards the previous still-open *unsaved* window. Resolves with the new id + a platform-clock
+     * start time. Throws against an older shell that doesn't support it.
      */
-    startRun(name?: string): Promise<{
+    startRun(name?: string, tags?: string[]): Promise<{
         runId: string;
         startedAt: number;
     }>;
@@ -409,35 +411,32 @@ export interface PlatformSession {
      * {@link setRoute}); the router does not change that requirement.
      */
     createRouter(options: CreateRouterOptions): GuestRouter;
-    /** Ask the shell to show/hide the trainerless power bar. Default is visible. Editors hide it
-     *  (`setPowerBar(false)`, paired with `setMenu("hidden")` — see {@link setMenu}). */
+    /** Ask the shell to show/hide the trainerless power bar. Default is visible — leave it alone
+     *  during gameplay and menus (a keyboard rider must always be able to feed power). Editors are
+     *  the one exception: a full-screen authoring tool has nothing to pedal, so it hides the bar
+     *  with `setPowerBar(false)`. */
     setPowerBar(visible: boolean): void;
-    /**
-     * Control the in-game platform menu — the hamburger that opens Exit + hardware/settings/profile.
-     * Three states:
-     * - `true` (default) — chrome shown; use on menu/browsing screens.
-     * - `false` — immersive play; the overlay collapses but the hamburger **stays** so the rider can
-     *   always exit and reach hardware mid-ride. Use during gameplay.
-     * - `"hidden"` — full takeover; the hamburger and the floating resistance/FTP pills are removed
-     *   **entirely**. Use in any authoring tool / editor (chart, album, world, voice-over): an editor
-     *   is a full-screen tool with its own navigation, so the shell menu must not overlay it. There is
-     *   no rider to strand, so hiding the exit is safe.
-     *
-     * Rule of thumb: **every game editor must call `setMenu("hidden")`** (alongside
-     * `setPowerBar(false)`). `false` is for gameplay, never for editors.
-     */
-    setMenu(state: boolean | "hidden"): void;
     /**
      * Report whether the rider is in **active gameplay** or navigating a **menu** (picker,
      * results, leaderboard, pause screen, etc.). The shell uses this to ease trainer resistance
-     * whenever the rider isn't racing — so you keep spinning comfortably while browsing — and
+     * (~35%) whenever the rider isn't racing — so you keep spinning comfortably while browsing — and
      * restores full resistance the instant you go back to `"playing"`. The game never sets a
      * resistance value; it only declares state.
      *
-     * - `"playing"` (default if never called) — active gameplay; full rider resistance.
-     * - `"menu"` — any non-racing screen; the shell eases resistance.
+     * - `"menu"` — any non-racing screen; the shell eases resistance. **This is the default** — a
+     *   freshly-launched game is treated as being in its own menus until it says otherwise.
+     * - `"playing"` — active gameplay; the shell holds FULL rider resistance.
      *
-     * Call it wherever you already switch between menu and play (typically alongside `setMenu`).
+     * **The one rule: call `setActivity("playing")` when your gameplay loop is live, and `"menu"`
+     * on every other screen — including your title/menu screen at boot.** If you never call it, the
+     * rider stays eased (~35% lighter) the whole time — safe, but your race won't feel full. You
+     * only ever declare menu↔play; the shell owns all the *cleanup* — opening the platform menu,
+     * pausing, exiting, or a crash all reset you to the eased rest state automatically, so you can
+     * never leave the trainer stuck at full resistance.
+     *
+     * A DOM-menu game with a screen router should map every screen → state and call this on each
+     * transition (see the guitar-hero `ACTIVITY_STATE` map). A game with a phase enum should call
+     * `"playing"` on the play phase and `"menu"` on results/pause/etc.
      */
     setActivity(state: "playing" | "menu"): void;
     /** Ask the shell to exit the game (back to the launcher). */
@@ -457,9 +456,15 @@ export interface PlatformSession {
      * - **Held button** (hold-to-brake, digital steer) → `isDown(name)` / `buttonsDown()` — poll each frame.
      * - **Analog trigger** (throttle, brake pressure) → `axis("LT"|"RT")` — `0..1`, poll each frame.
      * - **Joystick** (2D move/aim) → `stick("LSTICK"|"RSTICK")` — deadzoned `{x, y, magnitude, angle}`.
+     * - **Second stick, digitally** (8-way aim) → `RUP`/`RDOWN`/`RLEFT`/`RRIGHT` via `onButton`/`isDown` —
+     *   the right stick's own edges, so they never collide with the D-pad's `UP`/`DOWN`/`LEFT`/`RIGHT`
+     *   (which the left stick shares).
+     * - **Stick click** (crouch, recentre camera) → `LSTICK_PRESS`/`RSTICK_PRESS` via `onButton`/`isDown` —
+     *   an ordinary button edge, not an axis. Rare hardware: always leave a second way to do it.
      *
      * The digital (`onButton`/`isDown`) and analog (`axis`/`stick`) streams run in parallel — the same
-     * trigger is readable both ways (`isDown("LT")` and `axis("LT")`), so use whichever fits, or both.
+     * trigger is readable both ways (`isDown("LT")` / `axis("LT")`) and so is the same stick
+     * (`isDown("RLEFT")` / `stick("RSTICK")`), so use whichever fits, or both.
      * The SDK normalises keyboard, phone, and Zwift Play into these streams and delivers them whether
      * the shell or the game canvas holds focus (raw DOM key events silently break across iframe focus).
      *
@@ -494,8 +499,26 @@ export interface PlatformSession {
      * the stick's two axes (`"LSTICK"` → `LX`/`LY`, `"RSTICK"` → `RX`/`RY`) into `{ x, y, magnitude,
      * angle }`. Because axes are always populated, this returns a smooth vector on hall hardware and a
      * clean 8-way vector on a d-pad — one code path. Default deadzone `0.1`; override via `opts`.
+     *
+     * Clicking the stick is a separate button edge (`LSTICK_PRESS`/`RSTICK_PRESS`), not part of this vector,
+     * and the right stick's deflection also arrives digitally as `RUP`/`RDOWN`/`RLEFT`/`RRIGHT`.
      */
     stick(name: StickName, opts?: StickOptions): StickVector;
+    /**
+     * The label to PRINT for a button on the controller the rider is actually holding —
+     * `buttonLabel("DIAMOND_DOWN")` gives `"A"` on an Xbox pad, `"✕"` on a DualSense, `"B"` on a
+     * Switch Pro.
+     *
+     * **Use this everywhere you would otherwise type a button letter.** The wire vocabulary is
+     * positional ({@link ButtonName}) precisely because no letter is correct on every pad, so a
+     * hardcoded "Press A" is wrong for most riders. For a graphical prompt prefer a keycap from
+     * `@rydr/game-sdk/ui`, which calls this for you and draws the diamond.
+     *
+     * Reactive: the value changes when the rider swaps controllers mid-session. If you cache the
+     * string, re-read it in `onHardware` (the glyph set lives on the hardware snapshot) — or just call
+     * this at render time, it's a table lookup.
+     */
+    buttonLabel(name: ButtonName): string;
     /**
      * Rumble the connected controller. Pass a named effect (`vibrate("hit")`) or a custom
      * `{ pattern, intensity }` (`vibrate({ pattern: [100, 50, 100], intensity: 1 })`). The shell

package/dist/client/PlatformClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlatformClient.d.ts","sourceRoot":"","sources":["../../src/client/PlatformClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PlatformClient.d.ts","sourceRoot":"","sources":["../../src/client/PlatformClient.ts"],"names":[],"mappings":"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"}

package/dist/client/PlatformClient.js

@@ -9,6 +9,7 @@
 import { RYDR_PROTOCOL_VERSION, RYDR_SDK_VERSION } from "../protocol/version.js";
 import { ALL_CAPABILITIES } from "../protocol/capabilities.js";
 import { KEY_TO_BUTTON } from "../protocol/buttons.js";
+import { buttonLabel } from "../protocol/glyphs.js";
 import { setPlatformMaster } from "../sounds/platform-master.js";
 import { decodeReplay, encodeReplay } from "./replayCodec.js";
 import { isPlatformToGameMessage, isRydrMessage } from "../protocol/guards.js";
@@ -27,11 +28,14 @@ function emit(set, value) {
  * it stays renderer-agnostic — only a boolean flag + a DOM CustomEvent, no Three.js dependency.
  *
  * Two palindromes: the face-button code, and an arrows-only alternative for games where the face
- * code can't be entered — e.g. `Z` is the house back/cancel button, so it pops menus/exits before
- * the code completes; the D-pad only navigates *within* a game, never out of it.
+ * code can't be entered — `DIAMOND_RIGHT` is the house back/cancel button, so it pops menus/exits
+ * before the code completes; the D-pad only navigates *within* a game, never out of it.
+ *
+ * The face code is a clockwise sweep of the diamond and back (top → right → bottom → left, reversed),
+ * so it is the same physical gesture on every pad regardless of the letters printed on it.
  */
 const PERF_CODES = [
-    ["Y", "A", "B", "Z", "Z", "B", "A", "Y"],
+    ["DIAMOND_UP", "DIAMOND_RIGHT", "DIAMOND_DOWN", "DIAMOND_LEFT", "DIAMOND_LEFT", "DIAMOND_DOWN", "DIAMOND_RIGHT", "DIAMOND_UP"],
     ["UP", "RIGHT", "DOWN", "LEFT", "LEFT", "DOWN", "RIGHT", "UP"],
 ];
 const PERF_CODE_MAXLEN = Math.max(...PERF_CODES.map((c) => c.length));
@@ -234,6 +238,10 @@ export function connectToPlatform(options) {
                     // Manifest-configured smoothing wins over any ConnectOptions default.
                     if (welcome.powerSmoothing != null)
                         hardware._setSmoothingTau(welcome.powerSmoothing);
+                    // Seed the glyph set BEFORE resolving, so the game's first frame already prints the right
+                    // button labels instead of flashing the default and correcting on the first input.status.
+                    if (welcome.glyphSet)
+                        hardware._patch({ glyphSet: welcome.glyphSet });
                     resolve(session);
                     break;
                 }
@@ -286,7 +294,12 @@ export function connectToPlatform(options) {
                     hardware._patch({ trainerConnected: msg.connected, ergSupported: msg.ergSupported });
                     break;
                 case "rydr/input.status":
-                    hardware._patch({ controllerConnected: msg.controllerConnected });
+                    // `glyphSet` is optional on the wire (an older shell omits it), so keep the current value
+                    // rather than snapping every on-screen prompt back to the default mid-session.
+                    hardware._patch({
+                        controllerConnected: msg.controllerConnected,
+                        ...(msg.glyphSet ? { glyphSet: msg.glyphSet } : {}),
+                    });
                     break;
                 case "rydr/lifecycle.pause":
                     emit(pauseListeners, undefined);
@@ -396,14 +409,22 @@ export function connectToPlatform(options) {
         // Keyboard analog emulation: keep the axis values in sync with keyboard-held buttons so
         // `session.axis()` / `session.stick()` work on the keyboard for local dev — quantized to the
         // endpoints (a real hall controller sends continuous values over the wire instead). Triggers map
-        // to their own axis; the arrow / d-pad keys drive the LEFT stick (opposite keys cancel, so
-        // LEFT+RIGHT reads 0). Derived from `kbDown` (keyboard-only held state), so a relayed controller's
-        // own `input.axis` samples are the authority whenever one is actually in use.
+        // to their own axis; the arrow / d-pad keys drive the LEFT stick and the i/j/k/l keys
+        // (RUP/RLEFT/RDOWN/RRIGHT) the RIGHT one — opposite keys cancel, so LEFT+RIGHT (and RLEFT+RRIGHT)
+        // reads 0. The stick-click keys (f/o → LSTICK_PRESS/RSTICK_PRESS) are buttons only and have no axis.
+        // Derived from `kbDown` (keyboard-only held state), so a relayed controller's own `input.axis`
+        // samples are the authority whenever one is actually in use.
+        //
+        // The right-stick keys deliberately do NOT also feed `LX`/`LY`: a twin-stick game would move while
+        // aiming, and the keyboard is the reference implementation of the documented contract ("LSTICK" reads
+        // LX/LY). A game wanting one merged scheme can OR the two sticks itself; the reverse isn't possible.
         const syncKeyboardAxes = () => {
             axisValues.set("LT", kbDown.has("LT") ? 1 : 0);
             axisValues.set("RT", kbDown.has("RT") ? 1 : 0);
             axisValues.set("LX", (kbDown.has("RIGHT") ? 1 : 0) - (kbDown.has("LEFT") ? 1 : 0));
             axisValues.set("LY", (kbDown.has("UP") ? 1 : 0) - (kbDown.has("DOWN") ? 1 : 0));
+            axisValues.set("RX", (kbDown.has("RRIGHT") ? 1 : 0) - (kbDown.has("RLEFT") ? 1 : 0));
+            axisValues.set("RY", (kbDown.has("RUP") ? 1 : 0) - (kbDown.has("RDOWN") ? 1 : 0));
         };
         // A game canvas has no text fields, but admin editors mounted as guests (the song and
         // voice-over editors) do. When a keystroke is destined for a focused editable element, it
@@ -568,7 +589,7 @@ export function connectToPlatform(options) {
                 knownBoard(boardId);
                 return request((nonce) => post({ rydr: true, type: "rydr/leaderboard.rankQuery", nonce, boardId, key: opts.key, value: opts.value })).then((r) => ({ boardId, rank: r.rank, total: r.total }));
             },
-            startRun: (name) => request((nonce) => post({ rydr: true, type: "rydr/run.start", nonce, name })).then((r) => {
+            startRun: (name, tags) => request((nonce) => post({ rydr: true, type: "rydr/run.start", nonce, name, tags })).then((r) => {
                 if (r.error)
                     throw new Error(`[rydr-sdk] startRun: ${r.error}`);
                 runId = r.runId; // rotate the closure-captured id so `session.runId` + shell-stamped writes follow
@@ -763,7 +784,6 @@ export function connectToPlatform(options) {
                 return router;
             },
             setPowerBar: (visible) => post({ rydr: true, type: "rydr/ui.setPowerBar", visible }),
-            setMenu: (state) => post({ rydr: true, type: "rydr/ui.setMenu", visible: state === true, hidden: state === "hidden" }),
             setActivity: (state) => post({ rydr: true, type: "rydr/activity.set", state }),
             requestExit: () => post({ rydr: true, type: "rydr/exitRequest" }),
             requestHardwareModal: () => post({ rydr: true, type: "rydr/ui.requestHardwareModal" }),
@@ -790,6 +810,9 @@ export function connectToPlatform(options) {
                 const scale = scaled / rawMag; // maps the raw vector to the rescaled, clamped magnitude
                 return { x: rawX * scale, y: rawY * scale, magnitude: scaled, angle: Math.atan2(rawY, rawX) };
             },
+            // Read through to the live snapshot rather than capturing the set, so a mid-session controller
+            // swap changes every prompt on the next render with no game-side subscription.
+            buttonLabel: (name) => buttonLabel(hardware.current.glyphSet, name),
             vibrate: (effect) => post({ rydr: true, type: "rydr/haptics.vibrate", effect }),
             onPause: (cb) => {
                 pauseListeners.add(cb);
@@ -810,6 +833,7 @@ export function connectToPlatform(options) {
                 teardownKeyboard();
                 buttonListeners.clear();
                 heldButtons.clear();
+                axisValues.clear();
                 pauseListeners.clear();
                 resumeListeners.clear();
                 identityListeners.clear();