@rydr/game-sdk 8.11.0 → 8.12.0

package/dist/three/rider/three-rider-rig.js

@@ -0,0 +1,418 @@
+/**
+ * THREE RIDER RIG — the rider-on-a-trainer drawing, in 3D.
+ *
+ * A second {@link RigRenderer} for `mountRiderRig`, exactly as `createThreePadRenderer` is a second
+ * renderer for the controller views. The component is unchanged: it still owns the two EMAs, the
+ * crank, the effort, the %FTP zone and the glass tooltip, and it still hands over one
+ * {@link RigPose} per frame. All this file does is draw that pose with meshes instead of paths.
+ *
+ * ```ts
+ * import { createThreeRiderRig } from "@rydr/game-sdk/three";
+ * import { mountRiderRig } from "@rydr/game-sdk/ui";
+ *
+ * mountRiderRig(panel, { design: "solid", ftp: 240, renderer: createThreeRiderRig });
+ * ```
+ *
+ * ## What is shared, and what that buys
+ *
+ * **The joints arrive already solved.** `RigPose` carries the hip, shoulder, head, elbow, both knees
+ * and both pedals as points in the flat 200×200 drawing space — so the two-bone IK, the crank
+ * kinematics, the out-of-the-saddle rise and the posture fold all stay in `rider-rig.ts` and run
+ * once. This file re-derives nothing, which is the whole point of the seam: two renderers cannot
+ * drift into two different gaits, and a fix to the pedalling fixes both.
+ *
+ * So the mapping is the only geometry here: {@link toWorld} takes a flat point to metres. The drawing
+ * space is scaled off the ONE wheel that is left — a 700c wheel is 0.68 m and 52 units across, giving
+ * ~1.05 m of wheelbase and a rider whose head sits at ~1.7 m. Those are a real bike's numbers, which
+ * matters because in 3D a wrong scale reads as a toy the moment perspective is applied.
+ *
+ * **The tooltip needs nothing from us.** It is an HTML box the component positions over the drawing,
+ * so it sits over this canvas exactly as it sits over the flat `<svg>` — no 3D projection, no
+ * re-layout, no second implementation. That is a payoff from building it in CSS.
+ *
+ * ## What only 3D can add, and what it costs
+ *
+ * The flat drawing is a strict side view, so the bike is a silhouette. Here the camera sits off-axis,
+ * which is what makes the trainer read as a machine with a body rather than an outline: you see the
+ * housing's depth, the flywheel as a disc rather than a circle, and the rider's far leg genuinely
+ * behind the near one instead of merely darker.
+ *
+ * The cost is a WebGL context. **This renderer draws on demand — one frame per `setPose`, no
+ * animation loop of its own** — because a game calling `rig.tick(dt)` already has a loop, and a
+ * decorative rig must not open a second one. It is still a second context beside the game's own
+ * scene, so prefer the flat renderer in-game and reach for this one on the screens where the picture
+ * IS the content: onboarding, a store page, a "how this works" panel.
+ *
+ * Requires the optional `three` peer dependency, like everything else in `@rydr/game-sdk/three`.
+ */
+import * as THREE from "three";
+import { RIG_GEOMETRY as G } from "../../ui/rider-rig.js";
+import { characterById, disposeTree } from "../character/index.js";
+import { cyclistOverrides, mountCyclist, poseCyclist, tickPose } from "./cyclist-pose.js";
+/**
+ * Flat units → metres.
+ *
+ * Fixed by the front wheel: 52 units across, 0.68 m for a 700c. Everything else in the drawing was
+ * proportioned off that wheel, so this one number makes the whole rig life-sized.
+ */
+const S = 0.68 / (G.WHEEL_R * 2);
+/** Where the near limbs, the frame and the far limbs sit across the bike's centre line. */
+const Z_NEAR = 0.1;
+const Z_FRAME = 0;
+const Z_FAR = -0.1;
+const UP = new THREE.Vector3(0, 1, 0);
+/** Vertical field of view. Narrow enough that the perspective reads as a lens, not a fisheye. */
+const FOV = 32;
+/** A flat drawing point in world metres, at a given depth. */
+function toWorld(p, z) {
+    return new THREE.Vector3((p.x - G.VB_W / 2) * S, (G.GROUND - p.y) * S, z);
+}
+/**
+ * One palette per design, so `design` means the same thing in 3D as it does flat.
+ *
+ * `neon` is the one that changes materially rather than just in hue: its parts are emissive, which is
+ * how a glowing outline survives being lit. Faking it with a bright diffuse colour would go grey the
+ * moment the key light falls off.
+ */
+const PALETTES = {
+    solid: {
+        bg: 0x0b0f17,
+        frame: 0x8ea3c4,
+        metal: 0xb9c7de,
+        tyre: 0x2b3346,
+        housing: 0x44536f,
+        fly: 0x566b90,
+        jersey: 0xff7a45,
+        legs: 0xf0b429,
+        legsFar: 0xa8791b,
+        skin: 0xffd9a8,
+        emissive: 0x000000,
+        glow: 0,
+    },
+    blueprint: {
+        bg: 0x081620,
+        frame: 0x7fd4f0,
+        metal: 0xa9e6fa,
+        tyre: 0x2b5f77,
+        housing: 0x1b4356,
+        fly: 0x4fa3c7,
+        jersey: 0xffffff,
+        legs: 0xfef9c3,
+        legsFar: 0x8a7f4a,
+        skin: 0xe8f6ff,
+        emissive: 0x1d5f7a,
+        glow: 0.25,
+    },
+    neon: {
+        bg: 0x0a0418,
+        frame: 0x22d3ee,
+        metal: 0xa5f3fc,
+        tyre: 0xc026d3,
+        housing: 0x2f1152,
+        fly: 0xe879f9,
+        jersey: 0xfb7185,
+        legs: 0xfde047,
+        legsFar: 0xa16207,
+        skin: 0xfda4af,
+        emissive: 0xffffff,
+        glow: 0.55,
+    },
+};
+/**
+ * Which rider variant each design wears — `cel` for all three, and that is a decision rather than an
+ * oversight.
+ *
+ * Matching each design to its nearest variant was the obvious move and it was tried: `facet` for
+ * `blueprint`, `neon` for `neon`. On screen at this size it fails. `facet`'s cold palette sinks into
+ * the blueprint's own teal until the rider and the machine are one shape, and `neon`'s polished chrome
+ * has almost no diffuse response, so under this lighting it reads as a black mass with a few
+ * highlights — the exact opposite of what a rider needs to be, which is the most legible thing in the
+ * picture.
+ *
+ * `cel` is the one that holds: its own blurb says it "reads at thumbnail size and never goes muddy",
+ * and that is what the job is. So the DESIGN paints the bike, the trainer and the tooltip; the RIDER
+ * stays the same person across all three. Anyone who wants the others can pass `character` — they are
+ * all still exported, `clay` and `knight` included.
+ */
+const VARIANT = {
+    solid: "cel",
+    blueprint: "cel",
+    neon: "cel",
+};
+/** A unit-height cylinder, so a segment is placed by scaling Y and pointing it. */
+const SEG_GEOM = new THREE.CylinderGeometry(1, 1, 1, 12);
+/**
+ * Point an existing segment mesh from `a` to `b`.
+ *
+ * The mesh is a unit cylinder, so its length is a Y scale and its direction a quaternion — no
+ * geometry is rebuilt per frame, which is the 3D equivalent of the flat renderer never re-rendering
+ * its SVG.
+ */
+function setSegment(mesh, a, b, radius) {
+    const dir = new THREE.Vector3().subVectors(b, a);
+    const len = dir.length() || 1e-6;
+    mesh.position.copy(a).addScaledVector(dir, 0.5);
+    mesh.scale.set(radius, len, radius);
+    mesh.quaternion.setFromUnitVectors(UP, dir.divideScalar(len));
+}
+function matFor(color, p, opts = {}) {
+    return new THREE.MeshStandardMaterial({
+        color,
+        roughness: opts.rough ?? 0.55,
+        metalness: opts.metal ?? 0.15,
+        emissive: p.glow ? color : 0x000000,
+        emissiveIntensity: p.glow,
+    });
+}
+const VIEW_DIR = {
+    // A hair of elevation, not zero: dead level reads as a technical elevation rather than a photograph.
+    profile: [0, 0.07, 1],
+    "three-quarter": [0.6, 0.4, 1],
+};
+/**
+ * Build a renderer factory with options.
+ *
+ * `RigRendererFactory` takes only the design, so anything else has to be closed over — hence a factory
+ * of a factory rather than one more argument. {@link createThreeRiderRig} is this with the defaults,
+ * and is what you pass when you have nothing to configure.
+ */
+export function threeRiderRig(opts = {}) {
+    return ({ design }) => buildRenderer(design, opts);
+}
+/** The 3D renderer with its defaults — pass it straight to `mountRiderRig`'s `renderer` option. */
+export const createThreeRiderRig = ({ design }) => buildRenderer(design, {});
+function buildRenderer(design, opts) {
+    const p = PALETTES[design];
+    const renderer = new THREE.WebGLRenderer({ antialias: true, alpha: true });
+    renderer.setPixelRatio(Math.min(window.devicePixelRatio || 1, 2));
+    renderer.domElement.style.display = "block";
+    renderer.domElement.style.width = "100%";
+    renderer.domElement.style.height = "auto";
+    const scene = new THREE.Scene();
+    const camera = new THREE.PerspectiveCamera(FOV, 1, 0.05, 40);
+    /**
+     * The camera is FITTED, not placed by hand.
+     *
+     * Hand-placed, it framed the rig at one scale and cropped the rider's head the moment anything
+     * moved — and the bounds cannot be read off the meshes either, because the limbs are unit cylinders
+     * that only take their real positions on the first `setPose`. So it is fitted to the DRAWING's own
+     * bounds, which are known up front and are the same bounds the flat renderer works to. Change the
+     * scale or the geometry and the framing follows.
+     */
+    // The drawing occupies x 20→190 and y 32 (the rider's crown) → GROUND, plus the rig's own depth.
+    const bounds = new THREE.Box3()
+        .expandByPoint(toWorld({ x: 20, y: 32 }, -0.3))
+        .expandByPoint(toWorld({ x: 190, y: G.GROUND }, 0.3));
+    const centre = bounds.getCenter(new THREE.Vector3());
+    const radius = bounds.getSize(new THREE.Vector3()).length() / 2;
+    // Off-axis and slightly above: enough perspective for the housing to have depth and for the far leg
+    // to sit genuinely behind the near one, without losing the readable side-on silhouette.
+    const dir = new THREE.Vector3(...VIEW_DIR[opts.view ?? "profile"]).normalize();
+    camera.position.copy(centre).addScaledVector(dir, (radius / Math.sin((FOV / 2) * (Math.PI / 180))) * 0.86);
+    camera.lookAt(centre);
+    // `lookAt` sets the rotation but NOT `matrixWorld`, and `Vector3.project` reads
+    // `camera.matrixWorldInverse`. Without this the very first `anchor()` — which runs before anything
+    // has rendered — projects against an identity matrix and reports a point off the canvas entirely.
+    camera.updateMatrixWorld();
+    scene.add(new THREE.HemisphereLight(0xdfe9ff, p.bg, p.glow ? 0.5 : 0.85));
+    const key = new THREE.DirectionalLight(0xffffff, p.glow ? 0.7 : 1.35);
+    key.position.set(2.2, 3.2, 2.6);
+    scene.add(key);
+    const rim = new THREE.DirectionalLight(0x9ec7ff, 0.5);
+    rim.position.set(-2.4, 1.4, -1.8);
+    scene.add(rim);
+    const materials = [];
+    const geometries = [];
+    const mat = (color, o) => {
+        const m = matFor(color, p, o);
+        materials.push(m);
+        return m;
+    };
+    const geom = (g) => {
+        geometries.push(g);
+        return g;
+    };
+    const rig = new THREE.Group();
+    scene.add(rig);
+    /* ── the trainer ──────────────────────────────────────────────────────── */
+    // Extruded from the SAME outline the flat renderer strokes, so the two silhouettes agree; the depth
+    // is the only thing 3D adds. Reproducing the shape by hand here would let the two drift.
+    const body = new THREE.Shape();
+    const outline = [
+        [34, G.GROUND],
+        [44, 160],
+        [62, 154],
+        [G.AXLE.x, G.AXLE.y - 3],
+        [90, 157],
+        [96, 161],
+        [104, G.GROUND],
+    ];
+    outline.forEach(([x, y], i) => {
+        const w = toWorld({ x, y }, 0);
+        if (i === 0)
+            body.moveTo(w.x, w.y);
+        else
+            body.lineTo(w.x, w.y);
+    });
+    body.closePath();
+    const housing = new THREE.Mesh(geom(new THREE.ExtrudeGeometry(body, { depth: 0.3, bevelEnabled: true, bevelSize: 0.012, bevelThickness: 0.012, bevelSegments: 2 })), mat(p.housing, { rough: 0.42, metal: 0.25 }));
+    housing.position.z = -0.15;
+    rig.add(housing);
+    const discGeom = geom(new THREE.CylinderGeometry(G.FLY.r * S, G.FLY.r * S, 0.085, 28));
+    const flywheel = new THREE.Mesh(discGeom, mat(p.fly, { rough: 0.35, metal: 0.6 }));
+    flywheel.rotation.x = Math.PI / 2;
+    flywheel.position.copy(toWorld(G.FLY, 0.17));
+    rig.add(flywheel);
+    // A pair of spokes so the spin is legible on a disc that would otherwise look static.
+    const flySpokes = new THREE.Group();
+    const vaneMat = mat(p.housing, { rough: 0.5, metal: 0.3 });
+    for (let i = 0; i < 2; i++) {
+        const vane = new THREE.Mesh(geom(new THREE.BoxGeometry(G.FLY.r * S * 1.55, 0.02, 0.03)), vaneMat);
+        vane.rotation.z = (i * Math.PI) / 2;
+        flySpokes.add(vane);
+    }
+    flySpokes.position.copy(toWorld(G.FLY, 0.22));
+    rig.add(flySpokes);
+    const cassette = new THREE.Mesh(geom(new THREE.CylinderGeometry(G.CASSETTE_R * S, G.CASSETTE_R * S, 0.05, 18)), mat(p.metal, { rough: 0.3, metal: 0.7 }));
+    cassette.rotation.x = Math.PI / 2;
+    cassette.position.copy(toWorld(G.AXLE, 0.06));
+    rig.add(cassette);
+    /* ── the bike ─────────────────────────────────────────────────────────── */
+    const frameMat = mat(p.frame, { rough: 0.35, metal: 0.5 });
+    const tube = (a, b, r = 0.017, z = Z_FRAME) => {
+        const m = new THREE.Mesh(SEG_GEOM, frameMat);
+        setSegment(m, toWorld(a, z), toWorld(b, z), r);
+        rig.add(m);
+    };
+    tube(G.AXLE, G.SEAT_CLUSTER);
+    tube(G.SEAT_CLUSTER, G.HEADTUBE_TOP);
+    tube(G.HEADTUBE_TOP, G.HEADTUBE_BOT, 0.02);
+    tube(G.HEADTUBE_BOT, G.BB);
+    tube(G.BB, G.AXLE);
+    tube(G.SEAT_CLUSTER, G.BB);
+    tube(G.SEAT_CLUSTER, G.SADDLE, 0.012);
+    /**
+     * The fork is TWO blades, one either side of the wheel — not one tube down the middle.
+     *
+     * Drawn as a single centred tube it ran straight through the rim and out the far side, because the
+     * crown sits well outside a 0.34 m wheel and a straight line from there to the hub has to cross it.
+     * In the flat drawing that reads as a fork passing behind the wheel; in 3D, with solid geometry, it
+     * reads as the frame skewering it. A real fork straddles the wheel, and straddling it is also what
+     * removes the intersection.
+     */
+    const FORK_Z = 0.045;
+    tube(G.HEADTUBE_BOT, G.FRONT, 0.012, FORK_Z);
+    tube(G.HEADTUBE_BOT, G.FRONT, 0.012, -FORK_Z);
+    // The stem, out to the bars.
+    tube(G.HEADTUBE_TOP, G.BAR, 0.013);
+    const metalMat = mat(p.metal, { rough: 0.3, metal: 0.6 });
+    const saddle = new THREE.Mesh(geom(new THREE.BoxGeometry(0.16, 0.03, 0.09)), metalMat);
+    saddle.position.copy(toWorld(G.SADDLE, Z_FRAME));
+    saddle.rotation.z = -0.06;
+    rig.add(saddle);
+    const bars = new THREE.Mesh(geom(new THREE.CylinderGeometry(0.014, 0.014, 0.34, 10)), metalMat);
+    bars.rotation.x = Math.PI / 2;
+    bars.position.copy(toWorld(G.BAR, Z_FRAME));
+    rig.add(bars);
+    // The front wheel — the only one left, and it never turns: parked on the floor, driven by nothing.
+    const wheel = new THREE.Group();
+    const tyre = new THREE.Mesh(geom(new THREE.TorusGeometry(G.WHEEL_R * S, 0.017, 10, 44)), mat(p.tyre, { rough: 0.85, metal: 0.05 }));
+    wheel.add(tyre);
+    const spokeGeom = geom(new THREE.CylinderGeometry(0.0035, 0.0035, G.WHEEL_R * S * 2, 6));
+    for (let i = 0; i < 6; i++) {
+        const sp = new THREE.Mesh(spokeGeom, metalMat);
+        sp.rotation.z = (i * Math.PI) / 6;
+        wheel.add(sp);
+    }
+    const hub = new THREE.Mesh(geom(new THREE.CylinderGeometry(0.022, 0.022, 0.07, 12)), metalMat);
+    hub.rotation.x = Math.PI / 2;
+    wheel.add(hub);
+    wheel.position.copy(toWorld(G.FRONT, Z_FRAME));
+    rig.add(wheel);
+    /* ── the crank ────────────────────────────────────────────────────────── */
+    const crank = new THREE.Group();
+    crank.position.copy(toWorld(G.BB, 0));
+    rig.add(crank);
+    const chainring = new THREE.Mesh(geom(new THREE.CylinderGeometry(G.CHAINRING_R * S, G.CHAINRING_R * S, 0.012, 22)), metalMat);
+    chainring.rotation.x = Math.PI / 2;
+    chainring.position.z = 0.06;
+    crank.add(chainring);
+    for (const side of [1, -1]) {
+        const arm = new THREE.Mesh(geom(new THREE.BoxGeometry(G.CRANK_R * S, 0.02, 0.016)), metalMat);
+        arm.position.set((side * G.CRANK_R * S) / 2, 0, side * 0.1);
+        crank.add(arm);
+        const pedal = new THREE.Mesh(geom(new THREE.BoxGeometry(0.075, 0.014, 0.05)), mat(p.metal));
+        pedal.position.set(side * G.CRANK_R * S, 0, side * 0.1);
+        crank.add(pedal);
+    }
+    /* ── the rider ────────────────────────────────────────────────────────── */
+    // A real procedural character from `../character/`, not a stack of cylinders. It is built to the
+    // DRAWING's own dimensions (see `cyclistProportions`) so the knees the flat IK solved are knees this
+    // skeleton can actually reach — a rotation can aim a limb but it cannot stretch one.
+    const variant = characterById(opts.character ?? VARIANT[design]);
+    const rider = variant.build(cyclistOverrides(S));
+    const riderMount = mountCyclist(rider.object, S);
+    rig.add(riderMount);
+    /* ── the floor ────────────────────────────────────────────────────────── */
+    const floor = new THREE.Mesh(geom(new THREE.PlaneGeometry(6, 6)), new THREE.MeshStandardMaterial({ color: p.bg, roughness: 1, metalness: 0 }));
+    floor.rotation.x = -Math.PI / 2;
+    scene.add(floor);
+    materials.push(floor.material);
+    let w = 0;
+    let h = 0;
+    /** Seconds since mount — what a variant's own flourishes (a cape, a glow) advance against. */
+    let clock = 0;
+    function resize() {
+        const parent = renderer.domElement.parentElement;
+        const next = parent?.clientWidth ?? 0;
+        if (!next || next === w)
+            return;
+        w = next;
+        h = next; // the flat drawing is square, and the tooltip is anchored in % of that box
+        renderer.setSize(w, h, false);
+        renderer.domElement.style.height = `${h}px`;
+        camera.aspect = w / h;
+        camera.updateProjectionMatrix();
+    }
+    const anchorWorld = toWorld(G.TRAINER_ANCHOR, 0);
+    return {
+        node: renderer.domElement,
+        /**
+         * The anchor, PROJECTED. The flat renderer can answer with a fixed percentage because it is an
+         * orthographic side view; here the same point lands wherever the camera puts it, so it has to go
+         * through the projection matrix or the tooltip ends up across the middle of the machine.
+         */
+        anchor() {
+            camera.updateMatrixWorld();
+            const ndc = anchorWorld.clone().project(camera);
+            return { x: (ndc.x + 1) / 2, y: (1 - ndc.y) / 2 };
+        },
+        setPose(pose) {
+            resize();
+            clock += 1 / 60;
+            if (!w)
+                return; // not laid out yet; the next tick will size and draw
+            crank.rotation.z = -pose.crankAngle * (Math.PI / 180);
+            cassette.rotation.y = pose.cassetteAngle * (Math.PI / 180);
+            flySpokes.rotation.z = -pose.flyAngle * (Math.PI / 180);
+            // The rider: one call. Every joint it needs was solved by the component, so nothing about the
+            // gait is decided here — see `cyclist-pose.ts`.
+            poseCyclist(rider.joints, pose, S);
+            rider.tick?.(tickPose(pose, clock), 1 / 60);
+            renderer.render(scene, camera);
+        },
+        dispose() {
+            // A WebGL context is not garbage: it has to be handed back, along with everything uploaded to
+            // it, or a page that mounts a few of these leaks contexts until the browser drops the oldest.
+            disposeTree(riderMount);
+            SEG_GEOM.dispose();
+            for (const g of geometries)
+                g.dispose();
+            for (const m of materials)
+                m.dispose();
+            renderer.dispose();
+            renderer.domElement.remove();
+        },
+    };
+}
+//# sourceMappingURL=three-rider-rig.js.map

