sorbet-runtime 0.6.12689 → 0.6.12798

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5cc2152c2f33be6d199662395074532ccdb451a799d8a656da9e8d2be3387b97
-  data.tar.gz: 387ceabe4a2b8442dee11067283c01d714233a08d0cf74d59d34dc829e451c26
+  metadata.gz: 73a167fb61378c7eb261ccc15d0d1ad2a1ca7a9d9db1816ae74b83d292e6eae1
+  data.tar.gz: de1711647a5c5f7b3f47151f6fd57f761bea91093db902807013c0abe5854c14
 SHA512:
-  metadata.gz: 75917b4cc55be3a4709a87b8fb32e2d27519dddf02f7ae79aa06d4aa5451216b2d42734db26b2e403b875401489960999994cc6b1bd8fea6411c7431b177bfe4
-  data.tar.gz: 58d863a3b062fbb27eba9fe2a6c114447fb7e01e36566035a138d851f6758c657c566ef85d312403275abfd7f23390f99915ca87e0438dd6f5f46ad8e841a042
+  metadata.gz: abbcf8329b9bde8d238df649332083fed79f6175c31204a639d724a48b152614abcf942f9348ba5feb4e123e24957b42d9e36d61786024e641644091e2577c9b
+  data.tar.gz: 58b41fa8cf2452a463bed2ac64007be0e93190b281a4475c96d39c04e3f971c562c32f0a0cae9348a8d8a8fbc567541b4a504a7c116c24eb1f2d4e35ba0ff844

data/lib/sorbet-runtime.rb

@@ -85,6 +85,7 @@ require_relative 'types/boolean'
 
 # Depends on types/utils
 require_relative 'types/types/typed_array'
+require_relative 'types/types/typed_module'
 require_relative 'types/types/typed_class'
 
 # Props dependencies
@@ -114,6 +115,5 @@ require_relative 'types/props/private/parser'
 require_relative 'types/props/generated_code_validation'
 
 require_relative 'types/struct'
-require_relative 'types/non_forcing_constants'
 
 require_relative 'types/compatibility_patches'

data/lib/types/_types.rb

@@ -367,4 +367,16 @@ module T
       end
     end
   end
+
+  module Module
+    def self.[](type)
+      if type.is_a?(T::Types::Untyped)
+        T::Types::TypedModule::Untyped::Private::INSTANCE
+      elsif type.is_a?(T::Types::Anything)
+        T::Types::TypedModule::Anything::Private::INSTANCE
+      else
+        T::Types::TypedModule::Private::Pool.type_for_module(type)
+      end
+    end
+  end
 end

data/lib/types/configuration.rb

@@ -455,7 +455,7 @@ module T::Configuration
 
   # Set to override the default behavior for converting types
   #   to names in generated code. Used by the runtime implementation
-  #   associated with `--stripe-packages` mode.
+  #   associated with `--sorbet-packages` mode.
   #
   # @param [Lambda, Proc, nil] handler Proc that converts a type (Class/Module)
   #   to a String (pass nil to reset to default behavior)

data/lib/types/enum.rb

@@ -273,7 +273,7 @@ class T::Enum
 
   ### Private implementation ###
 
-  UNSET = T.let(Module.new.freeze, Module)
+  UNSET = T.let(Module.new.freeze, T::Module[T.anything])
   private_constant :UNSET
 
   sig { params(serialized_val: SerializedVal).void }

data/lib/types/props/custom_type.rb

@@ -50,7 +50,7 @@ module T::Props
     sig { abstract.params(scalar: T.untyped).returns(T.untyped).checked(:never) }
     def deserialize(scalar); end
 
-    sig { override.params(_base: Module).void }
+    sig { override.params(_base: T::Module[T.anything]).void }
     def self.included(_base)
       super
 

data/lib/types/props/decorator.rb

@@ -13,8 +13,10 @@ class T::Props::Decorator
   Rules = T.type_alias { T::Hash[Symbol, T.untyped] }
   DecoratedInstance = T.type_alias { Object } # Would be T::Props, but that produces circular reference errors in some circumstances
   PropType = T.type_alias { T::Types::Base }
-  PropTypeOrClass = T.type_alias { T.any(PropType, Module) }
+  PropTypeOrClass = T.type_alias { T.any(PropType, T::Module[T.anything]) }
   OverrideRules = T.type_alias { T::Hash[Symbol, {allow_incompatible: T::Boolean}] }
