106 lines
4.1 KiB
Python
106 lines
4.1 KiB
Python
"""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,
|
|
)
|