/** * @file sim_helpers.h * @brief Test helpers that touch sketch internals — include AFTER the * sketch (single-TU inclusion gives the tests access to the * sketch's statics, exactly like main.cpp gets them). */ #pragma once #include "harness.h" // advance the deterministic 20 Hz simulation by n ticks (no wall time) inline void stepTicks(int n) { for (int i = 0; i < n; i++) stepSim(); } // click exactly on a network node (Network view) — cursor + primary action inline void clickNode(int node) { curX = nodePx(node); curY = nodePy(node); registerClick(); } // click the center of a map tile (Cameras view) — places the beacon inline void clickTile(int tx, int ty) { curX = tx * nd::TILE + nd::TILE / 2; curY = ty * nd::TILE + nd::TILE / 2; registerClick(); } // find the active link on an edge, or -1 inline int linkIdx(int edge) { return linkOnEdge(edge); } // fresh deterministic scenario state for a test inline void freshScenario(unsigned seed = 0xC0FFEE) { std::srand((unsigned)seed); resetScenario(); viewMode = VM_CAMERAS; // resetScenario deliberately keeps the view test::serialClear(); }