@nomercy-entertainment/nomercy-player-core 2.0.2 → 2.0.3

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## [Unreleased]
 
+## [2.0.3] — 2026-07-31
+
+### Fixed
+
+- `item(target)` called between `setup()` and `ready()` addressed a queue the configured `playlist` had not seeded yet, so the cursor never moved and the choice was silently lost — a deep link naming a start item opened on the first item instead. The choice is now parked and applied the moment the pipeline seeds the queue.
+
+### Added
+
+- Screen-aware quality decisions: `detectDisplayHdr()`, `HdrOnSdrFallback` and the `hdrOnSdr` config field, plus `sizeAbrCeiling()` for capping the ladder to the space the picture is drawn in.
+
 ## [2.0.1] — 2026-07-18
 
 First published stable of the v2 line (2.0.0 was withdrawn before release, so 2.0.1 is the first stable on npm). The core now publishes under the `latest` dist-tag, so a plain `npm install @nomercy-entertainment/nomercy-player-core` resolves `2.0.1` instead of the stale `2.0.0-rc.2` that predated `publishConfig.tag`. This promotes the `2.0.0-rc.33` surface to stable with no runtime or signature changes; consumers already installing `@rc` are running the same code.

package/dist/adapters/quality/display-range.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Whether this screen can actually show HDR.
+ *
+ * `types/tracks.ts` already named the query — `matchMedia('(dynamic-range: high)')`
+ * — as how this would be answered, and nothing ever asked it. So `hdrDecision` had
+ * no input and an HDR ladder played on an SDR panel unchallenged.
+ *
+ * `video-dynamic-range` is asked first because it is the one that describes the
+ * VIDEO plane. `dynamic-range` answers for the page, and a browser can composite
+ * HDR video on a screen whose page rendering it reports as standard.
+ */
+export interface DisplayRangeProbe {
+    /** Answers a CSS media query. Injected so the decision is testable. */
+    matches: (query: string) => boolean;
+}
+/**
+ * A probe backed by the real browser, or null when there is no browser.
+ *
+ * Null rather than a probe that always says no: "there is no screen to ask" and
+ * "the screen said no" are different answers, and only the first one should leave
+ * a caller free to skip the whole question.
+ */
+export declare function browserDisplayRangeProbe(): DisplayRangeProbe | null;
+/**
+ * True only when the screen says so.
+ *
+ * Defaults to SDR when nothing can be asked, because that is the assumption whose
+ * failure is visible and recoverable: an SDR decision on an HDR panel shows a
+ * correct-looking picture at a lower rung, and an HDR decision on an SDR panel shows
+ * the washed-out one a viewer reported.
+ */
+export declare function detectDisplayHdr(probe?: DisplayRangeProbe | null): boolean;
+//# sourceMappingURL=display-range.d.ts.map

package/dist/adapters/quality/display-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-range.d.ts","sourceRoot":"","sources":["../../../src/adapters/quality/display-range.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IACjC,uEAAuE;IACvE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC;AAKD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,iBAAiB,GAAG,IAAI,CAgBnE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,iBAAiB,GAAG,IAAiC,GAAG,OAAO,CAKtG"}

package/dist/adapters/quality/display-range.js

