@rydr/game-sdk 5.0.0 → 6.1.0

package/dist/protocol/version.js

@@ -131,8 +131,37 @@
 // whatever went back on `DIAMOND_LEFT` must now go back on `DIAMOND_RIGHT`. Doing only the first step
 // compiles and runs while keeping the old, wrong ergonomics. Finally, replace every hardcoded button
 // letter in on-screen text with `session.buttonLabel(…)`.
-export const RYDR_PROTOCOL_VERSION = 26;
+// Bumped 26 → 27: REMOVES the trigger axes `LT`/`RT` from the `input.axis` `name` vocabulary
+// (BREAKING for the `AxisName` type — it narrows to the four stick axes `LX`/`LY`/`RX`/`RY`). The
+// shoulder triggers are plain CLICKS on the hardware — there is no analog trigger travel — so
+// `axis("LT"|"RT")` promised a reading that could never exist. The digital `LT`/`RT` ButtonNames are
+// untouched. Wire-wise this is a no-op: no shell ever emitted a trigger axis (protocol-22 shells only
+// ever sent stick axes), and the SDK's keyboard emulation was the sole feeder (`a`/`e` snapping 0/1),
+// now removed. Migrate: `session.axis("LT"|"RT")` → `session.isDown("LT"|"RT")` (the on/off click).
+// Bumped 27 → 28: adds `OPTIONS` to the `input.button` `name` vocabulary — a single extra button,
+// distinct from the platform's own overlay menu (`M`/phone `MENU`/gamepad Start, which never reaches
+// a game). It's the GAME's own menu/options button. Keyboard `o`, a standard gamepad's Select/Back
+// button, and a new phone icon all send it; not every device has it, so never gate a required flow
+// behind it alone. Additive: no existing shape or name changed, and an older game's `onButton` has no
+// branch for `OPTIONS`, so it's inert there — no old-guest shield needed. (Unrelated to the wire
+// vocabulary: the right stick and both stick-click buttons also moved off `i`/`j`/`k`/`l`/`f`/`o` onto
+// the numeric keypad in this same release, but that's purely which PHYSICAL KEY the SDK's own keyboard
+// emulation listens for — the `ButtonName`s it produces are unchanged, so it carries no protocol bump.)
+// Bumped 28 → 29: adds `rydr/rider.adjustFtp` (`{ direction: 1 | -1 }`, game→platform) — the fourth
+// shell-owned rider-key relay, joining `audio.adjustMaster` (T/G), `trainer.adjustResistance` (W/X)
+// and `menu.toggle` (M). The keys are − and + and they step the rider's PLAYING FTP: a memory-only
+// session override the shell layers on the profile FTP, so a rider can make every game harder or
+// easier mid-ride without editing their profile (it resets to the profile number on reload). Like
+// its three siblings it exists only because a focused game iframe swallows the keystroke before the
+// shell window can see it. There is no reply message — the shell pushes the resulting FTP to every
+// game as a fresh `rydr/identity.update`, so a game reads it exactly where it already reads FTP
+// (`session.identity.ftp` / `onIdentityChange`). Ungated (no capability), like the other three.
+// Additive: an older shell has no `onAdjustFtp` handler, so the message is a silent no-op there
+// (−/+ keeps working only while the shell holds focus) and nothing existing changed. No game code
+// required — but a game that snapshots `identity.ftp` at init instead of subscribing to
+// `onIdentityChange` won't see mid-ride changes, which was already true for a profile edit.
+export const RYDR_PROTOCOL_VERSION = 29;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging.
  *  (Bumped to 2.0.0 by `npm version major` on release — see CHANGELOG [Unreleased].) */
-export const RYDR_SDK_VERSION = "5.0.0";
+export const RYDR_SDK_VERSION = "6.1.0";
 //# sourceMappingURL=version.js.map

