tree_haver 5.0.5 → 7.1.0

data/sig/tree_haver.rbs

@@ -1,234 +1,6 @@
-# Type definitions for TreeHaver
-#
-# 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
-
-  # Base error class
-  class Error < StandardError
-  end
-
-  # Raised when a backend or feature is not available
-  class NotAvailable < Error
-  end
-
-  # Module namespace for backend implementations
-  module Backends
-  end
-
-  # Get the current backend selection
-  def self.backend: () -> Symbol
-
-  # Set the backend to use
-  def self.backend=: (Symbol | String | nil name) -> (Symbol | nil)
-
-  # Reset backend selection memoization
-  def self.reset_backend!: (?to: Symbol | String | nil) -> void
-
-  # Determine the concrete backend module to use
-  def self.backend_module: () -> Module?
-
-  # Get capabilities of the current backend
-  def self.capabilities: () -> Hash[Symbol, untyped]
-
-  # Register a language helper by name
-  def self.register_language: (Symbol | String name, path: String, ?symbol: String?) -> void
-
-  # Unregister a previously registered language helper
-  def self.unregister_language: (Symbol | String name) -> void
-
-  # Clear all registered languages
-  def self.clear_languages!: () -> void
-
-  # Fetch a registered language entry
-  def self.registered_language: (Symbol | String name) -> Hash[Symbol, String?]?
-
-  # Represents a tree-sitter language grammar
-  class Language
-    # Load a language grammar from a shared library
-    def self.from_library: (String path, ?symbol: String?, ?name: String?) -> Language
-
-    # Alias for from_library
-    def self.from_path: (String path, ?symbol: String?, ?name: String?) -> Language
-
-    def self.method_missing: (Symbol method_name, *untyped args, **untyped kwargs) ?{ () -> untyped } -> Language
-
-    def self.respond_to_missing?: (Symbol method_name, ?bool include_private) -> bool
-  end
-
-  # Represents a tree-sitter parser instance
-  class Parser
-    # Create a new parser instance
-    def initialize: () -> void
-
-    # Set the language grammar for this parser
-    def language=: (Language lang) -> Language
-
-    # Parse source code into a syntax tree
-    def parse: (String source) -> Tree
-
-    # Parse with optional incremental parsing support
-    def parse_string: (Tree? old_tree, String source) -> Tree
-
-    private
-
-    @impl: untyped
-  end
-
-  # Represents a parsed syntax tree
-  class Tree
-    attr_reader inner_tree: untyped
-    attr_reader source: String?
-
-    # Get the root node of the syntax tree
-    def root_node: () -> Node?
-
-    # Edit the tree for incremental parsing
-    def edit: (
-      start_byte: Integer,
-      old_end_byte: Integer,
-      new_end_byte: Integer,
-      start_point: Hash[Symbol, Integer],
-      old_end_point: Hash[Symbol, Integer],
-      new_end_point: Hash[Symbol, Integer]
-    ) -> void
-
-    # Check if the current backend supports incremental parsing
-    def supports_editing?: () -> bool
-
-    # String representation
-    def inspect: () -> String
-
-    # Check if tree responds to a method (includes delegation to inner_tree)
-    def respond_to_missing?: (Symbol method_name, ?bool include_private) -> bool
-
-    # Delegate unknown methods to the underlying backend-specific tree
-    def method_missing: (Symbol method_name, *untyped args, **untyped kwargs) ?{ () -> untyped } -> untyped
-
-    private
-
-    def initialize: (untyped inner_tree, ?source: String?) -> void
-  end
-
-  # Represents a node in the syntax tree
-  class Node
-    attr_reader inner_node: untyped
-    attr_reader source: String?
-
-    # Get the type name of this node
-    def type: () -> String
-
-    # Get the text content of this node
-    def text: () -> String?
-
-    # Get the start byte offset
-    def start_byte: () -> Integer
-
-    # Get the end byte offset
-    def end_byte: () -> Integer
-
-    # Get the start point (row, column)
-    def start_point: () -> Point
-
-    # 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
-
-    # Get a child node by index
-    def child: (Integer index) -> Node?
-
-    # Get all children as an array
-    def children: () -> Array[Node]
-
-    # Iterate over child nodes
-    def each: () { (Node child) -> void } -> nil
-            | () -> Enumerator[Node, nil]
-
-    # Get a named child by field name
-    def child_by_field_name: (String | Symbol field_name) -> Node?
-
-    # Get the parent node
-    def parent: () -> Node?
-
-    # Get the next sibling node
-    def next_sibling: () -> Node?
-
-    # Get the previous sibling node
-    def prev_sibling: () -> Node?
-
-    # Check if node responds to a method (includes delegation to inner_node)
-    def respond_to_missing?: (Symbol method_name, ?bool include_private) -> bool
-
-    # Delegate unknown methods to the underlying backend-specific node
-    def method_missing: (Symbol method_name, *untyped args, **untyped kwargs) ?{ () -> untyped } -> untyped
-
-    private
-
-    def initialize: (untyped inner_node, ?source: String?) -> void
-  end
-
-  # Position in source code that works as both object and hash
-  class Point
-    attr_reader row: Integer
-    attr_reader column: Integer
-
-    def initialize: (row: Integer, column: Integer) -> void
-
-    # Hash-style access
-    def []: (Symbol key) -> Integer?
-
-    # Convert to hash
-    def to_h: () -> Hash[Symbol, Integer]
-
-    # String representation
-    def inspect: () -> String
-  end
-
-  # Thread-safe language registrations and cache
-  module LanguageRegistry
-    # Register a language helper by name
-    def self.register: (Symbol | String name, path: String, ?symbol: String?) -> void
-
-    # Unregister a previously registered language helper
-    def self.unregister: (Symbol | String name) -> void
-
-    # Fetch a registration entry
-    def self.registered: (Symbol | String name) -> Hash[Symbol, String?]?
-
-    # Clear all registrations
-    def self.clear_registrations!: () -> void
-
-    # Fetch a cached language by key or compute and store it
-    def self.fetch: [T] (Array[untyped] key) { () -> T } -> T
-
-    # Clear the language cache
-    def self.clear_cache!: () -> void
-
-    # Clear everything (registrations and cache)
-    def self.clear_all!: () -> void
-  end
-
   module Version
     VERSION: String
   end
