Release 5.6.0

Author: r11a

CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## 5.6.0 - 2026-05-20
+
+Release focus: Flow Assistant voice commands, richer library browsing, radio artwork reliability, cleaner tablet/saver controls, and a full bug-fix rollup from the local 5.5.1 test cycle.
+
+Highlights:
+
+- Adds the experimental **Flow Assistant** voice command layer. It can be opened from the player, the empty-state music screen, and the screensaver. Voice commands are still experimental; failed examples, browser/device details, and community feedback are welcome so the matching can keep improving.
+- Renames the voice dialog from `Voice assistant` to **Flow Assistant** and adds HOMEii Flow branding inside the assistant panel.
+- Adds elegant microphone entry points in the empty-state player and screensaver, with better click feedback and guards against repeated delayed actions.
+- Keeps the screensaver active while Flow Assistant is open, so touching the assistant dialog does not leave the idle display. The screensaver exits only when the user taps the empty background area.
+- Adds optional previous/next controls to the screensaver when screensaver media controls are enabled.
+- Adds library drill-in for playlists and albums: tapping an item can open its track list first, while a small `Play` button starts the whole item directly.
+- Adds clearer tap feedback to library and recommendation content, including subtle loading feedback while playback starts.
+- Adds `Clear all` as a selectable Quick Action with a red-toned icon and a small confirmation popup that explains it disconnects all active players before running.
+- Improves media control states so shuffle, repeat-one, and repeat-all are visually clearer when active.
+- Improves the empty-state wand area with calmer animation, spacing, and visual feedback.
+- Bundles Simplified Chinese localization. Thank you to [@gao19970120](https://github.com/gao19970120) for the Chinese translation contribution.
+
+Bug fixes:
+
+- Fixes `_getAllocatedCardHeight` shrinking the card when Home Assistant reported a positive `getBoundingClientRect().top` during initial layout. The card now avoids losing height just because it is rendered lower on the page.
+- Restores cleaner card fit after the height fix so the player does not create unnecessary page scrolling on normal tablet/desktop dashboards.
+- Fixes rounded-corner leaks by clipping the host/card surface consistently and keeping internal layers aligned to the same radius treatment.
+- Fixes radio playback cover art in the normal player. Radio stations that expose live `entity_picture` artwork now show that dynamic artwork in the main player, not only in the screensaver.
+- Fixes the broken/empty radio cover slot by using safer artwork fallbacks and HOMEii branding when a station image cannot be loaded.
+- Fixes radio layout spacing so the radio artwork, microphone action, metadata, and side actions no longer crowd or float in awkward positions on wide tablet views.
+- Avoids false radio handling for normal songs or playlists that merely contain the word `radio` in their title or URI.
+- Expands the radio country selector in the visual editor and in-card settings so users can choose from the full country list instead of a small sample list.
+- Fixes visual-editor labels in the Flow Assistant section so they use readable text instead of underscore-style internal keys.
+- Fixes visual-editor labels for assistant icon sizing and related controls.
+- Renames the Quick Actions assistant option to **Flow Assistant** so it matches the user-facing feature name.
+- Fixes repeat button ambiguity by distinguishing repeat-one from repeat-all in the active UI state.
+- Fixes empty-player controls that sometimes required multiple taps before opening a panel or starting an action.
+- Prevents stacked delayed actions from repeated taps on the empty-state wand/microphone area.
+- Restores reliable Hebrew Flow Assistant matching for commands such as playing a song by artist and playing a playlist by artist/name after the local matching regression.
+- Adds regression coverage for Flow Assistant command matching so common Hebrew play requests do not silently break again.
+- Improves assistant failure handling so unsupported speech-service/browser failures are surfaced cleanly instead of looking like a successful command with an unrelated response.
+- Fixes the screensaver Flow Assistant button so it opens the assistant without changing the clean screensaver layout or forcing an unwanted exit.
+- Fixes library/recommendation click behavior so feedback appears immediately while Music Assistant starts playback.
+- Tightens radio and missing-artwork fallback behavior across player and screensaver surfaces so both views resolve artwork from the same safer priority chain.
+- Updates localization tests to include the new Simplified Chinese dictionary and language option.
+- Updates release packaging so `src/localization/zh.js` is synced into `dist/localization/zh.js`.
+
 ## 5.5.0 - 2026-05-17
 
 Released update from 5.4.2.

HOW_TO_ADD_A_LANGUAGE.md

@@ -1,6 +1,6 @@
 # How To Add A Language
 
-HOMEii Music Flow uses flat JavaScript dictionaries in `src/localization/`. English is the fallback language, so every new language file should start by copying the English keys. Version 5.5.0 ships with English and Hebrew only.
+HOMEii Music Flow uses flat JavaScript dictionaries in `src/localization/`. English is the fallback language, so every new language file should start by copying the English keys. Version 5.6.0 ships with English, Hebrew, and Simplified Chinese.
 
 ## Steps
 

LOCAL_DEPLOYMENT.md

@@ -12,7 +12,7 @@ Use only this runtime package folder in Home Assistant `www`:
 
 Use only this Lovelace resource pattern:
 
-`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.5.0`
+`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.6.0`
 
 From now on, bump only the query version after `?v=`.
 Do not change the file name again unless there is a hard cache emergency.
@@ -29,14 +29,14 @@ Stable deploy target:
 
 `dist/` should always be the latest approved install package.
 
-## Current 5.5.0 Mapping
+## Current 5.6.0 Mapping
 
 - Edit: `src/homeii-music-flow.js`
 - Review/share: `dist/`
 - Deploy to HA `www`: copy the full contents of `dist/` into `www/community/homeii-music-flow/`
 - Package includes: `homeii-music-flow.js`, `localization/`, `sendspin-js/`, `vendor/embla-carousel.umd.js`, `homeii-flow-logo.svg`
 - Lovelace type: `custom:homeii-music-flow`
-- Lovelace resource: `/local/community/homeii-music-flow/homeii-music-flow.js?v=5.5.0`
+- Lovelace resource: `/local/community/homeii-music-flow/homeii-music-flow.js?v=5.6.0`
 
 ## Cache Reset Rule
 
@@ -48,7 +48,7 @@ If a new version is approved:
 
 Example:
 
-`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.5.0`
+`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.6.0`
 
 ## Foundation Note
 

PUBLISHING.md

@@ -24,19 +24,19 @@
   - the HACS My Home Assistant button
   - the HACS download/install button
 
-## 2. Create the 5.5.0 release
+## 2. Create the 5.6.0 release
 
-- Create a Git tag named `v5.5.0`.
+- Create a Git tag named `v5.6.0`.
 - Create a GitHub release from that tag.
-- Title the release `5.5.0`.
-- Use the `5.5.0` section from `CHANGELOG.md` as the release notes.
+- Title the release `5.6.0`.
+- Use the `5.6.0` section from `CHANGELOG.md` as the release notes.
 - Do not attach a custom release zip asset for HACS. Keep the complete installable runtime in `dist/` and let HACS use the normal repository release/tag contents.
 
 ## 3. Verify repository files after publishing
 
 - Confirm `hacs.json` still points to `homeii-music-flow.js`.
 - Confirm `dist/homeii-music-flow.js` matches the released runtime.
-- Confirm `dist/localization/` includes English and Hebrew dictionaries only.
+- Confirm `dist/localization/` includes English, Hebrew, and Simplified Chinese dictionaries.
 - Confirm `dist/sendspin-js/` exists for the local Sendspin browser player.
 - Confirm `dist/vendor/embla-carousel.umd.js` exists for mobile swipe support.
 - Confirm `dist/homeii-flow-logo.svg` and `docs/brand/homeii-flow-logo.svg` exist.
@@ -81,7 +81,7 @@ to:
 
 Then load:
 
-`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.5.0`
+`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.6.0`
 
 ## 7. Final pre-release smoke test
 

README.md

@@ -26,7 +26,7 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/r11a/homeii-music-flow"><img alt="version" src="https://img.shields.io/badge/version-5.5.0-gold"></a>
+  <a href="https://github.com/r11a/homeii-music-flow"><img alt="version" src="https://img.shields.io/badge/version-5.6.0-gold"></a>
   <img alt="Home Assistant" src="https://img.shields.io/badge/Home%20Assistant-Dashboard-41BDF5">
   <img alt="Music Assistant" src="https://img.shields.io/badge/Music%20Assistant-required-7C5CFF">
   <img alt="Sendspin" src="https://img.shields.io/badge/Sendspin-browser%20player-18B6FF">
@@ -47,13 +47,27 @@ HOMEii Flow started from my own daily use of Home Assistant and Music Assistant.
 - **Sendspin browser player built in:** turn the current browser, phone, tablet, or wall panel into a Music Assistant playback target directly from the card, with a session that survives Dashboard page changes while the dashboard stays open.
 - **Premium now-playing experience:** artwork-led layout, dynamic atmosphere, elegant controls, full-screen lyrics, and responsive visual polish.
 - **FLOW guided music wizard:** a simple step-by-step music flow for choosing players, picking a mood or existing content, reviewing visual results, and starting playback without learning the full Music Assistant UI.
+- **Experimental Flow Assistant:** optional voice commands can launch music from the player, empty state, and screensaver. This is intentionally marked experimental, and community feedback is welcome so it can become sharper and more reliable.
 - **Studio / Control Room:** choose players, group rooms, control volumes, move playback, and manage multi-room listening.
 - **Mobile-first workflow:** queue, search, library, FLOW, actions, timers, announcements, settings, and player switching are designed for touch.
-- **Real Music Assistant library flow:** playlists, albums, artists, tracks, radio, favorites, recent listening, and recommendations.
+- **Real Music Assistant library flow:** playlists, albums, artists, tracks, radio, favorites, recent listening, recommendations, and album/playlist drill-in before playback.
 - **Smart-home aware listening:** optional Home Assistant light sync, screensaver display, and POWER actions let the card participate in the room without becoming mandatory setup.
-- **Hebrew and RTL ready:** layout, labels, alignment, and interaction patterns are built for Hebrew as a first-class use case.
+- **International and RTL ready:** English, Hebrew/RTL, and Simplified Chinese are bundled, with the same localization path available for future community translations.
 - **Release-ready package:** HACS-ready `dist/` output includes the card, Sendspin files, Embla swipe support, and the brand asset.
 
+## What's New In 5.6.0
+
+- **Flow Assistant arrives as an experimental voice layer:** open it from the player, the empty-state music screen, or the screensaver, then ask for music in natural language. This is still experimental; feedback, failed examples, and language/device reports are especially helpful for improving it.
+- **Library browsing is less accidental:** playlists and albums can open into their track list before playback, with a compact `Play` button when you want to start the full item immediately.
+- **Touch feedback is clearer across the music surface:** library content, recommendations, the empty-state wand, and quick actions now respond with stronger visual feedback so taps feel immediate instead of uncertain.
+- **Screensaver controls stay elegant:** the screensaver can show subtle voice, previous, and next controls when enabled, while keeping the clean idle look and avoiding accidental exits during Flow Assistant interaction.
+- **Radio artwork is fixed in normal playback:** radio stations that expose dynamic `entity_picture` artwork now show that cover in the main player too, not only in the screensaver, with safer fallback branding when station art is missing.
+- **Radio layout has been tightened:** radio playback no longer depends on broken station image URLs, and titles/artwork are arranged more cleanly across large tablet views.
+- **Quick Actions adds `Clear all`:** a red-toned disconnect action can be enabled from the visual editor and uses a confirmation popup before disconnecting all active players.
+- **Shuffle and repeat states are easier to read:** repeat-one, repeat-all, and shuffle now have clearer active styling so the current mode is not a guessing game.
+- **Visual editor wording is cleaner:** Flow Assistant, icon sizing, quick actions, and related settings now use friendly labels instead of internal underscore-style names.
+- **Simplified Chinese localization is now bundled:** thank you to [@gao19970120](https://github.com/gao19970120) for contributing the Chinese translation.
+
 ## What's New In 5.5.0
 
 - **Commercial-grade responsive fit:** the card now measures its actual dashboard/container size, reacts to Home Assistant grid/sidebar/editor changes, and adapts by width, height, and aspect ratio instead of relying only on the browser viewport.
@@ -190,7 +204,7 @@ If HACS does not add the resource automatically, add:
 3. Add this Dashboard resource:
 
 ```text
-/local/community/homeii-music-flow/homeii-music-flow.js?v=5.5.0
+/local/community/homeii-music-flow/homeii-music-flow.js?v=5.6.0
 ```
 
 4. Add the card:
@@ -867,7 +881,7 @@ npm run lint
 npm test
 ```
 
-Current packaged version: `5.5.0`
+Current packaged version: `5.6.0`
 
 ## Release Readiness
 

TRANSLATING.md

@@ -2,7 +2,7 @@
 
 This glossary lists every localization key currently used by the card. Translate the values in `src/localization/en.js` into a new language file, keep the keys unchanged, and use the context below to understand where each string appears.
 
-Generated for target version 5.5.0. Total strings: 758.
+Generated for target version 5.6.0. Total strings: 879.
 
 | Key | English | Description | Context |
 | --- | --- | --- | --- |