@@ -0,0 +1,46 @@
+// -----------------------------------------------------------------------------
+//  Copyright (c) NoMercy Entertainment
+//
+//  Licensed under the Apache License, Version 2.0. See LICENSE for details.
+//
+//  SPDX-License-Identifier: Apache-2.0
+// -----------------------------------------------------------------------------
+const VIDEO_RANGE_QUERY = '(video-dynamic-range: high)';
+const PAGE_RANGE_QUERY = '(dynamic-range: high)';
+/**
+ * A probe backed by the real browser, or null when there is no browser.
+ *
+ * Null rather than a probe that always says no: "there is no screen to ask" and
+ * "the screen said no" are different answers, and only the first one should leave
+ * a caller free to skip the whole question.
+ */
+export function browserDisplayRangeProbe() {
+    if (typeof globalThis.matchMedia !== 'function')
+        return null;
+    return {
+        matches: (query) => {
+            try {
+                return globalThis.matchMedia(query).matches;
+            }
+            catch {
+                // A browser that does not understand the query throws rather than
+                // returning false, and an unknown query is not a claim about the screen.
+                return false;
+            }
+        },
+    };
+}
+/**
+ * True only when the screen says so.
+ *
+ * Defaults to SDR when nothing can be asked, because that is the assumption whose
+ * failure is visible and recoverable: an SDR decision on an HDR panel shows a
+ * correct-looking picture at a lower rung, and an HDR decision on an SDR panel shows
+ * the washed-out one a viewer reported.
+ */
+export function detectDisplayHdr(probe = browserDisplayRangeProbe()) {
+    if (probe === null)
+        return false;
+    return probe.matches(VIDEO_RANGE_QUERY) || probe.matches(PAGE_RANGE_QUERY);
+}
+//# sourceMappingURL=display-range.js.map

package/dist/adapters/quality/display-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-range.js","sourceRoot":"","sources":["../../../src/adapters/quality/display-range.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uCAAuC;AACvC,EAAE;AACF,4EAA4E;AAC5E,EAAE;AACF,uCAAuC;AACvC,gFAAgF;AAkBhF,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AACxD,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB;IACvC,IAAI,OAAO,UAAU,CAAC,UAAU,KAAK,UAAU;QAC9C,OAAO,IAAI,CAAC;IAEb,OAAO;QACN,OAAO,EAAE,CAAC,KAAa,EAAW,EAAE;YACnC,IAAI,CAAC;gBACJ,OAAO,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;YAC7C,CAAC;YACD,MAAM,CAAC;gBACN,kEAAkE;gBAClE,yEAAyE;gBACzE,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkC,wBAAwB,EAAE;IAC5F,IAAI,KAAK,KAAK,IAAI;QACjB,OAAO,KAAK,CAAC;IAEd,OAAO,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAC5E,CAAC"}

package/dist/adapters/quality/hdr-policy.d.ts

@@ -0,0 +1,80 @@
+import type { QualityLevel } from '../../types/tracks.js';
+/**
+ * What to do when HDR content meets an SDR screen.
+ *
+ * The web had `dynamicRange` on QualityLevel and nothing that read it, so an HDR
+ * ladder played on an SDR display with nothing consulted and nothing converted —
+ * a washed-out picture, and a viewer with good bandwidth gets the WORST one,
+ * because adaptation climbs into the HDR rungs on its own.
+ *
+ * This is the oracle for the native port rather than the other way round: the
+ * native trio must match the web, so new behaviour lands here first and the Kotlin
+ * and Swift sides conform. Written to mirror `HdrPolicy.kt` decision for decision
+ * so the two cannot drift.
+ */
+/**
+ * What a consumer wants when the backend cannot convert and there is no SDR rung.
+ *
+ * A choice rather than a rule, because both answers are defensible and the library
+ * is not the one who has to explain either to a viewer: `play` shows a washed-out
+ * picture, `refuse` shows none. Tone-mapping is preferred over both wherever the
+ * backend can do it, so this only decides the case where it cannot.
+ */
+export type HdrOnSdrFallback = 'play' | 'refuse';
+export type HdrDecision = {
+    kind: 'as-is';
+}
+/**
+ * Ask the backend to convert HDR to SDR as it decodes.
+ *
+ * Preferred wherever the backend can do it, on every platform that can: it needs
+ * no second rendition on the server and no bandwidth decision, and the picture is
+ * right rather than merely watchable. It costs work per frame, deliberately.
+ */
+ | {
+    kind: 'tone-map';
+}
+/**
+ * Pin adaptation to the best SDR rung the ladder has.
+ *
+ * Ahead of tone-mapping when a rung exists, because a natively-SDR stream is
+ * correct without spending anything per frame.
+ */
+ | {
+    kind: 'cap-to';
+    level: QualityLevel;
+}
+/** No SDR rung, no converter, and the consumer chose to show it anyway. */
+ | {
+    kind: 'play-unconverted';
+}
+/** No SDR rung, no converter, and the consumer chose not to. */
+ | {
+    kind: 'refuse';
+};
+/**
+ * The best SDR rung, or null when there is nothing to cap to.
+ *
+ * Null on an HDR display, and null on a ladder with no HDR in it — a cap that
+ * changes nothing still narrows what adaptation may pick if anything about the
+ * comparison is subtly wrong, and the safest constraint is the one not applied.
+ *
+ * Ordered height first then bitrate, the same ordering a quality menu uses.
+ * Falling back to the lowest rung would be a worse picture than the display can
+ * show, which is the opposite mistake.
+ */
+export declare function hdrAbrCeiling(levels: ReadonlyArray<QualityLevel>, displayHdr: boolean): QualityLevel | null;
+/** Every rung is HDR and the display is not: there is nothing to cap to. */
+export declare function isHdrUnplayable(levels: ReadonlyArray<QualityLevel>, displayHdr: boolean): boolean;
+/**
+ * The decision, cheapest correct answer first.
+ *
+ * Pure and taking booleans rather than a Screen or a backend, so every branch is
+ * provable without a device. The device answers two questions and this answers the
+ * rest.
+ *
+ * `backendCanToneMap` is not a platform constant: the same browser answers
+ * differently by codec, by decoder, and by whether hardware decoding is in use.
+ */
+export declare function hdrDecision(levels: ReadonlyArray<QualityLevel>, displayHdr: boolean, backendCanToneMap: boolean, fallback?: HdrOnSdrFallback): HdrDecision;
+//# sourceMappingURL=hdr-policy.d.ts.map

