@rydr/game-sdk 7.0.0 → 7.1.0

package/dist/ui/controller/pad-svg.js

@@ -0,0 +1,289 @@
+/**
+ * The one SVG renderer for every controller silhouette, plus the animation layer that drives it.
+ *
+ * `buildPadSvg` emits nodes and hands back the node caches directly — `parts`, `sticks`, `meters`. That
+ * is the ONLY coupling between the drawing and whatever animates it: nothing ever re-renders the SVG
+ * per frame; a driver mutates classes and attributes on cached nodes. (The platform's Lit version had
+ * to re-scan the shadow root with `querySelectorAll` after each render to rebuild these maps; building
+ * them as we go is strictly less machinery.)
+ *
+ * `createPadDriver` is that animation layer. It keeps a `lastVal` dirty-guard so an **idle pad costs
+ * zero DOM writes** even when polled at 60 Hz — that guard is not an optimisation to trim, it's the
+ * reason this is cheap enough to run beside a game loop.
+ *
+ * Both are input-agnostic: they know about positions (`PadPart`), never about `ButtonName`s, key codes
+ * or gamepad indices. `controller-pad.ts` owns the translation from canonical input to positions.
+ */
+import { partCentre } from "./types.js";
+const NS = "http://www.w3.org/2000/svg";
+/**
+ * Parts a game can never bind, so the drawing must never light them.
+ *
+ * The bumpers are the rider's resistance − / + and `select`/`home` are the shell's own menu and guide —
+ * all four are handled by the shell and are never delivered to a game (see `protocol/buttons.ts` on
+ * the shell-owned keys). They are still DRAWN, faintly, because a rider needs to tell "this game
+ * doesn't use that button" apart from "that button isn't the game's to use".
+ *
+ * `setPart` refuses them outright rather than trusting callers: today no `ButtonName` maps here, and
+ * enforcing it in the driver keeps that true if someone later adds one by mistake.
+ */
+export const SHELL_OWNED_PARTS = new Set(["lb", "rb", "select", "home"]);
+/** Below this, a stick move is sub-pixel at every render size — skip the DOM write entirely. */
+const STICK_EPSILON = 0.02;
+/** Past this deflection the stick glows like a pressed button. Matches the shell's feel. */
+export const STICK_LIT_DEADZONE = 0.18;
+function el(tag, attrs, className) {
+    const node = document.createElementNS(NS, tag);
+    if (className)
+        node.setAttribute("class", className);
+    if (attrs)
+        for (const [k, v] of Object.entries(attrs))
+            node.setAttribute(k, String(v));
+    return node;
+}
+function geomEl(g, className) {
+    switch (g.kind) {
+        case "circle":
+            return el("circle", { cx: g.cx, cy: g.cy, r: g.r }, className);
+        case "rect":
+            return el("rect", { x: g.x, y: g.y, width: g.w, height: g.h, rx: g.rx ?? 2 }, className);
+        case "path":
+            return el("path", { d: g.d }, className);
+    }
+}
+function titled(parent, text) {
+    const t = el("title");
+    t.textContent = text;
+    parent.appendChild(t);
+}
+/**
+ * How far a pressed control travels, in viewBox units, and equally how far its shadow sits below it at
+ * rest. One number for both, because the effect only reads if the face lands exactly ON its own shadow.
+ */
+export const PRESS_DEPTH = 1.4;
+/**
+ * One highlightable part: a `<g data-part>` holding a fixed drop shadow and a `.rydr-pad-face` group
+ * (shape + glyph) that sinks onto it when pressed.
+ *
+ * The shadow is what makes a press read as *down* rather than merely *coloured*. A recolour alone says
+ * "this one is involved"; a face that drops onto its own shadow says "this one is held". Same trick as
+ * the kit's keycaps, which raise on a `box-shadow` and sink by the same distance — this is the SVG
+ * equivalent, since an SVG shape can't take one.
+ *
+ * The face is a GROUP so the glyph travels with the button; a shape that moved while its letter stayed
+ * put would look broken rather than pressed.
+ */
+function buildPart(name, spec, showGlyph, smallGlyph = false) {
+    const g = el("g", { "data-part": name }, "rydr-pad-part" + (SHELL_OWNED_PARTS.has(name) ? " shell-owned" : ""));
+    titled(g, spec.label);
+    const shadow = geomEl(spec.geom, "rydr-pad-shadow");
+    shadow.setAttribute("transform", `translate(0 ${PRESS_DEPTH})`);
+    g.appendChild(shadow);
+    const face = el("g", {}, "rydr-pad-face");
+    face.appendChild(geomEl(spec.geom, "rydr-pad-shape"));
+    if (showGlyph) {
+        const c = partCentre(spec.geom);
+        if (spec.glyphPath) {
+            // Vector glyph (PlayStation's ✕ ◯ ▢ △), drawn centred on (0,0) then translated onto the part.
+            face.appendChild(el("path", { d: spec.glyphPath, transform: `translate(${c.x} ${c.y})` }, "rydr-pad-glyph-vec"));
+        }
+        else if (spec.glyph) {
+            const t = el("text", { x: c.x, y: c.y }, "rydr-pad-glyph" + (smallGlyph ? " sm" : ""));
+            t.textContent = spec.glyph;
+            face.appendChild(t);
+        }
+    }
+    g.appendChild(face);
+    return { g, face };
+}
+/** A trigger: the same part shape, plus a meter rect that fills bottom-up as travel goes 0 → 1. */
+function buildTrigger(name, spec, side, showGlyph) {
+    const { g, face } = buildPart(name, spec, false);
+    const m = spec.meter;
+    // Starts empty: y at the BOTTOM of the band with zero height, so growth reads upward. It lives in the
+    // face group so the fill travels down with the trigger instead of hovering where the trigger used to be.
+    const meter = el("rect", { "data-meter": side, x: m.x, y: m.y + m.h, width: m.w, height: 0, rx: m.rx ?? 2 }, "rydr-pad-meter");
+    face.appendChild(meter);
+    if (showGlyph) {
+        const c = partCentre(spec.geom);
+        const t = el("text", { x: c.x, y: c.y }, "rydr-pad-glyph sm");
+        t.textContent = spec.glyph;
+        face.appendChild(t);
+    }
+    return { g, meter };
+}
+/**
+ * Build the drawing for `layout`.
+ *
+ * Draw order matters and matches the shell's: body → decor → triggers → bumpers → d-pad → face →
+ * system → sticks. Sticks come last so a deflected cap draws over the shell rather than under it.
+ */
+export function buildPadSvg(layout, opts = {}) {
+    const labels = opts.labels ?? true;
+    const [minX, minY, w, h] = layout.viewBox;
+    const svg = el("svg", {
+        viewBox: `${minX} ${minY} ${w} ${h}`,
+        preserveAspectRatio: "xMidYMid meet",
+        role: "img",
+        "aria-label": `${layout.displayName} — button map`,
+    });
+    const parts = new Map();
+    const sticks = {};
+    const meters = {};
+    const add = (name, spec, showGlyph, smallGlyph = false) => {
+        const { g } = buildPart(name, spec, showGlyph, smallGlyph);
+        parts.set(name, g);
+        svg.appendChild(g);
+    };
+    svg.appendChild(el("path", { d: layout.body.d }, "rydr-pad-body"));
+    for (const d of layout.decor ?? []) {
+        const g = el("g", d.opacity != null ? { opacity: d.opacity } : {}, "rydr-pad-decor");
+        g.appendChild(geomEl(d.geom, "rydr-pad-shape"));
+        svg.appendChild(g);
+    }
+    if (layout.triggers) {
+        for (const [side, name] of [["l", "lt"], ["r", "rt"]]) {
+            const spec = side === "l" ? layout.triggers.l : layout.triggers.r;
+            const { g, meter } = buildTrigger(name, spec, side, labels);
+            parts.set(name, g);
+            meters[side] = meter;
+            svg.appendChild(g);
+        }
+    }
+    if (layout.bumpers) {
+        add("lb", layout.bumpers.l, labels);
+        add("rb", layout.bumpers.r, labels);
+    }
+    if (layout.dpad) {
+        // The d-pad never carries a glyph: the arrows are the same on every pad and the arms are too
+        // small to letter legibly at this scale.
+        add("dpadUp", layout.dpad.up, false);
+        add("dpadDown", layout.dpad.down, false);
+        add("dpadLeft", layout.dpad.left, false);
+        add("dpadRight", layout.dpad.right, false);
+    }
+    add("faceTop", layout.face.top, labels);
+    add("faceRight", layout.face.right, labels);
+    add("faceBottom", layout.face.bottom, labels);
+    add("faceLeft", layout.face.left, labels);
+    if (layout.system?.select)
+        add("select", layout.system.select, labels, true);
+    if (layout.system?.start)
+        add("start", layout.system.start, labels, true);
+    if (layout.system?.home)
+        add("home", layout.system.home, false);
+    if (layout.sticks) {
+        for (const [side, pressPart] of [["l", "lstickPress"], ["r", "rstickPress"]]) {
+            const spec = side === "l" ? layout.sticks.l : layout.sticks.r;
+            const group = el("g", {}, "rydr-pad-stickgrp");
+            titled(group, spec.label);
+            group.appendChild(el("circle", { cx: spec.cx, cy: spec.cy, r: spec.well }, "rydr-pad-well"));
+            // ONE group carries both the translate and `.deflected`. The `[data-part]` node inside it is the
+            // stick CLICK, whose `.on` class `setPart` owns — two writers on one class would fight.
+            const moving = el("g", { "data-stick": side, transform: "translate(0 0)" }, "rydr-pad-stick");
+            // Same shadow-and-face pairing as a button, so CLICKING the stick reads as pressing it down —
+            // distinct from deflecting it, which is the outer group's translate.
+            const press = el("g", { "data-part": pressPart }, "rydr-pad-part");
+            press.appendChild(el("circle", { cx: spec.cx, cy: spec.cy + PRESS_DEPTH, r: spec.cap }, "rydr-pad-shadow"));
+            const capFace = el("g", {}, "rydr-pad-face");
+            capFace.appendChild(el("circle", { cx: spec.cx, cy: spec.cy, r: spec.cap }, "rydr-pad-shape"));
+            press.appendChild(capFace);
+            moving.appendChild(press);
+            group.appendChild(moving);
+            svg.appendChild(group);
+            parts.set(pressPart, press);
+            sticks[side] = moving;
+        }
+    }
+    return { svg, parts, sticks, meters };
+}
+export function createPadDriver(pad, layout, opts = {}) {
+    /** Dirty-guard: last value written per key, so an unchanged frame does no DOM work at all. */
+    const lastVal = new Map();
+    /** Numeric codes, because `lastVal` is a number map (it also holds stick offsets). */
+    const STATE_CODE = { off: 0, on: 1, hint: 2, done: 3 };
+    const setPartState = (part, state) => {
+        if (SHELL_OWNED_PARTS.has(part) && !opts.allowShellOwned)
+            return;
+        const code = STATE_CODE[state];
+        if (lastVal.get(part) === code)
+            return;
+        lastVal.set(part, code);
+        const node = pad.parts.get(part);
+        if (!node)
+            return;
+        node.classList.toggle("on", state === "on");
+        node.classList.toggle("hint", state === "hint");
+        node.classList.toggle("done", state === "done");
+    };
+    const setPart = (part, on) => setPartState(part, on ? "on" : "off");
+    const setStick = (side, x, y, lit = "auto") => {
+        const node = pad.sticks[side];
+        if (!node)
+            return; // this layout has no stick on that side (Zwift Play has neither)
+        // Lit state FIRST, and outside the epsilon guard below: a stick released in a single frame must
+        // still stop glowing even though the move itself is too small to redraw.
+        const litKey = `${side}lit`;
+        const resolved = lit === "auto" ? (Math.hypot(x, y) > STICK_LIT_DEADZONE ? "on" : "off") : lit;
+        const code = resolved === "on" ? 1 : resolved === "hint" ? 2 : 0;
+        if (lastVal.get(litKey) !== code) {
+            lastVal.set(litKey, code);
+            node.classList.toggle("deflected", resolved === "on");
+            node.classList.toggle("hint", resolved === "hint");
+        }
+        const travel = (side === "l" ? layout.sticks?.l : layout.sticks?.r)?.travel ?? 0;
+        const dx = x * travel;
+        // NEGATED, and this is the one line that differs from the shell. The shell feeds raw W3C axes,
+        // where stick-DOWN is +1 — the same direction SVG's y grows — so it deliberately does not invert.
+        // The SDK's AxisName convention is up = +1 (see protocol/buttons.ts), so here we must.
+        const dy = -y * travel;
+        const lastX = lastVal.get(`${side}x`) ?? 0;
+        const lastY = lastVal.get(`${side}y`) ?? 0;
+        if (Math.abs(dx - lastX) < STICK_EPSILON && Math.abs(dy - lastY) < STICK_EPSILON)
+            return;
+        lastVal.set(`${side}x`, dx);
+        lastVal.set(`${side}y`, dy);
+        node.setAttribute("transform", `translate(${dx.toFixed(2)} ${dy.toFixed(2)})`);
+    };
+    const setMeter = (side, v01) => {
+        const node = pad.meters[side];
+        if (!node)
+            return;
+        const v = Math.max(0, Math.min(1, v01));
+        const key = `${side}m`;
+        if (Math.abs((lastVal.get(key) ?? 0) - v) < 0.01)
+            return;
+        lastVal.set(key, v);
+        const m = (side === "l" ? layout.triggers?.l : layout.triggers?.r)?.meter;
+        if (!m)
+            return;
+        const filled = m.h * v;
+        node.setAttribute("y", String(m.y + m.h - filled));
+        node.setAttribute("height", String(filled));
+    };
+    return {
+        setPart,
+        setPartState,
+        setStick,
+        setMeter,
+        setAvailable(available) {
+            for (const [name, node] of pad.parts) {
+                const dim = available != null && !available.includes(name) && !SHELL_OWNED_PARTS.has(name);
+                node.classList.toggle("unavailable", dim);
+            }
+        },
+        clearAll() {
+            for (const [name, node] of pad.parts) {
+                node.classList.remove("on", "hint", "done");
+                lastVal.set(name, 0);
+            }
+            for (const side of ["l", "r"]) {
+                pad.sticks[side]?.classList.remove("deflected", "hint");
+                lastVal.delete(`${side}lit`);
+                setStick(side, 0, 0, "off");
+                setMeter(side, 0);
+            }
+        },
+    };
+}
+//# sourceMappingURL=pad-svg.js.map

