solargraph 0.57.0 → 0.58.1

data/rbs_collection.yaml

@@ -1,15 +1,15 @@
 # Download sources
 sources:
+  - type: local
+    name: shims
+    path: sig/shims
+
   - type: git
     name: ruby/gem_rbs_collection
     remote: https://github.com/ruby/gem_rbs_collection.git
     revision: main
     repo_dir: gems
 
-# You can specify local directories as sources also.
-# - type: local
-#   path: path/to/your/local/repository
-
 # A directory to install the downloaded RBSs
 path: .gem_rbs_collection
 

data/sig/shims/ast/0/node.rbs

@@ -0,0 +1,5 @@
+module ::AST
+  class Node
+     def children: () -> [self, Integer, String, Symbol, nil]
+  end
+end

data/sig/shims/ast/2.4/.rbs_meta.yaml

@@ -0,0 +1,9 @@
+---
+name: ast
+version: '2.4'
+source:
+  type: git
+  name: ruby/gem_rbs_collection
+  revision: c604d278dd6c14a1bb6cf0c0051af643b268a981
+  remote: https://github.com/ruby/gem_rbs_collection.git
+  repo_dir: gems

data/sig/shims/ast/2.4/ast.rbs

@@ -0,0 +1,73 @@
+module AST
+  interface _ToAst
+    def to_ast: () -> Node
+  end
+
+  interface _ToSym
+    def to_sym: () -> Symbol
+  end
+
+  class Node
+    public
+
+    attr_reader children: Array[self]
+    attr_reader hash: String
+    attr_reader type: Symbol
+
+    alias + concat
+
+    alias << append
+
+    def ==: (untyped other) -> bool
+
+    def append: (untyped element) -> self
+
+    alias clone dup
+
+    def concat: (_ToA[untyped] array) -> self
+
+    def dup: () -> self
+
+    def eql?: (untyped other) -> bool
+
+    def inspect: (?Integer indent) -> String
+
+    alias to_a children
+
+    def to_ast: () -> self
+
+    alias to_s to_sexp
+
+    def to_sexp: (?Integer indent) -> String
+
+    def to_sexp_array: () -> Array[untyped]
+
+    def updated: (?_ToSym? `type`, ?_ToA[untyped]? children, ?Hash[Symbol, untyped]? properties) -> self
+
+    private
+
+    def initialize: (_ToSym `type`, ?_ToA[untyped]? children, ?Hash[Symbol, untyped] properties) -> void
+
+    alias original_dup dup
+  end
+
+  class Processor
+    include Mixin
+
+    module Mixin
+      public
+
+      def handler_missing: (Node node) -> Node?
+
+      def process: (_ToAst? node) -> Node?
+
+      def process_all: (Array[_ToAst] nodes) -> Array[Node]
+    end
+  end
+
+  module Sexp
+    public
+
+    def s: (_ToSym `type`, *untyped children) -> Node
+  end
+end

data/sig/shims/parser/3.2.0.1/manifest.yaml

@@ -0,0 +1,7 @@
+# manifest.yaml describes dependencies which do not appear in the gemspec.
+# If this gem includes such dependencies, comment-out the following lines and
+# declare the dependencies.
+# If all dependencies appear in the gemspec, you should remove this file.
+#
+dependencies:
+  - name: ast

data/sig/shims/parser/3.2.0.1/parser.rbs

