dangernoodle-io / breadboard / 27323149317

100%

push

github

docs(bb_display): two-tier display model + component dependency-hygiene rules (#383)

document why ek79007 exposes lv_obj_t while the small panels don't, and
codify the dep-scoping rules the recent leak audit had to discover the
hard way, so neither gets re-litigated.

display model (bb_display.h + CLAUDE.md):
- small SPI/I2C panels (st77xx/ili9341/ssd1306) implement the portable
  pixel-blit core; no UI framework.
- large MIPI-DSI/RGB panels (ek79007) are LVGL-driven and expose an
  lv_obj_t* screen root as a deliberate, ESP-only escape hatch (not a
  leak; esp_lvgl_port stays in that backend's REQUIRES).
- small panels must not pull LVGL (no-PSRAM, CPU-busy classic ESP32 like
  the CYD).
- corrects the over-general "LVGL is initialized inside bb_display_init".

component dependency hygiene (CLAUDE.md):
- decisive REQUIRES-vs-PRIV_REQUIRES test (public-header use only)
- no esp/third-party types in public headers; wrap behind opaque bb_*
  handles (bb_http_request_t, bb_json_t cited as the model)
- the documented LVGL exception, cross-ref'd
- high-risk dep watchlist + a copy-paste self-check grep (CI TODO: B1-263)
- fixes the EARLY-tier registry list (adds bb_diag_panic, bb_event)

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

1637 of 1637 branches covered (100.0%)

Branch coverage included in aggregate %.

2755 of 2755 relevant lines covered (100.0%)

977.71 hits per line