@rydr/game-sdk 7.0.0 → 7.1.0

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

@@ -0,0 +1,82 @@
+/**
+ * CONTROLLER MAP — the static "here are your controls" view: the live pad, flanked by callout cards, each
+ * joined by a line to the button it belongs to.
+ *
+ * ```ts
+ * const map = mountControllerMap(host, {
+ *   press: session,
+ *   actions: [
+ *     { label: "Se déplacer", combo: ["LSTICK"] },
+ *     { label: "Freiner",     combo: ["LT"] },
+ *     { label: "Tir chargé",  combo: ["RT", "DIAMOND_DOWN"] },
+ *     { label: "Dash",        combo: ["LT", "LSTICK:left"] },
+ *   ],
+ * });
+ * ```
+ *
+ * **It is an inline widget, not a screen.** It renders a self-sized block into whatever host you give it
+ * — no fixed positioning, no backdrop, no close button, no back-button handling. Whether that host is a
+ * pause overlay, a pre-race panel or a settings tab is the game's call, same as every other component in
+ * the kit. For a pause overlay, own the host yourself:
+ *
+ * ```ts
+ * const overlay = document.createElement("div");
+ * overlay.style.cssText = "position:fixed; inset:0; display:grid; place-items:center; background:rgba(4,8,14,.72)";
+ * document.body.appendChild(overlay);
+ * mountControllerMap(overlay, { press: session, actions });
+ * ```
+ *
+ * The one genuinely new mechanic here is the **connector layer**. The lines join DOM cards to SVG nodes,
+ * so they can't live in the pad's own viewBox — they're drawn in page-pixel space from measured
+ * rectangles. Re-routing is therefore layout-dependent and is triggered by a `ResizeObserver` on the root
+ * *and on every card* (a label wrapping to two lines moves every card below it), by `document.fonts.ready`
+ * (a web font swapping in reflows labels after first paint), and by a pad re-letter. Every trigger is
+ * coalesced into a single `requestAnimationFrame` — this never runs per frame.
+ */
+import type { ButtonName } from "../../protocol/buttons.js";
+import type { GlyphSet } from "../../protocol/glyphs.js";
+import type { StickPictogramStyle } from "./input-chip.js";
+import { type ControllerPad, type PadInputSource } from "./controller-pad.js";
+import type { ControlAction } from "./tokens.js";
+import type { PadBrandKey } from "./types.js";
+export interface ControllerMapOptions {
+    /** What the rider can do, and what they press to do it. */
+    actions: readonly ControlAction[];
+    /**
+     * The rider's input source. Used for the LETTERING (and to re-letter on a pad swap) even when
+     * {@link live} is false — a controls screen must print the letters on the pad actually in their hands.
+     */
+    press?: PadInputSource;
+    /**
+     * Reflect real presses: light the pad and sink the matching chips as the rider presses. **Default
+     * false** — this is a reference diagram, and it stays legible precisely by not moving. A rider
+     * resting a thumb on a stick would otherwise light half the drawing while they are trying to read it.
+     * Pass `true` where a live "watch it respond" affordance is the point.
+     */
+    live?: boolean;
+    brand?: PadBrandKey;
+    glyphSet?: GlyphSet;
+    /** Draw the pad's own button letters. Default true. */
+    labels?: boolean;
+    /** Per-role hue on face keycaps in the chips (confirm green, back amber). Default true. */
+    colored?: boolean;
+    /** Drawing convention for the joystick pictograms in the chips. See {@link StickPictogramStyle}. */
+    stickStyle?: StickPictogramStyle;
+    /** Pad size preset. Default `"lg"` — this view is meant to be read. */
+    size?: "sm" | "md" | "lg";
+    accent?: string;
+    /** Optional heading above the pad. */
+    title?: string;
+    /** Buttons the rider's device actually has; the rest are drawn faint. See `ControllerPadOptions`. */
+    available?: readonly ButtonName[];
+}
+export interface ControllerMap {
+    readonly root: HTMLDivElement;
+    readonly pad: ControllerPad;
+    /** Replace the action list. Rebuilds the callouts and re-routes the lines. */
+    setActions(actions: readonly ControlAction[]): void;
+    setVisible(on: boolean): void;
+    dispose(): void;
+}
+export declare function mountControllerMap(host: HTMLElement, opts: ControllerMapOptions): ControllerMap;
+//# sourceMappingURL=controller-map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controller-map.d.ts","sourceRoot":"","sources":["../../../src/ui/controller/controller-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAsB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGlG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oGAAoG;IACpG,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,uEAAuE;IACvE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qGAAqG;IACrG,SAAS,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,8EAA8E;IAC9E,UAAU,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CAAC;IACpD,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,OAAO,IAAI,IAAI,CAAC;CACjB;AA4BD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,oBAAoB,GAAG,aAAa,CAmQ/F"}

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