package/dist/ui/controller/pad-svg.js.map

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

package/dist/ui/controller/parts-map.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Canonical input → drawn position. This module is where "the game said `DIAMOND_DOWN`" becomes "light
+ * the bottom face button", and it is the reason one action list draws correctly on every controller.
+ *
+ * **It maps to POSITIONS, never to letters.** `DIAMOND_DOWN` → `faceBottom` on every pad; each layout
+ * places `faceBottom` where that brand actually puts it, and `buttonLabel()` supplies the letter printed
+ * on it. So a Switch Pro (which prints `A` on the RIGHT button and `B` on the bottom) still highlights
+ * the bottom button for confirm — only the lettering shifts. Getting that backwards is the single most
+ * likely way a controller diagram lies to a rider.
+ *
+ * There are deliberately TWO lookups, because "which part lights up" and "which part a callout line
+ * points at" are not the same question — see {@link litPartOfButton} and {@link anchorPartOfToken}.
+ */
+import type { ButtonName } from "../../protocol/buttons.js";
+import { type ComboToken, type ControlAction, type ControlName, type ShellControl } from "./tokens.js";
+import { type PadLayout, type PadPart, type PartGeom } from "./types.js";
+/**
+ * Which part to LIGHT when a button is held.
+ *
+ * Partial on purpose: the right stick's digital directions (`RUP`/`RDOWN`/`RLEFT`/`RRIGHT`) map to
+ * nothing here. Lighting the stick's *click* for a *direction* would be a lie, and the truthful visual
+ * already exists — the cap physically moves, driven by the `RX`/`RY` axes, which the platform emits for
+ * every controller (quantized to the endpoints on non-hall hardware, and synthesized from the numpad on
+ * a keyboard). So a right-stick direction shows up as deflection, not as a highlight.
+ *
+ * `OPTIONS` lands on `start`, the button labelled "Options" on a DualSense and "Menu" on an Xbox pad —
+ * the game's own menu button. The shell's overlay menu is a different key and never reaches a game.
+ */
+export declare const LIT_PART_OF_BUTTON: Readonly<Partial<Record<ButtonName, PadPart>>>;
+/**
+ * The shell-owned controls, which have no {@link ButtonName} but do have a place on the drawing: the
+ * upper shoulders ARE the rider's resistance − / +.
+ *
+ * Kept separate from {@link LIT_PART_OF_BUTTON} so that nothing which walks the game vocabulary can
+ * accidentally light them — a game never receives these, and the drawing renders them faint by default
+ * (see `SHELL_OWNED_PARTS`). Only an explicit opt-in lets them light, which is exactly what a lesson
+ * teaching the rider where they are needs.
+ */
+export declare const PART_OF_SHELL_CONTROL: Readonly<Record<ShellControl, PadPart>>;
+export declare function litPartOfButton(name: ButtonName): PadPart | undefined;
+/** The part to light for any control — game button or shell-owned. */
+export declare function litPartOfControl(name: ControlName): PadPart | undefined;
+/** The four canonical directions the LEFT stick shares with the d-pad, and their axis signs. */
+export declare const DPAD_DIRECTIONS: Readonly<Record<"UP" | "DOWN" | "LEFT" | "RIGHT", readonly [number, number]>>;
+/**
+ * Which part a callout LINE should point at.
+ *
+ * Differs from {@link litPartOfButton} in exactly one way: a right-stick direction (or a bare stick
+ * token) resolves to that stick, because "this action uses the right stick" is precisely what the line
+ * should be saying — even though a *direction* shouldn't light the stick's click.
+ */
+export declare function anchorPartOfToken(token: ComboToken): PadPart | undefined;
+/**
+ * The movement controls that many actions share, so a callout line to one of them says nothing useful.
+ *
+ * Both sticks (whole or directional), both stick clicks, the d-pad, and the right-stick directions. In a
+ * game where the left stick steers, half the actions mention it; anchoring all their lines there makes a
+ * hairball around one part, while the distinctive button in each combination is what actually identifies
+ * the action.
+ */
+export declare function isGenericToken(token: ComboToken): boolean;
+/**
+ * Which token the callout line points at: **the first non-generic token**, falling back to the first
+ * token when every one of them is generic.
+ *
+ *     ["LSTICK_PRESS", "LT"]  → LT              (the distinctive button, not the shared stick)
+ *     ["LSTICK:left", "RT"]   → RT
+ *     ["LT", "DIAMOND_DOWN"]  → LT              (first, since neither is generic)
+ *     ["LSTICK"]              → LSTICK          (all generic → the first, so "Move" points at the stick)
+ *     ["DIAMOND_DOWN"]        → DIAMOND_DOWN
+ *
+ * `action.anchor` overrides this outright, so the rule is a sensible default rather than a ceiling.
+ */
+export declare function anchorTokenOf(action: ControlAction): ComboToken | undefined;
+/**
+ * The geometry of a drawn part in a given layout, or `undefined` when that layout has no such part (a
+ * Zwift pod has no sticks, no triggers and no system buttons).
+ *
+ * Stick clicks are synthesised from the {@link StickSpec} — the cap circle — since they have no
+ * `PartSpec` of their own.
+ */
+export declare function partGeomOf(layout: PadLayout, part: PadPart): PartGeom | undefined;
+/** Where a part sits in the layout's own viewBox units, for ordering and side placement. */
+export declare function partCentreOf(layout: PadLayout, part: PadPart): {
+    x: number;
+    y: number;
+} | undefined;
+/**
+ * Which column a callout belongs in: the side of the pad its anchor is physically on.
+ *
+ * Derived from the layout rather than hardcoded per brand, so it stays right across four very different
+ * control arrangements — Xbox's diagonal offset, DualSense's symmetric sticks, and the two-pod shapes —
+ * and for any layout added later.
+ */
+export declare function sideOfPart(layout: PadLayout, part: PadPart): "left" | "right";
+//# sourceMappingURL=parts-map.d.ts.map

