@nomercy-entertainment/nomercy-video-player 2.2.2 → 2.2.4

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 ## [Unreleased]
 
+## [2.2.4] — 2026-10-08
+
+### Fixed
+
+- Core 2.2.4: the saved volume no longer turns to 0 after a mute.
+- A language-only caption pick now lands on the full track before a sign-language or forced one.
+- Only the viewer's own caption pick is remembered.
+- The viewer's caption size now applies to ASS tracks and redraws when it changes.
+
+## [2.2.3] — 2026-09-25
+
+### Added
+
+- `disableClickToPause` in `setup()` stops a click from pausing the video.
+
+### Fixed
+
+- Streams added with `registerStream()` are now used for playback.
+- Playlist thumbnails load from the configured image URL.
+- Changing auth at runtime now applies to media requests.
+- Georgia subtitles fall back to a serif font, and subtitle colors match the palette.
+- One press of `?` opens the shortcuts overlay.
+- Cast artwork shows the right image, and the media-key option works.
+- The help key on a TV remote works.
+
 ## [2.2.2] — 2026-09-04
 
 ### Fixed

package/dist/adapters/video-backend/IVideoBackend.d.ts

@@ -1,5 +1,11 @@
-import type { AudioTrack, AuthHeaderProvider, BackendLoaderState, BackendState, HdrOnSdrFallback, MinimalBackendEventPayload, QualityLevel, SubtitleCueChange, SubtitleTrack } from '@nomercy-entertainment/nomercy-player-core';
+import type { AudioTrack, AuthHeaderProvider, BackendLoaderState, BackendState, HdrOnSdrFallback, IStreamSource, MinimalBackendEventPayload, QualityLevel, SubtitleCueChange, SubtitleTrack } from '@nomercy-entertainment/nomercy-player-core';
 import type { HtmlPreloadMode } from '../../types.js';
+/**
+ * Asks the player's stream registry whether a consumer registered a factory for
+ * this URL. Returns a source to play it with, or `undefined` to let the backend
+ * handle the URL the way it always has.
+ */
+export type StreamResolver = (url: string, contentType?: string) => IStreamSource | undefined;
 /**
  * Per-event payload map. Each backend event has a fixed payload shape so
  * `IVideoBackend.on(event, fn)` narrows the listener's parameter type
@@ -136,6 +142,14 @@ export interface IVideoBackend {
      * stack omit it.
      */
     setAuthHeaderProvider?(provider: AuthHeaderProvider): void;
