feat: add playlist management plugin to pillarbox player

Introduces a pillarbox playlist plugin. This plugin supports playlist loading, dynamic
modifications, auto-advancement, and repeat functionalities.

***Key Features:***

- **Initialization Options**: Configurable through an options object that can include an initial
  playlist, and settings for repeat and auto-advance behaviors.
- **Dynamic Playlist Management**: Methods to load, push, splice, and shuffle playlist items
  dynamically.
- **Playback Control**: Functions to navigate through the playlist such as next, previous, and
  select specific items.
- **State Properties**: Properties like `repeat` and `autoadvance` which can be toggled
  post-initialization to alter playback behavior.

***Example***

```javascript
import Pillarbox from '@srgssr/pillarbox-web';
import '@srgssr/pillarbox-playlist';

const player = new Pillarbox('my-player', {
  plugins: { pillarboxPlaylist: { autoadvance: true, repeat: true } }
});

const playlist = [
  { sources: [{ src: 'video1.mp4', type: 'video/mp4' }], poster: 'poster1.jpg' },
  { sources: [{ src: 'video2.mp4', type: 'video/mp4' }], poster: 'poster2.jpg' }
];

player.pillarboxPlaylist().load(...playlist);
```

packages/pillarbox-playlist/.babelrc

@@ -0,0 +1,3 @@
+{
+  "extends": "../../babel.config.json"
+}

packages/pillarbox-playlist/README.md