@@ -0,0 +1,291 @@
+/**
+ * CONTROLLER MAP — the static "here are your controls" view: the live pad, flanked by callout cards, each
+ * joined by a line to the button it belongs to.
+ *
+ * ```ts
+ * const map = mountControllerMap(host, {
+ *   press: session,
+ *   actions: [
+ *     { label: "Se déplacer", combo: ["LSTICK"] },
+ *     { label: "Freiner",     combo: ["LT"] },
+ *     { label: "Tir chargé",  combo: ["RT", "DIAMOND_DOWN"] },
+ *     { label: "Dash",        combo: ["LT", "LSTICK:left"] },
+ *   ],
+ * });
+ * ```
+ *
+ * **It is an inline widget, not a screen.** It renders a self-sized block into whatever host you give it
+ * — no fixed positioning, no backdrop, no close button, no back-button handling. Whether that host is a
+ * pause overlay, a pre-race panel or a settings tab is the game's call, same as every other component in
+ * the kit. For a pause overlay, own the host yourself:
+ *
+ * ```ts
+ * const overlay = document.createElement("div");
+ * overlay.style.cssText = "position:fixed; inset:0; display:grid; place-items:center; background:rgba(4,8,14,.72)";
+ * document.body.appendChild(overlay);
+ * mountControllerMap(overlay, { press: session, actions });
+ * ```
+ *
+ * The one genuinely new mechanic here is the **connector layer**. The lines join DOM cards to SVG nodes,
+ * so they can't live in the pad's own viewBox — they're drawn in page-pixel space from measured
+ * rectangles. Re-routing is therefore layout-dependent and is triggered by a `ResizeObserver` on the root
+ * *and on every card* (a label wrapping to two lines moves every card below it), by `document.fonts.ready`
+ * (a web font swapping in reflows labels after first paint), and by a pad re-letter. Every trigger is
+ * coalesced into a single `requestAnimationFrame` — this never runs per frame.
+ */
+import { buildCard } from "../card.js";
+import { createComboStrip } from "./combo-strip.js";
+import { mountControllerPad } from "./controller-pad.js";
+import { anchorPartOfToken, anchorTokenOf, partCentreOf, sideOfPart } from "./parts-map.js";
+import { injectPadCss } from "./styles.js";
+const NS = "http://www.w3.org/2000/svg";
+/**
+ * Beyond this many callouts per side the lines get dense and the cards squeeze. The component still
+ * renders — it warns rather than truncating, because silently dropping a control from a controls screen
+ * is worse than a crowded one.
+ */
+const SOFT_CAP_PER_SIDE = 5;
+/**
+ * The pad column's width per size preset. Upper bounds match the `.rydr-pad.sm/.md/.lg` max-widths; the
+ * `clamp` lets the pad shrink on a narrow host instead of squeezing the callout columns to nothing.
+ */
+const PAD_COL_WIDTH = {
+    sm: "clamp(150px, 20vw, 220px)",
+    md: "clamp(190px, 28vw, 340px)",
+    lg: "clamp(220px, 34vw, 460px)",
+};
+export function mountControllerMap(host, opts) {
+    injectPadCss();
+    const root = document.createElement("div");
+    root.className = "rydr-padmap";
+    // The shared card padding is asymmetric by default to seat a straddling keycap; these callouts have
+    // none, so even padding reads better. Set on the ancestor, which is the documented way to retune it.
+    root.style.setProperty("--rydr-ui-card-pad", "12px 16px 14px");
+    let titleEl;
+    if (opts.title) {
+        titleEl = document.createElement("h3");
+        titleEl.className = "rydr-padmap-title";
+        titleEl.textContent = opts.title;
+        root.appendChild(titleEl);
+    }
+    // The pad column needs a DEFINITE width (see styles.ts) — derive it from the size preset rather than
+    // letting an `auto` track and a `width:100%` SVG try to size each other.
+    const size = opts.size ?? "lg";
+    root.style.setProperty("--rydr-padmap-pad-w", PAD_COL_WIDTH[size]);
+    const leftCol = document.createElement("ul");
+    leftCol.className = "rydr-padmap-col left";
+    const padCell = document.createElement("div");
+    padCell.className = "rydr-padmap-padcell";
+    const rightCol = document.createElement("ul");
+    rightCol.className = "rydr-padmap-col right";
+    root.appendChild(leftCol);
+    root.appendChild(padCell);
+    root.appendChild(rightCol);
+    const lines = document.createElementNS(NS, "svg");
+    lines.setAttribute("class", "rydr-padmap-lines");
+    lines.setAttribute("aria-hidden", "true");
+    root.appendChild(lines);
+    host.appendChild(root);
+    // Glyph-only unless `live`: the pad still learns the rider's lettering and follows a pad swap, but its
+    // inert `onButton` means nothing reflects presses.
+    const padPress = opts.press && (opts.live ? opts.press : { onButton: () => () => { }, hardware: opts.press.hardware });
+    const pad = mountControllerPad(padCell, {
+        press: padPress,
+        brand: opts.brand,
+        glyphSet: opts.glyphSet,
+        size: opts.size ?? "lg",
+        labels: opts.labels,
+        accent: opts.accent,
+        available: opts.available,
+    });
+    let callouts = [];
+    let warnedCap = false;
+    // ── routing ─────────────────────────────────────────────────────────────────────────────────────
+    let routeQueued = 0;
+    function queueRoute() {
+        if (routeQueued)
+            return;
+        routeQueued = requestAnimationFrame(() => {
+            routeQueued = 0;
+            route();
+        });
+    }
+    function route() {
+        const rootRect = root.getBoundingClientRect();
+        if (rootRect.width < 1 || rootRect.height < 1)
+            return; // not laid out yet (hidden host, etc.)
+        // The narrow-host media query stacks the columns and hides this layer; don't compute geometry for
+        // something nobody can see.
+        if (getComputedStyle(lines).display === "none")
+            return;
+        lines.setAttribute("viewBox", `0 0 ${rootRect.width} ${rootRect.height}`);
+        lines.setAttribute("width", String(rootRect.width));
+        lines.setAttribute("height", String(rootRect.height));
+        lines.textContent = "";
+        const parts = pad.svg().parts;
+        // Stagger the elbow per card WITHIN its column so parallel runs don't overlap into one thick line.
+        const seen = { left: 0, right: 0 };
+        for (const c of callouts) {
+            const partNode = c.anchorPart ? parts.get(c.anchorPart) : undefined;
+            if (!partNode)
+                continue; // this layout has no such part (a Zwift pod has no sticks)
+            const pr = partNode.getBoundingClientRect();
+            const cr = c.li.getBoundingClientRect();
+            if (pr.width < 1 || cr.width < 1)
+                continue;
+            const i = seen[c.side]++;
+            const leftward = c.side === "left";
+            const from = {
+                x: (leftward ? cr.right : cr.left) - rootRect.left,
+                y: cr.top - rootRect.top + cr.height / 2,
+            };
+            // Stop at the button's NEAR EDGE, not its centre, so the terminating dot marks the control
+            // without sitting on top of its letter.
+            const to = {
+                x: (leftward ? pr.left - 4 : pr.right + 4) - rootRect.left,
+                y: pr.top - rootRect.top + pr.height / 2,
+            };
+            // The elbow MUST land between the two endpoints. Clamping it against the TARGET alone (which is
+            // what this did) can put it behind `from`, and the polyline then juts backwards out of the card
+            // before doubling back on itself — a visibly broken line. Clamping to the span can't do that.
+            const lo = Math.min(from.x, to.x) + 2;
+            const hi = Math.max(from.x, to.x) - 2;
+            const spur = leftward ? from.x + (10 + i * 8) : from.x - (10 + i * 8);
+            const elbowX = hi <= lo ? (from.x + to.x) / 2 : Math.min(hi, Math.max(lo, spur));
+            // A card sitting level with its button needs a straight line, not a 4-point path with a
+            // zero-length riser — which is what produced the kinked stub at the join.
+            const level = Math.abs(from.y - to.y) < 2;
+            const p = (x, y) => `${x.toFixed(1)},${y.toFixed(1)}`;
+            const poly = document.createElementNS(NS, "polyline");
+            poly.setAttribute("class", "rydr-padmap-line" + (c.action.disabled ? " dim" : ""));
+            poly.setAttribute("points", level
+                ? `${p(from.x, from.y)} ${p(to.x, to.y)}`
+                : `${p(from.x, from.y)} ${p(elbowX, from.y)} ${p(elbowX, to.y)} ${p(to.x, to.y)}`);
+            lines.appendChild(poly);
+            // A DOT, not an arrowhead. See `.rydr-padmap-dot` in styles.ts for why.
+            const dot = document.createElementNS(NS, "circle");
+            dot.setAttribute("class", "rydr-padmap-dot" + (c.action.disabled ? " dim" : ""));
+            dot.setAttribute("cx", to.x.toFixed(1));
+            dot.setAttribute("cy", to.y.toFixed(1));
+            dot.setAttribute("r", "2.9");
+            lines.appendChild(dot);
+        }
+    }
+    // ── callouts ────────────────────────────────────────────────────────────────────────────────────
+    const cardObserver = new ResizeObserver(() => queueRoute());
+    function clearCallouts() {
+        cardObserver.disconnect();
+        for (const c of callouts) {
+            c.strip.dispose();
+            c.disposeCard();
+            c.li.remove();
+        }
+        callouts = [];
+    }
+    function buildCallouts(actions) {
+        clearCallouts();
+        const layout = pad.layout();
+        const prepared = actions.map((action) => {
+            const token = anchorTokenOf(action);
+            const anchorPart = token ? anchorPartOfToken(token) : undefined;
+            const side = action.side ?? (anchorPart ? sideOfPart(layout, anchorPart) : "left");
+            // Order down the column by the anchor's height on the pad, so lines run roughly parallel and
+            // don't cross. Anchorless actions sink to the bottom.
+            const order = (anchorPart ? partCentreOf(layout, anchorPart)?.y : undefined) ?? Number.MAX_SAFE_INTEGER;
+            return { action, anchorPart, side, order };
+        });
+        prepared.sort((a, b) => a.order - b.order);
+        for (const p of prepared) {
+            const li = document.createElement("li");
+            li.className = "rydr-padmap-item" + (p.action.disabled ? " disabled" : "");
+            const box = document.createElement("div");
+            box.className = "rydr-padmap-callout";
+            const label = document.createElement("div");
+            label.className = "rydr-padmap-label";
+            label.textContent = p.action.label;
+            box.appendChild(label);
+            if (p.action.hint) {
+                const hint = document.createElement("div");
+                hint.className = "rydr-padmap-hint";
+                hint.textContent = p.action.hint;
+                box.appendChild(hint);
+            }
+            const strip = createComboStrip(p.action, {
+                glyphSet: opts.glyphSet ?? pad.glyphSet(),
+                press: opts.live ? opts.press : undefined,
+                colored: opts.colored,
+                stickStyle: opts.stickStyle,
+            });
+            box.appendChild(strip.el);
+            const card = buildCard({ inline: true, content: box });
+            if (p.action.disabled)
+                card.setDisabled(true);
+            li.appendChild(card.root);
+            (p.side === "left" ? leftCol : rightCol).appendChild(li);
+            cardObserver.observe(li);
+            callouts.push({
+                action: p.action,
+                li,
+                strip,
+                disposeCard: card.dispose,
+                anchorPart: p.anchorPart,
+                side: p.side,
+            });
+        }
+        // Un-dim any control an action actually names. `SHELL_OWNED_PARTS` draws the bumpers / View / Guide
+        // faint because they are not a GAME's to use — but when a callout points at one it is the subject of
+        // the screen, and drawing the subject at 40% reads as "disabled". The shell's own resistance map is
+        // exactly that case.
+        const referenced = new Set();
+        for (const c of callouts) {
+            for (const token of c.action.combo) {
+                const part = anchorPartOfToken(token);
+                if (part)
+                    referenced.add(part);
+            }
+        }
+        for (const [name, node] of pad.svg().parts)
+            node.classList.toggle("referenced", referenced.has(name));
+        const perSide = { left: 0, right: 0 };
+        for (const c of callouts)
+            perSide[c.side]++;
+        if (!warnedCap && (perSide.left > SOFT_CAP_PER_SIDE || perSide.right > SOFT_CAP_PER_SIDE)) {
+            warnedCap = true;
+            console.warn(`[rydr/ui] mountControllerMap: ${perSide.left} left / ${perSide.right} right callouts — the ` +
+                `layout is tuned for up to ${SOFT_CAP_PER_SIDE} per side. Nothing is dropped, but consider ` +
+                `splitting the list across screens or setting \`side\` to rebalance.`);
+        }
+        queueRoute();
+    }
+    buildCallouts(opts.actions);
+    const rootObserver = new ResizeObserver(() => queueRoute());
+    rootObserver.observe(root);
+    // A web font swapping in after first paint re-wraps every label, which moves every card.
+    void document.fonts?.ready.then(() => queueRoute()).catch(() => { });
+    // A pad swap rebuilds the drawing, so the cached part nodes we measure are new ones.
+    const offRebuild = pad.onRebuild(() => {
+        buildCallouts(callouts.map((c) => c.action));
+    });
+    return {
+        root,
+        pad,
+        setActions(actions) {
+            buildCallouts(actions);
+        },
+        setVisible(on) {
+            root.style.display = on ? "" : "none";
+            if (on)
+                queueRoute();
+        },
+        dispose() {
+            if (routeQueued)
+                cancelAnimationFrame(routeQueued);
+            rootObserver.disconnect();
+            offRebuild();
+            clearCallouts();
+            pad.dispose();
+            root.remove();
+        },
+    };
+}
+//# sourceMappingURL=controller-map.js.map

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

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

