CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

[1.0.17]

Custom quality API

• getQualityLevels() – returns all available renditions (id, label, height, width, bitrate, frameRate).
• setQualityLevel(id) – locks playback to a specific rendition (manual mode).
• setQualityAuto() – re-enables ABR; clears any manual lock.
• getPlaybackQuality() – snapshot of current state: { mode, lockedLevel, loadedLevel }.
• --resolution-selector: none – CSS variable to hide the built-in quality button when using a custom menu.

Quality events

• fastpixqualitylevelsready – fires after manifest parse; detail.levels is the full rendition ladder. Build your quality menu here.
• fastpixqualitychange – fires on every ABR or manual switch; detail includes mode, lockedLevel, loadedLevel, and previousLoadedLevel.
• fastpixqualityfailed – fires on invalid levelId or rendition load error; detail.reason describes the failure.

Named overlay slots

• Eight slot regions (top-left, top-center, top-right, center-left, center-right, bottom-left, bottom-center, bottom-right) let you place any HTML over the video as light-DOM children of <fastpix-player>.
• --user-slot-z – controls stacking order of the slot layer (default 6).
• --user-slot-bottom-clearance – space between bottom-row slots and the seek bar (default 64px).
• Shadow part part="user-slots" exposed for page-level ::part styling.

[1.0.16]

Updated

• Analytics / Video Data – @fastpix/video-data-core dependency range updated to ^1.0.7.

Live playback

• Cleaner live UI – For stream-type="live-stream", the duration-style time readout stays hidden so the experience matches open-ended live viewing.

On-demand playback

• Smarter background loading on VOD – On-demand streams use settings tuned for typical recorded playback; live streams use a lighter profile suited to the live edge.

Performance & stability

• Smoother day-to-day use – Less chance of the browser reporting long scripting tasks during normal actions (timeline updates, audio track changes, subtitle changes, and Chromecast handoff).
• Programmatic audio – When you switch tracks via setAudioTrack(...), the built-in audio menu stays aligned with fewer redundant updates.

[1.0.15]

Audio & Subtitle UX (tracks + subtitles)

• New attribute: hide-native-subtitles

  • When present, the internal subtitle container never paints text, so the built‑in overlay stays visually hidden even when a track is enabled.
  • All subtitle APIs still work as usual: fastpixsubtitlecue continues to fire with { text, language, startTime, endTime } and the native TextTrack state is unchanged.
  • Recommended when you render subtitles in your own UI (React overlay, custom HTML) and want to guarantee there is no duplicate text from the built‑in overlay.

• Clarified behavior: disable-hidden-captions

  • Now applied as an initial state only: on load, the player disables all subtitles/captions without emitting fastpixsubtitlechange.
  • After load, users (or your code) can still turn subtitles on via the built‑in menu or setSubtitleTrack(...); the internal overlay is allowed to show again unless hide-native-subtitles is also set.

Programmatic seek

• seekForward(seconds) and seekBackward(seconds) – New methods on the <fastpix-player> element to jump the playhead forward or back by a given number of seconds (clamped to the media range). Use them for custom “+10s” / “−10s” buttons or app shortcuts; the built-in skip buttons still follow forward-seek-offset / backward-seek-offset when set. Documented in README (Programmatic playback control and section 1.3 custom-controls example).

[1.0.14]

Audio & Subtitle Tracks

• Switch by name (label) – setAudioTrack(languageName) / setSubtitleTrack(languageName | null) switch tracks by label/name (no numeric ids required).
• Set defaults by name – New attributes:
  • default-audio-track="French"
  • default-subtitle-track="English"
• Cleaner track lists – getAudioTracks() / getSubtitleTracks() now avoid duplicate entries when multiple tracks share the same label.
• Better events for integrations
  • fastpixtracksready includes the full current track objects (currentAudioTrackLoaded, currentSubtitleLoaded) in addition to the track lists.
  • fastpixaudiochange / fastpixsubtitlechange include the current track object (currentTrack) so you can log/update UI easily.

[1.0.13]

Readme.md

• Updated Readme.md file

[1.0.12]

Changed

• Build & package – ESM build is now a single bundled file (dist/player.esm.js), so import '@fastpix/fp-player' works in React, Vite, and other bundlers without "Could not resolve ./utils/..." errors. CDN build stays at dist/player.js for backward compatibility with existing script-tag and CDN URLs.
• Exports – "import" resolves to player.esm.js; "require" and main resolve to player.js (IIFE).
• Build size – Stripped legal comments and debugger statements in both builds for slightly smaller output.

[1.0.11]

Features you can use

• Programmatic playback control – JavaScript API: play(), pause(), mute(), and unmute() for controlling playback and volume from your code (e.g. custom controls, Shorts-style UI, or framework integrations). mute()/unmute() sync with Chromecast when casting.
• Seekbar position – Use CSS variable --seekbar-bottom (e.g. 0px) to move the progress bar to the very bottom. Thumbnail preview stays above it.
• Invisible bar, keep preview & seek – Set --progress-bar-invisible: 1 to hide the bar visually while keeping hover thumbnail/timestamp preview and click-to-seek. Use your own progress bar on top.
• Style the bar – Use --progress-bar-track-unfilledto style the track.
• Thumbnail hover on seekbar – Hover or drag on the seekbar to see a frame preview (spritesheet) or timestamp pill when no thumbnails are available.
• Shorts mode – Attribute autoplay-shorts for muted autoplay, loop, and feed-friendly behavior.
• Free keyboard keys – Attribute disable-keyboard-controls so your app can use Arrow Up/Down (e.g. next/prev) without the player capturing them.
• Accent color – Attribute accent-color or CSS --accent-color for theming; your app can read it to match a custom progress bar.