package/dist/protocol/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/protocol/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,8FAA8F;AAC9F,yDAAyD;AACzD,4FAA4F;AAC5F,oGAAoG;AACpG,kGAAkG;AAClG,6EAA6E;AAC7E,kGAAkG;AAClG,uGAAuG;AACvG,wFAAwF;AACxF,oGAAoG;AACpG,gGAAgG;AAChG,yFAAyF;AACzF,kHAAkH;AAClH,oGAAoG;AACpG,qGAAqG;AACrG,kGAAkG;AAClG,mGAAmG;AACnG,oGAAoG;AACpG,6FAA6F;AAC7F,gGAAgG;AAChG,uGAAuG;AACvG,mGAAmG;AACnG,kGAAkG;AAClG,+FAA+F;AAC/F,kGAAkG;AAClG,iGAAiG;AACjG,iGAAiG;AACjG,+FAA+F;AAC/F,qGAAqG;AACrG,uGAAuG;AACvG,+FAA+F;AAC/F,qGAAqG;AACrG,kGAAkG;AAClG,2BAA2B;AAC3B,mGAAmG;AACnG,mGAAmG;AACnG,gGAAgG;AAChG,iGAAiG;AACjG,oFAAoF;AACpF,oGAAoG;AACpG,kGAAkG;AAClG,oGAAoG;AACpG,iGAAiG;AACjG,sGAAsG;AACtG,wGAAwG;AACxG,qGAAqG;AACrG,uGAAuG;AACvG,sGAAsG;AACtG,wGAAwG;AACxG,qGAAqG;AACrG,uGAAuG;AACvG,uGAAuG;AACvG,mGAAmG;AACnG,kFAAkF;AAClF,yGAAyG;AACzG,oGAAoG;AACpG,uGAAuG;AACvG,0GAA0G;AAC1G,yGAAyG;AACzG,yBAAyB;AACzB,sGAAsG;AACtG,sGAAsG;AACtG,qGAAqG;AACrG,wGAAwG;AACxG,uGAAuG;AACvG,6FAA6F;AAC7F,iGAAiG;AACjG,iGAAiG;AACjG,+FAA+F;AAC/F,mGAAmG;AACnG,iGAAiG;AACjG,oGAAoG;AACpG,qCAAqC;AACrC,kGAAkG;AAClG,yGAAyG;AACzG,4GAA4G;AAC5G,sGAAsG;AACtG,oGAAoG;AACpG,oGAAoG;AACpG,qGAAqG;AACrG,mGAAmG;AACnG,mGAAmG;AACnG,gGAAgG;AAChG,+FAA+F;AAC/F,iGAAiG;AACjG,oGAAoG;AACpG,kEAAkE;AAClE,qGAAqG;AACrG,wGAAwG;AACxG,sGAAsG;AACtG,0GAA0G;AAC1G,2GAA2G;AAC3G,yGAAyG;AACzG,oGAAoG;AACpG,iFAAiF;AACjF,wGAAwG;AACxG,4GAA4G;AAC5G,0GAA0G;AAC1G,uGAAuG;AACvG,2GAA2G;AAC3G,0GAA0G;AAC1G,wGAAwG;AACxG,mGAAmG;AACnG,4GAA4G;AAC5G,0GAA0G;AAC1G,2GAA2G;AAC3G,qFAAqF;AACrF,kGAAkG;AAClG,qGAAqG;AACrG,uGAAuG;AACvG,mGAAmG;AACnG,0FAA0F;AAC1F,qGAAqG;AACrG,kGAAkG;AAClG,uGAAuG;AACvG,+EAA+E;AAC/E,uGAAuG;AACvG,uGAAuG;AACvG,gEAAgE;AAChE,2FAA2F;AAC3F,iGAAiG;AACjG,qGAAqG;AACrG,sGAAsG;AACtG,qGAAqG;AACrG,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAW,CAAC;AAEjD;wFACwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/protocol/version.ts"],"names":[],"mappings":"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"}

package/dist/three/perf-marks.d.ts

@@ -17,27 +17,8 @@
  * Browser-only (uses `performance.now()` + `window`). Part of the optional
  * `@rydr/game-sdk/three` entry point.
  */