package/dist/adapters/quality/hdr-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hdr-policy.d.ts","sourceRoot":"","sources":["../../../src/adapters/quality/hdr-policy.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;;GAYG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjD,MAAM,MAAM,WAAW,GAElB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE;AACrB;;;;;;GAMG;GACA;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE;AACvB;;;;;GAKG;GACA;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE;AAC1C,2EAA2E;GACxE;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE;AAC/B,gEAAgE;GAC7D;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAMvB;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAuB3G;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAEjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAC1B,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,EACnC,UAAU,EAAE,OAAO,EACnB,iBAAiB,EAAE,OAAO,EAC1B,QAAQ,GAAE,gBAAyB,GACjC,WAAW,CAsBb"}

package/dist/adapters/quality/hdr-policy.js

@@ -0,0 +1,75 @@
+// -----------------------------------------------------------------------------
+//  Copyright (c) NoMercy Entertainment
+//
+//  Licensed under the Apache License, Version 2.0. See LICENSE for details.
+//
+//  SPDX-License-Identifier: Apache-2.0
+// -----------------------------------------------------------------------------
+function isHdr(level) {
+    return level.dynamicRange === 'hdr';
+}
+/**
+ * The best SDR rung, or null when there is nothing to cap to.
+ *
+ * Null on an HDR display, and null on a ladder with no HDR in it — a cap that
+ * changes nothing still narrows what adaptation may pick if anything about the
+ * comparison is subtly wrong, and the safest constraint is the one not applied.
+ *
+ * Ordered height first then bitrate, the same ordering a quality menu uses.
+ * Falling back to the lowest rung would be a worse picture than the display can
+ * show, which is the opposite mistake.
+ */
+export function hdrAbrCeiling(levels, displayHdr) {
+    if (displayHdr)
+        return null;
+    if (!levels.some(isHdr))
+        return null;
+    const sdr = levels.filter(level => !isHdr(level));
+    if (sdr.length === 0)
+        return null;
+    // `height` is optional on the web's QualityLevel — an audio-only rendition has
+    // none, and so does a ladder a backend has only half described. Nought sorts it
+    // below every real rung rather than above them, which is what an unknown height
+    // deserves when the question is "the best picture this screen can show".
+    return sdr.reduce((best, level) => {
+        const height = level.height ?? 0;
+        const bestHeight = best.height ?? 0;
+        if (height !== bestHeight)
+            return height > bestHeight ? level : best;
+        return (level.bitrate ?? 0) > (best.bitrate ?? 0) ? level : best;
+    });
+}
+/** Every rung is HDR and the display is not: there is nothing to cap to. */
+export function isHdrUnplayable(levels, displayHdr) {
+    return !displayHdr && levels.length > 0 && levels.every(isHdr);
+}
+/**
+ * The decision, cheapest correct answer first.
+ *
+ * Pure and taking booleans rather than a Screen or a backend, so every branch is
+ * provable without a device. The device answers two questions and this answers the
+ * rest.
+ *
+ * `backendCanToneMap` is not a platform constant: the same browser answers
+ * differently by codec, by decoder, and by whether hardware decoding is in use.
+ */
+export function hdrDecision(levels, displayHdr, backendCanToneMap, fallback = 'play') {
+    if (displayHdr)
+        return { kind: 'as-is' };
+    const ceiling = hdrAbrCeiling(levels, displayHdr);
+    if (ceiling !== null) {
+        return {
+            kind: 'cap-to',
+            level: ceiling,
+        };
+    }
+    // An ordinary SDR item on an SDR screen. An empty ladder lands here too, which
+    // is right — a backend that has not enumerated its rungs yet, or a progressive
+    // file with no ladder, must not be refused.
+    if (!isHdrUnplayable(levels, displayHdr))
+        return { kind: 'as-is' };
+    if (backendCanToneMap)
+        return { kind: 'tone-map' };
+    return fallback === 'play' ? { kind: 'play-unconverted' } : { kind: 'refuse' };
+}
+//# sourceMappingURL=hdr-policy.js.map