package/dist/ui/controller/parts-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts-map.d.ts","sourceRoot":"","sources":["../../../src/ui/controller/parts-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAA8B,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACnI,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAc7E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAGzE,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAErE;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAEvE;AAED,gGAAgG;AAChG,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAKzG,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAYxE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAkBzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS,CAG3E;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CA0BjF;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAGnG;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAI7E"}

package/dist/ui/controller/parts-map.js

@@ -0,0 +1,187 @@
+/**
+ * Canonical input → drawn position. This module is where "the game said `DIAMOND_DOWN`" becomes "light
+ * the bottom face button", and it is the reason one action list draws correctly on every controller.
+ *
+ * **It maps to POSITIONS, never to letters.** `DIAMOND_DOWN` → `faceBottom` on every pad; each layout
+ * places `faceBottom` where that brand actually puts it, and `buttonLabel()` supplies the letter printed
+ * on it. So a Switch Pro (which prints `A` on the RIGHT button and `B` on the bottom) still highlights
+ * the bottom button for confirm — only the lettering shifts. Getting that backwards is the single most
+ * likely way a controller diagram lies to a rider.
+ *
+ * There are deliberately TWO lookups, because "which part lights up" and "which part a callout line
+ * points at" are not the same question — see {@link litPartOfButton} and {@link anchorPartOfToken}.
+ */
+import { isShellControl, parseToken } from "./tokens.js";
+import { partCentre } from "./types.js";
+/**
+ * Which part to LIGHT when a button is held.
+ *
+ * Partial on purpose: the right stick's digital directions (`RUP`/`RDOWN`/`RLEFT`/`RRIGHT`) map to
+ * nothing here. Lighting the stick's *click* for a *direction* would be a lie, and the truthful visual
+ * already exists — the cap physically moves, driven by the `RX`/`RY` axes, which the platform emits for
+ * every controller (quantized to the endpoints on non-hall hardware, and synthesized from the numpad on
+ * a keyboard). So a right-stick direction shows up as deflection, not as a highlight.
+ *
+ * `OPTIONS` lands on `start`, the button labelled "Options" on a DualSense and "Menu" on an Xbox pad —
+ * the game's own menu button. The shell's overlay menu is a different key and never reaches a game.
+ */
+export const LIT_PART_OF_BUTTON = {
+    UP: "dpadUp",
+    DOWN: "dpadDown",
+    LEFT: "dpadLeft",
+    RIGHT: "dpadRight",
+    DIAMOND_UP: "faceTop",
+    DIAMOND_RIGHT: "faceRight",
+    DIAMOND_DOWN: "faceBottom",
+    DIAMOND_LEFT: "faceLeft",
+    LT: "lt",
+    RT: "rt",
+    LSTICK_PRESS: "lstickPress",
+    RSTICK_PRESS: "rstickPress",
+    OPTIONS: "start",
+};
+/**
+ * The shell-owned controls, which have no {@link ButtonName} but do have a place on the drawing: the
+ * upper shoulders ARE the rider's resistance − / +.
+ *
+ * Kept separate from {@link LIT_PART_OF_BUTTON} so that nothing which walks the game vocabulary can
+ * accidentally light them — a game never receives these, and the drawing renders them faint by default
+ * (see `SHELL_OWNED_PARTS`). Only an explicit opt-in lets them light, which is exactly what a lesson
+ * teaching the rider where they are needs.
+ */
+export const PART_OF_SHELL_CONTROL = {
+    LB: "lb",
+    RB: "rb",
+};
+export function litPartOfButton(name) {
+    return LIT_PART_OF_BUTTON[name];
+}
+/** The part to light for any control — game button or shell-owned. */
+export function litPartOfControl(name) {
+    return isShellControl(name) ? PART_OF_SHELL_CONTROL[name] : LIT_PART_OF_BUTTON[name];
+}
+/** The four canonical directions the LEFT stick shares with the d-pad, and their axis signs. */
+export const DPAD_DIRECTIONS = {
+    UP: [0, 1],
+    DOWN: [0, -1],
+    LEFT: [-1, 0],
+    RIGHT: [1, 0],
+};
+/**
+ * Which part a callout LINE should point at.
+ *
+ * Differs from {@link litPartOfButton} in exactly one way: a right-stick direction (or a bare stick
+ * token) resolves to that stick, because "this action uses the right stick" is precisely what the line
+ * should be saying — even though a *direction* shouldn't light the stick's click.
+ */
+export function anchorPartOfToken(token) {
+    const t = parseToken(token);
+    if (t.kind === "stick")
+        return t.stick === "LSTICK" ? "lstickPress" : "rstickPress";
+    switch (t.name) {
+        case "RUP":
+        case "RDOWN":
+        case "RLEFT":
+        case "RRIGHT":
+            return "rstickPress";
+        default:
+            return litPartOfControl(t.name);
+    }
+}
+/**
+ * The movement controls that many actions share, so a callout line to one of them says nothing useful.
+ *
+ * Both sticks (whole or directional), both stick clicks, the d-pad, and the right-stick directions. In a
+ * game where the left stick steers, half the actions mention it; anchoring all their lines there makes a
+ * hairball around one part, while the distinctive button in each combination is what actually identifies
+ * the action.
+ */
+export function isGenericToken(token) {
+    const t = parseToken(token);
+    if (t.kind === "stick")
+        return true;
+    switch (t.name) {
+        case "UP":
+        case "DOWN":
+        case "LEFT":
+        case "RIGHT":
+        case "RUP":
+        case "RDOWN":
+        case "RLEFT":
+        case "RRIGHT":
+        case "LSTICK_PRESS":
+        case "RSTICK_PRESS":
+            return true;
+        default:
+            return false;
+    }
+}
+/**
+ * Which token the callout line points at: **the first non-generic token**, falling back to the first
+ * token when every one of them is generic.
+ *
+ *     ["LSTICK_PRESS", "LT"]  → LT              (the distinctive button, not the shared stick)
+ *     ["LSTICK:left", "RT"]   → RT
+ *     ["LT", "DIAMOND_DOWN"]  → LT              (first, since neither is generic)
+ *     ["LSTICK"]              → LSTICK          (all generic → the first, so "Move" points at the stick)
+ *     ["DIAMOND_DOWN"]        → DIAMOND_DOWN
+ *
+ * `action.anchor` overrides this outright, so the rule is a sensible default rather than a ceiling.
+ */
+export function anchorTokenOf(action) {
+    if (action.anchor)
+        return action.anchor;
+    return action.combo.find((t) => !isGenericToken(t)) ?? action.combo[0];
+}
+/**
+ * The geometry of a drawn part in a given layout, or `undefined` when that layout has no such part (a
+ * Zwift pod has no sticks, no triggers and no system buttons).
+ *
+ * Stick clicks are synthesised from the {@link StickSpec} — the cap circle — since they have no
+ * `PartSpec` of their own.
+ */
+export function partGeomOf(layout, part) {
+    switch (part) {
+        case "dpadUp": return layout.dpad?.up.geom;
+        case "dpadDown": return layout.dpad?.down.geom;
+        case "dpadLeft": return layout.dpad?.left.geom;
+        case "dpadRight": return layout.dpad?.right.geom;
+        case "faceTop": return layout.face.top.geom;
+        case "faceRight": return layout.face.right.geom;
+        case "faceBottom": return layout.face.bottom.geom;
+        case "faceLeft": return layout.face.left.geom;
+        case "lb": return layout.bumpers?.l.geom;
+        case "rb": return layout.bumpers?.r.geom;
+        case "lt": return layout.triggers?.l.geom;
+        case "rt": return layout.triggers?.r.geom;
+        case "start": return layout.system?.start?.geom;
+        case "select": return layout.system?.select?.geom;
+        case "home": return layout.system?.home?.geom;
+        case "lstickPress": {
+            const s = layout.sticks?.l;
+            return s && { kind: "circle", cx: s.cx, cy: s.cy, r: s.cap };
+        }
+        case "rstickPress": {
+            const s = layout.sticks?.r;
+            return s && { kind: "circle", cx: s.cx, cy: s.cy, r: s.cap };
+        }
+    }
+}
+/** Where a part sits in the layout's own viewBox units, for ordering and side placement. */
+export function partCentreOf(layout, part) {
+    const geom = partGeomOf(layout, part);
+    return geom && partCentre(geom);
+}
+/**
+ * Which column a callout belongs in: the side of the pad its anchor is physically on.
+ *
+ * Derived from the layout rather than hardcoded per brand, so it stays right across four very different
+ * control arrangements — Xbox's diagonal offset, DualSense's symmetric sticks, and the two-pod shapes —
+ * and for any layout added later.
+ */
+export function sideOfPart(layout, part) {
+    const centre = partCentreOf(layout, part);
+    const midX = layout.viewBox[0] + layout.viewBox[2] / 2;
+    return (centre?.x ?? midX) < midX ? "left" : "right";
+}
+//# sourceMappingURL=parts-map.js.map