-/** One label's rolling stats over the last {@link SAMPLES} measures. */
-export interface PerfReportEntry {
-    avg: number;
-    max: number;
-    n: number;
-}
-/** Snapshot of every recorded label. */
-export type PerfReport = Record<string, PerfReportEntry>;
-declare global {
-    interface Window {
-        __PERF__?: boolean;
-        __perfReport?: () => PerfReport | null;
-    }
-    interface WindowEventMap {
-        /** Fired by the SDK when the built-in secret button code toggles the perf overlay.
-         *  `detail.on` is the new visibility state. See `connectToPlatform`. */
-        "rydr:perf-toggle": CustomEvent<{
-            on: boolean;
-        }>;
-    }
-}
+import type { PerfReport, PerfReportEntry } from "../protocol/perf.js";
+export type { PerfReport, PerfReportEntry };
 /** Start a timing region under `label`. No-op unless `window.__PERF__` is set. */
 export declare function perfMark(label: string): void;
 /**

package/dist/three/perf-marks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"perf-marks.d.ts","sourceRoot":"","sources":["../../src/three/perf-marks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;CACX;AACD,wCAAwC;AACxC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEzD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,UAAU,GAAG,IAAI,CAAC;KACxC;IACD,UAAU,cAAc;QACtB;gFACwE;QACxE,kBAAkB,EAAE,WAAW,CAAC;YAAE,EAAE,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KAClD;CACF;AAMD,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG5C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAY/C;AAED,iFAAiF;AACjF,wBAAgB,UAAU,IAAI,UAAU,GAAG,IAAI,CAU9C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9C"}
+{"version":3,"file":"perf-marks.d.ts","sourceRoot":"","sources":["../../src/three/perf-marks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AAU5C,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG5C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAY/C;AAED,iFAAiF;AACjF,wBAAgB,UAAU,IAAI,UAAU,GAAG,IAAI,CAU9C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9C"}

package/dist/three/perf-marks.js.map

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

package/dist/ui/README.md

@@ -48,6 +48,9 @@ feed its `{x, y, onScreen}` into `setScreenPos`/`setVisible` — don't compute p
 | `mountChoiceCard(host, opts)` | fn | A player choice menu: prompt + highlighted option list (▲▼ move, A confirm). |
 | `mountRarityCard(host, opts)` / `buildRarityCard(opts)` | fn | A generic rarity-tinted item/creature card. |
 | `createPowerRace(opts)` | fn | A timed **power-vs-deadline race** overlay — the "push NOW or lose it" beat. A charge bar (∫power dt) races a clock; first to 100% wins. `start()` then `setPower(w)`+`tick(dt)` per frame; `won`/`lost` via `onResolve`. Recolour with `theme`, relabel with `text`. |
+| `mountHeatVignette(host, opts)` | fn | **Screen-edge heat vignette alone** — the peripheral amber→orange→red glow that escalates with heat. Take this when your game draws its own heat bar. `setHeat(heat01, locked)` per frame. |
+| `mountOverheatGlitch(host, opts)` | fn | **Lockout glitch overlay alone** — one-shot RGB chromatic burst on entry, then scanlines + red noise for the lockout. `setLocked(bool)` per frame. |
+| `mountOverheatHudBar(host, opts)` | fn | **The whole overheat package**: centred inferno bar + label + COOLING DOWN countdown, composing the vignette and glitch above. One `update(heat01, locked, lockoutRemaining)` per frame. |
 | `injectCss()` | fn | Force the `.rydr-ui-*` CSS into `<head>` early (components call it for you). |
 
 Types: `DiamondButton` (`"DIAMOND_UP"\|"DIAMOND_DOWN"\|"DIAMOND_LEFT"\|"DIAMOND_RIGHT"`), `DirButton`, `KeycapVariant` (`"full"\|"solo"`),

package/dist/ui/heat-vignette.d.ts

@@ -0,0 +1,75 @@
+/**
+ * `mountHeatVignette` — the **screen-edge heat vignette**, on its own.
+ *
+ * A peripheral "you are cooking" cue: a coloured glow bleeding in from the edges of the play area
+ * that escalates amber → orange → red as heat rises, pulsing faster at each stage. It reads in
+ * peripheral vision while the player's eyes are on the road, which is exactly what a heat mechanic
+ * needs — the player should feel the danger without looking at a bar.
+ *
+ * This is the vignette **alone**, deliberately separable: a game that draws its own heat bar (e.g.
+ * the racing game's in-canvas gauge) still wants the peripheral cue. Pair it with
+ * {@link mountOverheatGlitch} for the lockout flash, or take the whole pre-assembled package —
+ * bar + vignette + glitch — from {@link mountOverheatHudBar}.
+ *
+ * Self-contained DOM/CSS like the rest of `@rydr/game-sdk/ui`: it injects its own scoped
+ * `.rydr-heat-vignette*` stylesheet once into `<head>`, needs no global styles, no CSS variables and
+ * no three.js. It takes a **0..1 heat value**, not a `session` — the game owns its heat model and
+ * feeds the ratio in.
+ *
+ * ```ts
+ * const vignette = mountHeatVignette(hudHost);
+ * // every frame:
+ * vignette.setHeat(heat.fillRatio, heat.isLocked);
+ * // on teardown:
+ * vignette.dispose();
+ * ```
+ *
+ * **Host contract:** the vignette is `position: absolute; inset: 0` and sits at `z-index: 19`, so
+ * `host` must be positioned (and ideally `isolation: isolate`, so the z-index doesn't leak past it).
+ * A full-viewport `position: fixed; inset: 0; pointer-events: none; isolation: isolate` div over the
+ * game canvas is the intended host.
+ */
+/** Discrete escalation stage of a heat cue. Drives the vignette colour + pulse rate. */
+export type HeatStage = "idle" | "warn" | "crit" | "danger";
+/**
+ * Default heat levels (0..1) at which each stage kicks in. `heat ∈ [warn, crit)` is a slow amber
+ * pulse, `[crit, danger)` a faster orange one, `[danger, 1]` the red panic pulse. Override per-mount
+ * with {@link HeatVignetteOptions.thresholds} when a game's own bar escalates on a different curve —
+ * keep the two in sync so the peripheral cue and the bar tell the same story.
+ */
+export declare const HEAT_STAGE_THRESHOLDS: Readonly<Record<Exclude<HeatStage, "idle">, number>>;
+/** Classify a 0..1 heat value into a {@link HeatStage} using `thresholds` (default {@link HEAT_STAGE_THRESHOLDS}). */
+export declare function heatStageFor(heat01: number, thresholds?: Readonly<Record<Exclude<HeatStage, "idle">, number>>): HeatStage;
+/** Options for {@link mountHeatVignette}. */
+export interface HeatVignetteOptions {
+    /** Stage cut-offs (0..1). Default {@link HEAT_STAGE_THRESHOLDS}. */
+    thresholds?: Readonly<Record<Exclude<HeatStage, "idle">, number>>;
+    /**
+     * Stacking order inside the host. Default `19` — under {@link mountOverheatHudBar}'s bar (20) and
+     * glitch overlay (21), so the three compose in the intended order when used together.
+     */
+    zIndex?: number;
+}
+/** Live handle to a mounted heat vignette. Returned by {@link mountHeatVignette}. */
+export interface HeatVignette {
+    /** The vignette element (already appended to the host). */
+    readonly root: HTMLDivElement;
+    /**
+     * Drive the vignette for one frame.
+     *
+     * @param heat01 Heat as a 0..1 ratio; classified into a stage via the mount's thresholds.
+     * @param locked True while the game is in its overheat lockout — forces the `danger` stage for the
+     *   whole window, so the peripheral cue stays bright even as heat drains during a forced cooldown.
+     */
+    setHeat(heat01: number, locked?: boolean): void;
+    /** Force a stage directly, bypassing the heat→stage mapping (for scripted moments/cutscenes). */
+    setStage(stage: HeatStage): void;
+    /** Remove the vignette from the host. Idempotent. */
+    dispose(): void;
+}
+/**
+ * Mount a heat vignette into `host`. See the module header for the host contract; drive it every
+ * frame with {@link HeatVignette.setHeat}.
+ */
+export declare function mountHeatVignette(host: HTMLElement, opts?: HeatVignetteOptions): HeatVignette;
+//# sourceMappingURL=heat-vignette.d.ts.map

