Fix incorrect extend T::Helpers for foreign annotations

Co-authored-by: Alexandre Terrasa <583144+Morriar@users.noreply.github.com>

Author: KaanOzkan

lib/spoom/rbs.rb

@@ -4,22 +4,64 @@
 module Spoom
   module RBS
     class Comments
-      #: Array[Annotations]
+      #: Array[Annotation]
       attr_reader :annotations
 
       #: Array[Signature]
       attr_reader :signatures
 
       #: -> void
       def initialize
-        @annotations = [] #: Array[Annotations]
+        @annotations = [] #: Array[Annotation]
         @signatures = [] #: Array[Signature]
       end
 
       #: -> bool
       def empty?
         @annotations.empty? && @signatures.empty?
       end
+
+      #: -> Array[Annotation]
+      def class_annotations
+        @annotations.select do |annotation|
+          case annotation.string
+          when "@abstract"
+            true
+          when "@interface"
+            true
+          when "@sealed"
+            true
+          when "@final"
+            true
+          when /^@requires_ancestor: /
+            true
+          else
+            false
+          end
+        end
+      end
+
+      #: -> Array[Annotation]
+      def method_annotations
+        @annotations.select do |annotation|
+          case annotation.string
+          when "@abstract"
+            true
+          when "@final"
+            true
+          when "@override"
+            true
+          when "@override(allow_incompatible: true)"
+            true
+          when "@overridable"
+            true
+          when "@without_runtime"
+            true
+          else
+            false
+          end
+        end
+      end
     end
 
     class Comment
@@ -36,7 +78,7 @@ def initialize(string, location)
       end
     end
 
-    class Annotations < Comment; end
+    class Annotation < Comment; end
     class Signature < Comment; end
 
     module ExtractRBSComments
@@ -54,7 +96,7 @@ def node_rbs_comments(node)
 
           if string.start_with?("# @")
             string = string.delete_prefix("#").strip
-            res.annotations << Annotations.new(string, comment.location)
+            res.annotations << Annotation.new(string, comment.location)
           elsif string.start_with?("#: ")
             string = string.delete_prefix("#:").strip
             location = comment.location

lib/spoom/sorbet/translate/rbs_comments_to_sorbet_sigs.rb

@@ -48,7 +48,7 @@ def visit_def_node(node)
             translator = RBI::RBS::MethodTypeTranslator.new(rbi_node)
             translator.visit(method_type)
             sig = translator.result
-            apply_member_annotations(comments.annotations, sig)
+            apply_member_annotations(comments.method_annotations, sig)
 
             @rewriter << Source::Replace.new(
               signature.location.start_offset,
@@ -99,7 +99,7 @@ def visit_attr(node)
 
             sig.return_type = RBI::RBS::TypeTranslator.translate(attr_type)
 
-            apply_member_annotations(comments.annotations, sig)
+            apply_member_annotations(comments.method_annotations, sig)
 
             @rewriter << Source::Replace.new(
               signature.location.start_offset,
@@ -127,12 +127,13 @@ def apply_class_annotations(node)
             node.expression.location.end_offset
           end
 
-          if comments.annotations.any?
+          class_annotations = comments.class_annotations
+          if class_annotations.any?
             unless already_extends?(node, /^(::)?T::Helpers$/)
               @rewriter << Source::Insert.new(insert_pos, "\n#{indent}extend T::Helpers\n")
             end
 
-            comments.annotations.reverse_each do |annotation|
+            class_annotations.reverse_each do |annotation|
               from = adjust_to_line_start(annotation.location.start_offset)
               to = adjust_to_line_end(annotation.location.end_offset)
 
@@ -209,7 +210,7 @@ def apply_class_annotations(node)
           end
         end
 
-        #: (Array[RBS::Annotations], RBI::Sig) -> void
+        #: (Array[RBS::Annotation], RBI::Sig) -> void
         def apply_member_annotations(annotations, sig)
           annotations.each do |annotation|
             case annotation.string

rbi/spoom.rbi

@@ -2579,7 +2579,7 @@ class Spoom::Printer
 end
 
 module Spoom::RBS; end
-class Spoom::RBS::Annotations < ::Spoom::RBS::Comment; end
+class Spoom::RBS::Annotation < ::Spoom::RBS::Comment; end
 
 class Spoom::RBS::Comment
   sig { params(string: ::String, location: ::Prism::Location).void }
@@ -2596,12 +2596,18 @@ class Spoom::RBS::Comments
   sig { void }
   def initialize; end
 
-  sig { returns(T::Array[::Spoom::RBS::Annotations]) }
+  sig { returns(T::Array[::Spoom::RBS::Annotation]) }
   def annotations; end
 
+  sig { returns(T::Array[::Spoom::RBS::Annotation]) }
+  def class_annotations; end
+
   sig { returns(T::Boolean) }
   def empty?; end
 
+  sig { returns(T::Array[::Spoom::RBS::Annotation]) }
+  def method_annotations; end
+
   sig { returns(T::Array[::Spoom::RBS::Signature]) }
   def signatures; end
 end
@@ -2914,7 +2920,7 @@ class Spoom::Sorbet::Translate::RBSCommentsToSorbetSigs < ::Spoom::Sorbet::Trans
   sig { params(node: T.any(::Prism::ClassNode, ::Prism::ModuleNode, ::Prism::SingletonClassNode)).void }
   def apply_class_annotations(node); end
 
-  sig { params(annotations: T::Array[::Spoom::RBS::Annotations], sig: ::RBI::Sig).void }
+  sig { params(annotations: T::Array[::Spoom::RBS::Annotation], sig: ::RBI::Sig).void }
   def apply_member_annotations(annotations, sig); end
 
   sig { params(node: ::Prism::CallNode).void }

test/spoom/sorbet/translate/rbs_comments_to_sorbet_sigs_test.rb

@@ -283,6 +283,16 @@ class << self
           RB
         end
 
+        def test_translate_to_rbi_does_not_insert_t_helpers_for_random_annotations
+          contents = <<~RB
+            # @private
+            class Foo
+            end
+          RB
+
+          assert_equal(contents, rbs_comments_to_sorbet_sigs(contents))
+        end
+
         def test_translate_to_rbi_helpers_with_right_order
           contents = <<~RB
             # @foo