@oddin-gg/havik-player 2.25.0 → 2.26.0

package/dist/index.d.cts

@@ -214,8 +214,13 @@ export declare interface CreatePlayerOptions {
      * box at 1x "covers" with 960×540, and a 540p encode at 1:1 looks softer
      * than 720p downscaled into the same box. Measured on production 2026-11-01:
      * Windows viewers spent 73% of their time at ≤540p with 20–60 Mbps to spare.
-     * Unset (the default): 1 rung on displays below 2x devicePixelRatio
-     * (bandwidth permitting; the top rung is never exceeded), 0 at 2x and
+     * Unset (the default): 1 rung on displays below 2x devicePixelRatio. On
+     * LL-HLS it is earned per session — its parts download within half a part
+     * duration even at the higher rung's bitrate, the bandwidth estimate is
+     * twice that rung (kept down to 1.5x), and it has not stalled in the last
+     * 2 minutes (a stall after the first 10 s of playback drops the rung at
+     * once); streams without parts (VOD, classic live) get it as before. The
+     * top rung is never exceeded. 0 at 2x and
      * above — phones and 2x Macs keep the cover-only cap, whose rung already
      * matches their device pixels, so a rung above it would mostly cost data
      * on small screens. An explicit value applies on every display: 0 = the
@@ -266,8 +271,8 @@ export declare interface CreatePlayerOptions {
      * waiting for the next playlist to list it. The origin and CDNs hold that
      * request until the part exists, so a viewer far from the origin saves
      * about one round trip per part. Bytes reach hls.js only when it asks for
-     * the part; a hinted part it never asks for is dropped. Default: false.
-     * Ignored when `hlsConfig.fLoader` is set.
+     * the part; a hinted part it never asks for is dropped. Default: true;
+     * pass `false` to opt out. Ignored when `hlsConfig.fLoader` is set.
      */
     preloadHints?: boolean;
     /** Force an engine; 'auto' uses the native engine for FairPlay on Apple

package/dist/index.d.ts

@@ -214,8 +214,13 @@ export declare interface CreatePlayerOptions {
      * box at 1x "covers" with 960×540, and a 540p encode at 1:1 looks softer
      * than 720p downscaled into the same box. Measured on production 2026-11-01:
      * Windows viewers spent 73% of their time at ≤540p with 20–60 Mbps to spare.
-     * Unset (the default): 1 rung on displays below 2x devicePixelRatio
-     * (bandwidth permitting; the top rung is never exceeded), 0 at 2x and
+     * Unset (the default): 1 rung on displays below 2x devicePixelRatio. On
+     * LL-HLS it is earned per session — its parts download within half a part
+     * duration even at the higher rung's bitrate, the bandwidth estimate is
+     * twice that rung (kept down to 1.5x), and it has not stalled in the last
+     * 2 minutes (a stall after the first 10 s of playback drops the rung at
+     * once); streams without parts (VOD, classic live) get it as before. The
+     * top rung is never exceeded. 0 at 2x and
      * above — phones and 2x Macs keep the cover-only cap, whose rung already
      * matches their device pixels, so a rung above it would mostly cost data
      * on small screens. An explicit value applies on every display: 0 = the
@@ -266,8 +271,8 @@ export declare interface CreatePlayerOptions {
      * waiting for the next playlist to list it. The origin and CDNs hold that
      * request until the part exists, so a viewer far from the origin saves
      * about one round trip per part. Bytes reach hls.js only when it asks for
-     * the part; a hinted part it never asks for is dropped. Default: false.
-     * Ignored when `hlsConfig.fLoader` is set.
+     * the part; a hinted part it never asks for is dropped. Default: true;
+     * pass `false` to opt out. Ignored when `hlsConfig.fLoader` is set.
      */
     preloadHints?: boolean;
     /** Force an engine; 'auto' uses the native engine for FairPlay on Apple