package/dist/ui/heat-vignette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heat-vignette.d.ts","sourceRoot":"","sources":["../../src/ui/heat-vignette.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,wFAAwF;AACxF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAChC,CAAC;AAExD,sHAAsH;AACtH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAyB,GACvF,SAAS,CAKX;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAClE;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChD,iGAAiG;IACjG,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,qDAAqD;IACrD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,mBAAwB,GAC7B,YAAY,CA8Bd"}

package/dist/ui/heat-vignette.js

@@ -0,0 +1,126 @@
+/**
+ * `mountHeatVignette` — the **screen-edge heat vignette**, on its own.
+ *
+ * A peripheral "you are cooking" cue: a coloured glow bleeding in from the edges of the play area
+ * that escalates amber → orange → red as heat rises, pulsing faster at each stage. It reads in
+ * peripheral vision while the player's eyes are on the road, which is exactly what a heat mechanic
+ * needs — the player should feel the danger without looking at a bar.
+ *
+ * This is the vignette **alone**, deliberately separable: a game that draws its own heat bar (e.g.
+ * the racing game's in-canvas gauge) still wants the peripheral cue. Pair it with
+ * {@link mountOverheatGlitch} for the lockout flash, or take the whole pre-assembled package —
+ * bar + vignette + glitch — from {@link mountOverheatHudBar}.
+ *
+ * Self-contained DOM/CSS like the rest of `@rydr/game-sdk/ui`: it injects its own scoped
+ * `.rydr-heat-vignette*` stylesheet once into `<head>`, needs no global styles, no CSS variables and
+ * no three.js. It takes a **0..1 heat value**, not a `session` — the game owns its heat model and
+ * feeds the ratio in.
+ *
+ * ```ts
+ * const vignette = mountHeatVignette(hudHost);
+ * // every frame:
+ * vignette.setHeat(heat.fillRatio, heat.isLocked);
+ * // on teardown:
+ * vignette.dispose();
+ * ```
+ *
+ * **Host contract:** the vignette is `position: absolute; inset: 0` and sits at `z-index: 19`, so
+ * `host` must be positioned (and ideally `isolation: isolate`, so the z-index doesn't leak past it).
+ * A full-viewport `position: fixed; inset: 0; pointer-events: none; isolation: isolate` div over the
+ * game canvas is the intended host.
+ */
+const STYLE_ID = "rydr-heat-vignette-css";
+/**
+ * Default heat levels (0..1) at which each stage kicks in. `heat ∈ [warn, crit)` is a slow amber
+ * pulse, `[crit, danger)` a faster orange one, `[danger, 1]` the red panic pulse. Override per-mount
+ * with {@link HeatVignetteOptions.thresholds} when a game's own bar escalates on a different curve —
+ * keep the two in sync so the peripheral cue and the bar tell the same story.
+ */
+export const HEAT_STAGE_THRESHOLDS = Object.freeze({ warn: 0.5, crit: 0.65, danger: 0.8 });
+/** Classify a 0..1 heat value into a {@link HeatStage} using `thresholds` (default {@link HEAT_STAGE_THRESHOLDS}). */
+export function heatStageFor(heat01, thresholds = HEAT_STAGE_THRESHOLDS) {
+    if (heat01 >= thresholds.danger)
+        return "danger";
+    if (heat01 >= thresholds.crit)
+        return "crit";
+    if (heat01 >= thresholds.warn)
+        return "warn";
+    return "idle";
+}
+/**
+ * Mount a heat vignette into `host`. See the module header for the host contract; drive it every
+ * frame with {@link HeatVignette.setHeat}.
+ */
+export function mountHeatVignette(host, opts = {}) {
+    injectCss();
+    const thresholds = opts.thresholds ?? HEAT_STAGE_THRESHOLDS;
+    const root = document.createElement("div");
+    root.className = "rydr-heat-vignette";
+    if (opts.zIndex !== undefined)
+        root.style.zIndex = String(opts.zIndex);
+    host.appendChild(root);
+    // Cache the applied stage so we only touch classList on a transition, not every frame.
+    let lastStage = "idle";
+    const setStage = (stage) => {
+        if (stage === lastStage)
+            return;
+        root.classList.remove("stage-warn", "stage-crit", "stage-danger");
+        if (stage !== "idle")
+            root.classList.add(`stage-${stage}`);
+        lastStage = stage;
+    };
+    return {
+        root,
+        setStage,
+        setHeat(heat01, locked = false) {
+            const clamped = Math.max(0, Math.min(1, heat01 || 0));
+            setStage(locked ? "danger" : heatStageFor(clamped, thresholds));
+        },
+        dispose() {
+            root.remove();
+        },
+    };
+}
+let cssInjected = false;
+/** Inject the scoped vignette CSS once per document. */
+function injectCss() {
+    if (cssInjected || document.getElementById(STYLE_ID)) {
+        cssInjected = true;
+        return;
+    }
+    const style = document.createElement("style");
+    style.id = STYLE_ID;
+    style.textContent = CSS;
+    document.head.appendChild(style);
+    cssInjected = true;
+}
+const CSS = `
+.rydr-heat-vignette {
+  position: absolute;
+  inset: 0;
+  pointer-events: none;
+  z-index: 19;
+  opacity: 0;
+  transition: opacity 0.2s;
+  box-shadow: inset 0 0 0 0 transparent;
+}
+.rydr-heat-vignette.stage-warn {
+  opacity: 1;
+  box-shadow: inset 0 0 80px rgba(251, 191, 36, 0.35);
+}
+.rydr-heat-vignette.stage-crit {
+  opacity: 1;
+  box-shadow: inset 0 0 120px rgba(249, 115, 22, 0.55);
+  animation: rydr-heat-vignette-pulse 0.7s ease-in-out infinite;
+}
+.rydr-heat-vignette.stage-danger {
+  opacity: 1;
+  box-shadow: inset 0 0 180px rgba(239, 68, 68, 0.85);
+  animation: rydr-heat-vignette-pulse 0.3s ease-in-out infinite;
+}
+@keyframes rydr-heat-vignette-pulse {
+  0%, 100% { filter: brightness(0.7); }
+  50%      { filter: brightness(1.25); }
+}
+`;
+//# sourceMappingURL=heat-vignette.js.map

