Fix: fully Checkstyle-compliant and optimized BalancedBrackets

Author: coder-Basundhara

src/main/java/com/thealgorithms/stacks/BalancedBrackets.java

@@ -4,18 +4,22 @@
 import java.util.Deque;
 
 /**
- * Optimized and robust Balanced Parenthesis (Valid Brackets) checker.
+ * BalancedBrackets.java
+ * Optimized valid parenthesis checker
  *
  * Supports: (), [], {}, <>
+ *
  * Rules:
  * - Returns true if brackets are properly nested and matched.
  * - Returns false for any non-bracket character.
  * - Empty string is balanced.
  * - Null input throws IllegalArgumentException.
- * @author Basundhara
- * @author <a href="https://github.com/coder-Basundhara">GitHub</a>
+ *
  * Time complexity: O(n)
  * Space complexity: O(n) in worst case (stack contains all opening brackets).
+ *
+ * @author Basundhara
+ * @author <a href="https://github.com/coder-Basundhara">GitHub</a>
  */
 public final class BalancedBrackets {
 
@@ -25,6 +29,10 @@ private BalancedBrackets() {
 
     /**
      * Returns true if {@code opening} and {@code closing} are matching bracket pair.
+     *
+     * @param opening opening bracket
+     * @param closing closing bracket
+     * @return true if matched
      */
     public static boolean isPaired(char opening, char closing) {
         return (opening == '(' && closing == ')')
@@ -36,6 +44,8 @@ public static boolean isPaired(char opening, char closing) {
     /**
      * Checks if the input string has balanced brackets.
      *
+     * @param input input string
+     * @return true if balanced
      * @throws IllegalArgumentException when input is null
      */
     public static boolean isBalanced(String input) {
@@ -47,7 +57,7 @@ public static boolean isBalanced(String input) {
             return true;
         }
 
-        // Odd-length strings cannot be fully balanced
+        // Odd-length strings cannot be balanced
         if ((input.length() & 1) == 1) {
             return false;
         }
@@ -62,7 +72,6 @@ public static boolean isBalanced(String input) {
                 case '<':
                     stack.push(c);
                     break;
-
                 case ')':
                 case ']':
                 case '}':
@@ -71,7 +80,6 @@ public static boolean isBalanced(String input) {
                         return false;
                     }
                     break;
-
                 default:
                     // Any non-bracket character makes string invalid
                     return false;
@@ -83,7 +91,7 @@ public static boolean isBalanced(String input) {
 
     /**
      * Optional main method for quick manual testing
-     
+     */
     public static void main(String[] args) {
         String[] tests = {
                 "()",
@@ -98,11 +106,10 @@ public static void main(String[] args) {
 
         for (String t : tests) {
             try {
-                System.out.println(t + " -> " + isBalanced(t));
-            } catch (IllegalArgumentException e) {
-                System.out.println(t + " -> Error: " + e.getMessage());
+                System.out.printf("%s -> %b%n", t, isBalanced(t));
+            } catch (Exception e) {
+                System.out.printf("%s -> Exception: %s%n", t, e.getMessage());
             }
         }
     }
- **/
 }