+  DecoratedClassType = T.type_alias { T.all(T::Module[T.anything], T::Props::ClassMethods) }
+  private_constant :DecoratedClassType
 
   class NoRulesError < StandardError; end
 
@@ -38,7 +40,7 @@ class T::Props::Decorator
 
   sig { params(klass: T.untyped).void.checked(:never) }
   def initialize(klass)
-    @class = T.let(klass, T.all(Module, T::Props::ClassMethods))
+    @class = T.let(klass, DecoratedClassType)
     @class.plugins.each do |mod|
       T::Props::Plugin::Private.apply_decorator_methods(mod, self)
     end
@@ -102,7 +104,7 @@ class T::Props::Decorator
   end
 
   # checked(:never) - O(prop accesses)
-  sig { returns(T.all(Module, T::Props::ClassMethods)).checked(:never) }
+  sig { returns(DecoratedClassType).checked(:never) }
   def decorated_class
     @class
   end
@@ -207,7 +209,7 @@ class T::Props::Decorator
     params(
       instance: DecoratedInstance,
       prop: Symbol,
-      foreign_class: Module,
+      foreign_class: T::Module[T.anything],
       rules: Rules,
       opts: T::Hash[Symbol, T.untyped],
     )
@@ -226,7 +228,7 @@ class T::Props::Decorator
   sig do
     params(
       name: Symbol,
-      cls: Module,
+      cls: T::Module[T.anything],
       rules: Rules,
       type: PropTypeOrClass
     )
@@ -277,7 +279,7 @@ class T::Props::Decorator
   end
 
   # This converts the type from a T::Type to a regular old ruby class.
-  sig { params(type: T::Types::Base).returns(Module).checked(:never) }
+  sig { params(type: T::Types::Base).returns(T::Module[T.anything]).checked(:never) }
   private def convert_type_to_class(type)
     case type
     when T::Types::TypedArray, T::Types::FixedArray
@@ -586,7 +588,7 @@ class T::Props::Decorator
   sig do
     params(
       prop_name: Symbol,
-      prop_cls: Module,
+      prop_cls: T::Module[T.anything],
       rules: Rules,
       foreign: T.untyped,
     )
@@ -629,10 +631,10 @@ class T::Props::Decorator
   #
   # This gets called when a module or class that extends T::Props gets included, extended,
   # prepended, or inherited.
-  sig { params(child: Module).void.checked(:never) }
+  sig { params(child: T::Module[T.anything]).void.checked(:never) }
   def model_inherited(child)
     child.extend(T::Props::ClassMethods)
-    child = T.cast(child, T.all(Module, T::Props::ClassMethods))
+    child = T.cast(child, DecoratedClassType)
 
     child.plugins.concat(decorated_class.plugins)
     decorated_class.plugins.each do |mod|
@@ -719,19 +721,19 @@ class T::Props::Decorator
     result
   end
 
-  sig { params(child: T.all(Module, T::Props::ClassMethods), prop: Symbol).returns(T::Boolean).checked(:never) }
+  sig { params(child: DecoratedClassType, prop: Symbol).returns(T::Boolean).checked(:never) }
   private def clobber_getter?(child, prop)
     !!(child.decorator.method(:prop_get).owner != method(:prop_get).owner &&
        child.instance_method(prop).source_location&.first == __FILE__)
   end
 
-  sig { params(child: T.all(Module, T::Props::ClassMethods), prop: Symbol).returns(T::Boolean).checked(:never) }
+  sig { params(child: DecoratedClassType, prop: Symbol).returns(T::Boolean).checked(:never) }
   private def clobber_setter?(child, prop)
     !!(child.decorator.method(:prop_set).owner != method(:prop_set).owner &&
        child.instance_method("#{prop}=").source_location&.first == __FILE__)
   end
 
-  sig { params(mod: Module).void.checked(:never) }
+  sig { params(mod: T::Module[T.anything]).void.checked(:never) }
   def plugin(mod)
     decorated_class.plugins << mod
     T::Props::Plugin::Private.apply_class_methods(mod, decorated_class)

data/lib/types/props/private/apply_default.rb

@@ -27,10 +27,10 @@ module T::Props
       sig { abstract.params(instance: T.all(T::Props::Optional, Object)).void.checked(:never) }
       def set_default(instance); end
 