package/dist/ui/heat-vignette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heat-vignette.js","sourceRoot":"","sources":["../../src/ui/heat-vignette.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAK1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAExD,sHAAsH;AACtH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,aAAmE,qBAAqB;IAExF,IAAI,MAAM,IAAI,UAAU,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IACjD,IAAI,MAAM,IAAI,UAAU,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAC7C,IAAI,MAAM,IAAI,UAAU,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AA+BD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAiB,EACjB,OAA4B,EAAE;IAE9B,SAAS,EAAE,CAAC;IACZ,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,qBAAqB,CAAC;IAE5D,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,GAAG,oBAAoB,CAAC;IACtC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAEvB,uFAAuF;IACvF,IAAI,SAAS,GAAc,MAAM,CAAC;IAElC,MAAM,QAAQ,GAAG,CAAC,KAAgB,EAAQ,EAAE;QAC1C,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO;QAChC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;QAClE,IAAI,KAAK,KAAK,MAAM;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;QAC3D,SAAS,GAAG,KAAK,CAAC;IACpB,CAAC,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,OAAO,CAAC,MAAc,EAAE,MAAM,GAAG,KAAK;YACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;YACtD,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,OAAO;YACL,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,wDAAwD;AACxD,SAAS,SAAS;IAChB,IAAI,WAAW,IAAI,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,WAAW,GAAG,IAAI,CAAC;QACnB,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC;IACpB,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BX,CAAC"}

package/dist/ui/index.d.ts