package/dist/adapters/quality/hdr-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hdr-policy.js","sourceRoot":"","sources":["../../../src/adapters/quality/hdr-policy.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uCAAuC;AACvC,EAAE;AACF,4EAA4E;AAC5E,EAAE;AACF,uCAAuC;AACvC,gFAAgF;AAmDhF,SAAS,KAAK,CAAC,KAAmB;IACjC,OAAO,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC;AACrC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,MAAmC,EAAE,UAAmB;IACrF,IAAI,UAAU;QACb,OAAO,IAAI,CAAC;IACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QACtB,OAAO,IAAI,CAAC;IAEb,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC;IAEb,+EAA+E;IAC/E,gFAAgF;IAChF,gFAAgF;IAChF,yEAAyE;IACzE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAEpC,IAAI,MAAM,KAAK,UAAU;YACxB,OAAO,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAE3C,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,MAAmC,EAAE,UAAmB;IACvF,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAC1B,MAAmC,EACnC,UAAmB,EACnB,iBAA0B,EAC1B,WAA6B,MAAM;IAEnC,IAAI,UAAU;QACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAE1B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,OAAO;SACd,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,+EAA+E;IAC/E,4CAA4C;IAC5C,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAE1B,IAAI,iBAAiB;QACpB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAE7B,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAChF,CAAC"}

package/dist/adapters/quality/size-policy.d.ts

