@rydr/game-sdk 7.0.1 → 7.1.0

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

@@ -0,0 +1,36 @@
+/**
+ * COMBO STRIP — the row of chips that says what to press for one action.
+ *
+ *     [L2] + [✕]      two controls held together (the default)
+ *     [L2] → [✕]      two controls in order (`action.sequence`)
+ *     [stick◀]        one control
+ *
+ * This is the "combination" half of a callout card, and the demo drives the same object, so the static
+ * legend and the animated tutorial can never disagree about what a combination looks like.
+ *
+ * Addressing is by INDEX rather than by token, because a combination may legitimately repeat a control
+ * (a double-tap sequence is `["DIAMOND_DOWN", "DIAMOND_DOWN"]`) and a token lookup would drive both
+ * chips at once. `setPressed(token, …)` exists for convenience and hits the first match.
+ */
+import { type InputChip, type InputChipOptions } from "./input-chip.js";
+import type { ComboToken, ControlAction } from "./tokens.js";
+export interface ComboStrip {
+    readonly el: HTMLElement;
+    readonly tokens: readonly ComboToken[];
+    readonly chips: readonly InputChip[];
+    /** Press/release the chip at `index`. Out-of-range indices are ignored. */
+    setPressedAt(index: number, on: boolean): void;
+    /** Press/release the FIRST chip carrying `token`. */
+    setPressed(token: ComboToken, on: boolean): void;
+    setAllPressed(on: boolean): void;
+    /** Deflect the stick chip at `index` (no-op on other chip kinds). Convention: right = +1, up = +1. */
+    setDeflectionAt(index: number, x: number, y: number): void;
+    /**
+     * In a sequence, mark separators before `step` as done so the eye can follow the progression.
+     * `-1` clears. No effect on a simultaneous combo, which has no ordering to show.
+     */
+    setStep(step: number): void;
+    dispose(): void;
+}
+export declare function createComboStrip(action: ControlAction, opts?: InputChipOptions): ComboStrip;
+//# sourceMappingURL=combo-strip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"combo-strip.d.ts","sourceRoot":"","sources":["../../../src/ui/controller/combo-strip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEzF,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,2EAA2E;IAC3E,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,qDAAqD;IACrD,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IACjD,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,sGAAsG;IACtG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,GAAE,gBAAqB,GAAG,UAAU,CAiD/F"}

package/dist/ui/controller/combo-strip.js