@@ -5,6 +5,10 @@
  * choice menu, a labeled diamond, a solo labeled diamond, and a generic rarity card). Games use it to show "which button to
  * press" in one consistent visual language across the library.
  *
+ * It also carries the **overheat HUD family** — the screen-edge heat vignette, the lockout glitch
+ * overlay, and the pre-assembled bar that composes both — so every game with a heat mechanic shares
+ * one look and can take just the pieces it needs (a game drawing its own bar takes only the cues).
+ *
  * Self-contained, like `@rydr/game-sdk/three`'s perf-overlay: it injects its own scoped `.rydr-ui-*`
  * CSS once into `<head>`, depends on no global styles or CSS variables, and pulls in no three.js — so
  * a game gets the look just by constructing a component. Wire any keycap to real input by passing the
@@ -33,4 +37,7 @@ export * from "./solo-labeled-diamond.js";
 export * from "./rarity-card.js";
 export * from "./power-race.js";
 export * from "./admin-nav.js";
+export * from "./heat-vignette.js";
+export * from "./overheat-glitch.js";
+export * from "./overheat-hud-bar.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/ui/index.js

@@ -5,6 +5,10 @@
  * choice menu, a labeled diamond, a solo labeled diamond, and a generic rarity card). Games use it to show "which button to
  * press" in one consistent visual language across the library.
  *
+ * It also carries the **overheat HUD family** — the screen-edge heat vignette, the lockout glitch
+ * overlay, and the pre-assembled bar that composes both — so every game with a heat mechanic shares
+ * one look and can take just the pieces it needs (a game drawing its own bar takes only the cues).
+ *
  * Self-contained, like `@rydr/game-sdk/three`'s perf-overlay: it injects its own scoped `.rydr-ui-*`
  * CSS once into `<head>`, depends on no global styles or CSS variables, and pulls in no three.js — so
  * a game gets the look just by constructing a component. Wire any keycap to real input by passing the
@@ -33,4 +37,7 @@ export * from "./solo-labeled-diamond.js";
 export * from "./rarity-card.js";
 export * from "./power-race.js";
 export * from "./admin-nav.js";
+export * from "./heat-vignette.js";
+export * from "./overheat-glitch.js";
+export * from "./overheat-hud-bar.js";
 //# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/ui/overheat-glitch.d.ts

@@ -0,0 +1,56 @@
+/**
+ * `mountOverheatGlitch` — the **overheat lockout glitch overlay**, on its own.
+ *
+ * The "your engine just blew" screen dressing: a one-shot RGB chromatic-aberration burst on the
+ * frame the lockout begins (cyan slides left, red slides right, white pops in the middle, ~160 ms),
+ * then sustained scanlines + a red noise wash for as long as the lockout lasts. It makes a forced
+ * cooldown feel like a hardware failure rather than a stat change.
+ *
+ * This is the glitch **alone**, deliberately separable: a game that draws its own heat bar (e.g. the
+ * racing game's in-canvas gauge) still wants the lockout drama. Pair it with
+ * {@link mountHeatVignette} for the peripheral heat cue, or take the whole pre-assembled package —
+ * bar + vignette + glitch — from {@link mountOverheatHudBar}.
+ *
+ * Self-contained DOM/CSS like the rest of `@rydr/game-sdk/ui`: it injects its own scoped
+ * `.rydr-heat-glitch*` stylesheet once into `<head>`, needs no global styles, no CSS variables and no
+ * three.js. It is driven by a single boolean — the game owns the lockout state.
+ *
+ * ```ts
+ * const glitch = mountOverheatGlitch(hudHost);
+ * // every frame (edge-detected internally — cheap to call unconditionally):
+ * glitch.setLocked(heat.isLocked);
+ * // on teardown:
+ * glitch.dispose();
+ * ```
+ *
+ * **Host contract:** the overlay is `position: absolute; inset: 0` at `z-index: 21`, so `host` must
+ * be positioned (and ideally `isolation: isolate`, so the z-index doesn't leak past it). A
+ * full-viewport `position: fixed; inset: 0; pointer-events: none; isolation: isolate` div over the
+ * game canvas is the intended host.
+ */
+/** Options for {@link mountOverheatGlitch}. */
+export interface OverheatGlitchOptions {
+    /**
+     * Stacking order inside the host. Default `21` — above {@link mountHeatVignette} (19) and
+     * {@link mountOverheatHudBar}'s bar (20), so the three compose in the intended order.
+     */
+    zIndex?: number;
+}
+/** Live handle to a mounted glitch overlay. Returned by {@link mountOverheatGlitch}. */
+export interface OverheatGlitch {
+    /** The overlay element (already appended to the host). */
+    readonly root: HTMLDivElement;
+    /**
+     * Set the lockout state. Safe to call every frame — the entry burst fires only on the
+     * `false → true` edge, and the sustained dressing follows the flag.
+     */
+    setLocked(locked: boolean): void;
+    /** Remove the overlay from the host and cancel any pending entry beat. Idempotent. */
+    dispose(): void;
+}
+/**
+ * Mount an overheat glitch overlay into `host`. See the module header for the host contract; drive
+ * it with {@link OverheatGlitch.setLocked}.
+ */
+export declare function mountOverheatGlitch(host: HTMLElement, opts?: OverheatGlitchOptions): OverheatGlitch;
+//# sourceMappingURL=overheat-glitch.d.ts.map