@@ -0,0 +1,57 @@
+import type { QualityLevel } from '../../types/tracks.js';
+/**
+ * What to do when a 4K rung meets a 740px-wide player.
+ *
+ * Adaptation climbed the ladder on bandwidth alone, so a pane a fifth of the
+ * screen wide pulled a 3840-wide rendition and threw most of it away in the
+ * scaler — paid for three times over, in bytes, in decode and in battery.
+ *
+ * `hls.js` ships `capLevelToPlayerSize` for this and it stays off deliberately:
+ * `autoLevelCapping` is already written from `hdr-policy`'s ceiling, and two
+ * writers to one property is a bug waiting for a resize. The rule lives here so
+ * the Kotlin and Swift ports mirror one decision rather than one decision and
+ * one library's private heuristic.
+ */
+/**
+ * The smallest rung that still covers the pane, or null when nothing should cap.
+ *
+ * Smallest rather than largest: a rung above the pane is bytes the scaler
+ * discards, and a rung below it upscales into a soft picture, which is the
+ * mistake a viewer actually notices.
+ *
+ * Null on an unmeasured pane, on an empty ladder, and when the covering rung is
+ * already the tallest thing on offer — a cap that changes nothing still narrows
+ * what adaptation may pick if anything about the comparison is subtly wrong, and
+ * the safest constraint is the one not applied. The same reason `hdrAbrCeiling`
+ * returns null on a ladder with no HDR in it.
+ */
+export declare function sizeAbrCeiling(levels: ReadonlyArray<QualityLevel>, paneWidthPx: number, paneHeightPx: number): QualityLevel | null;
+/**
+ * The pane in device pixels, which is the unit a rendition is measured in.
+ *
+ * CSS pixels understate a phone or a HiDPI laptop by two or three times, so a
+ * ceiling computed from them caps a retina viewer to a picture visibly softer
+ * than the panel can draw. Mirrors `hls.js`'s own `contentScaleFactor`.
+ *
+ * The port deliberately does NOT do this: a Compose or UIKit surface is already
+ * handed its size in real pixels, so a second multiplication there would cap a
+ * rung too high.
+ */
+export declare function panePixels(element: {
+    getBoundingClientRect(): {
+        width: number;
+        height: number;
+    };
+} | null | undefined): {
+    widthPx: number;
+    heightPx: number;
+};
+/**
+ * The more restrictive of the two ceilings.
+ *
+ * Two independent reasons to cap answer different questions, so neither may
+ * overwrite the other: the lower rung satisfies both, the higher one breaks
+ * whichever constraint it clears.
+ */
+export declare function abrCeiling(hdr: QualityLevel | null, size: QualityLevel | null): QualityLevel | null;
+//# sourceMappingURL=size-policy.d.ts.map

package/dist/adapters/quality/size-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-policy.d.ts","sourceRoot":"","sources":["../../../src/adapters/quality/size-policy.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,EACnC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAClB,YAAY,GAAG,IAAI,CAyCrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACzB,OAAO,EAAE;IAAE,qBAAqB,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GACxF;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAgBvC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAanG"}

package/dist/adapters/quality/size-policy.js

