hass-eink-dashboard: Skill for Claude Code

Write Widget Tests: $widget-type

Write comprehensive tests for the $widget-type widget. This is the TDD red phase — tests must FAIL until the SVG renderer is implemented.

Before you start

1. Read the task description / spec doc for the new widget.
2. Read tests/helpers.py for available test helpers.
3. Read existing per-widget test files in tests/test_render_*.py for patterns. The SEPARATOR tests (TestRenderSeparator) in tests/test_render_separator.py are the reference for structural/pixel assertions. The weather tests (TestRenderWeather) in tests/test_render_weather.py show the _DEFAULTS + _config() pattern.
4. Read custom_components/eink_dashboard/templates/_macros.svg.j2 for macro signatures (card_container, card_row, chip) so you know the card container insets to use in pixel region calculations.
5. Read const.py for COLOR_BLACK=0, COLOR_WHITE=255, COLOR_GRAY=120, PADDING=24.

Existing test classes

!grep -rn "^class Test" tests/test_render_*.py

Current test helper signatures

!grep -n "^def " tests/helpers.py

Current WidgetMetrics sizing ratios

Call _compute_metrics(row_h) in tests to derive expected pixel regions from the same ratios the renderer uses — no hardcoded magic numbers.

!grep -n "def _compute_metrics" -A 12 custom_components/eink_dashboard/render.py

SVG macro signatures (from _macros.svg.j2)

!grep -n "macro card_container\|macro card_row\|macro chip" custom_components/eink_dashboard/templates/_macros.svg.j2

Icon resolver (in render.py)

!grep -n "def _device_class_icon" -A 5 custom_components/eink_dashboard/render.py

SVG renderer registry

!grep -n "_SVG_RENDERERS" -A 12 custom_components/eink_dashboard/svg_render.py

Imports

import re

from custom_components.eink_dashboard.const import (
    COLOR_BLACK, COLOR_GRAY, PADDING, DEFAULT_CARD_STYLE,
    DEFAULT_ROW_H,
)
from custom_components.eink_dashboard.render import (
    WidgetMetrics, _compute_metrics, DEFAULT_METRICS,
    _device_class_icon, render_dashboard,
)
from custom_components.eink_dashboard.svg_render import (
    render_widget_svg,
)
from custom_components.eink_dashboard.widgets._helpers import (
    _card_insets, _metrics_context, _auto_row_height,
)
from tests.helpers import (
    assert_all_white, assert_card_border, assert_has_dark_pixels,
    assert_has_gray_pixels,
    assert_scales_proportionally, assert_vertically_centered,
    content_bbox, make_config, pixel, render_to_image,
)