-      NO_CLONE_TYPES = T.let([TrueClass, FalseClass, NilClass, Symbol, Numeric, T::Enum].freeze, T::Array[Module])
+      NO_CLONE_TYPES = T.let([TrueClass, FalseClass, NilClass, Symbol, Numeric, T::Enum].freeze, T::Array[T::Module[T.anything]])
 
       # checked(:never) - Rules hash is expensive to check
-      sig { params(cls: Module, rules: T::Hash[Symbol, T.untyped]).returns(T.nilable(ApplyDefault)).checked(:never) }
+      sig { params(cls: T::Module[T.anything], rules: T::Hash[Symbol, T.untyped]).returns(T.nilable(ApplyDefault)).checked(:never) }
       def self.for(cls, rules)
         accessor_key = rules.fetch(:accessor_key)
         setter = rules.fetch(:setter_proc)
@@ -138,7 +138,7 @@ module T::Props
       # checked(:never) - We do this with `T.let` instead
       sig do
         params(
-          cls: Module,
+          cls: T::Module[T.anything],
           factory: T.any(Proc, Method),
           accessor_key: Symbol,
           setter_proc: SetterFactory::SetterProc,
@@ -147,7 +147,7 @@ module T::Props
         .checked(:never)
       end
       def initialize(cls, factory, accessor_key, setter_proc)
-        @class = T.let(cls, Module)
+        @class = T.let(cls, T::Module[T.anything])
         @factory = T.let(factory, T.any(Proc, Method))
         super(accessor_key, setter_proc)
       end

data/lib/types/props/private/serde_transform.rb

@@ -20,7 +20,7 @@ module T::Props
 
       NO_TRANSFORM_TYPES = T.let(
         [TrueClass, FalseClass, NilClass, Symbol, String].freeze,
-        T::Array[Module],
+        T::Array[T::Module[T.anything]],
       )
       private_constant :NO_TRANSFORM_TYPES
 
@@ -151,7 +151,7 @@ module T::Props
         end
       end
 
-      sig { params(varname: String, type: Module, mode: ModeType).returns(String).checked(:never) }
+      sig { params(varname: String, type: T::Module[T.anything], mode: ModeType).returns(String).checked(:never) }
       private_class_method def self.handle_serializable_subtype(varname, type, mode)
         case mode
         when Serialize
@@ -164,7 +164,7 @@ module T::Props
         end
       end
 
-      sig { params(varname: String, type: Module, mode: ModeType).returns(String).checked(:never) }
+      sig { params(varname: String, type: T::Module[T.anything], mode: ModeType).returns(String).checked(:never) }
       private_class_method def self.handle_custom_type(varname, type, mode)
         case mode
         when Serialize
@@ -177,7 +177,7 @@ module T::Props
         end
       end
 
-      sig { params(type: Module).returns(T.nilable(String)).checked(:never) }
+      sig { params(type: T::Module[T.anything]).returns(T.nilable(String)).checked(:never) }
       private_class_method def self.module_name(type)
         T::Configuration.module_name_mangler.call(type)
       end

data/lib/types/props/private/setter_factory.rb

@@ -12,7 +12,7 @@ module T::Props
 
       sig do
         params(
-          klass: T.all(Module, T::Props::ClassMethods),
+          klass: T.all(T::Module[T.anything], T::Props::ClassMethods),
           prop: Symbol,
           rules: T::Hash[Symbol, T.untyped]
         )
@@ -53,8 +53,8 @@ module T::Props
         params(
           prop: Symbol,
           accessor_key: Symbol,
-          non_nil_type: Module,
-          klass: T.all(Module, T::Props::ClassMethods),
+          non_nil_type: T::Module[T.anything],
+          klass: T.all(T::Module[T.anything], T::Props::ClassMethods),
         )
         .returns([SetterProc, ValueValidationProc])
       end
@@ -89,7 +89,7 @@ module T::Props
           prop: Symbol,
           accessor_key: Symbol,
           non_nil_type: T::Types::Base,
-          klass: T.all(Module, T::Props::ClassMethods),
+          klass: T.all(T::Module[T.anything], T::Props::ClassMethods),
           validate: T.nilable(ValidateProc)
         )
         .returns([SetterProc, ValueValidationProc])
@@ -138,8 +138,8 @@ module T::Props
         params(
           prop: Symbol,
           accessor_key: Symbol,
-          non_nil_type: Module,
-          klass: T.all(Module, T::Props::ClassMethods),
+          non_nil_type: T::Module[T.anything],
+          klass: T.all(T::Module[T.anything], T::Props::ClassMethods),
         )
         .returns([SetterProc, ValueValidationProc])
       end