@@ -0,0 +1,114 @@
+// -----------------------------------------------------------------------------
+//  Copyright (c) NoMercy Entertainment
+//
+//  Licensed under the Apache License, Version 2.0. See LICENSE for details.
+//
+//  SPDX-License-Identifier: Apache-2.0
+// -----------------------------------------------------------------------------
+/**
+ * What to do when a 4K rung meets a 740px-wide player.
+ *
+ * Adaptation climbed the ladder on bandwidth alone, so a pane a fifth of the
+ * screen wide pulled a 3840-wide rendition and threw most of it away in the
+ * scaler — paid for three times over, in bytes, in decode and in battery.
+ *
+ * `hls.js` ships `capLevelToPlayerSize` for this and it stays off deliberately:
+ * `autoLevelCapping` is already written from `hdr-policy`'s ceiling, and two
+ * writers to one property is a bug waiting for a resize. The rule lives here so
+ * the Kotlin and Swift ports mirror one decision rather than one decision and
+ * one library's private heuristic.
+ */
+/**
+ * The smallest rung that still covers the pane, or null when nothing should cap.
+ *
+ * Smallest rather than largest: a rung above the pane is bytes the scaler
+ * discards, and a rung below it upscales into a soft picture, which is the
+ * mistake a viewer actually notices.
+ *
+ * Null on an unmeasured pane, on an empty ladder, and when the covering rung is
+ * already the tallest thing on offer — a cap that changes nothing still narrows
+ * what adaptation may pick if anything about the comparison is subtly wrong, and
+ * the safest constraint is the one not applied. The same reason `hdrAbrCeiling`
+ * returns null on a ladder with no HDR in it.
+ */
+export function sizeAbrCeiling(levels, paneWidthPx, paneHeightPx) {
+    // A pane measured before layout reports zero. Capping on that answer pins the
+    // stream to its lowest rung for the whole session, so an unmeasured pane must
+    // never cap at all.
+    if (paneWidthPx <= 0 || paneHeightPx <= 0)
+        return null;
+    if (levels.length === 0)
+        return null;
+    // An undeclared width is not a narrow width. The native ladder carries no
+    // widths whatsoever, so testing a missing one against the pane would drop
+    // every rung there and land the port on a taller rendition than the web —
+    // the divergence the port exists to remove. Height is the mandatory signal;
+    // width only narrows the field when a rung actually states it.
+    const covering = levels.filter((level) => {
+        const heightCovers = (level.height ?? 0) >= paneHeightPx;
+        const widthCovers = level.width == null || level.width >= paneWidthPx;
+        return heightCovers && widthCovers;
+    });
+    if (covering.length === 0)
+        return null;
+    // `height` is optional on the web's QualityLevel — an audio-only rendition has
+    // none, and so does a ladder a backend has only half described. Nought sorts it
+    // below every real rung, which is what an unknown height deserves when the
+    // question is "the least this pane can be fed without going soft".
+    const ceiling = covering.reduce((best, level) => {
+        const height = level.height ?? 0;
+        const bestHeight = best.height ?? 0;
+        if (height !== bestHeight)
+            return height < bestHeight ? level : best;
+        return (level.bitrate ?? 0) < (best.bitrate ?? 0) ? level : best;
+    });
+    const tallest = levels.reduce((max, level) => Math.max(max, level.height ?? 0), 0);
+    if ((ceiling.height ?? 0) >= tallest)
+        return null;
+    return ceiling;
+}
+/**
+ * The pane in device pixels, which is the unit a rendition is measured in.
+ *
+ * CSS pixels understate a phone or a HiDPI laptop by two or three times, so a
+ * ceiling computed from them caps a retina viewer to a picture visibly softer
+ * than the panel can draw. Mirrors `hls.js`'s own `contentScaleFactor`.
+ *
+ * The port deliberately does NOT do this: a Compose or UIKit surface is already
+ * handed its size in real pixels, so a second multiplication there would cap a
+ * rung too high.
+ */
+export function panePixels(element) {
+    if (!element) {
+        return {
+            widthPx: 0,
+            heightPx: 0,
+        };
+    }
+    const rect = element.getBoundingClientRect();
+    const reported = typeof window === 'undefined' ? undefined : window.devicePixelRatio;
+    const scale = typeof reported === 'number' && Number.isFinite(reported) && reported > 0 ? reported : 1;
+    return {
+        widthPx: Math.round(rect.width * scale),
+        heightPx: Math.round(rect.height * scale),
+    };
+}
+/**
+ * The more restrictive of the two ceilings.
+ *
+ * Two independent reasons to cap answer different questions, so neither may
+ * overwrite the other: the lower rung satisfies both, the higher one breaks
+ * whichever constraint it clears.
+ */
+export function abrCeiling(hdr, size) {
+    if (hdr === null)
+        return size;
+    if (size === null)
+        return hdr;
+    const hdrHeight = hdr.height ?? 0;
+    const sizeHeight = size.height ?? 0;
+    if (hdrHeight !== sizeHeight)
+        return hdrHeight < sizeHeight ? hdr : size;
+    return (hdr.bitrate ?? 0) <= (size.bitrate ?? 0) ? hdr : size;
+}
+//# sourceMappingURL=size-policy.js.map

package/dist/adapters/quality/size-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-policy.js","sourceRoot":"","sources":["../../../src/adapters/quality/size-policy.ts"],"names":[],"mappings":"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"}

package/dist/adapters/retry-policy/IRetryPolicy.d.ts