package/dist/three/rider/three-rider-rig.js.map

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

package/dist/ui/README.md

@@ -49,6 +49,7 @@ feed its `{x, y, onScreen}` into `setScreenPos`/`setVisible` — don't compute p
 | `mountRarityCard(host, opts)` / `buildRarityCard(opts)` | fn | A generic rarity-tinted item/creature card. |
 | `createActionMarker(host, opts)` | fn | **"There is something to do THERE"** — a card pinned to a point in the world (you `place(x, y)` it every frame with the point projected to screen), the keycap joining it once the rider is close enough (`setNear`), and a caret clamping it to the border with an arrow while the point is off screen. Two independent axes: `tone` is MOTION (`hint` still · `action` breathing · `urgent` hammering), `color` is SUBJECT (`red`/`danger`, `green`/`success`, `cyan`/`accent`, … — see `MARKER_COLORS`). |
 | `createPowerRace(opts)` | fn | A timed **power-vs-deadline race** overlay — the "push NOW or lose it" beat. A charge bar (∫power dt) races a clock; first to 100% wins. `start()` then `setPower(w)`+`tick(dt)` per frame; `won`/`lost` via `onResolve`. Recolour with `theme`, relabel with `text`. **Timings:** `introS` is the wind-up before the bars go live (default 2s — pass `0` for a widget the rider OPENED by pressing a button, so watts count from frame 1), `durationS` the race itself, `hold: { stampDelayS, hideAfterS }` what happens after it resolves (either can be `false`). `setTarget({ ftp })` re-sizes the effort target in place — no rebuild when a rider retunes their FTP mid-ride. |
