feat(query): implement [gs]etTimeoutMicros

Author: ObserverOfTime

scripts/jextract.ps1

@@ -108,6 +108,8 @@ $env:package = 'io.github.treesitter.jtreesitter.internal'
     --include-function ts_query_cursor_set_match_limit `
     --include-function ts_query_cursor_set_max_start_depth `
     --include-function ts_query_cursor_set_point_range `
+    --include-function ts_query_cursor_set_timeout_micros `
+    --include-function ts_query_cursor_timeout_micros `
     --include-function ts_query_delete `
     --include-function ts_query_disable_capture `
     --include-function ts_query_disable_pattern `

scripts/jextract.sh

@@ -108,6 +108,8 @@ jextract \
     --include-function ts_query_cursor_set_match_limit \
     --include-function ts_query_cursor_set_max_start_depth \
     --include-function ts_query_cursor_set_point_range \
+    --include-function ts_query_cursor_set_timeout_micros \
+    --include-function ts_query_cursor_timeout_micros \
     --include-function ts_query_delete \
     --include-function ts_query_disable_capture \
     --include-function ts_query_disable_pattern \

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

@@ -294,6 +294,25 @@ public Query setMatchLimit(@Unsigned int matchLimit) throws IllegalArgumentExcep
         return this;
     }
 
+    /**
+     * Get the maximum duration in microseconds that query
+     * execution should be allowed to take before halting.
+     *
+     * @apiNote Defaults to {@code 0} (unlimited).
+     */
+    public @Unsigned long getTimeoutMicros() {
+        return ts_query_cursor_timeout_micros(cursor);
+    }
+
+    /**
+     * Set the maximum duration in microseconds that query
+     * execution should be allowed to take before halting.
+     */
+    public Query setTimeoutMicros(@Unsigned long timeoutMicros) {
+        ts_query_cursor_set_timeout_micros(cursor, timeoutMicros);
+        return this;
+    }
+
     /**
      * Set the maximum start depth for the query.
      *

src/test/java/io/github/treesitter/jtreesitter/QueryTest.java

@@ -101,6 +101,19 @@ void setMatchLimit() {
         });
     }
 
+    @Test
+    void getTimeoutMicros() {
+        assertQuery(query -> assertEquals(0, query.getTimeoutMicros()));
+    }
+
+    @Test
+    void setTimeoutMicros() {
+        assertQuery(query -> {
+            assertSame(query, query.setTimeoutMicros(10));
+            assertEquals(10, query.getTimeoutMicros());
+        });
+    }
+
     @Test
     void setMaxStartDepth() {
         assertQuery(query -> assertSame(query, query.setMaxStartDepth(10)));