tapioca 0.17.8 → 0.17.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 489bd75ab0b8322c633ee51dbdb7f0bf4701fbca5cf64401c418d8a7fb454418
-  data.tar.gz: 62e4137c4fb603186d93b2f470148f5a8b7baa73bcfb6ed8b000a519dc1f106a
+  metadata.gz: fd0aedb9a8295fc96a30b43e9a3da1f84bebdf3f97bb2fbd1fd99375fdad6fc1
+  data.tar.gz: 2c649b047df9cb012f7ed8502c9206e419e70a6bc7c1d2d07785aaad51af649e
 SHA512:
-  metadata.gz: ef5107149d789dda2d5c426a14b611ab1062f8aaa919ec179805c95bf7ad7d22eaae368ac9e0ed86b61cfac38b5bbbfc2fa65fa262837ce22ff4ee054b5cbf31
-  data.tar.gz: e568320ce79f3e9afa07d1ea1fc58aa7aef422f782b77c4b93707016b680bd2e3c2c971b136016dbf754ed82199e461178467195166f2c7738dec40632ac5de1
+  metadata.gz: d1fe2a59d4570b065179f64d6de4e6bd27f494b2c23545c4a2ccf64a9cf33383ca5fd99a5eaf1ac3d93ff720b68780504b09beb501ad5567c6ea5c917d9004fe
+  data.tar.gz: '08514a0edef06b920cc2a07493f86f9a428e33554d1509210cfc4a0d044735303043efceb1a14f3ce2d18b29d4693bcd8e36a9153c4c4c836aa0fcbacd5110ef'

data/README.md

@@ -673,7 +673,7 @@ module Tapioca
 
       ConstantType = type_member {{ fixed: T.class_of(Encryptable) }}
 
-      sig { override.returns(T::Enumerable[Module]) }
+      sig { override.returns(T::Enumerable[T::Module[T.anything]]) }
       def self.gather_constants
         # Collect all the classes that include Encryptable
         all_classes.select { |c| c < ::Encryptable }
@@ -806,7 +806,7 @@ module Tapioca
 
       ConstantType = type_member {{ fixed: T.class_of(Encryptable) }}
 
-      sig { override.returns(T::Enumerable[Module]) }
+      sig { override.returns(T::Enumerable[T::Module[T.anything]]) }
       def self.gather_constants
         # Collect all the classes that include Encryptable
         all_classes.select { |c| c < ::Encryptable }

data/lib/tapioca/commands/abstract_dsl.rb

@@ -8,7 +8,26 @@ module Tapioca
       include SorbetHelper
       include RBIFilesHelper
 
