New apps Added

2026-07-08 10:43:39 -04:00
parent 3b1f4bbd75
commit fefc2c8b5c
1114 changed files with 406637 additions and 154 deletions
@@ -0,0 +1,89 @@
+"""Sidebar panel registration for the Maintenance Supporter integration."""
+
+from __future__ import annotations
+
+import hashlib
+import logging
+from pathlib import Path
+
+from homeassistant.components import frontend, panel_custom
+from homeassistant.components.http import StaticPathConfig
+from homeassistant.core import HomeAssistant
+
+from .const import DOMAIN, PANEL_ICON, PANEL_NAME, PANEL_URL
+from .helpers.global_options import get_panel_title
+
+_LOGGER = logging.getLogger(__name__)
+
+
+async def _async_file_hash(hass: HomeAssistant, path: Path) -> str:
+    """Return a short hash of a file for cache busting."""
+    try:
+        content = await hass.async_add_executor_job(path.read_bytes)
+        return hashlib.sha256(content).hexdigest()[:8]
+    except OSError:
+        return "0"
+
+
+async def async_register_panel(hass: HomeAssistant, *, force: bool = False) -> None:
+    """Register the maintenance supporter sidebar panel.
+
+    Pass ``force=True`` to re-register an already-registered panel (e.g. after
+    the user changes the sidebar title in options) — HA's panel registry has no
+    in-place update, so we remove and re-add it.
+    """
+    title = get_panel_title(hass)
+    if hass.data.get(DOMAIN, {}).get("_panel_registered"):
+        if not force:
+            return
+        # The ONLY global-options change that needs a re-register is the
+        # sidebar title — HA has no in-place panel update. If the title is
+        # unchanged, return early: calling async_remove_panel on every
+        # unrelated settings change (feature toggles, objects-table columns,
+        # notification prefs, …) yanks the panel out from under anyone
+        # currently viewing it and bounces them to the HA default dashboard.
+        if hass.data.get(DOMAIN, {}).get("_panel_title") == title:
+            return
+        # Title changed: drop the existing registration so the re-register
+        # below doesn't raise "Overwriting panel".
+        frontend.async_remove_panel(hass, PANEL_NAME)
+        hass.data.setdefault(DOMAIN, {})["_panel_registered"] = False
+
+    panel_path = Path(__file__).parent / "frontend" / "maintenance-panel.js"
+    version = await _async_file_hash(hass, panel_path)
+    versioned_url = f"{PANEL_URL}_{version}"
+
+    # Static path is registered once per versioned URL; on a forced re-register
+    # the URL is unchanged (same bundle hash), so guard against re-adding it.
+    if hass.data.get(DOMAIN, {}).get("_panel_static_url") != versioned_url:
+        await hass.http.async_register_static_paths([StaticPathConfig(versioned_url, str(panel_path), False)])
+        hass.data.setdefault(DOMAIN, {})["_panel_static_url"] = versioned_url
+
+    await panel_custom.async_register_panel(
+        hass,
+        frontend_url_path=PANEL_NAME,
+        webcomponent_name="maintenance-supporter-panel",
+        sidebar_title=title,
+        sidebar_icon=PANEL_ICON,
+        module_url=versioned_url,
+        require_admin=False,
+        config={},
+    )
+
+    hass.data.setdefault(DOMAIN, {})["_panel_registered"] = True
+    hass.data.setdefault(DOMAIN, {})["_panel_title"] = title
+    _LOGGER.debug(
+        "Maintenance Supporter sidebar panel registered (title=%s, v=%s)",
+        title,
+        version,
+    )
+
+
+async def async_unregister_panel(hass: HomeAssistant) -> None:
+    """Remove the maintenance supporter sidebar panel."""
+    if not hass.data.get(DOMAIN, {}).get("_panel_registered"):
+        return
+
+    frontend.async_remove_panel(hass, PANEL_NAME)
+    hass.data.setdefault(DOMAIN, {})["_panel_registered"] = False
+    _LOGGER.debug("Maintenance Supporter sidebar panel removed")