@@ -1,7 +1,10 @@
 /**
  * Per-code retry behaviour. All fields except `attempts` are optional; omitting
- * `backoff` means no delay between retries (immediate). `refreshFirst: true`
- * runs the auth refresh flow before the first retry attempt — used for 401s.
+ * `backoff` means linear, and `computeBackoff` fills in `baseMs: 500` and
+ * `maxMs: 30_000` — so an unset backoff still waits 500, 1000, 1500, …
+ * Set `baseMs: 0` for immediate retries. `refreshFirst: true` runs the auth
+ * refresh flow before the first retry attempt — used for 401s, which retry with
+ * no delay because that call site passes 0 rather than reading this config.
  *
  * `attempts: 0` is the canonical "do not retry" value. The kit checks this before
  * scheduling any delay, so `baseMs` / `maxMs` are irrelevant when `attempts` is 0.

package/dist/adapters/retry-policy/IRetryPolicy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IRetryPolicy.d.ts","sourceRoot":"","sources":["../../../src/adapters/retry-policy/IRetryPolicy.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC"}
+{"version":3,"file":"IRetryPolicy.d.ts","sourceRoot":"","sources":["../../../src/adapters/retry-policy/IRetryPolicy.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC"}

package/dist/core/kit-version.js

@@ -10,4 +10,4 @@
  * Semver string for the currently running kit build.
  * Inlined at build time from package.json — no runtime JSON import needed.
  */
-export const KIT_VERSION = "2.0.2";
+export const KIT_VERSION = "2.0.3";

package/dist/core/mixins/device.d.ts

@@ -29,6 +29,8 @@ export declare const deviceMethods: {
      *   autoplay and handles a NotAllowedError from the backend.
      * - `preferred` — `'powerEfficient'` on TV and mobile, `'smooth'` on
      *   desktop; used by quality selection heuristics.
+     * - `hdrDisplay` — from `detectDisplayHdr()`, which asks the video plane
+     *   before the page and defaults to SDR when nothing can be asked.
      */
     readonly device: (this: Internals) => DeviceCapabilities;
 };

package/dist/core/mixins/device.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../src/core/mixins/device.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAwE1C,eAAO,MAAM,aAAa;IACzB;;;;OAIG;0BACQ,SAAS,KAAG,OAAO;IAI9B;;;;OAIG;8BACY,SAAS,KAAG,OAAO;IAIlC;;;OAGG;+BACa,SAAS,KAAG,OAAO;IAInC;;;;;;;;;;;OAWG;4BACU,SAAS,KAAG,kBAAkB;CAiBlC,CAAC"}
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../src/core/mixins/device.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAyE1C,eAAO,MAAM,aAAa;IACzB;;;;OAIG;0BACQ,SAAS,KAAG,OAAO;IAI9B;;;;OAIG;8BACY,SAAS,KAAG,OAAO;IAIlC;;;OAGG;+BACa,SAAS,KAAG,OAAO;IAInC;;;;;;;;;;;;;OAaG;4BACU,SAAS,KAAG,kBAAkB;CAkBlC,CAAC"}

package/dist/core/mixins/device.js

@@ -6,6 +6,7 @@
 //  SPDX-License-Identifier: Apache-2.0
 // -----------------------------------------------------------------------------
 import { browserPlatform } from '../../adapters/platform/browser.js';
+import { detectDisplayHdr } from '../../adapters/quality/display-range.js';
 let _cachedDevice;
 /**
  * UA-based device classification. Order matters: TV detection runs FIRST so
@@ -91,6 +92,8 @@ export const deviceMethods = {
      *   autoplay and handles a NotAllowedError from the backend.
      * - `preferred` — `'powerEfficient'` on TV and mobile, `'smooth'` on
      *   desktop; used by quality selection heuristics.
+     * - `hdrDisplay` — from `detectDisplayHdr()`, which asks the video plane
+     *   before the page and defaults to SDR when nothing can be asked.
      */
     device() {
         const detected = _detectDevice();
@@ -107,6 +110,7 @@ export const deviceMethods = {
             webLocksSupported,
             autoplayAllowed: 'unknown',
             preferred: detected.isTv || detected.isMobile ? 'powerEfficient' : 'smooth',
+            hdrDisplay: detectDisplayHdr(),
         };
     },
 };

