feat(playlist-plugin): implement smart navigation based on playback position

[jboix]

Description

Resolves #17 by implementing smart navigation to the previous item in the playlist based on the current playback position:

• If playback is beyond the threshold, the current media is restarted.
• If playback is within the threshold, the previous item is navigated to.
• For live media, the previous items is always played regardless of the current playback position.
• The threshold functionality can be disabled by setting the value to undefined.

Example usage:

import pillarbox from '@srgssr/pillarbox-web';
import './src/pillarbox-playlist-ui.js';

window.player = pillarbox('player', {
  plugins: {
    pillarboxPlaylist: {
      // The threshold in seconds
      previousNavigationThreshold: 10
    }
  }
});

Changes Made

• Adapted the previous function to observe the threshold value.
• Added the possibility to define the threshold through the plugin options.
• The threshold can be modified at runtime through the plugin properties.

Checklist

• [x] I have followed the project's style and contribution guidelines.
• [x] I have performed a self-review of my own changes.
• [x] I have made corresponding changes to the documentation.
• [x] I have added tests that prove my fix is effective or that my feature works.

[github-actions[bot]]

Coverage Report

Status	Category	Percentage	Covered / Total
🔵	Lines	94.47%	958 / 1014
🔵	Statements	94.47%	958 / 1014
🔵	Functions	94.2%	65 / 69
🔵	Branches	92.23%	95 / 103

File Coverage

File	Stmts	% Branch	% Funcs	% Lines	Uncovered Lines
Changed Files
packages/pillarbox-playlist/src/pillarbox-playlist.js	98.84%	89.36%	95.83%	98.84%	107-110, 394

Generated in workflow #75

[github-actions[bot]]

PR Preview Action v1.4.7 :---: Preview removed because the pull request was closed. 2024-06-21 09:34 UTC

[github-actions[bot]]

:tada: This PR is included in version @srgssr/pillarbox-playlist-v1.2.0 :tada:

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot :package::rocket: