Fix Home Assistant custom card registry mutation

Author: r11a

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 5.1.5 - 2026-05-02
+
+Home Assistant Dashboard picker registry fix.
+
+- Mutates the existing `window.customCards` array in place instead of replacing it, matching Home Assistant's picker implementation which imports and keeps the original array reference.
+
 ## 5.1.4 - 2026-05-02
 
 Stronger Home Assistant Dashboard picker registration.

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.1.4`
+`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.1.5`
 
 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.1.4 Mapping
+## Current 5.1.5 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`, `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.1.4`
+- Lovelace resource: `/local/community/homeii-music-flow/homeii-music-flow.js?v=5.1.5`
 
 ## 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.1.4`
+`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.1.5`
 
 ## Foundation Note
 

PUBLISHING.md

@@ -23,12 +23,12 @@
   - the HACS My Home Assistant button
   - the HACS download/install button
 
-## 2. Create the 5.1.4 release
+## 2. Create the 5.1.5 release
 
-- Create a Git tag named `v5.1.4`.
+- Create a Git tag named `v5.1.5`.
 - Create a GitHub release from that tag.
-- Title the release `5.1.4`.
-- Use the `5.1.4` section from `CHANGELOG.md` as the release notes.
+- Title the release `5.1.5`.
+- Use the `5.1.5` 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.
 
 ## 3. Verify repository files after publishing
@@ -79,7 +79,7 @@ to:
 
 Then load:
 
-`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.1.4`
+`/local/community/homeii-music-flow/homeii-music-flow.js?v=5.1.5`
 
 ## 7. Final pre-release smoke test
 

README.md

@@ -22,7 +22,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.1.4-gold"></a>
+  <a href="https://github.com/r11a/homeii-music-flow"><img alt="version" src="https://img.shields.io/badge/version-5.1.5-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">
@@ -49,6 +49,10 @@ 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.1.5
+
+- **Dashboard picker registry fix:** HOMEii Flow now mutates Home Assistant's existing `window.customCards` registry in place instead of replacing it, matching the way the HA picker imports and reads custom-card metadata.
+
 ## What's New In 5.1.4
 
 - **Stronger Dashboard picker registration:** HOMEii Flow now refreshes its custom-card metadata after load and exposes picker config methods directly on the final card class for Home Assistant versions that do not reliably pick them up through inheritance.
@@ -122,7 +126,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.1.4
+/local/community/homeii-music-flow/homeii-music-flow.js?v=5.1.5
 ```
 
 4. Add the card:
@@ -700,7 +704,7 @@ npm run lint
 npm test
 ```
 
-Current packaged version: `5.1.4`
+Current packaged version: `5.1.5`
 
 ## Release Readiness
 

dist/homeii-music-flow.js

@@ -429,7 +429,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.1.4";
+    const version = typeof HOMEII_CARD_VERSION === "string" ? HOMEII_CARD_VERSION : "5.1.5";
     return `${value}${value.includes("?") ? "&" : "?"}v=${encodeURIComponent(version)}`;
   }
 
@@ -9685,9 +9685,9 @@ function ensureHaEditorComponents() {
   } catch (_) {}
 }
 