Fixed

• Chromecast – Fixed casting with m4s segments for both private and public playback;DRM playback casting remains unresolved and is still being worked on.
• DRM Playback - DRM Playback issue in player is fixed..

---

[1.0.10]

Changed

• Updated npm authentication from Classic token to Granular token for improved security and fine-grained permissions.

[1.0.9]

• Added skip-intro-start and skip-intro-end and next-episode-button-overlay buttons support.
• Fixed shoppable video hotspot issue
• Added player-buttons slot

[1.0.8]

New & Improved: Playlist

• Added playlist APIs: addPlaylist(playlist), next(), previous(), selectEpisodeByPlaybackId(playbackId)
• Supported attributes: default-playback-id, hide-default-playlist-panel, loop-next
• Events: playbackidchange, playlisttoggle
• Custom navigation hooks: customNext(handler), customPrev(handler); call i.next()/i.previous() inside your handlers
• Default playlist panel can be hidden to build a fully custom panel via slot="playlist-panel"
• Introduced destroy() for lightweight teardown before custom source-switching flows

iOS Volume Behavior

• When iOS-specific volume button is active, standard slider/button are hidden

Menu Bugs fixed

• Fixed playlist panel toggle inconsistencies (open/close state and pointer events)
• Ensured external custom panel shows/hides reliably with playlisttoggle
• Resolved menu overlap by closing rate/audio/subtitle/resolution menus when opening playlist panel

[1.0.7] - 2025-09-04

• Fixed "OpenOnPlay" and "autoClose" issue for shoppable-video-player theme

[1.0.6] - 2025-08-19

• Removed unnecessary console logs

[1.0.5] - 2025-08-18

New Feature: Shoppable Video Support

• Shoppable Video Player Theme: Introduced shoppable-video-player theme with full-featured product sidebar, interactive hotspots, and comprehensive product catalog functionality
• Shoppable Shorts Theme: Added shoppable-shorts theme for simplified external link integration optimized for social media and mobile-first content
• Product Integration: Support for product data configuration with hover effects, click actions, and time-based product activation
• Interactive Hotspots: Clickable markers on video timeline that link to specific products
• Post-Play Overlay: Product carousel that appears when video ends to encourage continued engagement
• Responsive Design: Cart button and sidebar adapt to different screen sizes with theme-specific visibility rules
• Developer Documentation: Comprehensive developer guide with configuration examples, troubleshooting section, and best practices

[1.0.4] - 2025-07-09

DRM Support & Chapters updation

• DRM support included
• Chapters feature updated

[1.0.3] - 2025-05-05

Bug Fix

• Fixed the spritesheet issue.

[1.0.2] - 2025-04-29

Beta Feature: Chromecast Integration

• Initial Chromecast Support (Beta): Added foundational support for Google Chromecast. This includes:
  • Chromecast session detection and management.
  • Remote playback toggling with fallback to local player.
  • Volume and mute sync between player and Chromecast.
  • Session cleanup on load and playback resume logic.

[1.0.1]

Enhancements & Bug Fixes:

• PIP Control Removed in Firefox Mobile: Fixed an issue where the Picture-in-Picture (PIP) control was displayed on Firefox mobile browsers when it shouldn't be.
• Subtitle Menu UI Fixes:
  • Fixed an issue where the subtitle menu was cropped, and scrolling was unavailable for videos with over 10 subtitles.
  • Ensured that if multiple subtitles exist, the list is scrollable and properly displayed in the UI.
• Subtitle Overlay Fix: Resolved an issue where, after turning off subtitles, the background overlay remained visible instead of disappearing.
• Data Metrics Integration: Added Quality of Experience (QoE) scoring in the FastPix dashboard, allowing users to monitor streaming quality.
• Enable Cache Busting (Beta): Introduced an experimental cache-busting feature to ensure that when tracks are added dynamically, the player checks for an updated manifest.

[1.0.0]

Initial Release:

• Playback: Introduced basic video playback functionality.
• Signed Playback: Enabled secure signed playback options.
• Stream Types: Added support for various stream types.
• Responsiveness: Ensured responsive design for different devices.
• Error Handling: Implemented robust error handling mechanisms.
• Customizability: Provided extensive customization options for users.
• Keyboard Accessibility Controls: Added keyboard shortcuts for better accessibility.
• Lazy Loading: Implemented lazy loading for improved performance.
• Chapters: Enabled chapter functionality for video navigation.
• Script Support for Video Events:: Added support for listening to video events via scripts.
• Poster customizations: Allowed customization of video posters.
• Thumbnail Customization: Enabled custom thumbnails for videos.
• Forward and Rewind Playback Customizations:: Provided options for customizable forward and rewind playback.
• Playback Rates: Allowed adjustment of playback rates.
• Styling Options: Added various styling options for UI elements.
• Volume Management: Implemented advanced volume control features.
• Subtitle Switching: Enabled switching between available subtitles.
• Audio Track Switching:: Allowed switching between different audio tracks.
• Thumbnail Hover Previews: Introduced thumbnail previews on hover.
• Customizing Time Display: Allowed customization of time display formats.
• Start Time: Implemented functionality to set a specific start time for playback.
• Placeholder: Added placeholder support for loading states.
• offline/online control: Provided control mechanisms for offline/online scenarios.
• Title Display: Implemented title display options for videos.
• Overriding Default Behaviors: Allowed users to override default player behaviors.