package/dist/ui/overheat-glitch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overheat-glitch.d.ts","sourceRoot":"","sources":["../../src/ui/overheat-glitch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAOH,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,sFAAsF;IACtF,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,qBAA0B,GAC/B,cAAc,CAqChB"}

package/dist/ui/overheat-glitch.js

@@ -0,0 +1,177 @@
+/**
+ * `mountOverheatGlitch` — the **overheat lockout glitch overlay**, on its own.
+ *
+ * The "your engine just blew" screen dressing: a one-shot RGB chromatic-aberration burst on the
+ * frame the lockout begins (cyan slides left, red slides right, white pops in the middle, ~160 ms),
+ * then sustained scanlines + a red noise wash for as long as the lockout lasts. It makes a forced
+ * cooldown feel like a hardware failure rather than a stat change.
+ *
+ * This is the glitch **alone**, deliberately separable: a game that draws its own heat bar (e.g. the
+ * racing game's in-canvas gauge) still wants the lockout drama. Pair it with
+ * {@link mountHeatVignette} for the peripheral heat cue, or take the whole pre-assembled package —
+ * bar + vignette + glitch — from {@link mountOverheatHudBar}.
+ *
+ * Self-contained DOM/CSS like the rest of `@rydr/game-sdk/ui`: it injects its own scoped
+ * `.rydr-heat-glitch*` stylesheet once into `<head>`, needs no global styles, no CSS variables and no
+ * three.js. It is driven by a single boolean — the game owns the lockout state.
+ *
+ * ```ts
+ * const glitch = mountOverheatGlitch(hudHost);
+ * // every frame (edge-detected internally — cheap to call unconditionally):
+ * glitch.setLocked(heat.isLocked);
+ * // on teardown:
+ * glitch.dispose();
+ * ```
+ *
+ * **Host contract:** the overlay is `position: absolute; inset: 0` at `z-index: 21`, so `host` must
+ * be positioned (and ideally `isolation: isolate`, so the z-index doesn't leak past it). A
+ * full-viewport `position: fixed; inset: 0; pointer-events: none; isolation: isolate` div over the
+ * game canvas is the intended host.
+ */
+const STYLE_ID = "rydr-heat-glitch-css";
+/** How long the one-shot entry burst is allowed to run before its marker class is cleared (ms). */
+const ENTRY_BEAT_MS = 500;
+/**
+ * Mount an overheat glitch overlay into `host`. See the module header for the host contract; drive
+ * it with {@link OverheatGlitch.setLocked}.
+ */
+export function mountOverheatGlitch(host, opts = {}) {
+    injectCss();
+    const root = document.createElement("div");
+    root.className = "rydr-heat-glitch";
+    if (opts.zIndex !== undefined)
+        root.style.zIndex = String(opts.zIndex);
+    root.innerHTML = `
+    <div class="rydr-heat-glitch-scanlines"></div>
+    <div class="rydr-heat-glitch-noise"></div>
+    <div class="rydr-heat-glitch-flash">
+      <div class="flash-cyan"></div>
+      <div class="flash-red"></div>
+      <div class="flash-white"></div>
+    </div>
+  `;
+    host.appendChild(root);
+    let lastLocked = false;
+    /** Timer clearing the one-shot `.entry` marker after the entry burst. */
+    let entryTimer = 0;
+    return {
+        root,
+        setLocked(locked) {
+            if (locked === lastLocked)
+                return;
+            lastLocked = locked;
+            root.classList.toggle("locked", locked);
+            if (!locked)
+                return;
+            root.classList.add("entry");
+            clearTimeout(entryTimer);
+            entryTimer = window.setTimeout(() => root.classList.remove("entry"), ENTRY_BEAT_MS);
+        },
+        dispose() {
+            clearTimeout(entryTimer);
+            root.remove();
+        },
+    };
+}
+let cssInjected = false;
+/** Inject the scoped glitch CSS once per document. */
+function injectCss() {
+    if (cssInjected || document.getElementById(STYLE_ID)) {
+        cssInjected = true;
+        return;
+    }
+    const style = document.createElement("style");
+    style.id = STYLE_ID;
+    style.textContent = CSS;
+    document.head.appendChild(style);
+    cssInjected = true;
+}
+const CSS = `
+.rydr-heat-glitch {
+  position: absolute;
+  inset: 0;
+  pointer-events: none;
+  z-index: 21;
+  opacity: 0;
+  transition: opacity 0.2s;
+}
+.rydr-heat-glitch.locked { opacity: 1; }
+
+/* ─── SUSTAINED DRESSING ──────────────────────────────────────── */
+.rydr-heat-glitch-scanlines {
+  position: absolute;
+  inset: 0;
+  background: repeating-linear-gradient(
+    0deg,
+    rgba(0,0,0,0.18) 0 2px,
+    transparent 2px 4px
+  );
+  animation: rydr-heat-glitch-scan 0.7s linear infinite;
+}
+@keyframes rydr-heat-glitch-scan {
+  from { background-position: 0 0; }
+  to   { background-position: 0 8px; }
+}
+.rydr-heat-glitch-noise {
+  position: absolute;
+  inset: 0;
+  background:
+    radial-gradient(at 20% 30%, rgba(239,68,68,0.12), transparent 60%),
+    radial-gradient(at 80% 70%, rgba(239,68,68,0.10), transparent 55%),
+    radial-gradient(at 50% 90%, rgba(220,38,38,0.08), transparent 50%);
+  mix-blend-mode: screen;
+}
+
+/* ─── ENTRY BEAT — RGB FLASH ──────────────────────────────────────
+   Full-screen chromatic-aberration burst when the lockout begins. Cyan
+   layer slides left, red slides right, white pops in the middle. ~160 ms. */
+.rydr-heat-glitch-flash {
+  position: absolute;
+  inset: 0;
+  opacity: 0;
+  pointer-events: none;
+}
+.rydr-heat-glitch-flash .flash-cyan,
+.rydr-heat-glitch-flash .flash-red,
+.rydr-heat-glitch-flash .flash-white {
+  position: absolute;
+  inset: 0;
+  mix-blend-mode: screen;
+}
+.rydr-heat-glitch-flash .flash-cyan  { background: rgba(0,   220, 255, 0.40); }
+.rydr-heat-glitch-flash .flash-red   { background: rgba(255,   0,  80, 0.40); }
+.rydr-heat-glitch-flash .flash-white { background: rgba(255, 255, 255, 0.35); }
+
+.rydr-heat-glitch.entry .rydr-heat-glitch-flash {
+  animation: rydr-heat-glitch-flash-shell 0.16s ease-out forwards;
+}
+.rydr-heat-glitch.entry .rydr-heat-glitch-flash .flash-cyan {
+  animation: rydr-heat-glitch-shift-left 0.16s ease-out forwards;
+}
+.rydr-heat-glitch.entry .rydr-heat-glitch-flash .flash-red {
+  animation: rydr-heat-glitch-shift-right 0.16s ease-out forwards;
+}
+.rydr-heat-glitch.entry .rydr-heat-glitch-flash .flash-white {
+  animation: rydr-heat-glitch-pop 0.16s ease-out forwards;
+}
+@keyframes rydr-heat-glitch-flash-shell {
+  0%   { opacity: 0; }
+  35%  { opacity: 1; }
+  100% { opacity: 0; }
+}
+@keyframes rydr-heat-glitch-shift-left {
+  0%   { transform: translateX(0); }
+  35%  { transform: translateX(-14px); }
+  100% { transform: translateX(0); }
+}
+@keyframes rydr-heat-glitch-shift-right {
+  0%   { transform: translateX(0); }
+  35%  { transform: translateX(14px); }
+  100% { transform: translateX(0); }
+}
+@keyframes rydr-heat-glitch-pop {
+  0%, 100% { opacity: 0; }
+  35%      { opacity: 1; }
+}
+`;
+//# sourceMappingURL=overheat-glitch.js.map

package/dist/ui/overheat-glitch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overheat-glitch.js","sourceRoot":"","sources":["../../src/ui/overheat-glitch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,mGAAmG;AACnG,MAAM,aAAa,GAAG,GAAG,CAAC;AAwB1B;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAiB,EACjB,OAA8B,EAAE;IAEhC,SAAS,EAAE,CAAC;IAEZ,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,GAAG,kBAAkB,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvE,IAAI,CAAC,SAAS,GAAG;;;;;;;;GAQhB,CAAC;IACF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAEvB,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,yEAAyE;IACzE,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,OAAO;QACL,IAAI;QACJ,SAAS,CAAC,MAAe;YACvB,IAAI,MAAM,KAAK,UAAU;gBAAE,OAAO;YAClC,UAAU,GAAG,MAAM,CAAC;YACpB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5B,YAAY,CAAC,UAAU,CAAC,CAAC;YACzB,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;QACtF,CAAC;QACD,OAAO;YACL,YAAY,CAAC,UAAU,CAAC,CAAC;YACzB,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,sDAAsD;AACtD,SAAS,SAAS;IAChB,IAAI,WAAW,IAAI,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,WAAW,GAAG,IAAI,CAAC;QACnB,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC;IACpB,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuFX,CAAC"}