Core header defining the `SystemFlags` and `BlueprintStatusFlags` bitfield structs, the `HardwareSettings` packed bitfield, and the `fire_ha_event()` function. This component demonstrates a clean, compile-time efficient state management pattern for embedded systems. The bitfield approach reduces RAM usage, and the event emitter abstraction decouples touch interactions from the Home Assistant event bus. The file also includes utility macros for conditional logging and version checking. It is self-contained and could be extracted into any ESPHome component needing similar event-driven state tracking.

Implements the main `NSPanel` class which manages the entire lifecycle: boot sequence, page transitions, touch event parsing, and Home Assistant communication. The class uses a clear state machine (boot phases, page IDs) and a robust event loop that processes serial commands from the Nextion display. The `wrapText()` utility (for text fitting on small screens) is a reusable algorithm. The separation of concerns between page handling, hardware abstraction, and event dispatch makes this a strong example of embedded firmware architecture.

Provides text wrapping (`wrapText`) and decimal separator adjustment functions. The wrapping algorithm is optimized for small displays with a fixed width, breaking lines at word boundaries and handling CJK characters. This is a self-contained, portable utility that could be reused in any project requiring text fitting on constrained displays, not tied to the NSPanel hardware.

The core YAML package that includes all base hardware and page definitions. It demonstrates a clean modular include pattern: each component (display, Wi-Fi, buttons, etc.) is a separate YAML file included via `packages`. The `!extend` and `!remove` mechanisms allow add-ons to override specific parts without modifying the core. This pattern is reusable for any ESPHome project that needs to manage configuration complexity across multiple hardware variants.