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,105 @@
+"""Frontend module registration for the Maintenance Supporter integration."""
+
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+from homeassistant.components.http import StaticPathConfig
+from homeassistant.core import HomeAssistant
+
+from ..const import (
+    CALENDAR_CARD_URL,
+    CARD_URL,
+    DOMAIN,
+    LOCALES_URL,
+    STRATEGY_CHUNKS_URL,
+    STRATEGY_SHIM_URL,
+    STRATEGY_URL,
+    VENDOR_URL,
+)
+
+_LOGGER = logging.getLogger(__name__)
+
+DATA_EXTRA_MODULE_URL = "frontend_extra_module_url"
+
+# Survives the hass.data[DOMAIN] pop on last-entry unload (see docstring).
+_CARD_REGISTERED_KEY = f"{DOMAIN}_card_registered"
+
+
+async def async_register_card(hass: HomeAssistant) -> None:
+    """Register the Lovelace card + dashboard strategy JS modules.
+
+    Card: works on every supported HA version.
+    Strategy: HA 2026.5+ picks it up via ``window.customStrategies``; on older
+    versions the registration is a silent no-op. We ship both unconditionally
+    so users on any version get the card and 2026.5+ users additionally get
+    the auto-generated dashboard in the "Add Dashboard" picker.
+
+    The already-registered guard lives OUTSIDE hass.data[DOMAIN]: that dict is
+    popped when the last entry unloads, but the static paths stay mounted on
+    the HTTP app — re-registering them after an uninstall → reinstall in the
+    same HA run would raise on the duplicate routes (journey O1).
+    """
+    if hass.data.get(_CARD_REGISTERED_KEY):
+        return
+
+    frontend_dir = Path(__file__).parent
+    # v2.3.4 (issue #52): the strategy is a multi-file split bundle living
+    # in frontend/strategy/. Mount the directory under STRATEGY_DIR_URL so
+    # the entry's relative ./chunks/* dynamic imports resolve without per-
+    # chunk URL registration. The entry file URL stays STRATEGY_URL so the
+    # frontend_extra_module_url registration that HA serves to the browser
+    # doesn't need to know about the chunk layout.
+    static_paths = [
+        StaticPathConfig(CARD_URL, str(frontend_dir / "maintenance-card.js"), False),
+        # The shim (tiny, zero-import) is the frontend extra-module-url; it
+        # lazy-imports the full strategy bundle below on first use.
+        StaticPathConfig(
+            STRATEGY_SHIM_URL,
+            str(frontend_dir / "maintenance-strategy-shim.js"),
+            False,
+        ),
+        StaticPathConfig(
+            STRATEGY_URL,
+            str(frontend_dir / "strategy" / "maintenance-dashboard-strategy.js"),
+            False,
+        ),
+        StaticPathConfig(
+            STRATEGY_CHUNKS_URL,
+            str(frontend_dir / "strategy" / "chunks"),
+            False,
+        ),
+        StaticPathConfig(
+            CALENDAR_CARD_URL,
+            str(frontend_dir / "maintenance-calendar-card.js"),
+            False,
+        ),
+        # Runtime-loaded UI translations: a directory of <lang>.json fetched by
+        # the panel/card on demand (only EN is bundled into the JS). cache=False
+        # so a translation edit shows up on reload without a version bump.
+        StaticPathConfig(LOCALES_URL, str(frontend_dir / "locales"), False),
+        # v2.21: pdf.js for the work sheet's inline manual excerpt (cache=True —
+        # versioned by release like the JS bundles).
+        StaticPathConfig(VENDOR_URL, str(frontend_dir / "vendor"), True),
+    ]
+    await hass.http.async_register_static_paths(static_paths)
+
+    # Add to extra module URLs so HA auto-loads them in the frontend.
+    # IMPORTANT: register the SHIM, not the heavy strategy bundle — the shim
+    # defines the dashboard-strategy element synchronously so it wins HA's 5 s
+    # whenDefined race even under heavy HACS plugin load (the bundle is loaded
+    # lazily by the shim). The heavy bundle's static path stays mounted above
+    # so the shim's import() can fetch it on demand.
+    extra = hass.data.setdefault(DATA_EXTRA_MODULE_URL, set())
+    extra.add(CARD_URL)
+    extra.add(STRATEGY_SHIM_URL)
+    extra.add(CALENDAR_CARD_URL)
+
+    hass.data[_CARD_REGISTERED_KEY] = True
+    _LOGGER.debug(
+        "Maintenance Supporter frontend resources registered: card=%s, strategy=%s, calendar=%s",
+        CARD_URL,
+        STRATEGY_URL,
+        CALENDAR_CARD_URL,
+    )