@rydr/game-sdk 8.0.0 → 8.2.0

package/dist/ui/controller/control-spotlight.js

@@ -0,0 +1,563 @@
+/**
+ * CONTROL SPOTLIGHT — "this button, and here's what it does", written on the button itself.
+ *
+ * ```ts
+ * // A tour: each control in turn, captioned, on a clock.
+ * const spot = mountControlSpotlight(host, {
+ *   press: shellInput,
+ *   watch: true,
+ *   steps: [
+ *     { label: "Descendre de vitesse", combo: ["LB"] },
+ *     { label: "Monter de vitesse",    combo: ["RB"] },
+ *   ],
+ * });
+ *
+ * // Or no clock at all: one control, lit and captioned, indefinitely.
+ * mountControlSpotlight(hud, { press: session, mode: "still", steps: [{ label: "Move", combo: ["LSTICK"] }] });
+ * ```
+ *
+ * The caption sits **on the control**, not in a list beside the pad — which is the whole reason this
+ * view exists. A rider on a bike reading a trainer screen from a few feet away cannot be asked to trace
+ * a line from a legend back to a button, and the control genuinely cannot be named in text: the same
+ * button reads `LB` on an Xbox pad, `L1` on a DualSense and a bare `L` on a Switch. Pointing at it and
+ * saying what it does is the only honest way to teach it.
+ *
+ * ## Which of the four controller views is this
+ *
+ *   {@link mountControllerPad}     the drawing alone, reflecting real input
+ *   {@link mountControllerMap}     STATIC — every control at once, callouts in columns joined by lines
+ *   {@link mountComboDemo}         DYNAMIC — one combination, animated on a loop
+ *   {@link mountControlSpotlight}  N controls, ONE at a time, captioned ON the button, on its own clock
+ *   {@link mountControlTrainer}    a lesson that WATCHES and gates on the rider performing it
+ *
+ * The map is what you want for "here is the control scheme". This is what you want when the caption has
+ * to land on the button, when each control needs its own dwell, or when there is no clock at all and you
+ * simply want one control lit with a label on it.
+ *
+ * ## Two modes, one render
+ *
+ * `"tour"` walks the steps: each lights for its `holdMs`, then a dark `gapMs`, then the next. The gap is
+ * load-bearing — two steps shown back to back read as one flickering picture, and the dark beat between
+ * them is what makes them two statements rather than one.
+ *
+ * `"still"` has no clock: every step lights and every caption shows, and stays. With a single step that
+ * is "highlight this key, with this text, for as long as I'm on screen", which needs no timeline to
+ * express. `prefers-reduced-motion` simply forces this mode — so the reduced-motion still is not a
+ * second code path to keep in step with the first, it IS the first.
+ *
+ * ## The rider outranks the lesson (`watch`)
+ *
+ * With `watch`, a control the rider is actually holding paints **green** (`done`) instead of the accent,
+ * and the timeline **stands down**: it stops, every unheld control goes dark, and it restarts from the
+ * top `resumeMs` after they let go. A loop that keeps cycling underneath a rider trying it out is two
+ * hands on the same pad — they cannot tell which of the lights is theirs, which is the entire feedback
+ * the lesson exists to give.
+ *
+ * Green is not limited to the controls the steps name: with `watch` the drawing paints EVERY control the
+ * rider is holding, including ones no step teaches. A rider trying the pad out while the lesson runs is
+ * asking "which one is this?", and a drawing that answers only for the two buttons it happens to be
+ * teaching reads as a dead pad rather than as an answer. Only what the rider holds turns green, so the
+ * lesson's own controls stay the only BLUE thing on it.
+ *
+ * Blue says *this is the press*; green says *and that one was yours*. Neither is the whitish `hint` the
+ * trainer uses, which is built for "do this, I'll wait" — here the instruction is a moving picture of a
+ * press, and a press drawn in not-a-press colours doesn't look like the thing it's asking for.
+ *
+ * ## This component is the sole writer of the drawing
+ *
+ * The pad is mounted **glyph-only** (it gets the hardware store for its lettering, and an `onButton` that
+ * does nothing), exactly as {@link mountControlTrainer} does. Wiring the pad to input as well would give
+ * two writers for the same classes every frame, each undoing the other. We take the rider's presses
+ * ourselves and fold them into the paint, so there is one writer and no race.
+ *
+ * ⚠️ **A caption is ONE line: the action's name.** No `hint` subtitle — `ControlSpotlightStep` types it
+ * out — because this bubble floats over the rider's controller for about two seconds while they pedal,
+ * and a second quieter line under the first means neither gets read. Qualify the label if you must.
+ *
+ * ⚠️ **Captions are text-only for now.** A step whose combo names several controls lights all of them
+ * and pins its caption per the usual anchor rule, but the bubble does not draw chips — the multi-control
+ * case is getting its own treatment later. Don't grow chips in here by drift; `mountComboDemo` and
+ * `mountControllerMap` are where a combination is spelled out today.
+ */
+import { mountControllerPad } from "./controller-pad.js";
+import { anchorPartOfToken, anchorTokenOf, channelsOf, litPartOfControl, partCentreOf, partGeomOf, triggerSideOfPart, } from "./parts-map.js";
+import { createLivePresses } from "./live-presses.js";
+import { injectPadCss } from "./styles.js";
+import { isShellControl, parseToken } from "./tokens.js";
+import { partCentre } from "./types.js";
+/** How long a step holds lit, unless it says otherwise. */
+export const SPOTLIGHT_HOLD_MS = 2000;
+/**
+ * The dark beat after a step. Not decoration — see the note on the gap above; two lit controls with no
+ * dark between them read as one picture flickering rather than as two separate statements.
+ */
+export const SPOTLIGHT_GAP_MS = 1000;
+/** How long after the rider lets go of everything before the timeline takes the pad back. */
+export const SPOTLIGHT_RESUME_MS = 1000;
+/** One full revolution of an undirected stick sweep, ms. Matches `combo-demo`'s feel. */
+const SWEEP_MS = 1200;
+/** Past this deflection an undirected sweep counts as engaged, for the caption's sake. */
+const SWEEP_RAMP = 1;
+export function mountControlSpotlight(host, opts) {
+    injectPadCss();
+    const reduceMotion = typeof matchMedia === "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
+    const mode = reduceMotion ? "still" : (opts.mode ?? "tour");
+    const watch = opts.watch === true && opts.press != null;
+    const resumeMs = opts.resumeMs ?? SPOTLIGHT_RESUME_MS;
+    const speed = opts.speed ?? 1;
+    const loop = opts.loop !== false;
+    const root = document.createElement("div");
+    root.className = "rydr-padspot" + (opts.glow === false ? " no-glow" : "");
+    // The captions are absolutely positioned over the drawing, so they need a positioned box of their own.
+    // `host` belongs to the caller and may be laid out however that screen wants.
+    const stage = document.createElement("div");
+    stage.className = "rydr-padspot-stage";
+    root.appendChild(stage);
+    host.appendChild(root);
+    /**
+     * Does any step name a shell-owned control? Then the drawing must be allowed to light it — that IS the
+     * lesson. Derived rather than asked for, so a caller can't forget it and get a dead highlight. (Same
+     * reasoning, same shape, as `control-trainer`.)
+     */
+    const teachesShellOwned = (steps) => steps.some((s) => s.combo.some((t) => {
+        const p = parseToken(t);
+        return p.kind === "button" && isShellControl(p.name);
+    }));
+    // Glyph-only: this component owns the drawing's state, so real presses must not write it too. We route
+    // them ourselves, below, and fold them into the same paint the timeline uses.
+    /**
+     * Whether the drawing may light the shell-owned shoulders. Held in a variable because the live-press
+     * paint below has to respect the same answer the pad was mounted with: lighting `LB` on a drawing that
+     * draws it faint (because nothing here teaches it) would be a highlight nobody can read.
+     */
+    const shellOwnedLit = teachesShellOwned(opts.steps);
+    const pad = mountControllerPad(stage, {
+        press: opts.press && { onButton: () => () => { }, hardware: opts.press.hardware },
+        brand: opts.brand,
+        glyphSet: opts.glyphSet,
+        size: opts.size ?? "lg",
+        labels: opts.labels,
+        accent: opts.accent,
+        allowShellOwned: shellOwnedLit,
+    });
+    let spots = [];
+    let cycleMs = 0;
+    let done = [];
+    /** What we last painted per part — the dirty guard that keeps this a few DOM writes a second. */
+    const painted = new Map();
+    /** What tone each caption last had, for the same reason. */
+    const toned = new Map();
+    /** Controls the rider is holding right now. These paint green whatever the timeline is doing. */
+    const held = new Set();
+    // ── build ───────────────────────────────────────────────────────────────────────────────────────
+    function buildSpots(steps) {
+        for (const s of spots)
+            s.tag.remove();
+        painted.clear();
+        toned.clear();
+        let at = 0;
+        spots = steps.map((step) => {
+            const holdMs = step.holdMs ?? SPOTLIGHT_HOLD_MS;
+            const from = at;
+            at += holdMs + (step.gapMs ?? SPOTLIGHT_GAP_MS);
+            const anchorToken = anchorTokenOf(step);
+            const spot = {
+                step,
+                channels: channelsOf(step),
+                // Only BUTTONS can be observed as held: `onButton` is the only stream we have, and a stick's
+                // deflection isn't a press. A stick-only step therefore never counts as performed, which is
+                // honest — we'd need axes to know, and the caption is doing the teaching either way.
+                required: step.combo.map((t) => parseToken(t)).flatMap((p) => (p.kind === "button" ? [p.name] : [])),
+                anchor: anchorToken ? anchorPartOfToken(anchorToken) : undefined,
+                tag: buildTag(step.label),
+                from,
+                holdMs,
+            };
+            stage.appendChild(spot.tag);
+            return spot;
+        });
+        cycleMs = Math.max(1, at);
+        done = spots.map(() => false);
+        placeAll();
+    }
+    /** The bubble: one line, and the caret that ties it to its control. Nothing else — see `hint`. */
+    function buildTag(label) {
+        const tag = document.createElement("div");
+        tag.className = "rydr-padspot-tag";
+        const text = document.createElement("span");
+        text.className = "rydr-padspot-label";
+        text.textContent = label;
+        tag.appendChild(text);
+        // The caret ties the bubble to the control directly beneath (or above) it. A separate element rather
+        // than a border trick on the bubble, because it has to be recoloured along with it.
+        const caret = document.createElement("span");
+        caret.className = "rydr-padspot-caret";
+        tag.appendChild(caret);
+        return tag;
+    }
+    /**
+     * Which side of its control a caption sits on.
+     *
+     * Top half → above, bottom half → below, so the bubble lands in the free space beyond the drawing
+     * rather than across the middle of the control cluster. Derived from the layout, never hardcoded per
+     * brand, for the same reason `sideOfPart` is: it has to stay right across five very different control
+     * arrangements.
+     *
+     * ⚠️ For a control in the MIDDLE of the body there is no side that covers nothing — the controls
+     * occupy the middle, and a caption near one of them will cross another. A left-stick caption crosses
+     * the shoulder row; a d-pad caption crosses the grips. That is the same trade the shell's original
+     * shift demo made deliberately (a caption sitting ON its control is what makes it unambiguous, and a
+     * control hidden for two seconds costs less than a caption the rider has to trace back to its button).
+     * `captionSide` is the escape when a particular screen disagrees.
+     */
+    function sideFor(part) {
+        if (opts.captionSide && opts.captionSide !== "auto")
+            return opts.captionSide;
+        const layout = pad.layout();
+        const centre = part ? partCentreOf(layout, part) : undefined;
+        const midY = layout.viewBox[1] + layout.viewBox[3] / 2;
+        return (centre?.y ?? midY) <= midY ? "above" : "below";
+    }
+    /**
+     * Where a control sits, in page pixels relative to the stage.
+     *
+     * Projected from the layout's own GEOMETRY through the SVG's screen matrix, rather than measured off
+     * the part's `getBoundingClientRect()`. That distinction is load-bearing for the sticks: the node
+     * registered as `lstickPress` lives *inside* the translated group that deflects the cap, so measuring
+     * it pins the caption to the moving thumb-cap and the bubble drifts around as the stick sweeps. The
+     * geometry is the stick's RESTING centre — the well — which is what the caption should aim at and the
+     * one point on a stick that doesn't move.
+     *
+     * It also means nothing here depends on a transform anywhere in the drawing, so a caption can be
+     * placed once and stay correct however the control animates underneath it.
+     */
+    function projectPart(part) {
+        const svgEl = pad.svg().svg;
+        const geom = partGeomOf(pad.layout(), part);
+        const ctm = svgEl.getScreenCTM();
+        if (!geom || !ctm)
+            return null;
+        let x;
+        let yTop;
+        let yBottom;
+        if (geom.kind === "circle") {
+            x = geom.cx;
+            yTop = geom.cy - geom.r;
+            yBottom = geom.cy + geom.r;
+        }
+        else if (geom.kind === "rect") {
+            x = geom.x + geom.w / 2;
+            yTop = geom.y;
+            yBottom = geom.y + geom.h;
+        }
+        else {
+            const c = partCentre(geom);
+            x = c.x;
+            yTop = c.y;
+            yBottom = c.y;
+        }
+        const box = stage.getBoundingClientRect();
+        const pt = svgEl.createSVGPoint();
+        pt.x = x;
+        pt.y = yTop;
+        const a = pt.matrixTransform(ctm);
+        pt.y = yBottom;
+        const b = pt.matrixTransform(ctm);
+        return { cx: a.x - box.left, top: a.y - box.top, bottom: b.y - box.top };
+    }
+    /**
+     * Park a caption over (or under) the control it names.
+     *
+     * Pinned in PAGE PIXELS, because the bubble is DOM and the control lives in an SVG viewBox — the same
+     * constraint the map view's connector layer has. Anything that changes that mapping has to re-run
+     * this: a pad swap rebuilds the SVG outright, and a resize rescales it underneath.
+     */
+    function place(spot) {
+        const side = sideFor(spot.anchor);
+        spot.tag.classList.toggle("above", side === "above");
+        spot.tag.classList.toggle("below", side === "below");
+        const at = spot.anchor ? projectPart(spot.anchor) : null;
+        // A layout may genuinely lack the part (a Zwift pod has no sticks or triggers). Centre the caption
+        // on the drawing rather than dropping it: the words are still the lesson.
+        if (!at) {
+            spot.tag.style.left = "50%";
+            spot.tag.style.top = "50%";
+            return;
+        }
+        spot.tag.style.left = `${at.cx}px`;
+        spot.tag.style.top = side === "above" ? `${at.top - 6}px` : `${at.bottom + 6}px`;
+    }
+    const placeAll = () => spots.forEach((spot) => place(spot));
+    // ── paint ───────────────────────────────────────────────────────────────────────────────────────
+    const paint = (part, state) => {
+        if (painted.get(part) === state)
+            return;
+        painted.set(part, state);
+        pad.driver().setPartState(part, state);
+    };
+    /**
+     * Paint one part, and move the meter if that part is a trigger — the pair that always travels together
+     * (see `triggerSideOfPart`). Both writers below go through here so neither can light a shoulder without
+     * pulling it.
+     */
+    function paintPart(part, state, engaged) {
+        paint(part, state);
+        const meter = triggerSideOfPart(part);
+        if (meter)
+            pad.driver().setMeter(meter, engaged ? 1 : 0);
+    }
+    /** Is the rider performing this step right now? Every button it names has to be down. */
+    const riderDoing = (spot) => watch && spot.required.length > 0 && spot.required.every((n) => held.has(n));
+    /** Is the rider holding anything this spotlight teaches? That's what makes the timeline stand down. */
+    const lessonHeld = () => spots.some((s) => s.required.some((n) => held.has(n)));
+    function showTag(spot, index, on, mine) {
+        if (on && !spot.tag.classList.contains("show"))
+            place(spot);
+        spot.tag.classList.toggle("show", on);
+        // Only ever recoloured while it's UP: a caption that turned white on its way out would flash through
+        // the fade, which reads as a second, different caption leaving rather than the same one.
+        if (!on || toned.get(index) === mine)
+            return;
+        toned.set(index, mine);
+        spot.tag.classList.toggle("mine", mine);
+    }
+    /**
+     * Apply one step's state to the drawing and its caption.
+     *
+     * `since` is ms into this step's own hold, which only an undirected stick needs — it sweeps its cap
+     * around the circle so the drawing says "any direction" rather than parking it somewhere arbitrary.
+     */
+    function paintSpot(spot, index, lit, since) {
+        const mine = riderDoing(spot);
+        const driver = pad.driver();
+        const engaged = lit || mine;
+        const state = mine ? "done" : lit ? "on" : "off";
+        for (const ch of spot.channels) {
+            if (ch.stick) {
+                let x = 0;
+                let y = 0;
+                if (engaged) {
+                    if (ch.stick.vec) {
+                        x = ch.stick.vec[0];
+                        y = ch.stick.vec[1];
+                    }
+                    else {
+                        const angle = (Math.max(0, since) / SWEEP_MS) * Math.PI * 2;
+                        x = Math.cos(angle) * SWEEP_RAMP;
+                        y = Math.sin(angle) * SWEEP_RAMP;
+                    }
+                }
+                driver.setStick(ch.stick.side, x, y, engaged ? "on" : "off");
+                continue;
+            }
+            if (!ch.part)
+                continue;
+            paintPart(ch.part, state, engaged);
+        }
+        showTag(spot, index, engaged, mine);
+        if (mine && !done[index]) {
+            done[index] = true;
+            opts.onPerformed?.(spot.step, index);
+        }
+    }
+    /** Does any step draw this part? Then it, not the live pass, decides what the part looks like unheld. */
+    const ownedByAStep = (part) => spots.some((s) => s.channels.some((ch) => ch.part === part));
+    /**
+     * Paint every control the rider is holding GREEN, on top of whatever the timeline just drew — the shared
+     * live-press pass (`live-presses.ts`), which every view in this family runs.
+     *
+     * It goes LAST, so a held control wins the part it shares with a step: the rider's own hand is the one
+     * thing on the drawing they can verify.
+     */
+    const paintLivePresses = createLivePresses({
+        state: "done",
+        axis: opts.press?.axis?.bind(opts.press),
+        shellOwned: shellOwnedLit,
+        light: (part, state) => paintPart(part, state, true),
+        // The rider's own stick outranks a step's demonstration on that side, for the same reason their press
+        // outranks a lit part: one of the two is a picture of their actual hand.
+        setStick: (side, x, y, state) => pad.driver().setStick(side, x, y, state === "done" ? "done" : "on"),
+        release: (part) => {
+            // A part a step draws is HANDED BACK, not blanked: dropping the cached value is enough, since that
+            // step repaints it (meter included) on the next frame. Blanking it here would flash one dark frame
+            // through a control the lesson is currently lighting.
+            if (ownedByAStep(part))
+                painted.delete(part);
+            else
+                paintPart(part, "off", false);
+        },
+    });
+    /**
+     * Every step engaged at once, captions up — the `"still"` render.
+     *
+     * `"still"` means there is no TIMELINE: nothing steps from one control to the next, nothing goes dark
+     * between them. It does **not** mean the artwork is a frozen frame. A control whose engaged state is
+     * inherently a motion still has to move, or the drawing stops saying what it is: an undirected stick
+     * parked at one arbitrary angle reads as "push it that way", when the whole point of a bare `LSTICK`
+     * is *any* direction. So the sweep keeps running and `t` is passed straight through.
+     *
+     * The exception is reduced motion, which asks for no animation at all — there we pass a fixed `t`.
+     */
+    function renderStill(t) {
+        spots.forEach((spot, i) => paintSpot(spot, i, true, t));
+    }
+    // ── the loop ────────────────────────────────────────────────────────────────────────────────────
+    let raf = 0;
+    /** Timeline origin. Cleared whenever the rider takes over, so the tour RESTARTS rather than resumes. */
+    let start = 0;
+    /** Nothing may light before this. Pushed forward every frame the rider is holding something. */
+    let resumeAt = 0;
+    /** Which step was last reported to `onStepShown`, so it fires on the change and not every frame. */
+    let shown = -1;
+    /** Which cycle we were in last frame, so `onCycle` fires once per pass. */
+    let cycles = 0;
+    /**
+     * One frame, for both modes — so the rAF plumbing, the hidden-tab guard and "what does engaged look
+     * like" each exist exactly once. `"still"` simply has no timeline to advance.
+     */
+    function frame(t) {
+        raf = requestAnimationFrame(frame);
+        if (document.hidden)
+            return;
+        if (mode === "still")
+            renderStill(reduceMotion ? 0 : t);
+        else
+            renderTour(t);
+        if (watch)
+            paintLivePresses(held);
+    }
+    function renderTour(t) {
+        // The rider driving outranks the lesson. `"still"` is exempt: there's no animation to stand down
+        // from, just a labelled diagram, and blanking it would take the lesson away mid-press.
+        if (lessonHeld()) {
+            start = 0;
+            resumeAt = t + resumeMs;
+        }
+        // Held pushes `resumeAt` forward every frame, so one test covers both the press and the quiet beat.
+        const waiting = resumeAt > t;
+        if (!waiting && !start)
+            start = t;
+        const elapsed = waiting ? -1 : (t - start) * speed;
+        if (!loop && elapsed >= cycleMs) {
+            spots.forEach((spot, i) => paintSpot(spot, i, false, 0));
+            stopFrames();
+            return;
+        }
+        if (elapsed >= 0) {
+            const pass = Math.floor(elapsed / cycleMs);
+            if (pass > cycles) {
+                cycles = pass;
+                opts.onCycle?.();
+            }
+        }
+        // Out of every step's range, so a waiting frame paints the pad dark and leaves the rider's own press
+        // as the only thing on it.
+        const at = waiting ? -1 : elapsed % cycleMs;
+        let lighting = -1;
+        spots.forEach((spot, i) => {
+            const lit = at >= spot.from && at < spot.from + spot.holdMs;
+            if (lit)
+                lighting = i;
+            paintSpot(spot, i, lit, at - spot.from);
+        });
+        if (lighting !== shown) {
+            shown = lighting;
+            if (lighting >= 0)
+                opts.onStepShown?.(spots[lighting].step, lighting);
+        }
+    }
+    function startFrames() {
+        if (!raf)
+            raf = requestAnimationFrame(frame);
+    }
+    function stopFrames() {
+        if (raf)
+            cancelAnimationFrame(raf);
+        raf = 0;
+    }
+    /**
+     * Is anything in `"still"` mode inherently in motion? Only an UNDIRECTED stick: a bare `LSTICK` means
+     * "any direction", which is a sweep, not a position. A directed token (`LSTICK:left`) is a place the
+     * cap sits, and buttons are just lit — neither needs a frame after the first.
+     */
+    const stillAnimates = () => !reduceMotion && spots.some((s) => s.channels.some((c) => c.stick && !c.stick.vec));
+    /**
+     * `"still"` only takes frames when it has a reason to: an animating control, or `watch` (where a press
+     * still has to turn green). A permanent spotlight on a plain button costs nothing per frame, which is
+     * part of why you'd ask for it.
+     */
+    function begin() {
+        renderStill(0);
+        if (mode === "tour" || watch || stillAnimates())
+            startFrames();
+    }
+    // ── input ───────────────────────────────────────────────────────────────────────────────────────
+    const offButton = watch
+        ? opts.press?.onButton(({ name, edge }) => {
+            if (edge === "down")
+                held.add(name);
+            else
+                held.delete(name);
+            // A part whose state is decided by `held` has to be repainted next frame; drop the cached value
+            // so the dirty guard doesn't hold the stale one.
+            for (const spot of spots) {
+                if (!spot.required.includes(name))
+                    continue;
+                for (const ch of spot.channels)
+                    if (ch.part)
+                        painted.delete(ch.part);
+            }
+            // …and the pressed control's own part, which turns green whether or not a step names it.
+            const own = litPartOfControl(name);
+            if (own)
+                painted.delete(own);
+            // In "still" + watch the loop is already running and will repaint on the next frame with a live
+            // clock; painting here would write a stale one and stutter an in-flight sweep.
+        })
+        : undefined;
+    // ── relayout ────────────────────────────────────────────────────────────────────────────────────
+    // A pad swap rebuilds the SVG outright, so every measured caption position is stale.
+    const offRebuild = pad.onRebuild(() => {
+        painted.clear();
+        placeAll();
+        // A swap with no loop running (a still, non-watching spotlight) has nobody to repaint it.
+        if (mode === "still" && !raf)
+            renderStill(0);
+    });
+    const resize = new ResizeObserver(() => placeAll());
+    resize.observe(stage);
+    buildSpots(opts.steps);
+    begin();
+    return {
+        root,
+        pad,
+        setSteps(steps) {
+            buildSpots(steps);
+            start = 0;
+            shown = -1;
+            cycles = 0;
+            pad.driver().clearAll();
+            if (mode === "still") {
+                renderStill(0);
+                if (watch || stillAnimates())
+                    startFrames();
+            }
+            else
+                startFrames();
+        },
+        play: startFrames,
+        pause: stopFrames,
+        performed: () => done.slice(),
+        dispose() {
+            stopFrames();
+            resize.disconnect();
+            offRebuild();
+            offButton?.();
+            // Release everything before detaching: a control lit at teardown must not survive a re-mount.
+            pad.driver().clearAll();
+            pad.dispose();
+            root.remove();
+        },
+    };
+}
+//# sourceMappingURL=control-spotlight.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"control-trainer.d.ts","sourceRoot":"","sources":["../../../src/ui/controller/control-trainer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAI3E,OAAO,EAAgD,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,YAAY,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,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,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC9B,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,WAAW;IAC1B,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,mGAAmG;IACnG,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,uGAAuG;IACvG,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,2FAA2F;IAC3F,UAAU,CAAC,IAAI,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,sCAAsC;IACtC,SAAS,IAAI,SAAS,OAAO,EAAE,CAAC;IAChC,sEAAsE;IACtE,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACjB;AA0DD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,qBAAqB,GAAG,cAAc,CAuelG"}
+{"version":3,"file":"control-trainer.d.ts","sourceRoot":"","sources":["../../../src/ui/controller/control-trainer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAK3E,OAAO,EAAgD,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,YAAY,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,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,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC9B,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,WAAW;IAC1B,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,mGAAmG;IACnG,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,uGAAuG;IACvG,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,2FAA2F;IAC3F,UAAU,CAAC,IAAI,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,sCAAsC;IACtC,SAAS,IAAI,SAAS,OAAO,EAAE,CAAC;IAChC,sEAAsE;IACtE,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACjB;AAsDD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,qBAAqB,GAAG,cAAc,CA4dlG"}

package/dist/ui/controller/control-trainer.js

@@ -55,15 +55,12 @@
  */
 import { createComboStrip } from "./combo-strip.js";
 import { mountControllerPad } from "./controller-pad.js";
-import { DPAD_DIRECTIONS, litPartOfControl } from "./parts-map.js";
+import { heldParts } from "./live-presses.js";
+import { litPartOfControl } from "./parts-map.js";
 import { STICK_LIT_DEADZONE } from "./pad-svg.js";
 import { injectPadCss } from "./styles.js";
 import { isShellControl, parseToken, STICK_DIR_VECTOR } from "./tokens.js";
 const CHECK = "✓";
-/** Is this one of the four directions the d-pad SHARES with the left stick? */
-function isDpadName(name) {
-    return name === "UP" || name === "DOWN" || name === "LEFT" || name === "RIGHT";
-}
 /**
  * Demonstration timings, in ms.
  *
@@ -369,23 +366,10 @@ export function mountControlTrainer(host, opts) {
         // it belongs to has been completed.
         // Pass 2 — the hardware. EVERY held control goes blue, whether or not the lesson mentions it: the
         // pad is a picture of the controller, and a press it ignores looks like a fault.
-        const axis = opts.press?.axis;
-        const lx = axis?.("LX") ?? 0;
-        const ly = axis?.("LY") ?? 0;
-        for (const name of held) {
-            // UP/DOWN/LEFT/RIGHT come from the d-pad AND from the left stick past its deadzone (see
-            // protocol/buttons.ts) — nothing in the canonical stream says which. So when the axes already
-            // explain a direction, DON'T light the d-pad: the stick's own cap is the truthful picture, and
-            // lighting both makes it look like the rider is pressing a d-pad they never touched.
-            // `mountControllerPad` has always done this; the "reflect everything" pass added here skipped it.
-            if (axis && isDpadName(name)) {
-                const [vx, vy] = DPAD_DIRECTIONS[name];
-                if (lx * vx + ly * vy > STICK_LIT_DEADZONE)
-                    continue;
-            }
-            const part = litPartOfControl(name);
-            if (part)
-                wanted.set(part, "on");
+        const axis = opts.press?.axis?.bind(opts.press);
+        // Blue, not green: in a lesson green is reserved for "this step is finished".
+        for (const part of heldParts({ held: held, axis, shellOwned: teachesShellOwned })) {
+            wanted.set(part, "on");
         }
         // Both sticks, live, for the same reason — and this overrides any demonstration on that side.
         if (axis) {