@oddin-gg/havik-player 2.14.0 → 2.15.1

package/docs/API.md

@@ -313,6 +313,17 @@ can't crash the player: if you pass the count‑based `liveSyncDurationCount` /
 rejects mixing the two); if you set `liveSyncDuration` alone, a matching ceiling
 is derived above it.
 
+- **Futile catch‑up is stopped.** hls.js speeds playback up (to 1.5×) whenever
+  latency sits above the target, and only lowers its ambition after a counted
+  rebuffer. On an edge that is itself seconds behind, a player that keeps a
+  deeper buffer (Safari) can chase at 1.5× for a whole session without ever
+  gaining a second, which viewers see as constant stutter. The SDK watches the
+  chase on its 3 s tick: a chase at ≥1.2× that gains under 0.5 s of latency
+  over the next three ticks (12 s in all) moves the target up to where playback
+  actually is (never closer than 1 s to the drift ceiling), and the rate drops
+  back to 1.0×. One‑way for the session; `targetLatencySeconds` reflects the
+  move and `liveRetargets` counts them. A rate the host sets itself is ignored.
+
 > **Migration note:** the default `liveLatencyTarget` **dropped from 3 s to 2 s**.
 > Nothing to change: the drift ceiling stays 12 s and the ABR reaction budgets
 > are derived from the target, so they tighten with it automatically. Expect
@@ -409,7 +420,10 @@ the theme colors; customise the copy with `endedMessage`/`interruptedMessage`/`e
 `statusOverlays: false` to drive your own end/error UI from the player events.
 It auto-hides during playback, supports keyboard shortcuts (space/`k` play-pause,
 `m` mute, `f` fullscreen, `c` captions, `l` go-live, arrows seek/volume), and is
-fully keyboard- and screen-reader-accessible.
+fully keyboard- and screen-reader-accessible. On a mouse, one click on the
+picture plays/pauses. On touch, a single tap shows or hides the bar and a double
+tap plays/pauses, so bringing the controls back on a phone never pauses the
+stream.
 
 > **Fullscreen on iPhone:** iPhone Safari has no element Fullscreen API, so the
 > fullscreen button there enters the **video-native** fullscreen

package/embed/index.html

@@ -28,7 +28,7 @@
            beacons endpoint can be derived and QoE analytics is silently off.
            `analytics` is honoured from the injected config only, never the query.
     -->
-    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.14.0/dist/havik-player.global.js" integrity="sha384-c9Ga1G40pKYyNg94aH3P6p28rPoHBPXA/ZV4O1+nzRQpqZq6OVXP89Nz0RuKnbas" crossorigin="anonymous"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.15.1/dist/havik-player.global.js" integrity="sha384-QfwGP+4bjAqO+AlPAKFvmkfq4JLAYGaAFgCPt2WDyaxn4Qf7vLZrPo4fwwoy0pDQ" crossorigin="anonymous"></script>
     <script>
       HavikPlayer.bootEmbed();
     </script>

package/examples/vanilla.html

@@ -12,7 +12,7 @@
          shipped in each npm release is pinned to that release with Subresource
          Integrity, injected at publish time (scripts/inject-sri.mjs). In
          production, always use a pinned + SRI'd tag like the released copy. -->
-    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.14.0/dist/havik-player.global.js" integrity="sha384-c9Ga1G40pKYyNg94aH3P6p28rPoHBPXA/ZV4O1+nzRQpqZq6OVXP89Nz0RuKnbas" crossorigin="anonymous"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.15.1/dist/havik-player.global.js" integrity="sha384-QfwGP+4bjAqO+AlPAKFvmkfq4JLAYGaAFgCPt2WDyaxn4Qf7vLZrPo4fwwoy0pDQ" crossorigin="anonymous"></script>
     <script>
       (async () => {
         const player = await HavikPlayer.createPlayer({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddin-gg/havik-player",
-  "version": "2.14.0",
+  "version": "2.15.1",
   "description": "Havik HTML5 player SDK — LL-HLS + DRM playback for Oddin live streams (managed, bring-your-own-player, and iframe-embed modes).",
   "type": "module",
   "sideEffects": false,