@@ -174,7 +174,7 @@ module T::Props
           prop: Symbol,
           accessor_key: Symbol,
           non_nil_type: T::Types::Base,
-          klass: T.all(Module, T::Props::ClassMethods),
+          klass: T.all(T::Module[T.anything], T::Props::ClassMethods),
           validate: T.nilable(ValidateProc),
         )
         .returns([SetterProc, ValueValidationProc])
@@ -225,9 +225,9 @@ module T::Props
 
       sig do
         params(
-          klass: T.all(Module, T::Props::ClassMethods),
+          klass: T.all(T::Module[T.anything], T::Props::ClassMethods),
           prop: Symbol,
-          type: T.any(T::Types::Base, Module),
+          type: T.any(T::Types::Base, T::Module[T.anything]),
           val: T.untyped,
         )
         .void

data/lib/types/props/type_validation.rb

@@ -20,9 +20,9 @@ module T::Props::TypeValidation
     sig do
       params(
         name: T.any(Symbol, String),
-        _cls: Module,
+        _cls: T::Module[T.anything],
         rules: T::Hash[Symbol, T.untyped],
-        type: T.any(T::Types::Base, Module)
+        type: T.any(T::Types::Base, T::Module[T.anything])
       )
       .void
       .checked(:never)

data/lib/types/types/class_of.rb

@@ -31,7 +31,7 @@ module T::Types
         @type.is_a?(other.type.singleton_class)
       when Simple
         @type.is_a?(other.raw_type)
-      when TypedClass
+      when TypedClass, TypedModule
         @type.is_a?(other.underlying_class)
       else
         false

data/lib/types/types/simple.rb

@@ -41,7 +41,7 @@ module T::Types
       case other
       when Simple
         @raw_type <= other.raw_type
-      when TypedClass
+      when TypedClass, TypedModule
         # This case is a bit odd--we would have liked to solve this like we do
         # for `T::Array` et al., but don't for backwards compatibility.
         # See `type_for_module` below.
@@ -103,9 +103,9 @@ module T::Types
           elsif !Object.autoload?(:Set) && Object.const_defined?(:Set) && mod == ::Set
             T::Set[T.untyped]
           else
-            # ideally we would have a case mapping from ::Class -> T::Class here
-            # but for backwards compatibility we don't have that, and instead
-            # have a special case in subtype_of_single?
+            # ideally we would have a case mapping from ::Class -> T::Class and
+            # ::Module -> T::Module here but for backwards compatibility we
+            # don't have that, and instead have a special case in subtype_of_single?
             Simple.new(mod)
           end
 

data/lib/types/types/typed_class.rb

@@ -33,7 +33,7 @@ module T::Types
     # overrides Base
     private def subtype_of_single?(type)
       case type
-      when TypedClass
+      when TypedClass, TypedModule
         # treat like generics are erased
         true
       when Simple

data/lib/types/types/typed_module.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+# typed: true
+
+module T::Types
+  class TypedModule < T::Types::Base
+    def initialize(type)
+      @inner_type = type
+    end
+
+    def type
+      @type ||= T::Utils.coerce(@inner_type)
+    end
+
+    def build_type
+      type
+      nil
+    end
+
+    # overrides Base
+    def name
+      "T::Module[#{type.name}]"
+    end
+
+    def underlying_class
+      Module
+    end
+
+    # overrides Base
+    def valid?(obj)
+      Module.===(obj)
+    end
+
+    # overrides Base
+    private def subtype_of_single?(type)
+      case type
+      when TypedModule
+        # treat like generics are erased
+        true
+      when Simple
+        Module <= type.raw_type
+      else
+        false
+      end
+    end
+
+    module Private
+      module Pool
+        CACHE_FROZEN_OBJECTS =
+          begin
+            ObjectSpace::WeakMap.new[1] = 1
+            true # Ruby 2.7 and newer
+          rescue ArgumentError
+            false # Ruby 2.6 and older
+          end
+
+        @cache = ObjectSpace::WeakMap.new
+
+        def self.type_for_module(mod)
+          cached = @cache[mod]
+          return cached if cached
+
+          type = TypedModule.new(mod)
+
+          if CACHE_FROZEN_OBJECTS || (!mod.frozen? && !type.frozen?)
+            @cache[mod] = type
+          end
+          type
+        end
+      end
+    end
+
+    class Untyped < TypedModule
+      def initialize
+        super(T::Types::Untyped::Private::INSTANCE)
+      end
+
+      def freeze
+        build_type # force lazy initialization before freezing the object
+        super
+      end
+
+      module Private
+        INSTANCE = Untyped.new.freeze
+      end
+    end
+
+    class Anything < TypedModule
+      def initialize
+        super(T.anything)
+      end
+
+      def freeze
+        build_type # force lazy initialization before freezing the object
+        super
+      end
+
+      module Private
+        INSTANCE = Anything.new.freeze
+      end
+    end
+  end
+end