@@ -0,0 +1,201 @@
+module Parser
+  CurrentRuby: Parser::Base
+
+  class SyntaxError < StandardError
+  end
+  class UnknownEncodingInMagicComment < StandardError
+  end
+
+  class Base < Racc::Parser
+    def version: -> Integer
+    def self.parse: (String string, ?String file, ?Integer line) -> Parser::AST::Node?
+    def self.parse_with_comments: (String string, ?String file, ?Integer line) -> [Parser::AST::Node?, Array[Source::Comment]]
+    def parse: (Parser::Source::Buffer source_buffer) -> Parser::AST::Node?
+  end
+
+  class Ruby18 < Base
+  end
+  class Ruby19 < Base
+  end
+  class Ruby20 < Base
+  end
+  class Ruby21 < Base
+  end
+  class Ruby22 < Base
+  end
+  class Ruby23 < Base
+  end
+  class Ruby24 < Base
+  end
+  class Ruby25 < Base
+  end
+  class Ruby26 < Base
+  end
+  class Ruby27 < Base
+  end
+  class Ruby30 < Base
+  end
+  class Ruby31 < Base
+  end
+  class Ruby32 < Base
+  end
+  class Ruby33 < Base
+  end
+
+  module AST
+    class Node < ::AST::Node
+      attr_reader location: Source::Map
+      alias loc location
+
+      def children: () -> Array[self]
+    end
+
+    class Processor
+      module Mixin
+        def process: (Node? node) ->  Node?
+      end
+
+      include Mixin
+    end
+  end
+
+  module Source
+    class Range
+      attr_reader source_buffer: Buffer
+      attr_reader begin_pos: Integer
+      attr_reader end_pos: Integer
+      def begin: () -> Range
+      def end: () -> Range
+      def size: () -> Integer
+      alias length size
+      def line: () -> Integer
+      alias first_line line
+      def column: () -> Integer
+      def last_line: () -> Integer
+      def last_column: () -> Integer
+      def column_range: () -> ::Range[Integer]
+      def source_line: () -> String
+      def source: () -> String
+      def with: (?begin_pos: Integer, ?end_pos: Integer) -> Range
+      def adjust: (?begin_pos: Integer, ?end_pos: Integer) -> Range
+      def resize: (Integer new_size) -> Range
+      def join: (Range other) -> Range
+      def intersect: (Range other) -> Range?
+      def disjoint?: (Range other) -> bool
+      def overlaps?: (Range other) -> bool
+      def contains?: (Range other) -> bool
+      def contained?: (Range other) -> bool
+      def crossing?: (Range other) -> bool
+      def empty?: () -> bool
+    end
+
+    ##
+    # A buffer with source code. {Buffer} contains the source code itself,
+    # associated location information (name and first line), and takes care
+    # of encoding.
+    #
+    # A source buffer is immutable once populated.
+    #
+    # @!attribute [r] name
+    #  Buffer name. If the buffer was created from a file, the name corresponds
+    #  to relative path to the file.
+    #  @return [String] buffer name
+    #
+    # @!attribute [r] first_line
+    #  First line of the buffer, 1 by default.
+    #  @return [Integer] first line
+    #
+    # @api public
+    #
+    class Buffer
+      attr_reader name: String
+      attr_reader first_line: Integer
+
+      def self.recognize_encoding: (String) -> Encoding
+      def self.reencode_string: (String) -> String
+
+      def initialize: (untyped name, ?Integer first_line, ?source: untyped) -> void
+      def read: () -> self
+      def source: () -> String
+      def source=: (String) -> String
+      def raw_source: (String) -> String
+      def decompose_position: (Integer) -> [Integer, Integer]
+      def source_lines: () -> Array[String]
+      def source_line: (Integer) -> String
+      def line_range: (Integer) -> ::Range[Integer]
+      def source_range: () -> ::Range[Integer]
+      def last_line: () -> Integer
+    end
+
+    class TreeRewriter
+      def replace: (Range range, String content) -> self
+      def remove: (Range range) -> self
+      def insert_before: (Range range, String content) -> self
+      def insert_after: (Range range, String content) -> self
+    end
+
+    class Map
+      attr_reader node: AST::Node | nil
+      attr_reader expression: Range
+      def line: () -> Integer
+      def first_line: () -> Integer
+      def last_line: () -> Integer
+      def column: () -> Integer
+      def last_column: () -> Integer
+    end
+
+    class Map::Collection < Map
+      attr_reader begin: Range?
+      attr_reader end: Range?
+    end
+
+    class Map::Condition < Map
+      attr_reader keyword: Range
+      attr_reader begin: Range?
+      attr_reader else: Range?
+      attr_reader end: Range
+    end
+
+    class Map::Heredoc < Map
+      attr_reader heredoc_body: Range
+      attr_reader heredoc_end: Range
+    end
+
+    class Map::Keyword < Map
+      attr_reader keyword: Range
+      attr_reader begin: Range?
+      attr_reader end: Range?
+    end
+
+    class Map::MethodDefinition < Map
+      attr_reader keyword: Range
+      attr_reader operator: Range?
+      attr_reader name: Range?
+      attr_reader end: Range?
+      attr_reader assignment: Range?
+    end
+
+    class Map::Operator < Map
+      attr_reader operator: Range?
+    end
+
+    class Map::Send < Map
+      attr_reader dot: Range?
+      attr_reader selector: Range
+      attr_reader operator: Range?
+      attr_reader begin: Range?
+      attr_reader end: Range?
+    end
+
+    class Map::Ternary < Map
+      attr_reader question: Range?
+      attr_reader colon: Range
+    end
+
+    class Comment
+      attr_reader text: String
+      attr_reader location: Map
+      alias loc location
+    end
+  end
+end

data/sig/shims/parser/3.2.0.1/polyfill.rbs

@@ -0,0 +1,4 @@
+module Racc
+  class Parser
+  end
+end

