Implement escape scan row

app/src/main/java/com/enaboapps/switchify/service/scanning/ScanTree.kt

@@ -24,6 +24,11 @@ class ScanTree(private val context: Context) : ScanStateInterface {
      */
     private var isInRow = false
 
+    /**
+     * This property indicates whether the current row should be escaped
+     */
+    private var shouldEscapeRow = false
+
     /**
      * This property indicates the scanning direction
      * Rows can scan up or down
@@ -95,6 +100,9 @@ class ScanTree(private val context: Context) : ScanStateInterface {
      */
     private fun moveSelectionToNextNode() {
         unhighlightCurrentNode()
+        if (shouldEscapeCurrentRow()) {
+            return
+        }
         if (currentColumn < tree[currentRow].size - 1) {
             currentColumn++
         } else {
@@ -108,6 +116,9 @@ class ScanTree(private val context: Context) : ScanStateInterface {
      */
     private fun moveSelectionToPreviousNode() {
         unhighlightCurrentNode()
+        if (shouldEscapeCurrentRow()) {
+            return
+        }
         if (currentColumn > 0) {
             currentColumn--
         } else {
@@ -116,6 +127,22 @@ class ScanTree(private val context: Context) : ScanStateInterface {
         highlightCurrentNode()
     }
 
+    /**
+     * This function checks if escaping the current row is necessary
+     * @return True if escaping the current row is necessary, false otherwise
+     */
+    private fun shouldEscapeCurrentRow(): Boolean {
+        // If at the last node, activate the escape row
+        if (currentColumn == tree[currentRow].size - 1 && !shouldEscapeRow) {
+            shouldEscapeRow = true
+            highlightCurrentRow()
+        } else if (shouldEscapeRow) {
+            shouldEscapeRow = false
+            unhighlightCurrentRow()
+        }
+        return shouldEscapeRow
+    }
+
     /**
      * This function moves the selection to the next row
      */
@@ -239,6 +266,8 @@ class ScanTree(private val context: Context) : ScanStateInterface {
 
     /**
      * This function performs the selection
+     * It starts scanning if it is not already scanning
+     * It escapes the row if the row should be escaped
      * If the scanning tree is in a row, it selects the current node
      * If the scanning tree is not in a row, it selects the current row
      */
@@ -249,6 +278,12 @@ class ScanTree(private val context: Context) : ScanStateInterface {
                 println("Scanning started")
                 return
             }
+            if (shouldEscapeRow) {
+                shouldEscapeRow = false
+                unhighlightCurrentRow()
+                reset()
+                return
+            }
             if (isInRow) {
                 selectCurrentColumn()
                 stopScanning()