vidply 1.2.1 → 1.2.3

package/README.md

@@ -54,6 +54,7 @@ Try VidPly in action:
 - **Buffering Spinner** - Centered loading spinner shown automatically while media is buffering (HTML5, HLS, DASH)
 - **Download Button** - Optional download control with custom URL support (`downloadButton` + `downloadUrl`)
 - **Preview Thumbnails** - Video preview thumbnails on progress bar hover
+- **OS Media Controls** - Media Session API integration: now-playing metadata (title/artist/album/artwork) and lock-screen / notification / headset controls, including previous/next track for playlists
 - **Playlists** - Full playlist support with auto-advance and navigation
   - Audio playlists with track info
   - Video playlists with thumbnails
@@ -354,7 +355,13 @@ const player = new Player('#video', {
   height: 450,
   poster: 'poster.jpg',
   responsive: true,
-  
+
+  // Media metadata + OS media controls (Media Session API)
+  title: null,                  // Now-playing title (lock-screen / notification)
+  artist: null,                 // Now-playing artist/author
+  album: null,                  // Now-playing album/collection
+  mediaSession: true,           // Expose OS media controls + metadata (set false to opt out)
+
   // Playback
   autoplay: false,
   loop: false,
@@ -381,6 +388,7 @@ const player = new Player('#video', {
   audioDescriptionButton: true,
   signLanguageButton: true,
   fullscreenButton: true,
+  helpButton: true,             // Show a keyboard-shortcuts help button (requires keyboard: true)
   pipButton: false,
   downloadButton: false,        // Show a download button in the control bar
   downloadUrl: null,            // Optional explicit download URL (falls back to current src)
@@ -439,7 +447,8 @@ const player = new Player('#video', {
     'speed-menu': ['s'],
     'quality-menu': ['q'],
     'chapters-menu': ['j'],
-    'transcript-toggle': ['t']
+    'transcript-toggle': ['t'],
+    'help': ['?']
   },
   
   // Accessibility
@@ -526,6 +535,7 @@ const player = new Player('#video', {
 | <kbd>Q</kbd>                                   | Open Quality Menu                             |
 | <kbd>J</kbd>                                   | Open Chapters Menu                            |
 | <kbd>T</kbd>                                   | Toggle Transcript                             |
+| <kbd>?</kbd>                                   | Show Keyboard Shortcuts help                  |
 | <kbd>D</kbd>                                   | Toggle Drag Mode (Transcript/Sign Language)   |
 | <kbd>R</kbd>                                   | Toggle Resize Mode (Transcript/Sign Language) |
 | <kbd>Escape</kbd>                              | Exit Drag/Resize Mode or Close Menus          |
@@ -693,6 +703,24 @@ player.showSettings()  // Open settings dialog
 player.hideSettings()  // Close settings dialog
 ```
 
+### Keyboard Shortcuts Help
+
+```javascript
+player.toggleKeyboardHelp()  // Toggle the keyboard-shortcuts help dialog
+player.showKeyboardHelp()    // Open the help dialog
+player.hideKeyboardHelp()    // Close the help dialog
+```
+
+The dialog is built from the live `keyboardShortcuts` bindings (including any
+overrides) and is also reachable via the control-bar help button and the
+<kbd>?</kbd> shortcut. It only lists shortcuts that are relevant to the
+specific player: feature shortcuts (captions, caption styling, speed, quality,
+chapters, transcript, fullscreen) are shown only when that feature is actually
+available, so an audio-only player or a video without captions won't advertise
+shortcuts it can't perform. The list is rebuilt each time the dialog opens, so
+features that load later (e.g. HLS captions or quality levels) appear once
+they're ready.
+
 ### State Information
 
 ```javascript

package/dist/dev/{vidply.AudioDescriptionManager-6RFVF27Z.js → vidply.AudioDescriptionManager-JYYLK5KB.js}

@@ -1,14 +1,14 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
 import {
   CaptionManager
-} from "./vidply.chunk-LDVFAFGC.js";
-import "./vidply.chunk-UHMVDBDB.js";
-import "./vidply.chunk-5IK3IC5V.js";
-import "./vidply.chunk-NSMAZCMB.js";
+} from "./vidply.chunk-JKMQGLCJ.js";
+import "./vidply.chunk-6LYZYI5G.js";
+import "./vidply.chunk-PRFNESYA.js";
+import "./vidply.chunk-I6EDRYGJ.js";
 
 // src/core/DescriptionSpeechManager.ts
 var DescriptionSpeechManager = class {
@@ -847,4 +847,4 @@ var AudioDescriptionManager = class {
 export {
   AudioDescriptionManager
 };
-//# sourceMappingURL=vidply.AudioDescriptionManager-6RFVF27Z.js.map
+//# sourceMappingURL=vidply.AudioDescriptionManager-JYYLK5KB.js.map

package/dist/dev/{vidply.CaptionStyleMenu-R2SCQ6VP.js → vidply.CaptionStyleMenu-47RCKQF5.js}

@@ -1,15 +1,15 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
 import {
   focusFirstElement
-} from "./vidply.chunk-JAKZNGOR.js";
+} from "./vidply.chunk-P25MRJ6O.js";
 import {
   DOMUtils,
   i18n
-} from "./vidply.chunk-NSMAZCMB.js";
+} from "./vidply.chunk-I6EDRYGJ.js";
 
 // src/controls/CaptionStyleMenu.ts
 function captionStylePropertyName(property) {
@@ -297,4 +297,4 @@ function showCaptionStyleMenu(controlBar, button) {
 export {
   showCaptionStyleMenu
 };
-//# sourceMappingURL=vidply.CaptionStyleMenu-R2SCQ6VP.js.map
+//# sourceMappingURL=vidply.CaptionStyleMenu-47RCKQF5.js.map

package/dist/dev/{vidply.DASHRenderer-EOVEW73H.js → vidply.DASHRenderer-VEJ4HDHO.js}

@@ -1,11 +1,11 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
 import {
   loadScriptOnce
-} from "./vidply.chunk-HOYEMJSD.js";
+} from "./vidply.chunk-JZNZX32Z.js";
 
 // src/renderers/DASHRenderer.ts
 var DASHRenderer = class {
@@ -862,4 +862,4 @@ var DASHRenderer = class {
 export {
   DASHRenderer
 };
-//# sourceMappingURL=vidply.DASHRenderer-EOVEW73H.js.map
+//# sourceMappingURL=vidply.DASHRenderer-VEJ4HDHO.js.map

package/dist/dev/{vidply.FloatingPlayerManager-V5XQWS75.js → vidply.FloatingPlayerManager-C2UVRPZY.js}

@@ -1,18 +1,18 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
 import {
   DraggableResizable
-} from "./vidply.chunk-C55OBT5H.js";
+} from "./vidply.chunk-UNFGMABP.js";
 import {
   createIconElement
-} from "./vidply.chunk-RQG3MA7W.js";
+} from "./vidply.chunk-UI3RYCVF.js";
 import {
   DOMUtils,
   i18n
-} from "./vidply.chunk-NSMAZCMB.js";
+} from "./vidply.chunk-I6EDRYGJ.js";
 
 // src/core/FloatingPlayerManager.ts
 var FLOATING_CLAIM_EVENT = "vidply:floating-claim";
@@ -534,4 +534,4 @@ var FloatingPlayerManager = class {
 export {
   FloatingPlayerManager
 };
-//# sourceMappingURL=vidply.FloatingPlayerManager-V5XQWS75.js.map
+//# sourceMappingURL=vidply.FloatingPlayerManager-C2UVRPZY.js.map

package/dist/dev/{vidply.HLSRenderer-ZBEFVH5W.js → vidply.HLSRenderer-ZVBK2TNQ.js}

@@ -1,11 +1,11 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
 import {
   loadScriptOnce
-} from "./vidply.chunk-HOYEMJSD.js";
+} from "./vidply.chunk-JZNZX32Z.js";
 
 // src/renderers/HLSRenderer.ts
 var HLSRenderer = class {
@@ -94,7 +94,7 @@ var HLSRenderer = class {
     return video.canPlayType("application/vnd.apple.mpegurl") !== "";
   }
   async initNative() {
-    const { HTML5Renderer } = await import("./vidply.HTML5Renderer-P7ICKYU4.js");
+    const { HTML5Renderer } = await import("./vidply.HTML5Renderer-HLRQUOCU.js");
     const native = new HTML5Renderer(this.player);
     await native.init();
     this.play = () => native.play();
@@ -701,4 +701,4 @@ var HLSRenderer = class {
 export {
   HLSRenderer
 };
-//# sourceMappingURL=vidply.HLSRenderer-ZBEFVH5W.js.map
+//# sourceMappingURL=vidply.HLSRenderer-ZVBK2TNQ.js.map

package/dist/dev/vidply.HTML5Renderer-HLRQUOCU.js

@@ -0,0 +1,12 @@
+/*!
+ * VidPly v1.2.3 - Universal, Accessible Video Player
+ * (c) 2026 Matthias Peltzer
+ * Released under GPL-2.0-or-later License
+ */
+import {
+  HTML5Renderer
+} from "./vidply.chunk-CGYIED2I.js";
+export {
+  HTML5Renderer
+};
+//# sourceMappingURL=vidply.HTML5Renderer-HLRQUOCU.js.map

package/dist/dev/{vidply.SignLanguageManager-7IAJOVF6.js → vidply.SignLanguageManager-FLUCBW5H.js}

@@ -1,5 +1,5 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
@@ -7,19 +7,19 @@ import {
   DraggablePanel,
   createLabeledSelect,
   preventDragOnElement
-} from "./vidply.chunk-W5BR65JY.js";
+} from "./vidply.chunk-A4ESEOQ2.js";
 import {
   DraggableResizable
-} from "./vidply.chunk-C55OBT5H.js";
+} from "./vidply.chunk-UNFGMABP.js";
 import {
   createIconElement
-} from "./vidply.chunk-RQG3MA7W.js";
-import "./vidply.chunk-JAKZNGOR.js";
-import "./vidply.chunk-5IK3IC5V.js";
+} from "./vidply.chunk-UI3RYCVF.js";
+import "./vidply.chunk-P25MRJ6O.js";
+import "./vidply.chunk-PRFNESYA.js";
 import {
   DOMUtils,
   i18n
-} from "./vidply.chunk-NSMAZCMB.js";
+} from "./vidply.chunk-I6EDRYGJ.js";
 
 // src/core/SignLanguageManager.ts
 var SignLanguageManager = class {
@@ -1083,4 +1083,4 @@ var SignLanguageManager = class {
 export {
   SignLanguageManager
 };
-//# sourceMappingURL=vidply.SignLanguageManager-7IAJOVF6.js.map
+//# sourceMappingURL=vidply.SignLanguageManager-FLUCBW5H.js.map

package/dist/dev/{vidply.SoundCloudRenderer-OA7QQYGN.js → vidply.SoundCloudRenderer-MGMAJ7NK.js}

@@ -1,11 +1,11 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
 import {
   loadScriptOnce
-} from "./vidply.chunk-HOYEMJSD.js";
+} from "./vidply.chunk-JZNZX32Z.js";
 
 // src/renderers/SoundCloudRenderer.ts
 var SoundCloudRenderer = class {
@@ -337,4 +337,4 @@ export {
   SoundCloudRenderer,
   SoundCloudRenderer_default as default
 };
-//# sourceMappingURL=vidply.SoundCloudRenderer-OA7QQYGN.js.map
+//# sourceMappingURL=vidply.SoundCloudRenderer-MGMAJ7NK.js.map

package/dist/dev/{vidply.TranscriptManager-BPM3T23L.js → vidply.TranscriptManager-Y2RYXHJW.js}

@@ -1,5 +1,5 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
@@ -8,28 +8,28 @@ import {
   createLabeledSelect,
   createMenuItem,
   preventDragOnElement
-} from "./vidply.chunk-W5BR65JY.js";
+} from "./vidply.chunk-A4ESEOQ2.js";
 import {
   DraggableResizable
-} from "./vidply.chunk-C55OBT5H.js";
+} from "./vidply.chunk-UNFGMABP.js";
 import {
   TimeUtils
-} from "./vidply.chunk-YVCYQZJI.js";
+} from "./vidply.chunk-HZ7UOKOU.js";
 import {
   createIconElement
-} from "./vidply.chunk-RQG3MA7W.js";
+} from "./vidply.chunk-UI3RYCVF.js";
 import {
   focusElement
-} from "./vidply.chunk-JAKZNGOR.js";
+} from "./vidply.chunk-P25MRJ6O.js";
 import {
   StorageManager,
   deriveTrackLabel
-} from "./vidply.chunk-UHMVDBDB.js";
-import "./vidply.chunk-5IK3IC5V.js";
+} from "./vidply.chunk-6LYZYI5G.js";
+import "./vidply.chunk-PRFNESYA.js";
 import {
   DOMUtils,
   i18n
-} from "./vidply.chunk-NSMAZCMB.js";
+} from "./vidply.chunk-I6EDRYGJ.js";
 
 // src/controls/TranscriptManager.ts
 var TranscriptManager = class {
@@ -1891,4 +1891,4 @@ var TranscriptManager = class {
 export {
   TranscriptManager
 };
-//# sourceMappingURL=vidply.TranscriptManager-BPM3T23L.js.map
+//# sourceMappingURL=vidply.TranscriptManager-Y2RYXHJW.js.map

package/dist/dev/{vidply.VimeoRenderer-BRHFYPNJ.js → vidply.VimeoRenderer-RQFQD7OE.js}

@@ -1,11 +1,11 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
 import {
   loadScriptOnce
-} from "./vidply.chunk-HOYEMJSD.js";
+} from "./vidply.chunk-JZNZX32Z.js";
 
 // src/renderers/VimeoRenderer.ts
 var VimeoRenderer = class {
@@ -236,4 +236,4 @@ var VimeoRenderer = class {
 export {
   VimeoRenderer
 };
-//# sourceMappingURL=vidply.VimeoRenderer-BRHFYPNJ.js.map
+//# sourceMappingURL=vidply.VimeoRenderer-RQFQD7OE.js.map

package/dist/dev/{vidply.YouTubeRenderer-HRTN4EJ5.js → vidply.YouTubeRenderer-EU2BARZF.js}

@@ -1,11 +1,11 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
 import {
   loadScriptOnce
-} from "./vidply.chunk-HOYEMJSD.js";
+} from "./vidply.chunk-JZNZX32Z.js";
 
 // src/renderers/YouTubeRenderer.ts
 var YouTubeRenderer = class {
@@ -235,4 +235,4 @@ var YouTubeRenderer = class {
 export {
   YouTubeRenderer
 };
-//# sourceMappingURL=vidply.YouTubeRenderer-HRTN4EJ5.js.map
+//# sourceMappingURL=vidply.YouTubeRenderer-EU2BARZF.js.map

package/dist/dev/{vidply.chunk-UHMVDBDB.js → vidply.chunk-6LYZYI5G.js}

@@ -1,12 +1,12 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
 import {
   i18n,
   shallowSanitize
-} from "./vidply.chunk-NSMAZCMB.js";
+} from "./vidply.chunk-I6EDRYGJ.js";
 
 // src/utils/StorageManager.ts
 function clamp(n, min, max) {
@@ -255,4 +255,4 @@ export {
   StorageManager,
   deriveTrackLabel
 };
-//# sourceMappingURL=vidply.chunk-UHMVDBDB.js.map
+//# sourceMappingURL=vidply.chunk-6LYZYI5G.js.map

package/dist/dev/{vidply.chunk-W5BR65JY.js → vidply.chunk-A4ESEOQ2.js}

@@ -1,21 +1,21 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
 import {
   createIconElement
-} from "./vidply.chunk-RQG3MA7W.js";
+} from "./vidply.chunk-UI3RYCVF.js";
 import {
   focusElement
-} from "./vidply.chunk-JAKZNGOR.js";
+} from "./vidply.chunk-P25MRJ6O.js";
 import {
   reducedMotionScrollOptions
-} from "./vidply.chunk-5IK3IC5V.js";
+} from "./vidply.chunk-PRFNESYA.js";
 import {
   DOMUtils,
   i18n
-} from "./vidply.chunk-NSMAZCMB.js";
+} from "./vidply.chunk-I6EDRYGJ.js";
 
 // src/utils/FormUtils.ts
 function createLabeledSelect({
@@ -639,4 +639,4 @@ export {
   createMenuItem,
   DraggablePanel
 };
-//# sourceMappingURL=vidply.chunk-W5BR65JY.js.map
+//# sourceMappingURL=vidply.chunk-A4ESEOQ2.js.map

package/dist/dev/{vidply.chunk-XAK3DPTO.js → vidply.chunk-CGYIED2I.js}

@@ -1,5 +1,5 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
@@ -297,4 +297,4 @@ var HTML5Renderer = class {
 export {
   HTML5Renderer
 };
-//# sourceMappingURL=vidply.chunk-XAK3DPTO.js.map
+//# sourceMappingURL=vidply.chunk-CGYIED2I.js.map

package/dist/dev/{vidply.chunk-YVCYQZJI.js → vidply.chunk-HZ7UOKOU.js}

@@ -1,11 +1,11 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
 import {
   i18n
-} from "./vidply.chunk-NSMAZCMB.js";
+} from "./vidply.chunk-I6EDRYGJ.js";
 
 // src/utils/TimeUtils.ts
 var TimeUtils = {
@@ -64,4 +64,4 @@ var TimeUtils = {
 export {
   TimeUtils
 };
-//# sourceMappingURL=vidply.chunk-YVCYQZJI.js.map
+//# sourceMappingURL=vidply.chunk-HZ7UOKOU.js.map

package/dist/dev/{vidply.chunk-NSMAZCMB.js → vidply.chunk-I6EDRYGJ.js}

@@ -1,5 +1,5 @@
 /*!
- * VidPly v1.2.1 - Universal, Accessible Video Player
+ * VidPly v1.2.3 - Universal, Accessible Video Player
  * (c) 2026 Matthias Peltzer
  * Released under GPL-2.0-or-later License
  */
@@ -429,6 +429,33 @@ var en = {
     reset: "Reset to defaults",
     close: "Close"
   },
+  help: {
+    title: "Keyboard shortcuts",
+    button: "Keyboard shortcuts",
+    close: "Close",
+    or: "or",
+    keys: {
+      space: "Space"
+    },
+    actions: {
+      "play-pause": "Play / Pause",
+      "seek-backward": "Seek backward",
+      "seek-forward": "Seek forward",
+      "volume-up": "Volume up",
+      "volume-down": "Volume down",
+      "mute": "Mute / Unmute",
+      "captions": "Toggle captions",
+      "caption-style-menu": "Caption styling",
+      "speed-down": "Decrease speed",
+      "speed-up": "Increase speed",
+      "speed-menu": "Playback speed",
+      "quality-menu": "Quality",
+      "chapters-menu": "Chapters",
+      "transcript-toggle": "Toggle transcript",
+      "fullscreen": "Toggle fullscreen",
+      "help": "Keyboard shortcuts"
+    }
+  },
   speeds: {
     normal: "Normal"
   },
@@ -471,10 +498,10 @@ var en = {
 
 // src/i18n/translations.ts
 var builtInLanguageLoaders = {
-  de: () => import("./vidply.de-5W5LBFSJ.js"),
-  es: () => import("./vidply.es-SHDAT6L6.js"),
-  fr: () => import("./vidply.fr-2JANOMNB.js"),
-  ja: () => import("./vidply.ja-WWMSTEJH.js")
+  de: () => import("./vidply.de-VAUVSQXC.js"),
+  es: () => import("./vidply.es-G65HFWO6.js"),
+  fr: () => import("./vidply.fr-MJNOZELM.js"),
+  ja: () => import("./vidply.ja-INMDHIYJ.js")
 };
 function getBaseTranslations() {
   return { en };
@@ -658,4 +685,4 @@ export {
   shallowSanitize,
   i18n
 };
-//# sourceMappingURL=vidply.chunk-NSMAZCMB.js.map
+//# sourceMappingURL=vidply.chunk-I6EDRYGJ.js.map