MouseInterfaceTests.cs 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444
  1. using Terminal.Gui.App;
  2. using Xunit.Abstractions;
  3. namespace UnitTests_Parallelizable.ApplicationTests;
  4. /// <summary>
  5. /// Parallelizable tests for IMouse interface.
  6. /// Tests the decoupled mouse handling without Application.Init or global state.
  7. /// </summary>
  8. [Trait ("Category", "Input")]
  9. public class MouseInterfaceTests (ITestOutputHelper output)
  10. {
  11. private readonly ITestOutputHelper _output = output;
  12. #region IMouse Basic Properties
  13. [Fact]
  14. public void Mouse_LastMousePosition_InitiallyNull ()
  15. {
  16. // Arrange
  17. MouseImpl mouse = new ();
  18. // Act & Assert
  19. Assert.Null (mouse.LastMousePosition);
  20. }
  21. [Theory]
  22. [InlineData (0, 0)]
  23. [InlineData (10, 20)]
  24. [InlineData (-5, -10)]
  25. [InlineData (100, 200)]
  26. public void Mouse_LastMousePosition_CanBeSetAndRetrieved (int x, int y)
  27. {
  28. // Arrange
  29. MouseImpl mouse = new ();
  30. Point testPosition = new (x, y);
  31. // Act
  32. mouse.LastMousePosition = testPosition;
  33. // Assert
  34. Assert.Equal (testPosition, mouse.LastMousePosition);
  35. Assert.Equal (testPosition, mouse.GetLastMousePosition ());
  36. }
  37. [Fact]
  38. public void Mouse_IsMouseDisabled_DefaultsFalse ()
  39. {
  40. // Arrange
  41. MouseImpl mouse = new ();
  42. // Act & Assert
  43. Assert.False (mouse.IsMouseDisabled);
  44. }
  45. [Theory]
  46. [InlineData (true)]
  47. [InlineData (false)]
  48. public void Mouse_IsMouseDisabled_CanBeSetAndRetrieved (bool disabled)
  49. {
  50. // Arrange
  51. MouseImpl mouse = new ();
  52. // Act
  53. mouse.IsMouseDisabled = disabled;
  54. // Assert
  55. Assert.Equal (disabled, mouse.IsMouseDisabled);
  56. }
  57. [Fact]
  58. public void Mouse_CachedViewsUnderMouse_InitiallyEmpty ()
  59. {
  60. // Arrange
  61. MouseImpl mouse = new ();
  62. // Act & Assert
  63. Assert.NotNull (mouse.CachedViewsUnderMouse);
  64. Assert.Empty (mouse.CachedViewsUnderMouse);
  65. }
  66. #endregion
  67. #region IMouse Event Handling
  68. [Fact]
  69. public void Mouse_MouseEvent_CanSubscribeAndFire ()
  70. {
  71. // Arrange
  72. MouseImpl mouse = new ();
  73. var eventFired = false;
  74. MouseEventArgs capturedArgs = null;
  75. mouse.MouseEvent += (sender, args) =>
  76. {
  77. eventFired = true;
  78. capturedArgs = args;
  79. };
  80. MouseEventArgs testEvent = new ()
  81. {
  82. ScreenPosition = new Point (5, 10),
  83. Flags = MouseFlags.Button1Pressed
  84. };
  85. // Act
  86. mouse.RaiseMouseEvent (testEvent);
  87. // Assert
  88. Assert.True (eventFired);
  89. Assert.NotNull (capturedArgs);
  90. Assert.Equal (testEvent.ScreenPosition, capturedArgs.ScreenPosition);
  91. Assert.Equal (testEvent.Flags, capturedArgs.Flags);
  92. }
  93. [Fact]
  94. public void Mouse_MouseEvent_CanUnsubscribe ()
  95. {
  96. // Arrange
  97. MouseImpl mouse = new ();
  98. var eventCount = 0;
  99. void Handler (object sender, MouseEventArgs args) => eventCount++;
  100. mouse.MouseEvent += Handler;
  101. MouseEventArgs testEvent = new ()
  102. {
  103. ScreenPosition = new Point (0, 0),
  104. Flags = MouseFlags.Button1Pressed
  105. };
  106. // Act - Fire once
  107. mouse.RaiseMouseEvent (testEvent);
  108. Assert.Equal (1, eventCount);
  109. // Unsubscribe
  110. mouse.MouseEvent -= Handler;
  111. // Fire again
  112. mouse.RaiseMouseEvent (testEvent);
  113. // Assert - Count should not increase
  114. Assert.Equal (1, eventCount);
  115. }
  116. [Fact]
  117. public void Mouse_RaiseMouseEvent_WithDisabledMouse_DoesNotFireEvent ()
  118. {
  119. // Arrange
  120. MouseImpl mouse = new ();
  121. var eventFired = false;
  122. mouse.MouseEvent += (sender, args) => { eventFired = true; };
  123. mouse.IsMouseDisabled = true;
  124. MouseEventArgs testEvent = new ()
  125. {
  126. ScreenPosition = new Point (0, 0),
  127. Flags = MouseFlags.Button1Pressed
  128. };
  129. // Act
  130. mouse.RaiseMouseEvent (testEvent);
  131. // Assert
  132. Assert.False (eventFired);
  133. }
  134. [Theory]
  135. [InlineData (MouseFlags.Button1Pressed)]
  136. [InlineData (MouseFlags.Button1Released)]
  137. [InlineData (MouseFlags.Button1Clicked)]
  138. [InlineData (MouseFlags.Button2Pressed)]
  139. [InlineData (MouseFlags.WheeledUp)]
  140. [InlineData (MouseFlags.ReportMousePosition)]
  141. public void Mouse_RaiseMouseEvent_CorrectlyPassesFlags (MouseFlags flags)
  142. {
  143. // Arrange
  144. MouseImpl mouse = new ();
  145. MouseFlags? capturedFlags = null;
  146. mouse.MouseEvent += (sender, args) => { capturedFlags = args.Flags; };
  147. MouseEventArgs testEvent = new ()
  148. {
  149. ScreenPosition = new Point (5, 5),
  150. Flags = flags
  151. };
  152. // Act
  153. mouse.RaiseMouseEvent (testEvent);
  154. // Assert
  155. Assert.NotNull (capturedFlags);
  156. Assert.Equal (flags, capturedFlags.Value);
  157. }
  158. #endregion
  159. #region IMouse ResetState
  160. [Fact]
  161. public void Mouse_ResetState_ClearsCachedViews ()
  162. {
  163. // Arrange
  164. MouseImpl mouse = new ();
  165. View testView = new () { Width = 10, Height = 10 };
  166. mouse.CachedViewsUnderMouse.Add (testView);
  167. Assert.Single (mouse.CachedViewsUnderMouse);
  168. // Act
  169. mouse.ResetState ();
  170. // Assert
  171. Assert.Empty (mouse.CachedViewsUnderMouse);
  172. testView.Dispose ();
  173. }
  174. [Fact]
  175. public void Mouse_ResetState_ClearsEventHandlers ()
  176. {
  177. // Arrange
  178. MouseImpl mouse = new ();
  179. var eventCount = 0;
  180. mouse.MouseEvent += (sender, args) => eventCount++;
  181. MouseEventArgs testEvent = new ()
  182. {
  183. ScreenPosition = new Point (0, 0),
  184. Flags = MouseFlags.Button1Pressed
  185. };
  186. // Verify event fires before reset
  187. mouse.RaiseMouseEvent (testEvent);
  188. Assert.Equal (1, eventCount);
  189. // Act
  190. mouse.ResetState ();
  191. // Raise event again
  192. mouse.RaiseMouseEvent (testEvent);
  193. // Assert - Event count should not increase after reset
  194. Assert.Equal (1, eventCount);
  195. }
  196. [Fact]
  197. public void Mouse_ResetState_DoesNotClearLastMousePosition ()
  198. {
  199. // Arrange
  200. MouseImpl mouse = new ();
  201. Point testPosition = new (42, 84);
  202. mouse.LastMousePosition = testPosition;
  203. // Act
  204. mouse.ResetState ();
  205. // Assert - LastMousePosition should NOT be cleared (per design)
  206. Assert.Equal (testPosition, mouse.LastMousePosition);
  207. }
  208. #endregion
  209. #region IMouse Isolation
  210. [Fact]
  211. public void Mouse_Instances_AreIndependent ()
  212. {
  213. // Arrange
  214. MouseImpl mouse1 = new ();
  215. MouseImpl mouse2 = new ();
  216. // Act
  217. mouse1.IsMouseDisabled = true;
  218. mouse1.LastMousePosition = new Point (10, 10);
  219. // Assert - mouse2 should be unaffected
  220. Assert.False (mouse2.IsMouseDisabled);
  221. Assert.Null (mouse2.LastMousePosition);
  222. }
  223. [Fact]
  224. public void Mouse_Events_AreIndependent ()
  225. {
  226. // Arrange
  227. MouseImpl mouse1 = new ();
  228. var mouse1EventCount = 0;
  229. MouseImpl mouse2 = new ();
  230. var mouse2EventCount = 0;
  231. mouse1.MouseEvent += (sender, args) => mouse1EventCount++;
  232. mouse2.MouseEvent += (sender, args) => mouse2EventCount++;
  233. MouseEventArgs testEvent = new ()
  234. {
  235. ScreenPosition = new Point (0, 0),
  236. Flags = MouseFlags.Button1Pressed
  237. };
  238. // Act
  239. mouse1.RaiseMouseEvent (testEvent);
  240. // Assert
  241. Assert.Equal (1, mouse1EventCount);
  242. Assert.Equal (0, mouse2EventCount);
  243. }
  244. [Fact]
  245. public void Mouse_CachedViews_AreIndependent ()
  246. {
  247. // Arrange
  248. MouseImpl mouse1 = new ();
  249. MouseImpl mouse2 = new ();
  250. View view1 = new ();
  251. View view2 = new ();
  252. // Act
  253. mouse1.CachedViewsUnderMouse.Add (view1);
  254. mouse2.CachedViewsUnderMouse.Add (view2);
  255. // Assert
  256. Assert.Single (mouse1.CachedViewsUnderMouse);
  257. Assert.Single (mouse2.CachedViewsUnderMouse);
  258. Assert.Contains (view1, mouse1.CachedViewsUnderMouse);
  259. Assert.Contains (view2, mouse2.CachedViewsUnderMouse);
  260. Assert.DoesNotContain (view2, mouse1.CachedViewsUnderMouse);
  261. Assert.DoesNotContain (view1, mouse2.CachedViewsUnderMouse);
  262. view1.Dispose ();
  263. view2.Dispose ();
  264. }
  265. #endregion
  266. #region Mouse Grab Tests
  267. [Fact]
  268. public void Mouse_GrabMouse_SetsMouseGrabView ()
  269. {
  270. // Arrange
  271. MouseImpl mouse = new ();
  272. View testView = new ();
  273. // Act
  274. mouse.GrabMouse (testView);
  275. // Assert
  276. Assert.Equal (testView, mouse.MouseGrabView);
  277. }
  278. [Fact]
  279. public void Mouse_UngrabMouse_ClearsMouseGrabView ()
  280. {
  281. // Arrange
  282. MouseImpl mouse = new ();
  283. View testView = new ();
  284. mouse.GrabMouse (testView);
  285. // Act
  286. mouse.UngrabMouse ();
  287. // Assert
  288. Assert.Null (mouse.MouseGrabView);
  289. }
  290. [Fact]
  291. public void Mouse_GrabbingMouse_CanBeCanceled ()
  292. {
  293. // Arrange
  294. MouseImpl mouse = new ();
  295. View testView = new ();
  296. var eventFired = false;
  297. mouse.GrabbingMouse += (sender, args) =>
  298. {
  299. eventFired = true;
  300. args.Cancel = true;
  301. };
  302. // Act
  303. mouse.GrabMouse (testView);
  304. // Assert
  305. Assert.True (eventFired);
  306. Assert.Null (mouse.MouseGrabView); // Should not be set because it was cancelled
  307. }
  308. [Fact]
  309. public void Mouse_GrabbedMouse_EventFired ()
  310. {
  311. // Arrange
  312. MouseImpl mouse = new ();
  313. View testView = new ();
  314. var eventFired = false;
  315. View? eventView = null;
  316. mouse.GrabbedMouse += (sender, args) =>
  317. {
  318. eventFired = true;
  319. eventView = args.View;
  320. };
  321. // Act
  322. mouse.GrabMouse (testView);
  323. // Assert
  324. Assert.True (eventFired);
  325. Assert.Equal (testView, eventView);
  326. }
  327. [Fact]
  328. public void Mouse_UnGrabbedMouse_EventFired ()
  329. {
  330. // Arrange
  331. MouseImpl mouse = new ();
  332. View testView = new ();
  333. mouse.GrabMouse (testView);
  334. var eventFired = false;
  335. View? eventView = null;
  336. mouse.UnGrabbedMouse += (sender, args) =>
  337. {
  338. eventFired = true;
  339. eventView = args.View;
  340. };
  341. // Act
  342. mouse.UngrabMouse ();
  343. // Assert
  344. Assert.True (eventFired);
  345. Assert.Equal (testView, eventView);
  346. }
  347. #endregion
  348. }