+| `mountRiderRig(host, opts)` | fn | **A rider pedalling on their direct-drive trainer, with their watts in a glass tooltip leaving the machine** (bubble + pointer, the number above the bar, every label inside the glass) — the one drawing here whose subject is the BIKE rather than the pad. No rear wheel (it comes off; the frame bolts to the trainer's axle and the chain drives its cassette), and the bike is STILL — it's clamped to a fixed machine, so the frame never sways and the front wheel never turns. What a game puts on an onboarding beat, a "how this works" panel or an effort-based pause screen to say that the trainer is half of the controller. `setPower(w)` + `setCadence(rpm)` + `tick(dt)` per frame. **Two separate engines:** cadence turns the legs, power fills the gauge and folds the posture — never drive both from watts (see below). `design` picks one of three art directions (`solid` / `blueprint` / `neon`); the geometry and the animation are shared. NOT `mountControlTrainer`, which is a lesson. |
 | `mountHeatVignette(host, opts)` | fn | **Screen-edge heat vignette alone** — the peripheral amber→orange→red glow that escalates with heat. Take this when your game draws its own heat bar. `setHeat(heat01, locked)` per frame. |
 | `mountOverheatGlitch(host, opts)` | fn | **Lockout glitch overlay alone** — one-shot RGB chromatic burst on entry, then scanlines + red noise for the lockout. `setLocked(bool)` per frame. |
 | `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. |
@@ -68,7 +69,9 @@ Types: `DiamondButton` (`"DIAMOND_UP"\|"DIAMOND_DOWN"\|"DIAMOND_LEFT"\|"DIAMOND_
 `LabeledDiamond`, `ActionDiamond`, `Rarity`, `RarityCard`, `OptionMenu`, `OptionMenuItem`, `OptionMenuOptions`,
 `ControlAction`, `ComboToken`, `StickDir`, `PadInputSource`, `PadBrandKey`, `PadPart`, `PadLayout`,
 `ControllerPad`, `ControllerMap`, `ComboDemo`, `InputChip`, `ComboStrip`,
-`ActionMarker`, `ActionMarkerOptions`, `ActionMarkerTone`, `ActionMarkerColor`, `ActionMarkerRole`
+`ActionMarker`, `ActionMarkerOptions`, `ActionMarkerTone`, `ActionMarkerColor`, `ActionMarkerRole`,
+`RiderRig`, `RiderRigOptions`, `RiderRigDesign`, `RigPose`, `RigPoint`, `RigRenderer`,
+`RigRendererFactory`
 (+ the `MARKER_COLORS` / `MARKER_ROLE_COLORS` tables).
 
 ---
@@ -262,6 +265,15 @@ where the caption sits in a card — but write it for what the combination *can'
 controls lights all of them, but the bubble draws no chips; use `mountComboDemo` or `mountControllerMap`
 to spell a combination out.
 
+**Two looks, chosen by the drawing underneath.** Over the flat SVG pad the caption is the opaque white
+bubble with a solid caret — one known tone under it, and a bubble that sits beside the drawing more
+than on it. Over a pad drawn in volume (`renderer: createThreePadRenderer`) it becomes bare white type
+with its own dark shadow and no pointer: an opaque slab on a shaded shell reads as a sticker and hides
+the control it names, and with the control lit under the caption there is nothing for a caret to
+disambiguate. The spotlight picks this from `PadRenderer.perspective` and marks its root
+`.on-3d`, so a host that wants something else overrides those rules in CSS rather than passing an
+option.
+
 ### Teaching a control — `mountControlTrainer`
 
 For a lesson the rider has to *perform*, not just watch. Built for paired controls: one concept, two
@@ -309,6 +321,146 @@ rotation moves on, so "you did it" lands before "now this one".
 
 ---
 
+## The rider on the trainer (`mountRiderRig`)
+
+Everything else in this kit teaches the rider about the **pad**. A game built only from those pieces
+tells a new player that the controller is the thing in their hands — and it isn't, or not only. This
+is the picture that says so.
+
+```ts
+const rig = mountRiderRig(panel, { design: "solid", ftp: session.identity.ftp });
+
+// each frame:
+rig.setPower(session.hardware.current.power);   // raw, not smoothedPower — see below
+rig.setCadence(session.hardware.current.cadence);
+rig.tick(dt);
+```
+
+### No rear wheel, and a bike that doesn't move
+
+This is a **direct-drive** trainer, the kind RYDR runs on: the rear wheel comes **off**, the bike's
+dropouts bolt onto the trainer's own axle, and the chain drives the trainer's cassette directly —
+that junction is where the connection to the platform physically happens. A wheel-on trainer (a tyre
+pressed onto a spinning roller) would be a picture of a different, older machine, and would quietly
+teach a newcomer that the trainer is something the bike sits on top of rather than part of the
+drivetrain.
+
+That also settles what may move. **The bike is still.** It is bolted to a fixed machine: the frame
+does not sway, and the front wheel — parked on the floor, driven by nothing — does not turn. The only
+things that rotate are the ones the rider's legs actually drive: the crank, the cassette, and the
+flywheel. A frame that rocked or a front wheel that spun would be describing a bike going somewhere,
+which is the one thing this bike is not doing.
+
+### ⚠️ Not `mountControlTrainer`
+
+English "trainer" means both the *turbo trainer* and the *coach*, and this kit has one of each:
+
+| | what it is |
+| --- | --- |
+| `mountControlTrainer` | the **coach** — a guided lesson that watches the rider perform a combination |
+| `mountRiderRig` | the **turbo trainer** — the physical machine, drawn, pedalled, with a watts gauge |
+
+They share no code. If you want to teach a control, you want the other one.
+
+### Two engines, and why they must stay separate
+
+**Cadence turns the legs. Power fills the gauge.** Nothing crosses over:
+
+- `setCadence(rpm)` drives the crank, the legs, the rear wheel and the flywheel — the *movement*.
+- `setPower(watts)` drives the gauge and the rider's posture (the torso folding onto the bars, and a
+  rock out of the saddle past ~110% FTP) — the *effort*.
+
+Driving both from watts would be less code and would teach the opposite of the truth: that a rider
+spinning fast against no resistance is doing something. Two riders at 90 rpm, one at 100 W and one at
+300 W, have identical legs and nothing else in common — and which of them the game is reading is
+exactly what a newcomer has to understand. If you have no cadence, pass a plausible constant (or
+`idleCadence`) rather than feeding watts in twice.
+
+### The gauge is FTP-relative, and it leaves the machine
+
+The gauge is a **glass tooltip leaving the machine**: a compact bubble with a pointer into the
+trainer's shoulder, the watts printed large at the top and the bar below them. The drawing is inline
+SVG; the tooltip is an **HTML element over it** — the kit's own split, the same one `mountControllerMap`
+makes when it draws its callout cards in HTML and only the lines between them in SVG. Boxes are CSS,
+shapes are SVG. That is what gives the panel real `backdrop-filter` glass, and it means its FTP label
+is centred on its tick by CSS rather than by a hand-computed coordinate. The bar's orientation
+drives the shape of the box — a landscape bubble where it fills left → right, a portrait one where it
+fills bottom → top.
+
+Two reasons, neither decorative. Where the number comes from is part of what the picture says — these
+watts are measured by *that* machine, not floating beside the bike. And the bubble gives every label
+somewhere to live: the number, its unit and the FTP mark all sit **inside** the glass, so none of them
+is ever printed over the frame, the rider or the trainer.
+
+The scale runs `0 → 1.5 × ftp`, with the rider's threshold marked at two thirds height and headroom
+above it for a sprint. Pass `ftp` (from `session.identity.ftp`) and never hard-code a raw-watt scale —
+the same rule as `createPowerRace`. Zone colours are computed from %FTP and are **local to this
+component**: they are deliberately not `@rydr/game-sdk/difficulty`'s ramp, which colours the rider's
+chosen *calibration level* and is a different quantity that happens to be measured in watts too.
+
+Feed it **raw `power`**. It keeps both numbers: the readout shows the true instantaneous value while
+the bar follows an internal EMA so it climbs smoothly between the trainer's sparse (~1–4 Hz) updates.
+That is the `power` / `smoothedPower` split from `HardwareSnapshot`, resolved here once so no caller
+has to hold two of them.
+
+### Drawn flat, or in 3D
+
+`mountRiderRig` never draws the rig itself. It owns the state — the two EMAs, the crank, the effort,
+the %FTP zone — and the tooltip, and hands one solved `RigPose` per frame to a **renderer**. The
+default is the flat SVG drawing; pass `renderer: createThreeRiderRig` from `@rydr/game-sdk/three` to
+get the same rig in 3D, with everything else unchanged:
+
+```ts
+import { createThreeRiderRig } from "@rydr/game-sdk/three";
+
+mountRiderRig(panel, { design: "solid", ftp: 240, renderer: createThreeRiderRig });
+```
+
+The `ui/showcase` catalog can show both: pass `riderRigRenderer` to `mountUiShowcase` and its rider-rig
+section grows a **Draw in 3D** button. It has to come from the HOST — the catalog is part of `/ui`,
+which must not depend on `three` — so omitting it leaves the button disabled rather than absent.
+
+The pose is solved **here**, once — the leg IK, the crank kinematics, the posture fold, the rise out
+of the saddle — so a renderer receives finished joint positions and re-derives nothing. Two renderers
+cannot drift into two different gaits, and a fix to the pedalling fixes both. `@rydr/game-sdk/ui` has
+no dependency on `three`: the 3D renderer lives in `@rydr/game-sdk/three`, where `three` is already an
+optional peer dependency. Types: `RigPose`, `RigPoint`, `RigRenderer`, `RigRendererFactory`, and
+`RIG_GEOMETRY` for a renderer that needs the drawing's own coordinates.
+
+### Placing the tooltip
+
+The tooltip sits where each layout's default puts it, and `tip` overrides any part of that:
+
+```ts
+mountRiderRig(panel, { design: "solid", ftp: 240, tip: { x: 0.32, y: 0.695, arrow: 6.2 } });
+```
+
+`x`/`y` are fractions of the drawing's box (y from the top) marking where the pointer's tip lands;
+`arrow` is how far along the tooltip's own bottom edge the pointer hangs, in em. `RiderRig.setTipPlacement()`
+moves it after mounting.
+
+Those numbers are meant to be found **by eye**, not derived: `npm run rig3d` carries a dev panel that
+drives `setTipPlacement` live and prints the exact `tip` option to paste back. The two layouts anchor
+differently, so it tunes them separately.
+
+### Three designs
+
+`design` is paint only — the geometry, the joint solving and the timings are shared, and the numeric
+readout sits in the same place in all three so the rider always knows where to look:
+
+Every gauge is a **continuous** fill; what changes is the paint and the tooltip's orientation.
+
+- **`solid`** (default) — flat opaque silhouette; a landscape tooltip. Most legible.
+- **`blueprint`** — thin technical linework; a **portrait** tooltip whose bar runs vertically and
+  which shows **no figure at all** — just the `WATTS` title and a tall bar marked at FTP. On that
+  variant the bar is the reading: a rider glancing at a trainer screen reads the fill long before
+  they read three digits, and a number beside it competes with what it annotates.
+- **`neon`** — glowing outline; a landscape tooltip whose fill carries a bright leading edge. The
+  arcade one.
+
+See all three side by side, drivable across the whole scale, in the `ui/showcase` catalog
+(`npm run showcase` → "Rider on the trainer").
+
 ## Wiring to real input
 
 Any keycap/card reflects real presses if you pass it something with `onButton` — your platform

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

@@ -32,6 +32,7 @@
  */
 import type { GlyphSet } from "../../protocol/glyphs.js";
 import { type ControllerPad, type PadInputSource } from "./controller-pad.js";
+import type { PadRendererFactory } from "./renderer.js";
 import type { ControlAction } from "./tokens.js";
 import type { PadBrandKey } from "./types.js";
 export interface ComboDemoOptions {
@@ -66,6 +67,14 @@ export interface ComboDemoOptions {
     speed?: number;
     /** Called each time the loop completes a full cycle. */
     onCycle?: () => void;
+    /**
+     * What DRAWS the pad. Default: the flat SVG drawing.
+     *
+     * Pass `createThreePadRenderer` from `@rydr/game-sdk/three` to render the Joy-Con in 3D — this view
+     * works against it unchanged, because it never draws the controller itself. See
+     * `ui/controller/renderer.ts`.
+     */
+    renderer?: PadRendererFactory;
 }
 export interface ComboDemo {
     readonly root: HTMLDivElement;