-const HOMEII_CARD_VERSION = "5.1.4";
-const HOMEII_BROWSER_EDITOR_TAG = "homeii-music-flow-browser-editor-v5140";
-const HOMEII_MOBILE_EDITOR_TAG = "homeii-music-flow-editor-v5140";
+const HOMEII_CARD_VERSION = "5.1.5";
+const HOMEII_BROWSER_EDITOR_TAG = "homeii-music-flow-browser-editor-v5150";
+const HOMEII_MOBILE_EDITOR_TAG = "homeii-music-flow-editor-v5150";
 
 const HomeiiEditorLocale = Object.freeze({
   isHebrewLanguageTag(value) {
@@ -12256,7 +12256,7 @@ if (!customElements.get(HOMEII_BROWSER_EDITOR_TAG)) {
   customElements.define(HOMEII_BROWSER_EDITOR_TAG, HomeiiBaseMusicEditor);
 }
 
-window.customCards = (window.customCards || []).filter((card) => card?.type !== "custom:homeii-music-flow");
+if (!Array.isArray(window.customCards)) window.customCards = [];
 
 class HomeiiMusicFlowBaseCard extends HomeiiBaseMusicCard {
   constructor() {
@@ -29156,11 +29156,14 @@ if (!customElements.get("homeii-music-mobile-editor")) {
 }
 
 function registerHomeiiDashboardCard() {
-  window.customCards = (window.customCards || []).filter((card) => (
-    card?.type !== "custom:homeii-music-flow"
-    && card?.type !== "homeii-music-flow"
-  ));
-  window.customCards.push({
+  const customCardsRegistry = Array.isArray(window.customCards) ? window.customCards : (window.customCards = []);
+  for (let index = customCardsRegistry.length - 1; index >= 0; index -= 1) {
+    const card = customCardsRegistry[index];
+    if (card?.type === "custom:homeii-music-flow" || card?.type === "homeii-music-flow") {
+      customCardsRegistry.splice(index, 1);
+    }
+  }
+  customCardsRegistry.push({
     type: "homeii-music-flow",
     name: "HOMEii Flow",
     description: `Premium Music Assistant dashboard card v${HOMEII_CARD_VERSION}`,

docs/qa-matrix.md

@@ -32,6 +32,6 @@ This matrix is the release gate for the `4.9.x` stabilization cycle. Every relea
 
 ## Release Rule
 
-- `5.1.4` is blocked by any known `P0` or `P1` bug in the matrix above.
+- `5.1.5` is blocked by any known `P0` or `P1` bug in the matrix above.
 - Cosmetic `P3` issues may ship only if they are documented and non-regressive.
 - Any regression found in one viewport/theme combination must be retested across the rest of the matrix after the fix lands.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "homeii-music-flow",
-  "version": "5.1.4",
+  "version": "5.1.5",
   "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

@@ -429,7 +429,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.1.4";
+    const version = typeof HOMEII_CARD_VERSION === "string" ? HOMEII_CARD_VERSION : "5.1.5";
     return `${value}${value.includes("?") ? "&" : "?"}v=${encodeURIComponent(version)}`;
   }
 
@@ -9685,9 +9685,9 @@ function ensureHaEditorComponents() {
   } catch (_) {}
 }
 
-const HOMEII_CARD_VERSION = "5.1.4";
-const HOMEII_BROWSER_EDITOR_TAG = "homeii-music-flow-browser-editor-v5140";
-const HOMEII_MOBILE_EDITOR_TAG = "homeii-music-flow-editor-v5140";
+const HOMEII_CARD_VERSION = "5.1.5";
+const HOMEII_BROWSER_EDITOR_TAG = "homeii-music-flow-browser-editor-v5150";
+const HOMEII_MOBILE_EDITOR_TAG = "homeii-music-flow-editor-v5150";
 
 const HomeiiEditorLocale = Object.freeze({
   isHebrewLanguageTag(value) {
@@ -12256,7 +12256,7 @@ if (!customElements.get(HOMEII_BROWSER_EDITOR_TAG)) {
   customElements.define(HOMEII_BROWSER_EDITOR_TAG, HomeiiBaseMusicEditor);
 }
 
-window.customCards = (window.customCards || []).filter((card) => card?.type !== "custom:homeii-music-flow");
+if (!Array.isArray(window.customCards)) window.customCards = [];
 
 class HomeiiMusicFlowBaseCard extends HomeiiBaseMusicCard {
   constructor() {
@@ -29156,11 +29156,14 @@ if (!customElements.get("homeii-music-mobile-editor")) {
 }
 
 function registerHomeiiDashboardCard() {
-  window.customCards = (window.customCards || []).filter((card) => (
-    card?.type !== "custom:homeii-music-flow"
-    && card?.type !== "homeii-music-flow"
-  ));
-  window.customCards.push({
+  const customCardsRegistry = Array.isArray(window.customCards) ? window.customCards : (window.customCards = []);
+  for (let index = customCardsRegistry.length - 1; index >= 0; index -= 1) {
+    const card = customCardsRegistry[index];
+    if (card?.type === "custom:homeii-music-flow" || card?.type === "homeii-music-flow") {
+      customCardsRegistry.splice(index, 1);
+    }
+  }
+  customCardsRegistry.push({
     type: "homeii-music-flow",
     name: "HOMEii Flow",
     description: `Premium Music Assistant dashboard card v${HOMEII_CARD_VERSION}`,