package/dist/ui/controller/controller-pad.d.ts

@@ -0,0 +1,122 @@
+/**
+ * CONTROLLER PAD — the live drawing of the controller in the rider's hands.
+ *
+ * ```ts
+ * const pad = mountControllerPad(host, { press: session, size: "lg" });
+ * // …buttons light as they're pressed, stick caps follow the real axes. Nothing to call per frame.
+ * pad.dispose();
+ * ```
+ *
+ * This is the game-side counterpart of the shell's own controller diagram, and it is deliberately fed by
+ * **canonical input, not raw hardware**: a game never sees gamepad indices, per-device bindings or analog
+ * trigger travel, so this module translates `ButtonName` → drawn position (`parts-map.ts`) and polls
+ * `session.axis()` for the sticks. Three consequences worth knowing:
+ *
+ * 1. **Axes are polled, buttons are not.** `onButton` is an edge stream, so presses cost nothing between
+ *    events; axes have no event, so when the source exposes `axis()` the pad runs its own
+ *    `requestAnimationFrame` loop. It stops on `dispose()` and while the tab is hidden, and the
+ *    `PadDriver` dirty-guard means an idle stick performs zero DOM writes per frame.
+ *
+ * 2. **The d-pad is shared with the left stick.** `UP`/`DOWN`/`LEFT`/`RIGHT` are emitted by the d-pad
+ *    *and* by the left stick past its deadzone (see `protocol/buttons.ts`), and nothing in the canonical
+ *    stream says which. When `axis()` is available we suppress the d-pad highlight for a direction the
+ *    stick already explains — so pushing the stick moves the cap instead of falsely lighting the d-pad.
+ *    Without `axis()` the d-pad lights for both, which is the honest best we can do.
+ *
+ * 3. **Triggers are clicks.** `LT`/`RT` have no analog travel in this protocol, so their travel meters
+ *    are driven 0/1 from button state.
+ *
+ * It also **re-letters itself.** A keycap resolves its glyph set once, on the reasoning that keycaps are
+ * cheap to recreate; a controls screen is long-lived and `/hardware` is exactly where a rider swaps pads.
+ * So if the source exposes `hardware.subscribe`, the pad rebuilds its drawing in place when the resolved
+ * set changes, restoring anything currently held. Callers keep their handle and need to know nothing.
+ */
+import type { AxisName, ButtonEdge, ButtonName } from "../../protocol/buttons.js";
+import { type GlyphSet } from "../../protocol/glyphs.js";
+import { type PadDriver, type PadSvg } from "./pad-svg.js";
+import type { ControlName } from "./tokens.js";
+import type { PadBrandKey, PadLayout } from "./types.js";
+/**
+ * The slice of a `PlatformSession` the controller views consume. A session satisfies it structurally —
+ * just pass `session`. Everything but `onButton` is optional so a hand-rolled stub or a showcase double
+ * works too; the pad simply does less with less.
+ */
+export interface PadInputSource {
+    /**
+     * Typed on {@link ControlName} — a superset of `ButtonName` that also covers the shell-owned controls.
+     *
+     * A `PlatformSession` only ever emits the `ButtonName` subset and still satisfies this, while a
+     * SHELL-side source can hand the same object to both this and `mountControlTrainer`. They used to
+     * take different shapes, which meant a caller with one source could feed the lesson but not the map.
+     */
+    onButton(cb: (e: {
+        name: ControlName;
+        edge: ButtonEdge;
+    }) => void): () => void;
+    /** Analog stick positions, −1..1 (right = +1, up = +1). Present → the sticks and cap glow come alive. */
+    axis?(name: AxisName): number;
+    /** Currently-held buttons, for showing the right state immediately on mount instead of on next press. */
+    buttonsDown?(): ButtonName[];
+    /** The hardware store — read for the rider's glyph set, subscribed to for pad swaps. */
+    hardware?: {
+        current: {
+            glyphSet?: GlyphSet;
+        };
+        subscribe?(cb: (snapshot: {
+            glyphSet?: GlyphSet;
+        }) => void): () => void;
+    };
+}
+export interface ControllerPadOptions {
+    /** Wire to real input. Omit for static art. */
+    press?: PadInputSource;
+    /** Force a silhouette. Default: derived from the glyph set (`"joycon"` is only reachable this way). */
+    brand?: PadBrandKey;
+    /**
+     * Force the lettering. Default: the set reported by `press`, else `"xbox"`. Setting this explicitly
+     * also PINS it — the pad stops following pad swaps, which is what a settings preview wants.
+     */
+    glyphSet?: GlyphSet;
+    /** Max width preset. Default `"md"` (340px). */
+    size?: "sm" | "md" | "lg";
+    /** Draw the face/trigger/bumper letters on the art. Default true. */
+    labels?: boolean;
+    /** Dim the whole drawing and skip the input subscription — a placeholder or a backdrop. */
+    ghost?: boolean;
+    /** Accent colour for pressed parts. Themed through this option, never by overriding the CSS. */
+    accent?: string;
+    /**
+     * Buttons the rider's device actually has; everything else is drawn faint.
+     *
+     * Opt-in because the protocol cannot tell us: `HardwareSnapshot` reports `controllerConnected` and
+     * `glyphSet` but not a button inventory, while `protocol/buttons.ts` warns that a phone exposes only
+     * the `DIAMOND_DOWN`/`DIAMOND_RIGHT` pair. Pass it when your game knows better.
+     */
+    available?: readonly ButtonName[];
+    /**
+     * Let the drawing light the shell-owned controls (the resistance bumpers, View, Guide).
+     *
+     * Off by default and normally correct that way: a game never receives them, so lighting them would
+     * tell the rider something untrue. The legitimate caller is a lesson that TEACHES those controls —
+     * `mountControlTrainer` sets it when a step names one.
+     */
+    allowShellOwned?: boolean;
+}
+export interface ControllerPad {
+    readonly root: HTMLDivElement;
+    /** The current drawing's node cache. Replaced on a re-letter — don't hold onto it across one. */
+    svg(): PadSvg;
+    driver(): PadDriver;
+    layout(): PadLayout;
+    /**
+     * The lettering currently drawn. Read it rather than re-deriving: anything built alongside the pad
+     * (the map's chips) must use the SAME set, or a pad swap leaves the two disagreeing.
+     */
+    glyphSet(): GlyphSet;
+    /** Fires after the drawing is rebuilt (a pad swap). The map view uses it to re-route its lines. */
+    onRebuild(cb: () => void): () => void;
+    setVisible(on: boolean): void;
+    dispose(): void;
+}
+export declare function mountControllerPad(host: HTMLElement, opts?: ControllerPadOptions): ControllerPad;
+//# sourceMappingURL=controller-pad.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controller-pad.d.ts","sourceRoot":"","sources":["../../../src/ui/controller/controller-pad.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAG5E,OAAO,EAAoD,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAW,MAAM,YAAY,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC/E,yGAAyG;IACzG,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC9B,yGAAyG;IACzG,WAAW,CAAC,IAAI,UAAU,EAAE,CAAC;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE;YAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;SAAE,CAAC;QACjC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE;YAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;SAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;KACzE,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,uGAAuG;IACvG,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,gDAAgD;IAChD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAClC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,iGAAiG;IACjG,GAAG,IAAI,MAAM,CAAC;IACd,MAAM,IAAI,SAAS,CAAC;IACpB,MAAM,IAAI,SAAS,CAAC;IACpB;;;OAGG;IACH,QAAQ,IAAI,QAAQ,CAAC;IACrB,mGAAmG;IACnG,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,OAAO,IAAI,IAAI,CAAC;CACjB;AAUD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,oBAAyB,GAAG,aAAa,CAuJpG"}