+  VERSION: String
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tree_haver
 version: !ruby/object:Gem::Version
-  version: 5.0.5
+  version: 7.1.0
 platform: ruby
 authors:
 - Peter H. Boling
@@ -37,6 +37,54 @@ cert_chain:
   -----END CERTIFICATE-----
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: citrus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: parslet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: tree_sitter_language_pack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.13.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.13.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: version_gem
   requirement: !ruby/object:Gem::Requirement
@@ -46,7 +94,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.9
+        version: 1.1.15
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -56,21 +104,27 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.9
+        version: 1.1.15
 - !ruby/object:Gem::Dependency
   name: kettle-dev
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '2.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.5.17
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '2.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.5.17
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -120,65 +174,85 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 1.0.4
 - !ruby/object:Gem::Dependency
-  name: appraisal2
+  name: anonymous_loader
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.6
+        version: 0.1.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.6
+        version: 0.1.3
 - !ruby/object:Gem::Dependency
-  name: kettle-soup-cover
+  name: appraisal2
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.1
+        version: 3.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.1
+        version: 3.2.0
 - !ruby/object:Gem::Dependency
   name: kettle-test
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.10
+        version: 2.0.19
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.19
+- !ruby/object:Gem::Dependency
+  name: turbo_tests2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.10
+        version: 3.2.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.4
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -202,7 +276,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 1.0.8
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -212,60 +286,68 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 1.0.8
 - !ruby/object:Gem::Dependency
   name: gitmoji-regex
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 2.0.11
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
-description: "\U0001F334 TreeHaver is a cross-Ruby adapter for many AST parsing libraries;
-  supporting MRI Ruby, JRuby, & TruffleRuby. Provides unified parsing API & AST when
-  using ruby_tree_sitter, parslet, citrus, ffi, tree_stump (Rust), JRuby JARs, etc.
-  As Faraday is to HTTP clients, this is for ASTs: 'Learn once & write once & run
-  anywhere'"
+        version: 2.0.11
+- !ruby/object:Gem::Dependency
+  name: toml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: toml-rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+description: "\U0001F334 Backend registry, parser request/result contracts, and tree-sitter
+  language-pack integration for Structured Merge."
 email:
 - floss@galtzo.com
 executables: []
 extensions: []
-extra_rdoc_files:
-- CHANGELOG.md
-- CITATION.cff
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
-- FUNDING.md
-- LICENSE.txt
-- README.md
-- REEK
-- RUBOCOP.md
-- SECURITY.md
+extra_rdoc_files: []
 files:
-- CHANGELOG.md
-- CITATION.cff
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
-- FUNDING.md
-- LICENSE.txt
+- LICENSE.md
 - README.md