data/solargraph.gemspec

@@ -2,6 +2,7 @@ $LOAD_PATH.unshift File.dirname(__FILE__) + '/lib'
 require 'solargraph/version'
 require 'date'
 
+# @param s [Gem::Specification]
 Gem::Specification.new do |s|
   s.name        = 'solargraph'
   s.version     = Solargraph::VERSION
@@ -23,12 +24,14 @@ Gem::Specification.new do |s|
   s.metadata["bug_tracker_uri"] = "https://github.com/castwide/solargraph/issues"
   s.metadata["changelog_uri"]   = "https://github.com/castwide/solargraph/blob/master/CHANGELOG.md"
   s.metadata["source_code_uri"] = "https://github.com/castwide/solargraph"
+  s.metadata["rubygems_mfa_required"] = "true"
 
   s.required_ruby_version = '>= 3.0'
 
+  s.add_runtime_dependency 'ast', '~> 2.4.3'
   s.add_runtime_dependency 'backport', '~> 1.2'
   s.add_runtime_dependency 'benchmark', '~> 0.4'
-  s.add_runtime_dependency 'bundler', '~> 2.0'
+  s.add_runtime_dependency 'bundler', '>= 2.0'
   s.add_runtime_dependency 'diff-lcs', '~> 1.4'
   s.add_runtime_dependency 'jaro_winkler', '~> 1.6', '>= 1.6.1'
   s.add_runtime_dependency 'kramdown', '~> 2.3'
@@ -36,6 +39,7 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency 'logger', '~> 1.6'
   s.add_runtime_dependency 'observer', '~> 0.1'
   s.add_runtime_dependency 'ostruct', '~> 0.6'
+  s.add_runtime_dependency 'open3', '~> 0.2.1'
   s.add_runtime_dependency 'parser', '~> 3.0'
   s.add_runtime_dependency 'prism', '~> 1.4'
   s.add_runtime_dependency 'rbs', ['>= 3.6.1', '<= 4.0.0.dev.4']
@@ -51,9 +55,16 @@ Gem::Specification.new do |s|
   s.add_development_dependency 'public_suffix', '~> 3.1'
   s.add_development_dependency 'rake', '~> 13.2'
   s.add_development_dependency 'rspec', '~> 3.5'
-  s.add_development_dependency 'rubocop-rake', '~> 0.7'
-  s.add_development_dependency 'rubocop-rspec', '~> 3.6'
-  s.add_development_dependency 'rubocop-yard', '~> 1.0'
+  #
+  # very specific development-time RuboCop version patterns for CI
+  # stability - feel free to update in an isolated PR
+  #
+  # even more specific on RuboCop itself, which is written into _todo
+  # file.
+  s.add_development_dependency 'rubocop', '~> 1.80.0.0'
+  s.add_development_dependency 'rubocop-rake', '~> 0.7.1'
+  s.add_development_dependency 'rubocop-rspec', '~> 3.6.0'
+  s.add_development_dependency 'rubocop-yard', '~> 1.0.0'
   s.add_development_dependency 'simplecov', '~> 0.21'
   s.add_development_dependency 'simplecov-lcov', '~> 0.8'
   s.add_development_dependency 'undercover', '~> 0.7'

metadata

@@ -1,14 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: solargraph
 version: !ruby/object:Gem::Version
-  version: 0.57.0
+  version: 0.58.1
 platform: ruby
 authors:
 - Fred Snyder
 bindir: bin
 cert_chain: []
-date: 2025-09-16 00:00:00.000000000 Z
+date: 2026-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: ast
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.4.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.4.3
 - !ruby/object:Gem::Dependency
   name: backport
   requirement: !ruby/object:Gem::Requirement
@@ -41,14 +55,14 @@ dependencies:
   name: bundler
   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
@@ -155,6 +169,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: open3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.1
 - !ruby/object:Gem::Dependency
   name: parser
   requirement: !ruby/object:Gem::Requirement
@@ -363,48 +391,62 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.80.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.80.0.0
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: 0.7.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: 0.7.1
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.6'
+        version: 3.6.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.6'
+        version: 3.6.0
 - !ruby/object:Gem::Dependency
   name: rubocop-yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -496,6 +538,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gitattributes"
 - ".github/FUNDING.yml"
 - ".github/workflows/linting.yml"
 - ".github/workflows/plugins.yml"
@@ -621,7 +664,6 @@ files:
 - lib/solargraph/parser.rb
 - lib/solargraph/parser/comment_ripper.rb
 - lib/solargraph/parser/flow_sensitive_typing.rb
