avbridge 2.8.2 → 2.8.3

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to **avbridge.js** are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.8.3]
+
+### Added
+
+- **`showControls(durationMs?)` on `<avbridge-player>`.** Public method
+  to reveal the auto-hiding chrome (top toolbar + bottom controls)
+  and re-start the auto-hide timer. Intended for app-level "flash the
+  UI" moments like a carousel slide change or focus handoff — one call
+  instead of reaching into `data-controls-hidden`. Custom duration
+  overrides the default 3 s; pointer movement during the flash resets
+  the timer so there's no flicker if the user interacts mid-flash.
+
 ## [2.8.2]
 
 Small ergonomics release driven by downstream `<avbridge-player>`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "avbridge",
-  "version": "2.8.2",
+  "version": "2.8.3",
   "description": "Play and convert arbitrary video files in the browser. Native, remux, hybrid, fallback, and transcode — one API.",
   "license": "MIT",
   "author": "Keishi Hattori",

package/src/element/avbridge-player.ts

@@ -680,13 +680,29 @@ export class AvbridgePlayerElement extends HTMLElement {
 
   // ── Controls: auto-hide ────────────────────────────────────────────────
 
-  private _showControls(): void {
+  /**
+   * Reveal the auto-hiding chrome (top toolbar + bottom controls) and
+   * re-start the auto-hide timer. Call this from app-level code to
+   * briefly surface the player UI — e.g. to confirm "you just swiped to
+   * this video" in a carousel, or to flash the title on focus change.
+   *
+   * @param durationMs  How long the chrome stays visible before fading.
+   *                    Defaults to the player's normal 3 s auto-hide.
+   *                    Pointer movement or any other interaction resets
+   *                    the timer, so a user hovering during the flash
+   *                    sees no flicker.
+   */
+  showControls(durationMs?: number): void {
     this.removeAttribute("data-controls-hidden");
     this._toolbarTop.setAttribute("data-visible", "true");
-    this._scheduleHide();
+    this._scheduleHide(durationMs);
+  }
+
+  private _showControls(): void {
+    this.showControls();
   }
 
-  private _scheduleHide(): void {
+  private _scheduleHide(durationMs: number = CONTROLS_HIDE_MS): void {
     if (this._controlsTimer) clearTimeout(this._controlsTimer);
     if (this._state !== "playing" && this._state !== "buffering") return;
     if (this._settingsOpen) return;
@@ -695,7 +711,7 @@ export class AvbridgePlayerElement extends HTMLElement {
         this.setAttribute("data-controls-hidden", "");
         this._toolbarTop.setAttribute("data-visible", "false");
       }
-    }, CONTROLS_HIDE_MS);
+    }, durationMs);
   }
 
   // Strategy is visible in Stats for Nerds, no badge in controls bar.