package/dist/core/mixins/device.js.map

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

package/dist/core/mixins/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/core/mixins/lifecycle.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,KAAK,EACX,gBAAgB,EAEhB,WAAW,EAGX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAgB1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA4DzC,eAAO,MAAM,gBAAgB;IAC5B;;;;;;;;;;;;;;;;;;OAkBG;2BACS,SAAS,UAAU,gBAAgB,KAAG,OAAO;IA+BzD;;;;;;;;;;;;;;OAcG;2BACS,SAAS,KAAG,OAAO,CAAC,IAAI,CAAC;IAuBrC;;;;;;;;;;;;;;;;;;;;;;OAsBG;6BACiB,SAAS,KAAG,OAAO,CAAC,IAAI,CAAC;IAoD7C;;;;;OAKG;gCACc,SAAS,KAAG,UAAU;IAcvC,mGAAmG;2BACvF,SAAS,KAAG,WAAW;IAInC;;;;;OAKG;iCACe,SAAS,KAAG,aAAa,CAAC,MAAM,CAAC;IAInD;;;;OAIG;kCACgB,SAAS,QAAQ,MAAM,KAAG,IAAI;IAIjD,0FAA0F;iCACxE,SAAS,KAAG,MAAM,GAAG,SAAS;IAIhD;;;;;OAKG;8BACY,SAAS,KAAG,SAAS;CAG3B,CAAC"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/core/mixins/lifecycle.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,KAAK,EACX,gBAAgB,EAEhB,WAAW,EAGX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAgB1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA6DzC,eAAO,MAAM,gBAAgB;IAC5B;;;;;;;;;;;;;;;;;;OAkBG;2BACS,SAAS,UAAU,gBAAgB,KAAG,OAAO;IA+BzD;;;;;;;;;;;;;;OAcG;2BACS,SAAS,KAAG,OAAO,CAAC,IAAI,CAAC;IAuBrC;;;;;;;;;;;;;;;;;;;;;;OAsBG;6BACiB,SAAS,KAAG,OAAO,CAAC,IAAI,CAAC;IAoD7C;;;;;OAKG;gCACc,SAAS,KAAG,UAAU;IAcvC,mGAAmG;2BACvF,SAAS,KAAG,WAAW;IAInC;;;;;OAKG;iCACe,SAAS,KAAG,aAAa,CAAC,MAAM,CAAC;IAInD;;;;OAIG;kCACgB,SAAS,QAAQ,MAAM,KAAG,IAAI;IAIjD,0FAA0F;iCACxE,SAAS,KAAG,MAAM,GAAG,SAAS;IAIhD;;;;;OAKG;8BACY,SAAS,KAAG,SAAS;CAG3B,CAAC"}

package/dist/core/mixins/lifecycle.js

@@ -21,6 +21,7 @@ import { kitTranslations } from '../../kit-translations.js';
 import { SetupState } from '../../types/index.js';
 import { authFetch } from '../auth-fetch/index.js';
 import { wireActivityTracking } from './activity.js';
+import { applyPendingSelection } from './queue.js';
 // ──────────────────────────────────────────────────────────────────────────
 // Playlist URL resolver
 // ──────────────────────────────────────────────────────────────────────────
@@ -855,6 +856,7 @@ function _runSetupPipeline(self) {
             const playlist = self.options.playlist;
             if (typeof playlist === 'string') {
                 await _resolvePlaylistUrl(self, playlist);
+                applyPendingSelection(self);
             }
             else if (Array.isArray(playlist)) {
                 // Only seed the queue from the config array when the consumer
@@ -867,6 +869,7 @@ function _runSetupPipeline(self) {
                 if (!alreadySeeded) {
                     self.queue(playlist);
                 }
+                applyPendingSelection(self);
                 self.emit('playlistReady', { length: playlist.length });
             }
             else {