feat(query): allow custom allocators in findMatches

Author: Emmeral

src/main/java/io/github/treesitter/jtreesitter/Query.java

@@ -5,6 +5,7 @@
 import io.github.treesitter.jtreesitter.internal.*;
 import java.lang.foreign.Arena;
 import java.lang.foreign.MemorySegment;
+import java.lang.foreign.SegmentAllocator;
 import java.util.*;
 import java.util.function.BiPredicate;
 import java.util.function.Consumer;
@@ -480,10 +481,21 @@ public Map<String, Optional<String>> getPatternAssertions(@Unsigned int index, b
     /**
      * Iterate over all the matches in the order that they were found.
      *
+     * @implNote The lifetime of the matches is bound to that of the query.
+     *
      * @param node The node that the query will run on.
      */
     public Stream<QueryMatch> findMatches(Node node) {
-        return findMatches(node, null);
+        return findMatches(node, arena, null);
+    }
+
+    /**
+     * Iterate over all the matches in the order that they were found, using the given allocator.
+     *
+     * @since 0.25.0
+     */
+    public Stream<QueryMatch> findMatches(Node node, SegmentAllocator allocator) {
+        return findMatches(node, allocator, null);
     }
 
     /**
@@ -500,14 +512,26 @@ public Stream<QueryMatch> findMatches(Node node) {
      *  });
      * }
      *
+     * @implNote The lifetime of the matches is bound to that of the query.
+     *
      * @param node The node that the query will run on.
      * @param predicate A function that handles custom predicates.
      */
     public Stream<QueryMatch> findMatches(Node node, @Nullable BiPredicate<QueryPredicate, QueryMatch> predicate) {
+        return findMatches(node, arena, predicate);
+    }
+
+    /**
+     * Iterate over all the matches in the order that they were found.
+     *
+     * @see #findMatches(Node, BiPredicate)
+     */
+    public Stream<QueryMatch> findMatches(
+            Node node, SegmentAllocator allocator, @Nullable BiPredicate<QueryPredicate, QueryMatch> predicate) {
         try (var alloc = Arena.ofConfined()) {
             ts_query_cursor_exec(cursor, query, node.copy(alloc));
         }
-        return StreamSupport.stream(new MatchesIterator(node.getTree(), predicate), false);
+        return StreamSupport.stream(new MatchesIterator(node.getTree(), allocator, predicate), false);
     }
 
     @Override
@@ -537,11 +561,14 @@ private void checkIndex(@Unsigned int index) throws IndexOutOfBoundsException {
     private final class MatchesIterator extends Spliterators.AbstractSpliterator<QueryMatch> {
         private final @Nullable BiPredicate<QueryPredicate, QueryMatch> predicate;
         private final Tree tree;
+        private final SegmentAllocator allocator;
 
-        public MatchesIterator(Tree tree, @Nullable BiPredicate<QueryPredicate, QueryMatch> predicate) {
+        public MatchesIterator(
+                Tree tree, SegmentAllocator allocator, @Nullable BiPredicate<QueryPredicate, QueryMatch> predicate) {
             super(Long.MAX_VALUE, Spliterator.IMMUTABLE | Spliterator.NONNULL);
             this.predicate = predicate;
             this.tree = tree;
+            this.allocator = allocator;
         }
 
         @Override
@@ -555,7 +582,7 @@ public boolean tryAdvance(Consumer<? super QueryMatch> action) {
                 for (int i = 0; i < count; ++i) {
                     var capture = TSQueryCapture.asSlice(matchCaptures, i);
                     var name = captureNames.get(TSQueryCapture.index(capture));
-                    var node = TSNode.allocate(arena).copyFrom(TSQueryCapture.node(capture));
+                    var node = TSNode.allocate(allocator).copyFrom(TSQueryCapture.node(capture));
                     captureList.add(new QueryCapture(name, new Node(node, tree)));
                 }
                 var patternIndex = TSQueryMatch.pattern_index(match);