@@ -0,0 +1,131 @@
+# Pillarbox Web: Playlist Plugin
+
+This plugin extends the pillarbox-web player with playlist management capabilities. It allows to
+load, manage, and control playback of a sequence of videos with options for auto-advancing,
+repeating content, and dynamic playlist modification.
+
+## Requirements
+
+To use this plugin, you need the following installed on your system:
+
+- Node.js
+
+## Quick Start
+
+To get started with this plugin, follow these steps:
+
+Add the `@srgssr` registry to your `.npmrc` file:
+
+```plaintext
+//npm.pkg.github.com/:_authToken=TOKEN
+@srgssr:registry=https://npm.pkg.github.com
+```
+
+Generate a personal access token on the [Personal Access Tokens page][token-settings]. For more
+information on using tokens with GitHub packages,
+visit: [Authenticating with a Personal Access Token][token-guide].
+
+You can now install it through `npm` the following command:
+
+```bash
+npm install --save @srgssr/pillarbox-web @srgssr/pillarbox-playlist
+```
+
+For instructions on setting up Pillarbox, see
+the [Quick Start guide](SRGSSR/pillarbox-web#quick-start).
+
+Once the player is installed you can activate the plugin as follows:
+
+```javascript
+import Pillarbox from '@srgssr/pillarbox-web';
+import '@srgssr/pillarbox-playlist';
+
+const player = new Pillarbox('my-player', {
+  plugins: { pillarboxPlaylist: { autoadvance: true, repeat: true } }
+});
+
+const playlist = [
+  { sources: [{ src: 'video1.mp4', type: 'video/mp4' }], poster: 'poster1.jpg' },
+  { sources: [{ src: 'video2.mp4', type: 'video/mp4' }], poster: 'poster2.jpg' }
+];
+
+player.playlistPlugin().load(...playlist);
+```
+
+### API Documentation
+
+#### Methods
+
+The following table outlines the key methods available in the this plugin:
+
+| Function                               | Description                                                                                            |
+|----------------------------------------|--------------------------------------------------------------------------------------------------------|
+| `load(...items)`                       | Initializes the playlist with the given items and starts playback from the first item.                 |
+| `push(...items)`                       | Adds new items to the end of the current playlist.                                                     |
+| `splice(start, deleteCount, ...items)` | Modifies the playlist by adding, removing, or replacing items. Adjusts the current index if necessary. |
+| `next()`                               | Advances to the next item in the playlist, with support for repeat mode.                               |
+| `previous()`                           | Moves to the previous item in the playlist.                                                            |
+| `shuffle()`                            | Randomizes the order of the playlist items using the Fisher-Yates shuffle algorithm.                   |
+| `select(index)`                        | Selects and plays the item at the specified index in the playlist.                                     |
+
+#### Options
+
+When initializing the playlist plugin, you can pass an `options` object that configures the
+behavior of the plugin. Here are the available options:
+
+| Option        | Type    | Default | Description                                                                                 |
+|---------------|---------|---------|---------------------------------------------------------------------------------------------|
+| `playlist`    | Array   | `[]`    | An array of playlist items to be initially loaded into the player.                          |
+| `repeat`      | Boolean | `false` | If true, the playlist will start over automatically after the last item ends.               |
+| `autoadvance` | Boolean | `false` | If enabled, the player will automatically move to the next item after the current one ends. |
+
+#### Properties
+
+After initializing the plugin, you can modify these properties to control playlist behavior
+dynamically:
+
+| Property      | Type    | Description                                                                                                                                   |
+|---------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------|
+| `repeat`      | Boolean | Enables or disables repeating the playlist once the last item has played. Changes take effect immediately and apply to subsequent operations. |
+| `autoadvance` | Boolean | Toggles automatic advancement to the next item when the current item ends.                                                                    |
+
+## Contributing
+
+For detailed contribution guidelines, refer to the main project’s [README file][main-readme]. Please
+adhere to the specified guidelines.
+
+### Setting up a development server
+
+Start the development server:
+
+```bash
+npm run start
+```
+
+This will start the server on `http://localhost:4200`. Open this URL in your browser to view the
+demo page.
+
+The video player (`player`) and the Pillarbox library (`pillarbox`) are exposed on the `window`
+object, making it easy to access and manipulate from the browser's developer console for debugging.
+
+#### Available URL parameters
+
+The demo page supports several URL parameters that modify the behavior of the video player:
+
+- `debug`: Set this to enable debugging mode.
+- `ilHost`: Specifies the host for the data provider.
+- `language`: Sets the language for the player interface.
+
+You can combine parameters in the URL like so:
+
+```plaintext
+http://localhost:4200/?language=fr
+```
+
+## Licensing
+
+This project is licensed under the MIT License. See the [LICENSE](../../LICENSE) file for more
+details.
+
+[main-readme]: ../../docs/README.md#Contributing
+[generate-token]: https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#authenticating-with-a-personal-access-token

packages/pillarbox-playlist/index.html

@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8"/>
+  <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+  <title>Pillarbox-Playlist Demo</title>
+  <style>
+    html,
+    body {
+      height: 100%;
+    }
+
+    body {
+      margin: 0;
+      overflow: hidden;
+    }
+  </style>
+</head>
+<body>
+<video id="player" class="pillarbox-js" controls muted></video>
+
+<script type="module">
+  import '@srgssr/pillarbox-web/dist/pillarbox.min.css';
+  import pillarbox from '@srgssr/pillarbox-web';
+  import './src/pillarbox-playlist.js';
+
+  // Handle URL parameters
+  const searchParams = new URLSearchParams(location.search);
+  const debug = searchParams.has('debug');
+  const ilHost = searchParams.get('ilHost') || undefined;
+  const language = searchParams.get('language');
+
+  // Create a pillarbox player instance with the PillarboxPlaylist enabled
+  window.player = pillarbox('player', {
+    debug,
+    language,
+    autoplay: true,
+    srgOptions: { dataProviderHost: ilHost },
+    plugins: { pillarboxPlaylist: { autoadvance: true, repeat: true } }
+  });
+
+  // Load the video source for the player
+  player.pillarboxPlaylist().load(
+    { sources: [{ src: 'urn:rts:video:14827306', type: 'srgssr/urn' }] },
+    { sources: [{ src: 'urn:rts:video:8393241', type: 'srgssr/urn' }] },
+    { sources: [{ src: 'urn:rts:video:13444390', type: 'srgssr/urn' }] },
+    { sources: [{ src: 'urn:rsi:video:15916771', type: 'srgssr/urn' }] }
+  );
+
+  // Expose player for debugging
+  window.player = player;
+  window.pillarbox = pillarbox;
+</script>
+</body>
+</html>

packages/pillarbox-playlist/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@srgssr/pillarbox-playlist",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "dist/pillarbox-playlist.cjs.js",
+  "module": "dist/pillarbox-playlist.es.js",
+  "style": "./dist/pillarbox-playlist.min.css",
+  "exports": {
+    ".": {
+      "import": "./dist/pillarbox-playlist.es.js",
+      "require": "./dist/pillarbox-playlist.cjs.js"
+    },
+    "./*": "./*"
+  },
+  "files": [
+    "dist/*",
+    "scss/*"
+  ],
+  "targets": {
+    "main": false,
+    "github-page": {
+      "publicUrl": "./",
+      "isLibrary": false,
+      "outputFormat": "esmodule"
+    }
+  },
+  "scripts": {
+    "build": "npm run build:lib && npm run build:css",
+    "build:css": "sass ./scss/pillarbox-playlist.scss:dist/pillarbox-playlist.min.css --style compressed --source-map --load-path node_modules",
+    "build:lib": "vite build --config vite.config.lib.js",
+    "github:page": "vite build",
+    "start": " vite --port 4200 --open",
+    "test": "vitest run --silent --coverage --coverage.reporter text"
+  },
+  "peerDependencies": {
+    "@srgssr/pillarbox-web": "^1.12.1"
+  }
+}