tree_haver 2.0.0 → 3.1.0

data/sig/tree_haver.rbs

@@ -1,6 +1,9 @@
 # Type definitions for TreeHaver
 #
-# TreeHaver is a cross-Ruby adapter for the tree-sitter parsing library
+# TreeHaver is a cross-Ruby adapter for code parsing with 10 backends:
+# - Tree-sitter: MRI, Rust, FFI, Java
+# - Native parsers: Prism (Ruby), Psych (YAML), Commonmarker (Markdown), Markly (GFM)
+# - Pure Ruby: Citrus
 
 module TreeHaver
   VERSION: String
@@ -134,6 +137,20 @@ module TreeHaver
     # Get the end point (row, column)
     def end_point: () -> Point
 
+    # Position API - consistent across all backends
+    # Get 1-based line number where node starts
+    def start_line: () -> Integer
+
+    # Get 1-based line number where node ends
+    def end_line: () -> Integer
+
+    # Get complete position information as hash
+    # Returns {start_line:, end_line:, start_column:, end_column:}
+    def source_position: () -> Hash[Symbol, Integer]
+
+    # Get first child node (convenience method)
+    def first_child: () -> Node?
+
     # Get the number of child nodes
     def child_count: () -> Integer
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tree_haver
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Peter H. Boling
@@ -241,10 +241,15 @@ files:
 - SECURITY.md
 - lib/tree_haver.rb
 - lib/tree_haver/backends/citrus.rb
+- lib/tree_haver/backends/commonmarker.rb
 - lib/tree_haver/backends/ffi.rb
 - lib/tree_haver/backends/java.rb
+- lib/tree_haver/backends/markly.rb
 - lib/tree_haver/backends/mri.rb
+- lib/tree_haver/backends/prism.rb
+- lib/tree_haver/backends/psych.rb
 - lib/tree_haver/backends/rust.rb
+- lib/tree_haver/citrus_grammar_finder.rb
 - lib/tree_haver/compat.rb
 - lib/tree_haver/grammar_finder.rb
 - lib/tree_haver/language_registry.rb
@@ -261,10 +266,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://tree-haver.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/tree_haver/tree/v2.0.0
-  changelog_uri: https://github.com/kettle-rb/tree_haver/blob/v2.0.0/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/tree_haver/tree/v3.1.0
+  changelog_uri: https://github.com/kettle-rb/tree_haver/blob/v3.1.0/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/tree_haver/issues
-  documentation_uri: https://www.rubydoc.info/gems/tree_haver/2.0.0
+  documentation_uri: https://www.rubydoc.info/gems/tree_haver/3.1.0
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/tree_haver/wiki
   news_uri: https://www.railsbling.com/tags/tree_haver