@nomercy-entertainment/nomercy-video-player 2.1.9 → 2.2.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [2.1.10] — 2026-08-31
+
+### Fixed
+
+- A caption choice is a language, a variant and a format. The language memory carried the language alone, so a viewer who picked English SDH got plain English back on the next item, and a viewer who picked the `.ass` rendition got the `.vtt` of the same lines without the show's own styling. The whole descriptor is carried now and matched narrowest-first, falling back to the same language rather than to no captions when a device's list has dropped the exact variant. A bare language written by an older build still reads as a choice.
+
 ## [2.1.9] — 2026-08-31
 
 ### Changed

package/dist/index.d.ts

@@ -398,11 +398,6 @@ export declare class NMVideoPlayer<T extends VideoPlaylistItem = VideoPlaylistIt
     setTransitionStrategy: (strategy: ITransitionStrategy) => void;
     preloadStrategy: () => IPreloadStrategy;
     transitionStrategy: () => ITransitionStrategy;
-    createElement: IPlayer<VideoEventMap>['createElement'];
-    createButton: IPlayer<VideoEventMap>['createButton'];
-    createSVG: IPlayer<VideoEventMap>['createSVG'];
-    addClasses: IPlayer<VideoEventMap>['addClasses'];
-    removeClasses: IPlayer<VideoEventMap>['removeClasses'];
     _disposeBackend(): void;
 }
 /**

package/dist/index.js

@@ -11,7 +11,7 @@ import { readItemImage } from './player/itemImage.js';
 import { normalizeVideoPlaylistItem } from './player/normalize-item.js';
 import { VideoPreloadStrategy } from './player/preload.js';
 import { pickStartItem } from './player/start-selection.js';
-import { SUBTITLES_OFF, TrackLanguageMemory } from './player/track-language-memory.js';
+import { matchSubtitleTrack, SUBTITLES_OFF, TrackLanguageMemory } from './player/track-language-memory.js';
 import { titleTokenTranslations } from './plugins/desktop-ui/i18n/token-bundle.js';
 import { containedRect, FullscreenState, PipState, SubtitleState, TheaterState } from './types.js';
 export { VttChapterSource } from './adapters/chapter-source/vtt-chapters.js';
@@ -121,7 +121,7 @@ export class NMVideoPlayer extends EventEmitter {
             this.languageMemory.rememberAudio(this.audioTracks()[id]?.language);
         });
         this.on('subtitle', ({ track }) => {
-            this.languageMemory.rememberSubtitle(track === null ? SUBTITLES_OFF : this.subtitles()[track]?.language);
+            this.languageMemory.rememberSubtitle(track === null ? SUBTITLES_OFF : this.subtitles()[track]);
         });
         // Re-emit videoRect on signals that change the displayed content rect.
         this.on('duration', () => { this._emitVideoRect(); });
@@ -215,18 +215,21 @@ export class NMVideoPlayer extends EventEmitter {
      * `'en-US'`). No match → leave selection at off; no warning emitted.
      */
     _applyDefaultTracks() {
-        const rememberedSubtitle = this.languageMemory.subtitleLanguage();
-        const subtitleLang = rememberedSubtitle ?? this.options?.defaultSubtitleLanguage;
-        if (subtitleLang === SUBTITLES_OFF) {
+        const remembered = this.languageMemory.subtitleChoice();
+        const wanted = remembered
+            ?? (this.options?.defaultSubtitleLanguage
+                ? { language: this.options.defaultSubtitleLanguage }
+                : undefined);
+        if (wanted === SUBTITLES_OFF) {
             this.subtitle(-1);
         }
-        else if (subtitleLang) {
+        else if (wanted) {
             let tracks = [];
             try {
                 tracks = this.subtitles();
             }
             catch { /* not yet available */ }
-            const matchIdx = _matchLanguage(tracks.map(subtitleTrack => subtitleTrack.language), subtitleLang);
+            const matchIdx = matchSubtitleTrack(tracks, wanted, _matchLanguage);
             if (matchIdx >= 0) {
                 this.subtitle(matchIdx);
             }