-- lib/solargraph/parser/node_methods.rb
 - lib/solargraph/parser/node_processor.rb
 - lib/solargraph/parser/node_processor/base.rb
 - lib/solargraph/parser/parser_gem.rb
@@ -757,9 +799,21 @@ files:
 - lib/solargraph/yard_map/to_method.rb
 - lib/solargraph/yard_tags.rb
 - lib/solargraph/yardoc.rb
-- rbs/fills/tuple.rbs
+- rbs/fills/bundler/0/bundler.rbs
+- rbs/fills/open3/0/open3.rbs
+- rbs/fills/rubygems/0/basic_specification.rbs
+- rbs/fills/rubygems/0/errors.rbs
+- rbs/fills/rubygems/0/spec_fetcher.rbs
+- rbs/fills/rubygems/0/specification.rbs
+- rbs/fills/tuple/tuple.rbs
 - rbs_collection.yaml
+- sig/shims/ast/0/node.rbs
+- sig/shims/ast/2.4/.rbs_meta.yaml
+- sig/shims/ast/2.4/ast.rbs
 - sig/shims/parser/3.2.0.1/builders/default.rbs
+- sig/shims/parser/3.2.0.1/manifest.yaml
+- sig/shims/parser/3.2.0.1/parser.rbs
+- sig/shims/parser/3.2.0.1/polyfill.rbs
 - sig/shims/thor/1.2.0.1/.rbs_meta.yaml
 - sig/shims/thor/1.2.0.1/manifest.yaml
 - sig/shims/thor/1.2.0.1/thor.rbs
@@ -772,6 +826,7 @@ metadata:
   bug_tracker_uri: https://github.com/castwide/solargraph/issues
   changelog_uri: https://github.com/castwide/solargraph/blob/master/CHANGELOG.md
   source_code_uri: https://github.com/castwide/solargraph
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib

data/lib/solargraph/parser/node_methods.rb

@@ -1,97 +0,0 @@
-module Solargraph
-  module Parser
-    module NodeMethods
-      module_function
-
-      # @abstract
-      # @param node [Parser::AST::Node]
-      # @return [String]
-      def unpack_name node
-        raise NotImplementedError
-      end
-
-      # @abstract
-      # @todo Temporarily here for testing. Move to Solargraph::Parser.
-      # @param node [Parser::AST::Node]
-      # @return [Array<Parser::AST::Node>]
-      def call_nodes_from node
-        raise NotImplementedError
-      end
-
-      # Find all the nodes within the provided node that potentially return a
-      # value.
-      #
-      # The node parameter typically represents a method's logic, e.g., the
-      # second child (after the :args node) of a :def node. A simple one-line
-      # method would typically return itself, while a node with conditions
-      # would return the resulting node from each conditional branch. Nodes
-      # that follow a :return node are assumed to be unreachable. Nil values
-      # are converted to nil node types.
-      #
-      # @abstract
-      # @param node [Parser::AST::Node]
-      # @return [Array<Parser::AST::Node>]
-      def returns_from_method_body node
-        raise NotImplementedError
-      end
-
-      # @abstract
-      # @param node [Parser::AST::Node]
-      #
-      # @return [Array<Parser::AST::Node>]
-      def const_nodes_from node
-        raise NotImplementedError
-      end
-
-      # @abstract
-      # @param cursor [Solargraph::Source::Cursor]
-      # @return [Parser::AST::Node, nil]
-      def find_recipient_node cursor
-        raise NotImplementedError
-      end
-
-      # @abstract
-      # @param node [Parser::AST::Node]
-      # @return [Array<AST::Node>] low-level value nodes in
-      #   value position.  Does not include explicit return
-      #   statements
-      def value_position_nodes_only(node)
-        raise NotImplementedError
-      end
-
-      # @abstract
-      # @param nodes [Enumerable<Parser::AST::Node>]
-      def any_splatted_call?(nodes)
-        raise NotImplementedError
-      end
-
-      # @abstract
-      # @param node [Parser::AST::Node]
-      # @return [void]
-      def process node
-        raise NotImplementedError
-      end
-
-      # @abstract
-      # @param node [Parser::AST::Node]
-      # @return [Hash{Symbol => Source::Chain}]
-      def convert_hash node
-        raise NotImplementedError
-      end
-
-      # @abstract
-      # @param node [Parser::AST::Node]
-      # @return [Position]
-      def get_node_start_position(node)
-        raise NotImplementedError
-      end
-
-      # @abstract
-      # @param node [Parser::AST::Node]
-      # @return [Position]
-      def get_node_end_position(node)
-        raise NotImplementedError
-      end
-    end
-  end
-end