-      #: (requested_constants: Array[String], requested_paths: Array[Pathname], outpath: Pathname, only: Array[String], exclude: Array[String], file_header: bool, tapioca_path: String, ?skip_constant: Array[String], ?quiet: bool, ?verbose: bool, ?number_of_workers: Integer?, ?auto_strictness: bool, ?gem_dir: String, ?rbi_formatter: RBIFormatter, ?app_root: String, ?halt_upon_load_error: bool, ?compiler_options: Hash[String, untyped], ?lsp_addon: bool) -> void
+      #: (
+      #|   requested_constants: Array[String],
+      #|   requested_paths: Array[Pathname],
+      #|   outpath: Pathname,
+      #|   only: Array[String],
+      #|   exclude: Array[String],
+      #|   file_header: bool,
+      #|   tapioca_path: String,
+      #|   ?skip_constant: Array[String],
+      #|   ?quiet: bool,
+      #|   ?verbose: bool,
+      #|   ?number_of_workers: Integer?,
+      #|   ?auto_strictness: bool,
+      #|   ?gem_dir: String,
+      #|   ?rbi_formatter: RBIFormatter,
+      #|   ?app_root: String,
+      #|   ?halt_upon_load_error: bool,
+      #|   ?compiler_options: Hash[String, untyped],
+      #|   ?lsp_addon: bool
+      #| ) -> void
       def initialize(
         requested_constants:,
         requested_paths:,
@@ -143,7 +162,7 @@ module Tapioca
         filenames.to_set
       end
 
-      #: (Array[String] constant_names, ?ignore_missing: bool) -> Array[Module]
+      #: (Array[String] constant_names, ?ignore_missing: bool) -> Array[T::Module[top]]
       def constantize(constant_names, ignore_missing: false)
         constant_map = constant_names.to_h do |name|
           [name, Object.const_get(name)]

data/lib/tapioca/commands/abstract_gem.rb

@@ -8,7 +8,26 @@ module Tapioca
       include SorbetHelper
       include RBIFilesHelper
 
-      #: (gem_names: Array[String], exclude: Array[String], include_dependencies: bool, prerequire: String?, postrequire: String, typed_overrides: Hash[String, String], outpath: Pathname, file_header: bool, include_doc: bool, include_loc: bool, include_exported_rbis: bool, ?number_of_workers: Integer?, ?auto_strictness: bool, ?dsl_dir: String, ?rbi_formatter: RBIFormatter, ?halt_upon_load_error: bool, ?lsp_addon: bool?, ?verbose: bool?) -> void
+      #: (
+      #|   gem_names: Array[String],
+      #|   exclude: Array[String],
+      #|   include_dependencies: bool,
+      #|   prerequire: String?,
+      #|   postrequire: String,
+      #|   typed_overrides: Hash[String, String],
+      #|   outpath: Pathname,
+      #|   file_header: bool,
+      #|   include_doc: bool,
+      #|   include_loc: bool,
+      #|   include_exported_rbis: bool,
+      #|   ?number_of_workers: Integer?,
+      #|   ?auto_strictness: bool,
+      #|   ?dsl_dir: String,
+      #|   ?rbi_formatter: RBIFormatter,
+      #|   ?halt_upon_load_error: bool,
+      #|   ?lsp_addon: bool?,
+      #|   ?verbose: bool?
+      #| ) -> void
       def initialize(
         gem_names:,
         exclude:,
@@ -70,7 +89,7 @@ module Tapioca
           reason: "types exported from the `#{gem.name}` gem",
         ) if @file_header
 
-        rbi.root = Tapioca.with_disabled_exits do
+        rbi.root = Runtime.with_disabled_exits do
           Tapioca::Gem::Pipeline.new(
             gem,
             include_doc: @include_doc,

data/lib/tapioca/commands/annotations.rb

@@ -6,7 +6,13 @@ module Tapioca
     class Annotations < CommandWithoutTracker
       extend T::Sig
 
-      #: (central_repo_root_uris: Array[String], ?auth: String?, ?netrc_file: String?, ?central_repo_index_path: String, ?typed_overrides: Hash[String, String]) -> void
+      #: (
+      #|   central_repo_root_uris: Array[String],
+      #|   ?auth: String?,
+      #|   ?netrc_file: String?,
+      #|   ?central_repo_index_path: String,
+      #|   ?typed_overrides: Hash[String, String]
+      #| ) -> void
       def initialize(
         central_repo_root_uris:,
         auth: nil,

data/lib/tapioca/commands/check_shims.rb

@@ -8,7 +8,15 @@ module Tapioca
       include SorbetHelper
       include RBIFilesHelper
 
-      #: (gem_rbi_dir: String, dsl_rbi_dir: String, annotations_rbi_dir: String, shim_rbi_dir: String, todo_rbi_file: String, payload: bool, number_of_workers: Integer?) -> void
+      #: (
+      #|   gem_rbi_dir: String,
+      #|   dsl_rbi_dir: String,
+      #|   annotations_rbi_dir: String,
+      #|   shim_rbi_dir: String,
+      #|   todo_rbi_file: String,
+      #|   payload: bool,
+      #|   number_of_workers: Integer?
+      #| ) -> void
       def initialize(
         gem_rbi_dir:,
         dsl_rbi_dir:,

data/lib/tapioca/commands/command.rb

@@ -21,7 +21,7 @@ module Tapioca
       # @final
       #: -> void
       def run
-        Tapioca.silence_warnings do
+        Runtime.silence_warnings do
           execute
         end
       end

data/lib/tapioca/dsl/compiler.rb

@@ -4,7 +4,7 @@
 module Tapioca
   module Dsl
     # @abstract
-    #: [ConstantType < Module]
+    #: [ConstantType < T::Module[top]]
     class Compiler
       extend T::Sig
 
@@ -21,26 +21,26 @@ module Tapioca
       #: Hash[String, untyped]
       attr_reader :options
 
-      @@requested_constants = [] #: Array[Module] # rubocop:disable Style/ClassVars
+      @@requested_constants = [] #: Array[T::Module[top]] # rubocop:disable Style/ClassVars
 
       class << self
         extend T::Sig
 
-        #: (Module constant) -> bool
+        #: (T::Module[top] constant) -> bool
         def handles?(constant)
           processable_constants.include?(constant)
         end
 
         # @abstract
-        #: -> T::Enumerable[Module]
+        #: -> Enumerable[T::Module[top]]
         def gather_constants = raise NotImplementedError, "Abstract method called"
 
-        #: -> Set[Module]
+        #: -> Set[T::Module[top]]
         def processable_constants
-          @processable_constants ||= T::Set[Module].new.compare_by_identity.merge(gather_constants) #: Set[Module]?
+          @processable_constants ||= T::Set[T::Module[T.anything]].new.compare_by_identity.merge(gather_constants) #: Set[T::Module[top]]?
         end
 
-        #: (Array[Module] constants) -> void
+        #: (Array[T::Module[top]] constants) -> void
         def requested_constants=(constants)
           @@requested_constants = constants # rubocop:disable Style/ClassVars
         end
@@ -68,22 +68,27 @@ module Tapioca
           end
         end
 
-        #: -> T::Enumerable[Class[top]]
+        #: -> Enumerable[Class[top]]
         def all_classes
-          @all_classes ||= all_modules.grep(Class).freeze #: T::Enumerable[Class[top]]?
+          @all_classes ||= all_modules.grep(Class).freeze #: Enumerable[Class[top]]?
         end
 
-        #: -> T::Enumerable[Module]
+        #: -> Enumerable[T::Module[top]]
         def all_modules
           @all_modules ||= if @@requested_constants.any?
             @@requested_constants.grep(Module)
           else
             ObjectSpace.each_object(Module).to_a
-          end.freeze #: T::Enumerable[Module]?
+          end.freeze #: Enumerable[T::Module[top]]?
         end
       end
 
-      #: (Tapioca::Dsl::Pipeline pipeline, RBI::Tree root, ConstantType constant, ?Hash[String, untyped] options) -> void
+      #: (
+      #|   Tapioca::Dsl::Pipeline pipeline,
+      #|   RBI::Tree root,
+      #|   ConstantType constant,
+      #|   ?Hash[String, untyped] options
+      #| ) -> void
       def initialize(pipeline, root, constant, options = {})
         @pipeline = pipeline
         @root = root

data/lib/tapioca/dsl/compilers/aasm.rb

@@ -203,9 +203,9 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
-            T.cast(ObjectSpace.each_object(::AASM::ClassMethods), T::Enumerable[Module])
+            T.cast(ObjectSpace.each_object(::AASM::ClassMethods), T::Enumerable[T::Module[T.anything]])
           end
         end
       end

data/lib/tapioca/dsl/compilers/action_controller_helpers.rb

@@ -121,7 +121,7 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             descendants_of(::ActionController::Base).select(&:name).select do |klass|
               klass.const_defined?(:HelperMethods, false)
@@ -152,7 +152,7 @@ module Tapioca
           )
         end
 
-        #: (Module mod) -> Array[String]
+        #: (T::Module[top] mod) -> Array[String]
         def gather_includes(mod)
           mod.ancestors
             .reject { |ancestor| ancestor.is_a?(Class) || ancestor == mod || name_of(ancestor).nil? }

data/lib/tapioca/dsl/compilers/action_mailer.rb

@@ -54,7 +54,7 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             descendants_of(::ActionMailer::Base).reject(&:abstract?)
           end

data/lib/tapioca/dsl/compilers/action_text.rb

@@ -84,7 +84,7 @@ module Tapioca
           end
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             descendants_of(::ActiveRecord::Base)
               .reject(&:abstract_class?)

data/lib/tapioca/dsl/compilers/active_job.rb

@@ -88,7 +88,7 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             descendants_of(::ActiveJob::Base)
           end

data/lib/tapioca/dsl/compilers/active_model_attributes.rb

@@ -63,7 +63,7 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             all_classes.grep(::ActiveModel::Attributes::ClassMethods)
           end

data/lib/tapioca/dsl/compilers/active_model_secure_password.rb

@@ -93,8 +93,14 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
+            # In some versions of Rails 8.1, `ActiveModel::SecurePassword` uses `Numeric#minutes`
+            # which isn't explicitly required in the gem, and it might not be loaded already.
+            # We might need to require it before referencing the constant to avoid a NoMethodError when
+            # the constant is autoloaded.
+            require "active_support/core_ext/numeric/time" unless defined?(1.minutes)
+
             # This selects all classes that are `ActiveModel::SecurePassword::ClassMethods === klass`.
             # In other words, we select all classes that have `ActiveModel::SecurePassword::ClassMethods`
             # as an ancestor of its singleton class, i.e. all classes that have extended the

data/lib/tapioca/dsl/compilers/active_model_validations_confirmation.rb

@@ -46,7 +46,7 @@ module Tapioca
 
         class << self
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             # Collect all the classes that include ActiveModel::Validations
             all_classes.select { |c| ActiveModel::Validations > c }

data/lib/tapioca/dsl/compilers/active_record_associations.rb

@@ -141,7 +141,7 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             descendants_of(::ActiveRecord::Base).reject(&:abstract_class?)
           end

data/lib/tapioca/dsl/compilers/active_record_columns.rb

@@ -166,7 +166,7 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             descendants_of(::ActiveRecord::Base).reject(&:abstract_class?)
           end
@@ -189,7 +189,13 @@ module Tapioca
           )
         end
 
-        #: (RBI::Scope klass, String name, Array[String]? methods_to_add, ?return_type: String, ?parameters: Array[RBI::TypedParam]) -> void
+        #: (
+        #|   RBI::Scope klass,
+        #|   String name,
+        #|   Array[String]? methods_to_add,
+        #|   ?return_type: String,
+        #|   ?parameters: Array[RBI::TypedParam]
+        #| ) -> void
         def add_method(klass, name, methods_to_add, return_type: "void", parameters: [])
           klass.create_method(
             name,

data/lib/tapioca/dsl/compilers/active_record_delegated_types.rb

@@ -91,7 +91,7 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             descendants_of(::ActiveRecord::Base).reject(&:abstract_class?)
           end

data/lib/tapioca/dsl/compilers/active_record_enum.rb

@@ -13,7 +13,7 @@ module Tapioca
       #
       # ~~~rb
       # class Post < ApplicationRecord
-      #   enum title_type: %i(book all web), _suffix: :title
+      #   enum :title_type, %i(book all web), suffix: :title
       # end
       # ~~~
       #
@@ -78,7 +78,7 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             descendants_of(::ActiveRecord::Base)
           end

data/lib/tapioca/dsl/compilers/active_record_fixtures.rb

@@ -62,7 +62,7 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             return [] unless defined?(Rails.application) && Rails.application
 

data/lib/tapioca/dsl/compilers/active_record_relations.rb

@@ -184,7 +184,7 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             ActiveRecord::Base.descendants.reject(&:abstract_class?)
           end
@@ -229,15 +229,7 @@ module Tapioca
           use_ranges: ["T.untyped", "nil"],
         } #: Hash[Symbol, [String, String]]
         CALCULATION_METHODS = ActiveRecord::Calculations.instance_methods(false) #: Array[Symbol]
-        ENUMERABLE_QUERY_METHODS = [:any?, :many?, :none?, :one?] #: Array[Symbol]
-        FIND_OR_CREATE_METHODS = [
-          :find_or_create_by,
-          :find_or_create_by!,
-          :find_or_initialize_by,
-          :create_or_find_by,
-          :create_or_find_by!,
-        ] #: Array[Symbol]
-        BUILDER_METHODS = [:new, :create, :create!, :build] #: Array[Symbol]
+        RELATION_METHODS = ActiveRecord::Relation.instance_methods(false) #: Array[Symbol]
         TO_ARRAY_METHODS = [:to_ary, :to_a] #: Array[Symbol]
 
         private
@@ -612,47 +604,9 @@ module Tapioca
 
         #: -> void
         def create_association_relation_methods
-          returning_type = "T.nilable(T.any(T::Array[Symbol], FalseClass))"
-          unique_by_type = "T.nilable(T.any(T::Array[Symbol], Symbol))"
-
-          ASSOCIATION_METHODS.each do |method_name|
-            case method_name
-            when :insert_all, :insert_all!, :upsert_all
-              parameters = [
-                create_param("attributes", type: "T::Array[Hash]"),
-                create_kw_opt_param("returning", type: returning_type, default: "nil"),
-              ]
-
-              # Bang methods don't have the `unique_by` parameter
-              unless bang_method?(method_name)
-                parameters << create_kw_opt_param("unique_by", type: unique_by_type, default: "nil")
-              end
-
-              association_relation_methods_module.create_method(
-                method_name.to_s,
-                parameters: parameters,
-                return_type: "ActiveRecord::Result",
-              )
-            when :insert, :insert!, :upsert
-              parameters = [
-                create_param("attributes", type: "Hash"),
-                create_kw_opt_param("returning", type: returning_type, default: "nil"),
-              ]
-
-              # Bang methods don't have the `unique_by` parameter
-              unless bang_method?(method_name)
-                parameters << create_kw_opt_param("unique_by", type: unique_by_type, default: "nil")
-              end
-
-              association_relation_methods_module.create_method(
-                method_name.to_s,
-                parameters: parameters,
-                return_type: "ActiveRecord::Result",
-              )
-            when :proxy_association
-              # skip - private method
-            end
-          end
+          # skips insert/upsert methods - these methods' signatures aren't model-specific and don't need to be generated dynamically
+          # also skips proxy_association method - it's a private method
+          # but there could be other association methods that we need to generate
         end
 
         #: -> void
@@ -907,61 +861,96 @@ module Tapioca
             end
           end
 
-          ENUMERABLE_QUERY_METHODS.each do |method_name|
-            block_type = "T.nilable(T.proc.params(record: #{constant_name}).returns(T.untyped))"
-            create_common_method(
-              method_name,
-              parameters: [
-                create_block_param("block", type: block_type),
-              ],
-              return_type: "T::Boolean",
-            )
-          end
-
-          FIND_OR_CREATE_METHODS.each do |method_name|
-            common_relation_methods_module.create_method(method_name.to_s) do |method|
-              method.add_param("attributes")
-              method.add_block_param("block")
+          RELATION_METHODS.each do |method_name|
+            case method_name
+            when :any?, :many?, :none?, :one? # enumerable query methods
+              block_type = "T.nilable(T.proc.params(record: #{constant_name}).returns(T.untyped))"
+              create_common_method(
+                method_name,
+                parameters: [
+                  create_block_param("block", type: block_type),
+                ],
+                return_type: "T::Boolean",
+              )
+            when :find_or_create_by, :find_or_create_by!, :find_or_initialize_by, :create_or_find_by, :create_or_find_by! # find or create methods
+              common_relation_methods_module.create_method(method_name.to_s) do |method|
+                method.add_param("attributes")
+                method.add_block_param("block")
 
-              # `T.untyped` matches `T::Array[T.untyped]` so the array signature
-              # must be defined first for Sorbet to pick it, if valid.
-              method.add_sig do |sig|
-                sig.add_param("attributes", "T::Array[T.untyped]")
-                sig.add_param("block", "T.nilable(T.proc.params(object: #{constant_name}).void)")
-                sig.return_type = "T::Array[#{constant_name}]"
-              end
+                # `T.untyped` matches `T::Array[T.untyped]` so the array signature
+                # must be defined first for Sorbet to pick it, if valid.
+                method.add_sig do |sig|
+                  sig.add_param("attributes", "T::Array[T.untyped]")
+                  sig.add_param("block", "T.nilable(T.proc.params(object: #{constant_name}).void)")
+                  sig.return_type = "T::Array[#{constant_name}]"
+                end
 
-              method.add_sig do |sig|
-                sig.add_param("attributes", "T.untyped")
-                sig.add_param("block", "T.nilable(T.proc.params(object: #{constant_name}).void)")
-                sig.return_type = constant_name
+                method.add_sig do |sig|
+                  sig.add_param("attributes", "T.untyped")
+                  sig.add_param("block", "T.nilable(T.proc.params(object: #{constant_name}).void)")
+                  sig.return_type = constant_name
+                end
               end
-            end
-          end
-
-          BUILDER_METHODS.each do |method_name|
-            common_relation_methods_module.create_method(method_name.to_s) do |method|
-              method.add_opt_param("attributes", "nil")
-              method.add_block_param("block")
+            when :new, :create, :create!, :build # builder methods
+              common_relation_methods_module.create_method(method_name.to_s) do |method|
+                method.add_opt_param("attributes", "nil")
+                method.add_block_param("block")
 
-              method.add_sig do |sig|
-                sig.add_param("block", "T.nilable(T.proc.params(object: #{constant_name}).void)")
-                sig.return_type = constant_name
-              end
+                method.add_sig do |sig|
+                  sig.add_param("block", "T.nilable(T.proc.params(object: #{constant_name}).void)")
+                  sig.return_type = constant_name
+                end
 
-              # `T.untyped` matches `T::Array[T.untyped]` so the array signature
-              # must be defined first for Sorbet to pick it, if valid.
-              method.add_sig do |sig|
-                sig.add_param("attributes", "T::Array[T.untyped]")
-                sig.add_param("block", "T.nilable(T.proc.params(object: #{constant_name}).void)")
-                sig.return_type = "T::Array[#{constant_name}]"
-              end
+                # `T.untyped` matches `T::Array[T.untyped]` so the array signature
+                # must be defined first for Sorbet to pick it, if valid.
+                method.add_sig do |sig|
+                  sig.add_param("attributes", "T::Array[T.untyped]")
+                  sig.add_param("block", "T.nilable(T.proc.params(object: #{constant_name}).void)")
+                  sig.return_type = "T::Array[#{constant_name}]"
+                end
 
-              method.add_sig do |sig|
-                sig.add_param("attributes", "T.untyped")
-                sig.add_param("block", "T.nilable(T.proc.params(object: #{constant_name}).void)")
-                sig.return_type = constant_name
+                method.add_sig do |sig|
+                  sig.add_param("attributes", "T.untyped")
+                  sig.add_param("block", "T.nilable(T.proc.params(object: #{constant_name}).void)")
+                  sig.return_type = constant_name
+                end
               end
+            when :insert_all, :insert_all!, :upsert_all, :insert, :insert!, :upsert # insert methods
+              # skip - these methods' signatures aren't model-specific and don't need to be generated dynamically
+            when :delete, :destroy
+              # For these cases, it is valid to pass the above kind of things, but also:
+              # - a model identifier, which can be:
+              #   - a numeric id, thus `Integer`
+              #   - a string id, thus `String`
+              # - a collection of identifiers
+              #   - a collection of identifiers, thus `T::Enumerable[T.any(Integer, String)]`
+              # which, coupled with the above case, gives us:
+              #   `T.any(Model, Integer, String, T::Enumerable[T.any(Model, Integer, String, T::Enumerable[Model])])`
+
+              common_relation_methods_module.create_method(
+                method_name.to_s,
+                parameters: [
+                  create_rest_param(
+                    "records",
+                    type: "T.any(#{constant_name}, Integer, String" \
+                      ", T::Enumerable[T.any(#{constant_name}, Integer, String, T::Enumerable[#{constant_name}])])",
+                  ),
+                ],
+                return_type: method_name == :delete ? "Integer" : "T::Array[#{constant_name}]",
+              )
+            when :delete_all, :destroy_all
+              common_relation_methods_module.create_method(
+                method_name.to_s,
+                return_type: method_name == :delete_all ? "Integer" : "T::Array[#{constant_name}]",
+              )
+            when :delete_by, :destroy_by
+              common_relation_methods_module.create_method(
+                method_name.to_s,
+                parameters: [
+                  create_param("args", type: "T.untyped"),
+                ],
+                return_type: method_name == :delete_by ? "Integer" : "T::Array[#{constant_name}]",
+              )
             end
           end
 
@@ -1044,7 +1033,12 @@ module Tapioca
           end
         end
 
-        #: ((Symbol | String) name, ?parameters: Array[RBI::TypedParam], ?relation_return_type: String, ?association_return_type: String) -> void
+        #: (
+        #|   (Symbol | String) name,
+        #|   ?parameters: Array[RBI::TypedParam],
+        #|   ?relation_return_type: String,
+        #|   ?association_return_type: String
+        #| ) -> void
         def create_relation_method(
           name,
           parameters: [],

data/lib/tapioca/dsl/compilers/active_record_scope.rb

@@ -78,7 +78,7 @@ module Tapioca
 
         class << self
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             descendants_of(::ActiveRecord::Base).reject(&:abstract_class?)
           end

data/lib/tapioca/dsl/compilers/active_record_secure_token.rb

@@ -60,7 +60,7 @@ module Tapioca
           extend T::Sig
 
           # @override
-          #: -> T::Enumerable[Module]
+          #: -> Enumerable[T::Module[top]]
           def gather_constants
             descendants_of(::ActiveRecord::Base).reject(&:abstract_class?)
           end