Detach RBI header comment from top-level node (when generating YARD docs)

lib/tapioca/rbi_formatter.rb

@@ -16,6 +16,8 @@ def write_header!(file, command, reason: nil)
       file.comments << RBI::Comment.new("DO NOT EDIT MANUALLY")
       file.comments << RBI::Comment.new("This is an autogenerated file for #{reason}.") unless reason.nil?
       file.comments << RBI::Comment.new("Please instead update this file by running `#{command}`.")
+      # Prevent the header from being attached to the top-level node when generating YARD docs
+      file.comments << RBI::BlankLine.new
     end
 
     sig { params(file: RBI::File).void }

spec/tapioca/cli/dsl_spec.rb

@@ -199,6 +199,7 @@ class Post
             # This is an autogenerated file for dynamic methods in `Post`.
             # Please instead update this file by running `bin/tapioca dsl Post`.
 
+
             class Post
               include SmartPropertiesGeneratedMethods
 
@@ -315,6 +316,7 @@ class Comment
             # This is an autogenerated file for dynamic methods in `Post`.
             # Please instead update this file by running `bin/tapioca dsl Post`.
 
+
             class Post
               include SmartPropertiesGeneratedMethods
 
@@ -335,6 +337,7 @@ def title=(title); end
             # This is an autogenerated file for dynamic methods in `Namespace::Comment`.
             # Please instead update this file by running `bin/tapioca dsl Namespace::Comment`.
 
+
             class Namespace::Comment
               include SmartPropertiesGeneratedMethods
 
@@ -400,6 +403,7 @@ class Role
             # This is an autogenerated file for dynamic methods in `Foo::Role`.
             # Please instead update this file by running `bin/tapioca dsl Foo::Role`.
 
+
             class Foo::Role
               include SmartPropertiesGeneratedMethods
 
@@ -454,6 +458,7 @@ class Comment
               # This is an autogenerated file for dynamic methods in `Post`.
               # Please instead update this file by running `bin/tapioca dsl Post`.
 
+
               class Post
                 include SmartPropertiesGeneratedMethods
 
@@ -1049,6 +1054,7 @@ def self.gather_constants
             # This is an autogenerated file for dynamic methods in `Post`.
             # Please instead update this file by running `bin/tapioca dsl Post`.
 
+
             class Post
               include GeneratedBar
               include GeneratedFoo
@@ -1142,6 +1148,7 @@ def self.gather_constants
             # This is an autogenerated file for dynamic methods in `Job`.
             # Please instead update this file by running `bin/tapioca dsl Job`.
 
+
             class Job
               class << self
                 sig { params(foo: T.untyped, bar: T.untyped).returns(String) }
@@ -1357,6 +1364,7 @@ class Post
             # This is an autogenerated file for dynamic methods in `Post`.
             # Please instead update this file by running `bin/tapioca dsl Post`.
 
+
             class Post
               include SmartPropertiesGeneratedMethods
 
@@ -1661,6 +1669,7 @@ class Post < ActiveRecord::Base
             # This is an autogenerated file for dynamic methods in `Post`.
             # Please instead update this file by running `bin/tapioca dsl Post`.
 
+
             class Post
               include StoreAccessors
 
@@ -1972,6 +1981,7 @@ def self.gather_constants
             # This is an autogenerated file for dynamic methods in `Post`.
             # Please instead update this file by running `bin/tapioca dsl Post`.
 
+
             class Post
               include GeneratedBar
 
@@ -2181,6 +2191,7 @@ def decorate
             # This is an autogenerated file for dynamic methods in `CreditCard`.
             # Please instead update this file by running `bin/tapioca dsl CreditCard`.
 
+
             class CreditCard
               sig { returns(String) }
               def number; end
@@ -2333,6 +2344,7 @@ def decorate
             # This is an autogenerated file for dynamic methods in `CreditCard`.
             # Please instead update this file by running `bin/tapioca dsl CreditCard`.
 
+
             class CreditCard
               sig { returns(String) }
               def number; end
@@ -2484,6 +2496,7 @@ class Post::Rack < Post
             # This is an autogenerated file for dynamic methods in `Post::Rack`.
             # Please instead update this file by running `bin/tapioca dsl Post::Rack`.
 
+
             class Post::Rack
               include SmartPropertiesGeneratedMethods
 
@@ -2504,6 +2517,7 @@ def title=(title); end
             # This is an autogenerated file for dynamic methods in `Post::Rails`.
             # Please instead update this file by running `bin/tapioca dsl Post::Rails`.
 
+
             class Post::Rails
               include SmartPropertiesGeneratedMethods
 

spec/tapioca/cli/gem_spec.rb

@@ -30,6 +30,7 @@ module Reopened
       # This is an autogenerated file for types exported from the `foo` gem.
       # Please instead update this file by running `bin/tapioca gem foo`.
 
+
       module Foo
         class << self
           def foo(a = T.unsafe(nil), b: T.unsafe(nil), **opts); end
@@ -64,6 +65,7 @@ module Reopened
       # This is an autogenerated file for types exported from the `bar` gem.
       # Please instead update this file by running `bin/tapioca gem bar`.
 
+
       module Bar
         class << self
           def bar(a = T.unsafe(nil), b: T.unsafe(nil), **opts); end
@@ -93,6 +95,7 @@ def fizz
       # This is an autogenerated file for types exported from the `baz` gem.
       # Please instead update this file by running `bin/tapioca gem baz`.
 
+
       module Baz; end
 
       class Baz::Test
@@ -350,6 +353,7 @@ def bar; end
             # This is an autogenerated file for types exported from the `foo` gem.
             # Please instead update this file by running `bin/tapioca gem foo`.
 
+
             module Foo
               def foo; end
 
@@ -835,6 +839,7 @@ class Secret; end
             # This is an autogenerated file for types exported from the `foo` gem.
             # Please instead update this file by running `bin/tapioca gem foo`.
 
+
             # THIS IS AN EMPTY RBI FILE.
             # see https://github.com/Shopify/tapioca#manually-requiring-parts-of-a-gem
           RBI
@@ -959,6 +964,7 @@ class TaskLib
             # This is an autogenerated file for types exported from the `fake_rake` gem.
             # Please instead update this file by running `bin/tapioca gem fake_rake`.
 
+
             module FakeRake; end
             class FakeRake::TaskLib; end
           RBI
@@ -1052,6 +1058,7 @@ def foo(a, b, c, d, e, f, g, h); end
             # This is an autogenerated file for types exported from the `foo` gem.
             # Please instead update this file by running `bin/tapioca gem foo`.
 
+
             module Foo
               sig { params(a: T.untyped, b: T.untyped, c: T.untyped, d: T.untyped, e: T.untyped, f: T.untyped, g: T.untyped).void }
               def bar(a, b, c, d, e, f, g); end
@@ -1103,6 +1110,7 @@ def foo(a, b, c, d, e, f, g, h); end
             # This is an autogenerated file for types exported from the `foo` gem.
             # Please instead update this file by running `bin/tapioca gem foo`.
 
+
             module Foo
               sig do
                 params(
@@ -1249,6 +1257,7 @@ class Post
             # This is an autogenerated file for types exported from the `foo` gem.
             # Please instead update this file by running `bin/tapioca gem foo`.
 
+
             module Foo; end
 
             class Foo::Engine < ::Rails::Engine
@@ -1806,6 +1815,7 @@ class << self
           # This is an autogenerated file for types exported from the `type_variable` gem.
           # Please instead update this file by running `bin/tapioca gem type_variable`.
 
+
           class ComplexGenericType
             extend T::Generic