🏷️ Update RBS types

Author: pboling

CHANGELOG.md

@@ -18,10 +18,12 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ## [Unreleased]
 ### Added
+- More RBS types
 ### Changed
 ### Deprecated
 ### Removed
 ### Fixed
+- RBS types are more accurate
 ### Security
 
 ## [1.1.8] 2025-05-06

sig/version_gem.rbs

@@ -1,4 +1,2 @@
 module VersionGem
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
 end

sig/version_gem/api.rbs

@@ -1,33 +1,27 @@
 module VersionGem
   module Api
+    # Internal memoized version string segments
     @_to_a: Array[String]
 
+    # Memoized components
     @major: Integer
-
     @minor: Integer
-
     @patch: Integer
-
     @pre: String?
-
-    @to_a: Array
-
-    @to_h: Hash
-
-    def major: -> Integer
-
-    def minor: -> Integer
-
-    def patch: -> Integer
-
-    def pre: -> String?
-
-    def to_a: -> Array
-
-    def to_h: -> Hash
+    @to_a: Array[Integer | String | nil]
+    @to_h: Hash[Symbol, (Integer | String | nil)]
+
+    # Public API
+    def to_s: () -> String
+    def major: () -> Integer
+    def minor: () -> Integer
+    def patch: () -> Integer
+    def pre: () -> String?
+    def to_a: () -> Array[Integer | String | nil]
+    def to_h: () -> Hash[Symbol, (Integer | String | nil)]
 
     private
 
-    def _to_a: -> Array[String]
+    def _to_a: () -> Array[String]
   end
 end

sig/version_gem/basic.rbs

@@ -1,5 +1,5 @@
 module VersionGem
   module Basic
-    def self.extended: -> void
+    def self.extended: () -> void
   end
 end

sig/version_gem/epoch.rbs

@@ -0,0 +1,26 @@
+module VersionGem
+  module Epoch
+    EPOCH_SIZE: Integer
+
+    # Hook used when this module is extended
+    def self.extended: (untyped) -> void
+
+    module OverloadApiForEpoch
+      # The epoch component (derived)
+      def epoch: () -> Integer
+
+      # Override of Api#major returning the derived major component
+      def major: () -> Integer
+
+      # Hash representation including epoch
+      def to_h: () -> Hash[Symbol, (Integer | String | nil)]
+
+      # Array of components [epoch, major, minor, patch, pre]
+      def to_a: () -> Array[Integer | String | nil]
+
+      private
+
+      def _major: () -> Integer
+    end
+  end
+end

sig/version_gem/error.rbs

@@ -0,0 +1,4 @@
+module VersionGem
+  class Error < ::RuntimeError
+  end
+end

sig/version_gem/ruby.rbs

@@ -1,9 +1,11 @@
 module VersionGem
   module Ruby
-    RUBY_VER: Gem::Version
+    RUBY_VER: ::Gem::Version
 
-    def actual_minor_version?: -> bool
+    # Check if the current Ruby version is >= given version for the engine
+    def self.gte_minimum_version?: (String, ?String) -> bool
 
-    def gte_minimum_version?: -> bool
+    # Check if the current Ruby MAJOR.MINOR equals the given values for the engine
+    def self.actual_minor_version?: ((Integer | String), (Integer | String), ?String) -> bool
   end
 end

sig/version_gem/version.rbs

@@ -1,5 +1,9 @@
 module VersionGem
   module Version
     VERSION: String
+
+    # At runtime this module is extended with Basic via class_eval in lib/version_gem.rb
+    # Declare the intended extension so class methods are available in typing
+    extend VersionGem::Basic
   end
 end