feat: add BracketMismatchError (todo)

Author: nedpals

error_templates/java/bracket_mismatch_error.go

@@ -0,0 +1,45 @@
+package java
+
+import (
+	"fmt"
+	"strconv"
+	"strings"
+
+	lib "github.com/nedpals/errgoengine"
+)
+
+var BracketMismatchError = lib.ErrorTemplate{
+	Name:    "ArrayIndexOutOfBoundsException",
+	Pattern: comptimeErrorPattern(`'(?P<expected>\S+)' expected`),
+	OnAnalyzeErrorFn: func(cd *lib.ContextData, m *lib.MainError) {
+		lib.QueryNode(m.Nearest, strings.NewReader("(array_access index: (_) @index)"), func(ctx lib.QueryNodeCtx) bool {
+			match := ctx.Cursor.FilterPredicates(ctx.Match, []byte(m.Nearest.Doc.Contents))
+			for _, c := range match.Captures {
+				node := lib.WrapNode(m.Nearest.Doc, c.Node)
+				m.Nearest = node
+				return false
+			}
+			return true
+		})
+	},
+	OnGenExplainFn: func(cd *lib.ContextData, gen *lib.ExplainGenerator) {
+		gen.Add("This error occurs because the code is trying to access index %s that is beyond the bounds of the array which only has %s items.", cd.Variables["index"], cd.Variables["length"])
+	},
+	OnGenBugFixFn: func(cd *lib.ContextData, gen *lib.BugFixGenerator) {
+		arrayLen, _ := strconv.Atoi(cd.Variables["length"])
+
+		// TODO: add a suggestion to add an if statement if the array length is 0
+
+		gen.Add("Accessing Array Index Within Bounds", func(s *lib.BugFixSuggestion) {
+			sampleIndex := max(0, arrayLen-2)
+
+			s.AddStep("The error is caused by trying to access an index that does not exist within the array. Instead of accessing index %s, which is beyond the array's length, change it to a valid index within the array bounds, for example, `nums[%d]`.", cd.Variables["index"], sampleIndex).
+				AddFix(lib.FixSuggestion{
+					NewText:       fmt.Sprintf("%d", sampleIndex),
+					StartPosition: cd.MainError.Nearest.StartPosition(),
+					EndPosition:   cd.MainError.Nearest.EndPosition(),
+					Description:   "This adjustment ensures that you're accessing an index that exists within the array bounds, preventing the `ArrayIndexOutOfBoundsException`.",
+				})
+		})
+	},
+}

error_templates/java/test_files/bracket_mismatch_error/test.txt

@@ -7,4 +7,19 @@ BracketMismatch.java:7: error: '}' expected
 ===
 template: "Java.BracketMismatchError"
 ---
-aaa
+# BracketMismatchError
+This error occurs because there is a missing closing bracket for the if statement.
+
+## Steps to fix
+### Add Missing Bracket
+Add a closing bracket '}' after the `System.out.println` statement.
+```diff
+            System.out.println("x is greater than 5.");
++       }
+```
+
+### Remove Excessive Bracket
+If you accidentally added an extra closing bracket '}' at the end, remove it.
+```diff
+        }  // Remove this line if it's an extra bracket
+```

error_templates/java/test_files/not_a_statement_error/test.txt

@@ -0,0 +1,10 @@
+// BracketMismatch.java
+public class BracketMismatch {
+    public static void main(String[] args) {
+        int x = 10;
+        if (x > 5) {
+            System.out.println("x is greater than 5.");
+          // Missing closing bracket for if statement
+    }
+}
+