package/dist/ui/controller/parts-map.js.map

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

package/dist/ui/controller/styles.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Scoped `.rydr-pad-*` CSS for the controller family — the pad drawing, the input chips, the static
+ * controller map and the combo demo — injected once into `<head>`.
+ *
+ * Self-contained like the rest of `@rydr/game-sdk/ui`: no global styles, no dependence on host CSS
+ * variables, no font loading. The pad's own tokens (`--pad-body`, `--pad-accent`, …) are declared on
+ * `.rydr-pad` itself, so a caller theming the accent sets ONE property via the `accent` option rather
+ * than reaching into this stylesheet.
+ *
+ * Ported from the platform shell's `rydr-controller-diagram.ts`, with `:host` rewritten to `.rydr-pad`
+ * and every internal class prefixed — the shell had shadow DOM to scope bare `.part` / `.shape` names;
+ * we don't, so the prefix IS the scoping.
+ *
+ * The type sizes and dimensions here are tuned for a **trainer screen read from a few feet away while
+ * pedaling**, exactly as the rest of the kit. They are part of the contract, not defaults to override.
+ */
+/** Force the controller CSS into `<head>`. Components call this for you; idempotent. */
+export declare function injectPadCss(): void;
+//# sourceMappingURL=styles.d.ts.map

package/dist/ui/controller/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/ui/controller/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,wFAAwF;AACxF,wBAAgB,YAAY,IAAI,IAAI,CAUnC"}