14 — Themes — Subsystem Test Map¶

The themes subsystem owns the dashboard-card theme library: preloaded built-in themes, the user library (save-as-new / overwrite / rename / delete), the active theme + working draft, import/export, and the update-callback fan-out that refreshes theme-bound entities. Covered by 89 tests across 5 files.

Source: custom_components/eufy_vacuum/themes/ Architecture reference: docs/dev/frontend/theme-system.md

Coverage map¶

Source module	Stmts	Cov	Test files	Layer	Mocking
`manager.py`	353	96%	`test_themes_manager.py`, `test_themes_manager_deep.py`, `test_themes_import_scoped.py`	integration	clean
`services.py`	125	91%	`test_themes_services.py`	integration	bare x1
`preloaded.py`	32	98%	`test_themes_preloaded.py` (unit)	unit	clean

What's tested¶

Library CRUD — save-as-new, overwrite, rename, delete. Preloaded built-ins are re-seeded on restart but are not delete-protected at the manager/service layer.
Active theme + draft — set active, update working draft, revert draft.
Import / export — round-trip of a theme payload (legacy full import that adds a new library theme), plus scoped per-floor-type import (manager.py _import_scoped) that clear-then-applies an --evcc-floor-{type}-* namespace onto the vacuum's active theme and clears the matching working-draft overrides.
Service layer — the theme services raise ServiceValidationError on bad input (HA Silver action-exception contract).

How it's tested¶

ThemeManager over the manager fixture; the _deep file pushes the less-common branches (draft revert, import validation). Services are driven through the registry with manager_with_services.

Known gaps¶

manager.py (95%, grown from 308 to 337 statements) — the remaining uncovered lines are still defensive input-validation guards, not behavior gaps, though line numbers have moved with the file's growth. A new deleted_core_ids tombstone-list re-init guard (407-408) joined the set. import_theme/_import_scoped-family rejection guards: a non-dict payload or missing theme (547, 551), non-dict colors/alpha (571, 573 — the parallel tokens guard is covered), and empty_scope when every scope name strips blank (673). A non-dict bucket re-init while merging a scoped import (696-697). One normalize-loop guard skips a blank theme id (_get_theme_library_entries, 182), and the tag-list cap break in _clean_theme_tags (48) never fires under test. All are the same skip-the-malformed class — deliberately measured, not pragma'd. The update-callback fan-out except (_notify_updated) is covered by the raising-callback test ([TMD-3]).

services.py (95%) — nearly fully covered; the one uncovered handler is handle_set_theme_tags (192-200), whose set_theme_tags → _raise_if_failed → async_save + return tail has no test driving it through the registry. Every other handler's failure and success path, including the handle_overwrite_theme async_save + return tail, is exercised.

preloaded.py (98%, grown from 28 to 32 statements) — one partial branch, the 540->542 partial in ensure_preloaded_theme_library, where an already-present built-in entry is not a dict, so the setdefault("source", "core") provenance backfill is skipped and the loop falls straight through to continue. Tests only exercise the dict-entry re-seed path.