@nomercy-entertainment/nomercy-video-player 2.1.1 → 2.1.2

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+## [2.1.2] — 2026-08-29
+
+### Fixed
+
+- ASS/SSA subtitles rendered in the wrong face. The libass font map was keyed by the attachment's filename, so a release whose attachments are not named after their family resolved nothing and every line fell back to an arbitrary attached font. Keys now come from the font's own name table.
+- The chosen audio and subtitle language is remembered and re-applied on every item, instead of the player trusting a track index and the playlist's `DEFAULT` flag — both of which differ per file, so a picked language was lost on the next episode.
+- A selected track index left over from the previous item no longer ticks in the menu while the stream plays a different track.
+
 ## [2.1.0] — 2026-08-20
 
 ### Added

package/README.md

@@ -1,4 +1,4 @@
-[![npm](https://img.shields.io/npm/v/@nomercy-entertainment/nomercy-video-player/rc?label=rc)](https://www.npmjs.com/package/@nomercy-entertainment/nomercy-video-player)
+[![npm](https://img.shields.io/npm/v/@nomercy-entertainment/nomercy-video-player/latest?label=latest)](https://www.npmjs.com/package/@nomercy-entertainment/nomercy-video-player)
 [![license](https://img.shields.io/npm/l/@nomercy-entertainment/nomercy-video-player)](./LICENSE)
 [![bundlephobia](https://img.shields.io/bundlephobia/minzip/@nomercy-entertainment/nomercy-video-player)](https://bundlephobia.com/package/@nomercy-entertainment/nomercy-video-player)
 

package/dist/index.d.ts

@@ -172,6 +172,12 @@ export declare class NMVideoPlayer<T extends VideoPlaylistItem = VideoPlaylistIt
     plugins: () => ReadonlyArray<Plugin>;
     enabledPlugins: () => ReadonlyArray<Plugin>;
     constructor(id?: string | number);
+    private _languageMemoryInstance;
+    /**
+     * Carries the viewer's chosen audio / subtitle language across items. Built
+     * on first use — `options` is not assigned yet when fields initialise.
+     */
+    private get languageMemory();
     private _wantedPoster;
     private _defaultQualityApplied;
     /**

package/dist/index.js

@@ -11,6 +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 { 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';
@@ -111,6 +112,17 @@ export class NMVideoPlayer extends EventEmitter {
             this._applyDefaultTracks();
             this._emitVideoRect();
         });
+        // 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.
+        this.on('audioTrack', ({ id }) => {
+            if (id === null)
+                return;
+            this.languageMemory.rememberAudio(this.audioTracks()[id]?.language);
+        });
+        this.on('subtitle', ({ track }) => {
+            this.languageMemory.rememberSubtitle(track === null ? SUBTITLES_OFF : this.subtitles()[track]?.language);
+        });
         // Re-emit videoRect on signals that change the displayed content rect.
         this.on('duration', () => { this._emitVideoRect(); });
         this.on('fullscreen', () => { this._emitVideoRect(); });
@@ -129,6 +141,15 @@ export class NMVideoPlayer extends EventEmitter {
             catch { /* backend may not be ready yet — ignore */ }
         });
     }
+    _languageMemoryInstance;
+    /**
+     * Carries the viewer's chosen audio / subtitle language across items. Built
+     * on first use — `options` is not assigned yet when fields initialise.
+     */
+    get languageMemory() {
+        this._languageMemoryInstance ??= new TrackLanguageMemory(this.options?.storage);
+        return this._languageMemoryInstance;
+    }
     _wantedPoster = null;
     _defaultQualityApplied = false;
     /**
@@ -194,8 +215,12 @@ export class NMVideoPlayer extends EventEmitter {
      * `'en-US'`). No match → leave selection at off; no warning emitted.
      */
     _applyDefaultTracks() {
-        const subtitleLang = this.options?.defaultSubtitleLanguage;
-        if (subtitleLang) {
+        const rememberedSubtitle = this.languageMemory.subtitleLanguage();
+        const subtitleLang = rememberedSubtitle ?? this.options?.defaultSubtitleLanguage;
+        if (subtitleLang === SUBTITLES_OFF) {
+            this.subtitle(-1);
+        }
+        else if (subtitleLang) {
             let tracks = [];
             try {
                 tracks = this.subtitles();
@@ -206,17 +231,35 @@ export class NMVideoPlayer extends EventEmitter {
                 this.subtitle(matchIdx);
             }
         }
-        const audioLang = this.options?.defaultAudioLanguage;
-        if (audioLang) {
-            let tracks = [];
-            try {
-                tracks = this.audioTracks();
-            }
-            catch { /* not yet available */ }
-            const matchIdx = _matchLanguage(tracks.map(audioTrack => audioTrack.language), audioLang);
-            if (matchIdx >= 0) {
+        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
+        // the backend alone rather than reading its track list for no reason.
+        if (!audioLang && selectedIdx === null)
+            return;
+        let audioTracks = [];
+        try {
+            audioTracks = this.audioTracks();
+        }
+        catch { /* not yet available */ }
+        const matchIdx = audioLang
+            ? _matchLanguage(audioTracks.map(audioTrack => audioTrack.language), audioLang)
+            : -1;
+        // With no language to honour, fall back to whichever rendition the stream
+        // marks default. The selected index survives an item change, so a stale
+        // one left alone ticks the previous item's track in the menu while the
+        // stream plays its own default.
+        const targetIdx = matchIdx >= 0
+            ? matchIdx
+            : audioTracks.findIndex(audioTrack => audioTrack.default === true);
+        if (matchIdx >= 0) {
+            if (selectedIdx !== matchIdx)
                 this.audioTrack(matchIdx);
-            }
+        }
+        // Nothing to honour: only correct a selection that actually disagrees.
+        // Re-asserting the track already playing costs a switch for no change.
+        else if (targetIdx >= 0 && selectedIdx !== null && selectedIdx !== targetIdx) {
+            this.audioTrack(targetIdx);
         }
     }
     /** Test-only: clear the registry. Not part of the public API. */