-- REEK
-- RUBOCOP.md
-- SECURITY.md
 - lib/tree_haver.rb
 - lib/tree_haver/backend_api.rb
+- lib/tree_haver/backend_context.rb
 - lib/tree_haver/backend_registry.rb
 - lib/tree_haver/backends/citrus.rb
 - lib/tree_haver/backends/ffi.rb
@@ -275,50 +357,52 @@ files:
 - lib/tree_haver/backends/prism.rb
 - lib/tree_haver/backends/psych.rb
 - lib/tree_haver/backends/rust.rb
-- lib/tree_haver/base.rb
+- lib/tree_haver/backends/tslp.rb
+- lib/tree_haver/base/comment.rb
 - lib/tree_haver/base/language.rb
 - lib/tree_haver/base/node.rb
 - lib/tree_haver/base/parser.rb
 - lib/tree_haver/base/point.rb
 - lib/tree_haver/base/tree.rb
 - lib/tree_haver/citrus_grammar_finder.rb
-- lib/tree_haver/compat.rb
+- lib/tree_haver/contracts.rb
 - lib/tree_haver/grammar_finder.rb
+- lib/tree_haver/kaitai_backend.rb
 - lib/tree_haver/language.rb
+- lib/tree_haver/language_pack.rb
 - lib/tree_haver/language_registry.rb
 - lib/tree_haver/library_path_utils.rb
 - lib/tree_haver/node.rb
 - lib/tree_haver/parser.rb
 - lib/tree_haver/parslet_grammar_finder.rb
 - lib/tree_haver/path_validator.rb
+- lib/tree_haver/peg_backends.rb
 - lib/tree_haver/point.rb
 - lib/tree_haver/rspec.rb
 - lib/tree_haver/rspec/dependency_tags.rb
-- lib/tree_haver/rspec/testable_node.rb
 - lib/tree_haver/tree.rb
 - lib/tree_haver/version.rb
 - sig/tree_haver.rbs
-- sig/tree_haver/backends.rbs
-- sig/tree_haver/grammar_finder.rbs
-- sig/tree_haver/path_validator.rbs
-homepage: https://github.com/kettle-rb/tree_haver
+homepage: https://github.com/structuredmerge/structuredmerge-ruby
 licenses:
-- MIT
+- AGPL-3.0-only
+- PolyForm-Small-Business-1.0.0
 metadata:
-  homepage_uri: https://tree-haver.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/tree_haver/tree/v5.0.5
-  changelog_uri: https://github.com/kettle-rb/tree_haver/blob/v5.0.5/CHANGELOG.md
-  bug_tracker_uri: https://github.com/kettle-rb/tree_haver/issues
-  documentation_uri: https://www.rubydoc.info/gems/tree_haver/5.0.5
+  homepage_uri: https://structuredmerge.org
+  source_code_uri: https://github.com/structuredmerge/structuredmerge-ruby/tree/v7.1.0
+  changelog_uri: https://github.com/structuredmerge/structuredmerge-ruby/blob/v7.1.0/CHANGELOG.md
+  bug_tracker_uri: https://github.com/structuredmerge/structuredmerge-ruby/issues
+  documentation_uri: https://www.rubydoc.info/gems/tree_haver/7.1.0
   funding_uri: https://github.com/sponsors/pboling
-  wiki_uri: https://github.com/kettle-rb/tree_haver/wiki
+  wiki_uri: https://github.com/structuredmerge/structuredmerge-ruby/wiki
   news_uri: https://www.railsbling.com/tags/tree_haver
   discord_uri: https://discord.gg/3qme4XHNKN
+  mailing_list_uri: https://www.rubyforum.org/tag/tree_haver
   rubygems_mfa_required: 'true'
 rdoc_options:
 - "--title"
-- "tree_haver - \U0001F334 Cross-Ruby adapter for AST parsing libraries, like tree-sitter,
-  citrus, & parslet; works on MRI, JRuby, and TruffleRuby"
+- "tree_haver - \U0001F334 Structured Merge parser abstraction and process analysis
+  for Ruby"
 - "--main"
 - README.md
 - "--exclude"
@@ -332,15 +416,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 4.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.5
+rubygems_version: 4.0.17
 specification_version: 4
-summary: "\U0001F334 Cross-Ruby adapter for AST parsing libraries, like tree-sitter,
-  citrus, & parslet; works on MRI, JRuby, and TruffleRuby"
+summary: "\U0001F334 Structured Merge parser abstraction and process analysis for
+  Ruby"
 test_files: []