+    /**
+     * Wire the lookup that asks the player's stream registry whether a consumer
+     * has registered a factory for a URL. The backend calls it before its own
+     * HLS and progressive handling, and falls through to that handling when the
+     * lookup returns nothing, so a player with no registered factory behaves
+     * exactly as it did before. Optional — backends with no registry omit it.
+     */
+    setStreamResolver?(resolver: StreamResolver): void;
     /**
      * Consumer policy for an all-HDR item on a display that can't show HDR and
      * a backend that can't tone-map it. Optional — backends that never face the

package/dist/adapters/video-backend/html5.d.ts

@@ -1,15 +1,16 @@
 import type { AudioTrack, HdrOnSdrFallback, QualityLevel, SubtitleTrack } from '@nomercy-entertainment/nomercy-player-core';
 import type { HtmlPreloadMode } from '../../types.js';
-import type { BackendEventPayload, BackendState, IVideoBackend } from './IVideoBackend.js';
+import type { BackendEventPayload, BackendState, IVideoBackend, StreamResolver } from './IVideoBackend.js';
 import { MediaElementBackend } from '@nomercy-entertainment/nomercy-player-core';
 /**
  * Default video backend. Wraps an `<HTMLVideoElement>` for transport.
  *
- * HLS support: native pass-through when `canPlayType` reports support
- * (Safari / iOS), otherwise dynamically imports `hls.js` (peer dep — not
- * bundled; IIFE build externalises it as `window.Hls`, ESM build resolves
- * it from the consumer's node_modules) and attaches it. MSE / WebCodecs
- * backends ship later.
+ * HLS support: native pass-through when `canPlayType` reports support,
+ * otherwise dynamically imports `hls.js` and attaches it. `hls.js` is a
+ * runtime dependency of nomercy-player-core, not a peer dependency, so an
+ * npm consumer installs it without asking. The IIFE build externalizes it
+ * as `window.Hls`; the ESM build resolves it from node_modules. MSE /
+ * WebCodecs backends ship later.
  */
 export declare class Html5VideoBackend extends MediaElementBackend<HTMLVideoElement, BackendEventPayload> implements IVideoBackend {
     readonly kind: "html5";
@@ -137,6 +138,14 @@ export declare class Html5VideoBackend extends MediaElementBackend<HTMLVideoElem
     unload(): void;
     dispose(): void;
     private _teardownAudioGraph;
+    private _streamResolver?;
+    private _customSource?;
+    /**
+     * Wire the lookup that asks the player's stream registry for a consumer's
+     * factory. Without it the backend keeps its own HLS and progressive handling
+     * and a registered factory is never consulted.
+     */
+    setStreamResolver(resolver: StreamResolver): void;
     buffered(): number;
     videoWidth(): number;
     videoHeight(): number;

package/dist/adapters/video-backend/html5.js

@@ -34,11 +34,12 @@ function humanCodec(raw) {
 /**
  * Default video backend. Wraps an `<HTMLVideoElement>` for transport.
  *
- * HLS support: native pass-through when `canPlayType` reports support
- * (Safari / iOS), otherwise dynamically imports `hls.js` (peer dep — not
- * bundled; IIFE build externalises it as `window.Hls`, ESM build resolves
- * it from the consumer's node_modules) and attaches it. MSE / WebCodecs
- * backends ship later.
+ * HLS support: native pass-through when `canPlayType` reports support,
+ * otherwise dynamically imports `hls.js` and attaches it. `hls.js` is a
+ * runtime dependency of nomercy-player-core, not a peer dependency, so an
+ * npm consumer installs it without asking. The IIFE build externalizes it
+ * as `window.Hls`; the ESM build resolves it from node_modules. MSE /
+ * WebCodecs backends ship later.
  */
 export class Html5VideoBackend extends MediaElementBackend {
     kind = 'html5';
@@ -238,6 +239,21 @@ export class Html5VideoBackend extends MediaElementBackend {
         resetMediaElement(this.element);
         performance.mark('nm:backend:load:start');
         const headerValue = this._authHeaderProvider?.(url);
+        // A consumer's factory is asked first, because the branches below cover
+        // only HLS and whatever the element itself decodes. Nothing registered
+        // means nothing returned, and the built-in path runs untouched.
+        if (this._customSource) {
+            this._customSource.destroy();
+            this._customSource = undefined;
+        }
+        const customSource = this._streamResolver?.(url);
+        if (customSource) {
+            this._customSource = customSource;
+            await customSource.attach(this.element);
+            this._state = 'ready';
+            performance.mark('nm:backend:load:end');
+            return;
+        }
         if (hlsUrl && !nativeHls) {
             const { default: Hls } = await import('hls.js');
             if (!Hls?.isSupported?.()) {
@@ -349,6 +365,16 @@ export class Html5VideoBackend extends MediaElementBackend {
     // playbackRate / volume / mute / unmute / captureStream / setSinkId /
     // getSinkId / mediaKeys / setMediaKeys / mediaElement / pauseLoader /
     // resumeLoader / loaderState / setAuthHeaderProvider
+    _streamResolver;
+    _customSource;
+    /**
+     * Wire the lookup that asks the player's stream registry for a consumer's
+     * factory. Without it the backend keeps its own HLS and progressive handling
+     * and a registered factory is never consulted.
+     */
+    setStreamResolver(resolver) {
+        this._streamResolver = resolver;
+    }
     // ── Time / position (video-specific: buffered uses currentTime walk) ──
     buffered() {
         const ranges = this.element.buffered;
@@ -381,7 +407,9 @@ export class Html5VideoBackend extends MediaElementBackend {
                 default: hlsAudioTrack.default === true,
             }));
         }
-        // Native: HTMLMediaElement.audioTracks (Safari/Chrome with multi-audio).
+        // Native: HTMLMediaElement.audioTracks. Measured absent in Chrome 152,
+        // Edge 152 and bundled Chromium, so this branch is Safari in practice
+        // and yields [] elsewhere; the HLS path above is what fills the list.
         const nativeTracks = this.element.audioTracks;
         if (nativeTracks && nativeTracks.length > 0) {
             const out = [];

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { ActionOptions, AriaLiveLevel, AudioTrack, AuthConfig, BasePlaylistItem, BufferState, CanPlayResult, CastState, CastTarget, Chapter, CurrentAudioTrackSelection, CurrentQualitySelection, CurrentSubtitleSelection, DeviceCapabilities, ICueParser, IPlatform, IPlayer, IPreloadStrategy, IStreamFactory, ITransitionStrategy, IUrlResolver, TimeState as KitTimeState, LoadOptions, NetworkState, PlaybackMetrics, PlayerExperimental, PlayerPhase, Plugin, PluginCtorWithId, QualityLevel, ResolvedUrl, SetupState, SidecarSubtitleInput, SubtitleStyle, SubtitleTrack, Translations, UrlCategory, VisibilityState } from '@nomercy-entertainment/nomercy-player-core';
+import type { ActionOptions, AriaLiveLevel, AudioTrack, AuthConfig, BasePlaylistItem, BufferState, CanPlayResult, CastState, CastTarget, Chapter, CurrentAudioTrackSelection, CurrentQualitySelection, CurrentSubtitleSelection, DeviceCapabilities, ICueParser, IPlatform, IPlayer, IPreloadStrategy, IStreamFactory, IStreamSource, ITransitionStrategy, IUrlResolver, TimeState as KitTimeState, LoadOptions, NetworkState, PlaybackMetrics, PlayerExperimental, PlayerPhase, Plugin, PluginCtorWithId, QualityLevel, ResolvedUrl, SetupState, SidecarSubtitleInput, SubtitleStyle, SubtitleTrack, Translations, UrlCategory, VisibilityState } from '@nomercy-entertainment/nomercy-player-core';
 import type { IVideoBackend, VideoBackendKind } from './adapters/video-backend/IVideoBackend.js';
 import type { AudioTrackState, IVideoPlayer, PlayState, QualityState, RepeatState, SegmentOptions, ShuffleState, Stretching, VideoEventMap, VideoPlayerConfig, VideoPlaylistItem, VideoRect, VolumeState } from './types.js';
 import { EventEmitter } from '@nomercy-entertainment/nomercy-player-core';
@@ -200,12 +200,19 @@ export declare class NMVideoPlayer<T extends VideoPlaylistItem = VideoPlaylistIt
      * `mediaReady` fires so the backend's track lists are populated.
      *
      * Language matching: exact tag first, then prefix (e.g. `'en'` matches
-     * `'en-US'`). No match → leave selection at off; no warning emitted.
+     * `'en-US'`). No match leaves an UNSELECTED slot alone, but where a track is
+     * already selected the slot is handed to the stream's own default rendition
+     * instead. No warning either way.
      */
     private _applyDefaultTracks;
+    /** True while the player picks a caption itself; such a pick is never remembered. */
+    private _selectingDefaults;
+    private _selectDefaultSubtitle;
+    private _selectDefaultAudio;
     /** Test-only: clear the registry. Not part of the public API. */
     static _resetRegistry(): void;
     registerStream: (factory: IStreamFactory, prepend?: boolean) => this;
+    resolveCustomStream: (url: string, contentType?: string) => IStreamSource | undefined;
     unregisterStream: (id: string) => this;
     streams: () => ReadonlyArray<string>;
     getStreamFactory: (id: string) => IStreamFactory | undefined;

package/dist/index.js

@@ -115,12 +115,16 @@ export class NMVideoPlayer extends EventEmitter {
         // Record the chosen LANGUAGE, not the index — an index means a different
         // language on the next file. Fires for the viewer's own pick and for the
         // selection _applyDefaultTracks restores, which write the same value.
+        // The caption slot below is different: only the viewer's pick is kept.
         this.on('audioTrack', ({ id }) => {
             if (id === null)
                 return;
             this.languageMemory.rememberAudio(this.audioTracks()[id]?.language);
         });
         this.on('subtitle', ({ track }) => {
+            // A pick _applyDefaultTracks makes is the player's, not the viewer's.
+            if (this._selectingDefaults)
+                return;
             this.languageMemory.rememberSubtitle(track === null ? SUBTITLES_OFF : this.subtitles()[track]);
         });
         // Re-emit videoRect on signals that change the displayed content rect.
@@ -212,9 +216,23 @@ export class NMVideoPlayer extends EventEmitter {
      * `mediaReady` fires so the backend's track lists are populated.
      *
      * Language matching: exact tag first, then prefix (e.g. `'en'` matches
-     * `'en-US'`). No match → leave selection at off; no warning emitted.
+     * `'en-US'`). No match leaves an UNSELECTED slot alone, but where a track is
+     * already selected the slot is handed to the stream's own default rendition
+     * instead. No warning either way.
      */
     _applyDefaultTracks() {
+        this._selectingDefaults = true;
+        try {
+            this._selectDefaultSubtitle();
+        }
+        finally {
+            this._selectingDefaults = false;
+        }
+        this._selectDefaultAudio();
+    }
+    /** True while the player picks a caption itself; such a pick is never remembered. */
+    _selectingDefaults = false;
+    _selectDefaultSubtitle() {
         const remembered = this.languageMemory.subtitleChoice();
         const wanted = remembered
             ?? (this.options?.defaultSubtitleLanguage
@@ -234,6 +252,8 @@ export class NMVideoPlayer extends EventEmitter {
                 this.subtitle(matchIdx);
             }
         }
+    }
+    _selectDefaultAudio() {
         const audioLang = this.languageMemory.audioLanguage() ?? this.options?.defaultAudioLanguage;
         const selectedIdx = this.audioTrack()?.index ?? null;
         // Nothing to honour and no selection that could have gone stale — leave
@@ -308,7 +328,14 @@ export class NMVideoPlayer extends EventEmitter {
         // lazily so getter-style tokens (Vue refs, stores) stay live.
         // Read per request rather than captured, so a consumer whose token or
         // rule changes mid-session is not answered from a stale closure.
-        instance.setAuthHeaderProvider?.((url) => this.options?.auth?.mediaAuthorization?.(url));
+        // Live config, not `options.auth`: setup seeds it and `player.auth()`
+        // updates it, so a rule set after setup reaches media requests too.
+        instance.setAuthHeaderProvider?.((url) => this.auth()?.mediaAuthorization?.(url));
+        // Without this the stream registry is seeded and never asked, so
+        // `registerStream` records a factory that no load path consults. Only
+        // consumer-registered factories are offered: HLS and progressive files
+        // stay on the backend's own path exactly as before.
+        instance.setStreamResolver?.((url, contentType) => this.resolveCustomStream?.(url, contentType));
         // Consumer's HDR-on-SDR policy, read once here rather than normalized
         // into `options` — `hdrDecision`'s own default ('play') applies at the
         // point of use when this was never pushed at all.