Changelog

Added FLAC, WAV, and AIFF metadata reading for audio properties, song tags, cover art, and lyrics, with unified parsing and error handling.

Improved lyric shadows with darker colors and less blur for clearer text, while preserving the existing background effects.

Playback fixes: Fixed truncated long audio URLs, stale audio after clearing a playlist, and missed mounting when scripts load late.

Lyric improvements: Bottom lyrics now use a translucent background derived from cover colors or the theme color, with bolder text and shadows for readability.

Interaction and performance: Track changes now animate song titles and artist names with a dynamic blur transition; redundant code and dependencies were trimmed.

Fixed real-time waveform progress and animated lyric-background bars failing to update correctly in Windows 10 browsers, improving audio visualization stability across rendering environments.

Fixed stuttering player expand and collapse transitions in Windows 10 browsers by improving animation compositing and state changes.

Fixed strict browser audio-loading policies causing an initial playback rejection to be treated as a damaged resource and incorrectly enter the automatic track-recovery flow.

Fixed monitor panel state and layout issues when system monitoring is enabled, keeping the monitor and player body correctly positioned.

Fixed player and message dialog stacking issues on pages with complex stacking contexts, high-level navigation, or modal layers.

Optimized the production bundle by removing an internal test request path that was not part of the public API.

Added independent debouncing for keyboard controls to prevent repeated player state changes when playback, track navigation, or expand shortcuts are pressed rapidly.

Added automatic hiding for the bottom lyric control when the page reaches the bottom. It returns when the user scrolls up or leaves the bottom area, reducing overlap with page content.

Added configurable 2D Canvas audio visualization, including a real-time waveform progress bar and animated lyric-background bars. When colorful lyrics are enabled, the lyric background bars use stable per-bar colors.

Improved lyric-background bar density, width, and interpolation smoothness, and cleaned up unnecessary runtime paths to reduce redundant drawing and repeated state syncing.

Added progress-bar lyric previews: desktop users see the lyric at the pointer time while hovering, while mobile users see it during taps and drags with a roughly 1.5-second hold after release. The preview is not rendered when no real lyrics exist or only the instrumental fallback is available.

Improved theme integration, boundary positioning, and fade transitions for the lyric preview panel, with a centered pointer triangle that makes the relationship between the drag position and lyric clearer.

Fixed mobile progress gestures occasionally reaching the play button or adjacent controls, refined control visibility and pointer release during dragging

Fixed playlist scrollbar styling being overridden by host-site global rules. The scrollbar is now isolated to the player theme, while accumulated frame-based easing makes mouse-wheel scrolling smoother and still hands scrolling back to the page at list boundaries.

Improved mobile volume dragging with reliable pointer capture, cancellation, and release handling, plus a touch-event fallback for older mobile browsers to reduce interrupted gestures and missed volume updates.

Fixed the player being covered by high-level dialogs, fixed navigation, or complex stacking contexts. It now prefers the browser Top Layer and falls back to the maximum effective stacking level, while its zero-sized host avoids covering page interactions.

The first stable Xiao Feng Music Player release, built with Lit and Howler to provide a clear integration flow, reliable playback, and a complete foundation.

It supports cloud and local modes, lyrics, playlists, memory playback, repeat one, shuffle, and theme switching, with Web Component, IIFE, ESM, npm, and CDN entry points.