@@ -0,0 +1,66 @@
+/**
+ * COMBO STRIP — the row of chips that says what to press for one action.
+ *
+ *     [L2] + [✕]      two controls held together (the default)
+ *     [L2] → [✕]      two controls in order (`action.sequence`)
+ *     [stick◀]        one control
+ *
+ * This is the "combination" half of a callout card, and the demo drives the same object, so the static
+ * legend and the animated tutorial can never disagree about what a combination looks like.
+ *
+ * Addressing is by INDEX rather than by token, because a combination may legitimately repeat a control
+ * (a double-tap sequence is `["DIAMOND_DOWN", "DIAMOND_DOWN"]`) and a token lookup would drive both
+ * chips at once. `setPressed(token, …)` exists for convenience and hits the first match.
+ */
+import { createInputChip } from "./input-chip.js";
+import { injectPadCss } from "./styles.js";
+export function createComboStrip(action, opts = {}) {
+    injectPadCss();
+    const el = document.createElement("span");
+    el.className = "rydr-pad-strip";
+    const tokens = [...action.combo];
+    const chips = [];
+    const seps = [];
+    tokens.forEach((token, i) => {
+        if (i > 0) {
+            const sep = document.createElement("span");
+            sep.className = "rydr-pad-strip-sep";
+            // "+" = at the same time, "→" = then. The glyph is the whole explanation.
+            sep.textContent = action.sequence ? "→" : "+";
+            el.appendChild(sep);
+            seps.push(sep);
+        }
+        const chip = createInputChip(token, opts);
+        chips.push(chip);
+        el.appendChild(chip.el);
+    });
+    const setPressedAt = (index, on) => chips[index]?.setPressed(on);
+    return {
+        el,
+        tokens,
+        chips,
+        setPressedAt,
+        setPressed(token, on) {
+            const i = tokens.indexOf(token);
+            if (i >= 0)
+                setPressedAt(i, on);
+        },
+        setAllPressed(on) {
+            for (const chip of chips)
+                chip.setPressed(on);
+        },
+        setDeflectionAt(index, x, y) {
+            chips[index]?.setDeflection(x, y);
+        },
+        setStep(step) {
+            // Separator i sits between chip i and chip i+1, so it is "done" once step has passed chip i+1.
+            seps.forEach((sep, i) => sep.classList.toggle("done", action.sequence === true && step > i));
+        },
+        dispose() {
+            for (const chip of chips)
+                chip.dispose();
+            el.remove();
+        },
+    };
+}
+//# sourceMappingURL=combo-strip.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"combo-strip.js","sourceRoot":"","sources":["../../../src/ui/controller/combo-strip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAyC,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAsB3C,MAAM,UAAU,gBAAgB,CAAC,MAAqB,EAAE,OAAyB,EAAE;IACjF,YAAY,EAAE,CAAC;IACf,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,EAAE,CAAC,SAAS,GAAG,gBAAgB,CAAC;IAEhC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAkB,EAAE,CAAC;IAE/B,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC3C,GAAG,CAAC,SAAS,GAAG,oBAAoB,CAAC;YACrC,0EAA0E;YAC1E,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAC9C,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;QACD,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAA+B,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IAE7F,OAAO;QACL,EAAE;QACF,MAAM;QACN,KAAK;QACL,YAAY;QACZ,UAAU,CAAC,KAAK,EAAE,EAAE;YAClB,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC;gBAAE,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,aAAa,CAAC,EAAE;YACd,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,eAAe,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,CAAC,IAAI;YACV,+FAA+F;YAC/F,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO;YACL,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,EAAE,CAAC,MAAM,EAAE,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,132 @@
+/**
+ * CONTROL TRAINER — a guided lesson: "here's what to press; now you do it."
+ *
+ * Where {@link mountComboDemo} only *shows* a combination on a loop, this one **watches the rider** and
+ * gates on them actually performing it. It exists for the paired lessons where two related controls have
+ * to be taught together — the case that named it being the trainer resistance, which is one concept
+ * (`Changer la résistance`) with two opposite halves (`−` and `+`).
+ *
+ * ```ts
+ * mountControlTrainer(modalBody, {
+ *   title: "Changer la résistance",
+ *   press: shellInput,
+ *   steps: [
+ *     { label: "Réduire la résistance",   combo: ["LSTICK_PRESS", "LB"] },
+ *     { label: "Augmenter la résistance", combo: ["LSTICK_PRESS", "RB"] },
+ *   ],
+ *   onComplete: () => closeModal(),
+ * });
+ * ```
+ *
+ * Layout: the title, then one panel per step laid left → right, then **one shared controller drawing
+ * spanning the full width** underneath. Sharing the drawing is the point — both halves of the lesson are
+ * on the same physical pad, and seeing the left paddle and the right paddle light up on one picture is
+ * what teaches the pairing.
+ *
+ * Each step walks three states, and each one has to *look* like what it means:
+ *
+ *   1. **hint** — whitish, pulsing, on both the panel's chips and the pad's buttons. This is an
+ *      instruction, so it must not look like a press; the pulse is what separates the two, since a solid
+ *      fill is what a real press already looks like. The prompt shows **one step at a time, alternating**,
+ *      and builds each combination up **cumulatively** — the first control lights, STAYS lit, and the next
+ *      joins it a beat later. Prompting both halves at once would light four controls on one pad and read
+ *      as "press all of this"; blinking them in turn would never show that they are held together.
+ *   2. **active** — the accent colour, and the pulse STOPS. The rider has started but the combination
+ *      isn't complete yet: on a two-control step this is the state between the first control and the
+ *      second.
+ *   3. **done** — the step's PANEL turns green and its ✓ pops, the moment the WHOLE combination is held.
+ *      Holding all of it is doing it; there is nothing further to wait for, and it stays done whether or
+ *      not the rider keeps the controls down.
+ *
+ * **The controller drawing is never green.** White and blue have already taught the rider that colour on
+ * the pad means *now*, so progress there would be a third colour breaking that rule — a green button
+ * beside a white one reads as "and this one too". Progress lives on the panels, whose chips picture the
+ * same combination one line up, so the confirmation still lands on the controls they just pressed. See
+ * `paint` for the two languages.
+ *
+ * When every step is done, `onComplete` fires after a short beat so the last ✓ is actually seen. The
+ * component does not close anything itself — it has no idea it's in a modal. The host owns that, exactly
+ * as with every other piece of this kit.
+ *
+ * ⚠️ **The resistance case needs a shell-side input source.** `LB`/`RB` are shell-owned: the
+ * SDK client turns those keys into `trainer.adjustResistance` intents and they never reach a game's
+ * `onButton` (see {@link ShellControl}). So a *game* can build a trainer for its own buttons, but a
+ * resistance lesson has to be driven by the shell, which is also the only place that lesson belongs.
+ */
+import type { ButtonEdge } from "../../protocol/buttons.js";
+import type { AxisName } from "../../protocol/buttons.js";
+import type { GlyphSet } from "../../protocol/glyphs.js";
+import { type ControllerPad } from "./controller-pad.js";
+import type { StickPictogramStyle } from "./input-chip.js";
+import { type ComboToken, type ControlName } from "./tokens.js";
+import type { PadBrandKey } from "./types.js";
+/**
+ * The input the lesson watches.
+ *
+ * Typed on {@link ControlName}, not `ButtonName`, so a shell-side source can report `LB`/`RB`.
+ * A `PlatformSession` satisfies it structurally and can drive any lesson made of game buttons.
+ */
+export interface TrainerInputSource {
+    onButton(cb: (e: {
+        name: ControlName;
+        edge: ButtonEdge;
+    }) => void): () => void;
+    axis?(name: AxisName): number;
+    hardware?: {
+        current: {
+            glyphSet?: GlyphSet;
+        };
+        subscribe?(cb: (snapshot: {
+            glyphSet?: GlyphSet;
+        }) => void): () => void;
+    };
+}
+export interface TrainerStep {
+    /** What the rider has to do — the panel heading. */
+    label: string;
+    /** The controls that do it. Several tokens = they must all be engaged together. */
+    combo: readonly ComboToken[];
+    /** The controls must be engaged IN ORDER rather than together. */
+    sequence?: boolean;
+    /** A quieter line under the label. */
+    hint?: string;
+    /** Stable key, for `onStepComplete`. Falls back to `label`. */
+    id?: string;
+}
+export interface ControlTrainerOptions {
+    /** The one thing the lesson is about — e.g. "Changer la résistance". */
+    title: string;
+    /** One panel per step, laid left → right in the order given. */
+    steps: readonly TrainerStep[];
+    /** The input to watch. Without it the lesson still renders and prompts, but can never complete. */
+    press?: TrainerInputSource;
+    brand?: PadBrandKey;
+    glyphSet?: GlyphSet;
+    labels?: boolean;
+    accent?: string;
+    colored?: boolean;
+    stickStyle?: StickPictogramStyle;
+    /** Pad size preset. Default `"lg"` — the drawing is the shared reference here, so make it readable. */
+    size?: "sm" | "md" | "lg";
+    /**
+     * How long to hold on the final ✓ before `onComplete`. Default 900ms.
+     *
+     * Not decoration: firing the instant the last control is released would yank the lesson away before the
+     * rider sees that they got it right, which is the only feedback the whole exercise exists to give.
+     */
+    completionDelayMs?: number;
+    onStepComplete?(step: TrainerStep, index: number): void;
+    /** Every step done. The host closes its modal here — the component never closes itself. */
+    onComplete?(): void;
+}
+export interface ControlTrainer {
+    readonly root: HTMLDivElement;
+    readonly pad: ControllerPad;
+    /** Which steps are done, by index. */
+    completed(): readonly boolean[];
+    /** Back to square one — every step un-done, prompts pulsing again. */
+    reset(): void;
+    dispose(): void;
+}
+export declare function mountControlTrainer(host: HTMLElement, opts: ControlTrainerOptions): ControlTrainer;
+//# sourceMappingURL=control-trainer.d.ts.map

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

@@ -0,0 +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"}