Merge pull request #26 from UiPath/feature/testing_cursor

Feature / Expose testing cursor utility

Author: vladjerca

CHANGELOG.md

@@ -0,0 +1,37 @@
+# v0.9.2 (2019-06-01)
+
+### Features:
+
+* **EventGenerator** expose the `cursor` utility that injects a cursor image, to help visualize UTs.
+
+# v0.9.1 (2019-06-01)
+
+### First Official Release
+
+#### Components
+
+* [grid](https://uipath.github.io/angular-components/modules/UiGridModule.html)
+* [suggest](https://uipath.github.io/angular-components/modules/UiSuggestModule.html)
+
+#### Directives
+
+* [autofocus](https://uipath.github.io/angular-components/modules/UiAutofocusModule.html)
+* [click-outside](https://uipath.github.io/angular-components/modules/UiClickOutsideModule.html)
+* [clipboard](https://uipath.github.io/angular-components/modules/UiClipboardModule.html)
+* [date-format](https://uipath.github.io/angular-components/modules/UiDateFormatModule.html)
+* [second-format](https://uipath.github.io/angular-components/modules/UiSecondFormatModule.html)
+* [drag-and-drop](https://uipath.github.io/angular-components/modules/UiDragAndDropModule.html)
+* [ng-let](https://uipath.github.io/angular-components/modules/UiNgLetModule.html)
+* [scroll-into-view](https://uipath.github.io/angular-components/modules/UiScrollIntoViewModule.html)
+* [virtual-scroll-range-loader](https://uipath.github.io/angular-components/modules/UiVirtualScrollRangeLoaderModule.html)
+* [virtual-scroll-viewport-resize](https://uipath.github.io/angular-components/modules/UiVirtualScrollViewportResizeModule.html)
+
+#### a11y
+
+* [queued-announcer](https://uipath.github.io/angular-components/injectables/QueuedAnnouncer.html)
+
+#### Testing
+
+* [EventGenerator](https://uipath.github.io/angular-components/classes/EventGenerator.html)
+* [Key](https://uipath.github.io/angular-components/classes/Key.html)
+* [FakeFileList](https://uipath.github.io/angular-components/classes/FakeFileList.html)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-components",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "author": {
     "name": "UiPath Inc",
     "url": "https://github.com/UiPath/angular-components"

projects/angular/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/angular",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "license": "MIT",
   "author": {
     "name": "UiPath Inc",

projects/angular/testing/src/utilities/event-generator.ts

@@ -17,30 +17,36 @@ type KeyOrKeyName = (IKey | keyof Key);
  * @dynamic
  */
 export class EventGenerator {
-    private static _cursor = {
+    /**
+     * A cursor utility that draws a cursor icon over the tested component.
+     *
+     * Very useful when testing hover effects.
+     *
+     */
+    public static cursor = {
         ref: {} as HTMLElement,
         initialize: (parent?: HTMLElement) => {
             if (!parent) { return; }
-            EventGenerator._cursor.ref = document.createElement('div') as HTMLElement;
+            EventGenerator.cursor.ref = document.createElement('div') as HTMLElement;
 
-            EventGenerator._cursor.ref.style.position = 'absolute';
-            EventGenerator._cursor.ref.style.display = 'block';
-            EventGenerator._cursor.ref.style.left = '0px';
-            EventGenerator._cursor.ref.style.top = '0px';
-            EventGenerator._cursor.ref.style.width = '20px';
-            EventGenerator._cursor.ref.style.height = '20px';
-            EventGenerator._cursor.ref.style.background = CURSOR_IMG;
+            EventGenerator.cursor.ref.style.position = 'absolute';
+            EventGenerator.cursor.ref.style.display = 'block';
+            EventGenerator.cursor.ref.style.left = '0px';
+            EventGenerator.cursor.ref.style.top = '0px';
+            EventGenerator.cursor.ref.style.width = '20px';
+            EventGenerator.cursor.ref.style.height = '20px';
+            EventGenerator.cursor.ref.style.background = CURSOR_IMG;
 
-            parent.appendChild(EventGenerator._cursor.ref);
+            parent.appendChild(EventGenerator.cursor.ref);
         },
         destroy: (parent?: HTMLElement) => {
             if (!parent) { return; }
 
-            parent.removeChild(EventGenerator._cursor.ref);
+            parent.removeChild(EventGenerator.cursor.ref);
         },
         update: (x: number, y: number) => {
-            EventGenerator._cursor.ref.style.left = `${x - 10}px`;
-            EventGenerator._cursor.ref.style.top = `${y - 10}px`;
+            EventGenerator.cursor.ref.style.left = `${x - 10}px`;
+            EventGenerator.cursor.ref.style.top = `${y - 10}px`;
         },
     };
 
@@ -208,7 +214,7 @@ export class EventGenerator {
             value: offsetY,
         });
 
-        this._cursor.update(offsetX, offsetY);
+        this.cursor.update(offsetX, offsetY);
         return event;
     }
 
@@ -231,7 +237,7 @@ export class EventGenerator {
             value: offsetY,
         });
 
-        this._cursor.update(offsetX, offsetY);
+        this.cursor.update(offsetX, offsetY);
         return event;
     }