Release 5.4.1

Author: r11a

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 5.4.1 - 2026-05-10
+
+Distribution hotfix for the withdrawn 5.4.0 release.
+
+- Republishes the 5.4.0 card fixes as `5.4.1` without adding a custom release zip asset, so HACS can use the normal repository release/tag contents and the complete `dist/` package.
+- Keeps the runtime logic unchanged from 5.4.0; this release is intentionally limited to packaging/versioning.
+- Bumps runtime/editor tags to `5.4.1` so Home Assistant browsers do not reuse cached `5.4.0` resources.
+- Updates README and publishing instructions to avoid custom zip assets for HACS releases.
+
 ## 5.4.0 - 2026-05-10
 
 Community fix cycle for tablet library artwork, local browser playback, search, queue ergonomics, player controls, and visual polish.

PUBLISHING.md

@@ -23,13 +23,13 @@
   - the HACS My Home Assistant button
   - the HACS download/install button
 
-## 2. Create the 5.4.0 release
+## 2. Create the 5.4.1 release
 
-- Create a Git tag named `v5.4.0`.
+- Create a Git tag named `v5.4.1`.
 - Create a GitHub release from that tag.
-- Title the release `5.4.0`.
-- Use the `5.4.0` section from `CHANGELOG.md` as the release notes.
-- If you attach a release artifact, zip the contents of `dist/`; do not publish only a single JS file while the local Sendspin player and Embla swipe support are enabled.
+- Title the release `5.4.1`.
+- Use the `5.4.1` 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
 
@@ -79,7 +79,7 @@ to:
 
 Then load:
 
-`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.4.0`
+`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.4.1`
 
 ## 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.4.0-gold"></a>
+  <a href="https://github.com/r11a/homeii-music-flow"><img alt="version" src="https://img.shields.io/badge/version-5.4.1-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">
@@ -53,6 +53,12 @@ HOMEii Flow started from my own daily use of Home Assistant and Music Assistant.
 - **Hebrew and RTL ready:** layout, labels, alignment, and interaction patterns are built for Hebrew as a first-class use case.
 - **Release-ready package:** HACS-ready `dist/` output includes the card, Sendspin files, Embla swipe support, and the brand asset.
 
+## What's New In 5.4.1
+
+- **Distribution hotfix:** republishes the 5.4.0 fixes without a custom release zip asset, so HACS can use the normal repository release/tag contents and the complete `dist/` package.
+- **No runtime feature changes from 5.4.0:** this release is intentionally limited to packaging/versioning.
+- **Cache refresh:** bumps the runtime/editor tags to 5.4.1 so browsers do not reuse the withdrawn 5.4.0 bundle.
+
 ## What's New In 5.4.0
 
 - **Local Sendspin fixed:** `This device` loads from the packaged `sendspin-js/index.js` runtime again, fixing the missing bundle/core import errors seen after 5.3.0.
@@ -172,7 +178,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.4.0
+/local/community/homeii-music-flow/homeii-music-flow.js?v=5.4.1
 ```
 
 4. Add the card:
@@ -840,7 +846,7 @@ npm run lint
 npm test
 ```
 
-Current packaged version: `5.4.0`
+Current packaged version: `5.4.1`
 
 ## Release Readiness
 

dist/homeii-music-flow.js

@@ -577,7 +577,7 @@
   _versionedAssetUrl(url) {
     const value = String(url || "").trim();
     if (!value || /^data:/i.test(value) || /[?&]v=/.test(value)) return value;
-    const version = typeof HOMEII_CARD_VERSION === "string" ? HOMEII_CARD_VERSION : "5.4.0";
+    const version = typeof HOMEII_CARD_VERSION === "string" ? HOMEII_CARD_VERSION : "5.4.1";
     return `${value}${value.includes("?") ? "&" : "?"}v=${encodeURIComponent(version)}`;
   }
 
@@ -11560,9 +11560,9 @@ function ensureHaEditorComponents() {
   } catch (_) {}
 }
 
-const HOMEII_CARD_VERSION = "5.4.0";
-const HOMEII_BROWSER_EDITOR_TAG = "homeii-music-flow-browser-editor-v540";
-const HOMEII_MOBILE_EDITOR_TAG = "homeii-music-flow-editor-v540";
+const HOMEII_CARD_VERSION = "5.4.1";
+const HOMEII_BROWSER_EDITOR_TAG = "homeii-music-flow-browser-editor-v541";
+const HOMEII_MOBILE_EDITOR_TAG = "homeii-music-flow-editor-v541";
 
 const HomeiiEditorLocale = Object.freeze({
   isHebrewLanguageTag(value) {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "homeii-music-flow",
-  "version": "5.4.0",
+  "version": "5.4.1",
   "description": "Premium Home Assistant Music Assistant dashboard card with a mobile-first visual player and built-in editor.",
   "private": true,
   "license": "MIT",

src/homeii-music-flow.js

@@ -577,7 +577,7 @@
   _versionedAssetUrl(url) {
     const value = String(url || "").trim();
     if (!value || /^data:/i.test(value) || /[?&]v=/.test(value)) return value;
-    const version = typeof HOMEII_CARD_VERSION === "string" ? HOMEII_CARD_VERSION : "5.4.0";
+    const version = typeof HOMEII_CARD_VERSION === "string" ? HOMEII_CARD_VERSION : "5.4.1";
     return `${value}${value.includes("?") ? "&" : "?"}v=${encodeURIComponent(version)}`;
   }
 
@@ -11560,9 +11560,9 @@ function ensureHaEditorComponents() {
   } catch (_) {}
 }
 
-const HOMEII_CARD_VERSION = "5.4.0";
-const HOMEII_BROWSER_EDITOR_TAG = "homeii-music-flow-browser-editor-v540";
-const HOMEII_MOBILE_EDITOR_TAG = "homeii-music-flow-editor-v540";
+const HOMEII_CARD_VERSION = "5.4.1";
+const HOMEII_BROWSER_EDITOR_TAG = "homeii-music-flow-browser-editor-v541";
+const HOMEII_MOBILE_EDITOR_TAG = "homeii-music-flow-editor-v541";
 
 const HomeiiEditorLocale = Object.freeze({
   isHebrewLanguageTag(value) {