data/lib/types/types/typed_set.rb

@@ -14,7 +14,6 @@ module T::Types
 
     # overrides Base
     def recursively_valid?(obj)
-      # Re-implements non_forcing_is_a?
       return false if Object.autoload?(:Set) # Set is meant to be autoloaded but not yet loaded, this value can't be a Set
       return false unless Object.const_defined?(:Set) # Set is not loaded yet
       obj.is_a?(Set) && super
@@ -22,7 +21,6 @@ module T::Types
 
     # overrides Base
     def valid?(obj)
-      # Re-implements non_forcing_is_a?
       return false if Object.autoload?(:Set) # Set is meant to be autoloaded but not yet loaded, this value can't be a Set
       return false unless Object.const_defined?(:Set) # Set is not loaded yet
       obj.is_a?(Set)
@@ -41,7 +39,6 @@ module T::Types
       end
 
       def valid?(obj)
-        # Re-implements non_forcing_is_a?
         return false if Object.autoload?(:Set) # Set is meant to be autoloaded but not yet loaded, this value can't be a Set
         return false unless Object.const_defined?(:Set) # Set is not loaded yet
         obj.is_a?(Set)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sorbet-runtime
 version: !ruby/object:Gem::Version
-  version: 0.6.12689
+  version: 0.6.12798
 platform: ruby
 authors:
 - Stripe
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-10-31 00:00:00.000000000 Z
+date: 2025-11-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -165,7 +165,6 @@ files:
 - lib/types/enum.rb
 - lib/types/generic.rb
 - lib/types/helpers.rb
-- lib/types/non_forcing_constants.rb
 - lib/types/private/abstract/data.rb
 - lib/types/private/abstract/declare.rb
 - lib/types/private/abstract/hooks.rb
@@ -237,6 +236,7 @@ files:
 - lib/types/types/typed_enumerator_chain.rb
 - lib/types/types/typed_enumerator_lazy.rb
 - lib/types/types/typed_hash.rb
+- lib/types/types/typed_module.rb
 - lib/types/types/typed_range.rb
 - lib/types/types/typed_set.rb
 - lib/types/types/union.rb

data/lib/types/non_forcing_constants.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-# typed: strict
-
-module T::NonForcingConstants
-  # NOTE: This method is documented on the RBI in Sorbet's payload, so that it
-  # shows up in the hover/completion documentation via LSP.
-  T::Sig::WithoutRuntime.sig { params(val: BasicObject, klass: String).returns(T::Boolean) }
-  def self.non_forcing_is_a?(val, klass)
-    method_name = "T::NonForcingConstants.non_forcing_is_a?"
-    if klass.empty?
-      raise ArgumentError.new("The string given to `#{method_name}` must not be empty")
-    end
-
-    current_klass = T.let(nil, T.nilable(Module))
-    current_prefix = T.let(nil, T.nilable(String))
-
-    parts = klass.split('::')
-    parts.each do |part|
-      if current_klass.nil?
-        # First iteration
-        if part != ""
-          raise ArgumentError.new("The string given to `#{method_name}` must be an absolute constant reference that starts with `::`")
-        end
-
-        current_klass = Object
-        current_prefix = ''
-
-        # if this had a :: prefix, then there's no more loading to
-        # do---skip to the next one
-        next
-      end
-
-      if current_klass.autoload?(part)
-        # There's an autoload registered for that constant, which means it's not
-        # yet loaded. `value` can't be an instance of something not yet loaded.
-        return false
-      end
-
-      # Sorbet guarantees that the string is an absolutely resolved name.
-      search_inheritance_chain = false
-      if !current_klass.const_defined?(part, search_inheritance_chain)
-        return false
-      end
-
-      current_klass = current_klass.const_get(part)
-      current_prefix = "#{current_prefix}::#{part}"
-
-      if !Module.===(current_klass)
-        raise ArgumentError.new("#{current_prefix} is not a class or module")
-      end
-    end
-
-    current_klass.===(val)
-  end
-end