Issue #128 Address all PR review comments

Fixes:
1. Remove unused evaluateRecursiveDescentFull() method from JsonPathHelpers
2. Remove unused collectAtPath() method from JsonPathHelpers
3. Fix README example: use 'compiled'/'interpreted' instead of undefined 'path'
4. Clarify in README that only limited script expressions are supported
5. Throw UnsupportedOperationException for unsupported script expressions
   instead of silently ignoring them

All 140 tests pass.

Co-authored-by: simbo1905 <simbo1905@60hertz.com>

Author: cursoragent

json-java21-jsonpath/README.md

@@ -99,8 +99,8 @@ JsonPath compiled = JsonPath.compile(interpreted);
 JsonPath sameCompiled = JsonPath.compile(compiled); // Returns same instance
 
 // Check if a path is compiled
-boolean isCompiled = path.isCompiled();
-boolean isInterpreted = path.isInterpreted();
+boolean isCompiled = compiled.isCompiled();
+boolean isInterpreted = interpreted.isInterpreted();
 ```
 
 ### Supported Features in Compiled Mode
@@ -109,7 +109,7 @@ All JsonPath features are supported in compiled mode:
 - Property access, array indices, slices, wildcards
 - Recursive descent (`$..property`)
 - Filters with comparisons and logical operators
-- Unions and script expressions
+- Unions and limited script expressions (e.g., `[(@.length-1)]`)
 
 ## Stream-Based Functions (Aggregations)
 

json-java21-jsonpath/src/main/java/json/java21/jsonpath/JsonPathCompiler.java

@@ -469,11 +469,10 @@ private static void generateScriptExpression(
             sb.append("            }\n");
             sb.append("        }\n");
         } else {
-            // Unsupported script - log warning and skip
+            // Unsupported script - throw exception at runtime for clarity
             // Only @.length-1 is supported in compiled mode
-            sb.append("        // WARNING: Unsupported script expression '%s' - skipped in compiled mode\n"
+            sb.append("        throw new UnsupportedOperationException(\"Unsupported script expression in compiled mode: '%s'. Consider using slice notation instead (e.g., [-1:] for last element).\");\n"
                     .formatted(escapeJavaString(script.script())));
-            sb.append("        // Consider using slice notation instead: [-1:] for last element\n");
         }
     }
 

json-java21-jsonpath/src/main/java/json/java21/jsonpath/JsonPathHelpers.java

@@ -151,30 +151,6 @@ public static void evaluateRecursiveDescent(String propertyName, JsonValue curre
         }
     }
 
-    /// Evaluates recursive descent and then applies subsequent segments.
-    /// This is a more general version that delegates back to the interpreter for complex cases.
-    /// @param path the original JsonPath being evaluated
-    /// @param segmentIndex the index of the recursive descent segment
-    /// @param current the current value
-    /// @param root the root document
-    /// @param results the results list
-    public static void evaluateRecursiveDescentFull(
-            JsonPath path,
-            int segmentIndex,
-            JsonValue current,
-            JsonValue root,
-            List<JsonValue> results) {
-
-        // For full recursive descent support, we delegate to the interpreter
-        // This handles the case where there are segments after the recursive descent
-        if (path instanceof JsonPathInterpreted interpreted) {
-            final var ast = interpreted.ast();
-            JsonPathInterpreted.evaluateSegments(ast.segments(), segmentIndex, current, root, results);
-        } else if (path.ast() != null) {
-            JsonPathInterpreted.evaluateSegments(path.ast().segments(), segmentIndex, current, root, results);
-        }
-    }
-
     /// Collects all arrays recursively from a JSON value.
     /// Used for recursive descent with array index targets like $..book[2].
     /// @param current the current JSON value to search
@@ -196,24 +172,4 @@ public static void collectArrays(JsonValue current, List<JsonValue> arrays) {
         }
     }
 
-    /// Collects values at a specific property path recursively.
-    /// Used for recursive descent patterns like $..book.
-    /// @param propertyName the property name to search for
-    /// @param current the current JSON value to search
-    /// @param results the list to collect results into
-    public static void collectAtPath(String propertyName, JsonValue current, List<JsonValue> results) {
-        if (current instanceof JsonObject obj) {
-            final var value = obj.members().get(propertyName);
-            if (value != null) {
-                results.add(value);
-            }
-            for (final var child : obj.members().values()) {
-                collectAtPath(propertyName, child, results);
-            }
-        } else if (current instanceof JsonArray array) {
-            for (final var element : array.elements()) {
-                collectAtPath(propertyName, element, results);
-            }
-        }
-    }
 }