onboardable 1.4.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9b6bddf9e6bd140af8b288a658222c3742ce07f6b9f2585716ba28e9c24a1097
-  data.tar.gz: '09a2c6fe377f80a33e1fbff274c9e05cfa6c907ae3661def938b961bf1afe181'
+  metadata.gz: 8f24682a34d8f84cf2eba4bdf9e69734bfa4788c7937d1b8b90b05456985b27b
+  data.tar.gz: c18c2ec8f27809b239c7ca8059522923bc511b3aebafaf732cc611244549d463
 SHA512:
-  metadata.gz: '0379a520c2bb0699772c500866924497fb6ab89ffacbb93d3e7b34b0fac3f614ae899d8ab5bff49a9189d6c46f3d37fe1c7e557c95c9929d2205c03530edc63c'
-  data.tar.gz: ce3d1feaca082deedc5dbf4d20fb56663ec403d3614e35e35c1ebb21b237864bde9599da46e8ff0e16a7d03164253fea878c9f736afc0631bba982a706b25200
+  metadata.gz: e443300f42828683e075ec62377ff4d3d43663c8c4e8609f9f17baf89b06b71c84fdda673939fa4fd86f487f192b7c6d65028b389cd790f3c196f6d8ad62e0a8
+  data.tar.gz: b8f14acd58e53891ef6de0f0c0b65181a354904ff27fd77940072641c680980ba99539012b12add6ae4395f42087416ed9f174b04168c12df6a0483414fd4f22

data/CHANGELOG.md

@@ -1,65 +1,72 @@
 # CHANGELOG
 
-## [Unreleased]
+## 1.6.0
 
-## [1.4.0] - 2025-04-01
+- Add support for Ruby 4.0.
+
+## 1.5.0
+
+- Drop support for Ruby 3.1.
+- Update development dependencies to their latest versions.
+
+## 1.4.0
 
 - Add support for Ruby 3.4.
 - Drop support for Ruby 3.0.
 
-## [1.3.3] - 2024-08-16
+## 1.3.3
 
 - Updated rbs files to improve type-checking.
 - Added github-actions package ecosystem to the development workflow.
 
-## [1.3.2] - 2024-07-10
+## 1.3.2
 
 - Added adjustments to rbs files to improve type-checking.
 
-## [1.3.1] - 2024-06-10
+## 1.3.1
 
 - Fixed the issue with the custom formula calculation.
 
-## [1.3.0] - 2024-06-10
+## 1.3.0
 
-- Added option to calculate onboarding progress using a custom formula.
+- Added an option to calculate onboarding progress using a custom formula.
 
-## [1.2.2] - 2024-06-03
+## 1.2.2
 
 - Fixed the issue with the default `#current_step` method.
 
-## [1.2.1] - 2024-06-01
+## 1.2.1
 
 - Added trusted publisher
 
-## [1.2.0] - 2024-05-25
+## 1.2.0
 
 - Added `#second_step?` method to check if the target step is the second step.
 - Added `#prev_step?` method to check if the target step is the previous step.
 - Added `#current_step?` method to check if the target step is the current step.
 
-## [1.1.1] - 2024-05-21
+## 1.1.1
 
 - Added `onboarding` class method to define the onboarding steps.
 - Added [documentation link](https://rubydoc.info/gems/onboardable) to gemspec.
 
-## [1.1.0] - 2024-05-21
+## 1.1.0
 
 - Introduced `step_from` method for adding steps from external sources.
 - Added warn_about_override method to alert on step overrides.
 - Added YARD documentation to the project for improved code documentation.
 
-## [1.0.1] - 2024-05-09
+## 1.0.1
 
 - Added `first_step` and `last_step` methods to easily access
   the boundaries of step lists.
 - Added `progress` method for calculating onboarding completion percentage.
 
-## [1.0.0] - 2024-05-08
+## 1.0.0
 
 - Enhanced `first_step?` and `last_step?` methods to accept an optional argument,
   improving flexibility by allowing checks against any specified step.
 
-## [0.1.0] - 2024-05-07
+## 0.1.0
 
 - Initial release

data/Gemfile.lock

@@ -1,40 +1,40 @@
 PATH
   remote: .
   specs:
-    onboardable (1.4.0)
+    onboardable (1.6.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.3)
-    diff-lcs (1.6.1)
+    diff-lcs (1.6.2)
     docile (1.4.1)
-    json (2.10.2)
-    language_server-protocol (3.17.0.4)
+    json (2.18.0)
+    language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
-    parallel (1.26.3)
-    parser (3.3.7.4)
+    parallel (1.27.0)
+    parser (3.3.10.0)
       ast (~> 2.4.1)
       racc
-    prism (1.4.0)
+    prism (1.7.0)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.2.1)
-    regexp_parser (2.10.0)
-    rspec (3.13.0)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rspec (3.13.2)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.3)
+    rspec-core (3.13.6)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.3)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.2)
+    rspec-mocks (3.13.6)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.2)
-    rubocop (1.75.1)
+    rspec-support (3.13.6)
+    rubocop (1.82.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -42,22 +42,22 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.43.0, < 2.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.43.0)
+    rubocop-ast (1.48.0)
       parser (>= 3.3.7.2)
       prism (~> 1.4)
-    rubocop-performance (1.25.0)
+    rubocop-performance (1.26.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.75.0, < 2.0)
-      rubocop-ast (>= 1.38.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
-    rubocop-rspec (3.5.0)
+    rubocop-rspec (3.8.0)
       lint_roller (~> 1.1)
-      rubocop (~> 1.72, >= 1.72.1)
+      rubocop (~> 1.81)
     ruby-progressbar (1.13.0)
     simplecov (0.22.0)
       docile (~> 1.1)
@@ -65,12 +65,17 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.1)
     simplecov_json_formatter (0.1.4)
-    unicode-display_width (3.1.4)
-      unicode-emoji (~> 4.0, >= 4.0.4)
-    unicode-emoji (4.0.4)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    yard (0.9.38)
+    yard-lint (1.3.0)
+      yard (~> 0.9)
+      zeitwerk (~> 2.6)
+    zeitwerk (2.7.4)
 
 PLATFORMS
-  x86_64-darwin-23
+  x86_64-darwin-25
   x86_64-linux
 
 DEPENDENCIES
@@ -82,6 +87,7 @@ DEPENDENCIES
   rubocop-rake (~> 0.7.1)
   rubocop-rspec (~> 3.0, >= 3.0.4)
   simplecov (~> 0.22.0)
+  yard-lint (~> 1.2, >= 1.2.3)
 
 BUNDLED WITH
-   2.6.6
+  4.0.3

data/README.md

@@ -65,7 +65,7 @@ could be included in the documentation. This guide covers initialization,
 navigation, step verification, and completion of the onboarding process.
 
 After defining and accessing the onboarding steps as described
-earlier, managed the onboarding process through various controls
+earlier, manage the onboarding process through various controls
 that allow step navigation and state verification:
 
 1. **Initialize Onboarding Process**
@@ -91,16 +91,16 @@ that allow step navigation and state verification:
      onboarding = builder.build
      ```
 
-1. **Check the order of steps**
+2. **Check the order of steps**
 
    Determine the order of steps in the onboarding process to ensure
    that the sequence is correct and that the steps are defined as expected.
 
    ```ruby
-   onboarding.steps # Returns the list of steps
+   onboarding.steps
    ```
 
-1. **Navigating Through Steps**
+3. **Navigating Through Steps**
 
    Navigate through the onboarding steps using the navigation methods provided.
    These methods help in moving forward and backward through the onboarding process.
@@ -111,8 +111,8 @@ that allow step navigation and state verification:
       what's next or advance to it, updating the current step status.
 
       ```ruby
-      onboarding.next_step  # Preview the next step
-      onboarding.next_step! # Advance to the next step
+      onboarding.next_step
+      onboarding.next_step!
       ```
 
    - **Previous Step**
@@ -121,32 +121,32 @@ that allow step navigation and state verification:
      making changes or updates to revert to the previous step.
 
      ```ruby
-     onboarding.prev_step  # Preview the previous step
-     onboarding.prev_step! # Move back to the previous step
+     onboarding.prev_step
+     onboarding.prev_step!
      ```
 
-1. **Check Step Position**
+4. **Check Step Position**
 
    Determine whether the current step is the first or the last in the sequence
    to manage UI elements like 'Next' or 'Back' buttons appropriately.
 
    ```ruby
-   step = onboarding.steps.sample # Random step from the list
+   step = onboarding.steps.sample
 
-   onboarding.first_step?(step)   # Is the first step?
-   onboarding.last_step?(step)    # Is the last step?
-   onboarding.current_step?(step) # Is the current step?
-   onboarding.second_step?(step)  # Is the second step?
-   onboarding.prev_step?(step)    # Is the previous step?
+   onboarding.first_step?(step)
+   onboarding.last_step?(step)
+   onboarding.current_step?(step)
+   onboarding.second_step?(step)
+   onboarding.prev_step?(step)
    ```
 
-1. **Monitor Progress**
+5. **Monitor Progress**
 
    - Calculate the progress or completion percentage of the onboarding process
      to provide users with an indication of how far they have progressed.
 
      ```ruby
-     onboarding.progress # Returns the completion percentage
+     onboarding.progress
      ```
 
    - To customize the progress calculation formula, define a lambda function
@@ -172,20 +172,20 @@ that allow step navigation and state verification:
      end
      ```
 
-1. **Access Current Step Details**
+6. **Access Current Step Details**
 
    Retrieve details about the current step, which can include the name,
    custom data, and status, to display appropriate information or help
-   the user completes tasks associated with the step.
+   the user understand their current position in the onboarding process.
 
    ```ruby
-   onboarding.current_step        # Current step details
-   onboarding.current_step.name   # Step name
-   onboarding.current_step.data   # Step custom data
-   onboarding.current_step.status # Step status
+   onboarding.current_step
+   onboarding.current_step.name
+   onboarding.current_step.data
+   onboarding.current_step.status
    ```
 
-1. **Complete the Onboarding Process**
+7. **Complete the Onboarding Process**
 
    Once the user reaches the last step and completes it, finalize the
    onboarding process, which might involve setting a user attribute to
@@ -200,12 +200,12 @@ that allow step navigation and state verification:
    # Exception Handling Approach
    begin
      onboarding.next_step!
-   rescue LastStepError
+   rescue Onboardable::LastStepError
      # Implement finalization processes like updating user attributes
    end
    ```
 
-1. **Exit the Onboarding Process Early**
+8. **Exit the Onboarding Process Early**
 
    Handle cases where a user decides to discontinue the onboarding
    by attempting to navigate back from the initial step.
@@ -219,7 +219,7 @@ that allow step navigation and state verification:
    # Exception Handling Approach
    begin
      onboarding.prev_step!
-   rescue FirstStepError
+   rescue Onboardable::FirstStepError
      # Implement cleanup or final actions for an orderly exit
    end
    ```
@@ -230,13 +230,13 @@ user-friendly onboarding process using the Onboardable gem.
 ## 🛠 Development
 
 1. After checking out the repo, run `bin/setup` to install dependencies.
-1. Then, run `rake spec` to run the tests.
-1. Also run `bin/console` for an interactive prompt that will allow you to experiment.
-1. To install this gem onto your local machine, run `bundle exec rake install`.
-1. To release a new version, update the version number in `version.rb`.
-1. After, run `bundle exec rake release`, which will create a git tag for the version.
-1. Push git commits and the created tag.
-1. Then push the `.gem` file to [rubygems.org](https://rubygems.org).
+2. Then, run `rake spec` to run the tests.
+3. Also run `bin/console` for an interactive prompt that will allow you to experiment.
+4. To install this gem onto your local machine, run `bundle exec rake install`.
+5. To release a new version, update the version number in `version.rb`.
+6. After, run `bundle exec rake release`, which will create a git tag for the version.
+7. Push git commits and the created tag.
+8. Then push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## 🤝 Contributing
 
@@ -250,5 +250,5 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## 📜 Code of Conduct
 
-Everyone interacting in the Onboardable project's codebases, issue trackers,
-chat rooms and mailing lists are expected to follow the [code of conduct](https://github.com/dmrAnderson/onboardable/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting with the Onboardable project's codebases, issue trackers,
+chat rooms, and mailing lists are expected to follow the [code of conduct](https://github.com/dmrAnderson/onboardable/blob/main/CODE_OF_CONDUCT.md).

data/lib/onboardable/errors.rb

@@ -20,7 +20,7 @@ module Onboardable
     # Initializes a new instance of StepConversionError.
     #
     # @param klass [Class] The class that failed to convert.
-    # @param step [unknown] The object that was attempted to be converted to a Step.
+    # @param step [Object] The object that was attempted to be converted to a Step.
     def initialize(klass, step)
       super("Can't convert #{klass} to Step (#{klass}#to_onboarding_step gives #{step.class}).")
     end

data/lib/onboardable/list/base.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
 module Onboardable
+  # The List module encapsulates functionality for managing a sequence of onboarding steps.
   module List
     # The List class manages a sequence of steps in an onboarding process, tracking progress and current state.
     class Base
       include Navigation
 
+      # Default calculation for onboarding progress as a percentage.
       PROGRESS_CALCULATION = ->(step_index, steps_size) { (step_index.to_f / steps_size) * 100 }
 
       # @return [Array<Step>] The steps in the list.
@@ -14,11 +16,13 @@ module Onboardable
       # @return [Step] The current step in the list.
       attr_reader :current_step
 
-      # Initializes a new instance of List with steps and a current step.
+      # Initializes a new instance of the List with steps and a current step.
       #
       # @param steps [Array<Step>] An array of steps comprising the onboarding process.
       # @param current_step [Step] The step currently active in the process.
-      # @param options [Hash] An options hash for the list.
+      # @param options [Hash] Optional parameters for configuring the list.
+      # @option options [Proc] :progress_calculation A custom calculation for progress percentage.
+      #   Receives step_index and steps_size as arguments and returns a Float.
       def initialize(steps, current_step, options = {})
         self.steps = steps
         self.current_step = current_step
@@ -39,7 +43,7 @@ module Onboardable
       # @return [Hash] The options hash for the list.
       attr_reader :options
 
-      # Sets and validates the steps array, ensuring it is an Array of Step objects.
+      # Sets and validates an array of steps.
       #
       # @param steps [Array<Step>] The steps to be assigned to the list.
       # @return [Array<Step>] The assigned steps.
@@ -58,9 +62,11 @@ module Onboardable
         end
       end
 
-      # Sets and validates the options hash, ensuring it is a Hash object.
+      # Sets and validates options for the list.
       #
       # @param options [Hash] The options to be assigned to the list.
+      # @option options [Proc] :progress_calculation A custom calculation for progress percentage.
+      #   Receives step_index and steps_size as arguments and returns a Float.
       # @return [Hash] The assigned options.
       def options=(options)
         @options = Hash(options).transform_keys(&:to_sym).freeze

data/lib/onboardable/list/builder.rb

@@ -6,6 +6,7 @@ module Onboardable
     class Builder
       include Utils::Warnings
 
+      # Key used to store steps in the options hash.
       STEP_KEY = :steps
 
       # Stores the steps added to the builder.
@@ -19,6 +20,10 @@ module Onboardable
       attr_accessor :current_step
 
       # Initializes a new instance of ListBuilder.
+      #
+      # @param options [Hash] Options to be set for the builder.
+      # @option options [Proc] :progress_calculation A custom calculation for progress percentage.
+      #   Receives step_index and steps_size as arguments and returns a Float.
       def initialize(options = {})
         self.options = options
       end
@@ -59,9 +64,11 @@ module Onboardable
       # @return [Hash] The options hash for the builder.
       attr_reader :options
 
-      # Sets the options hash for the builder.
+      # Sets options hash for the builder.
       #
-      # @param options [Hash] The options hash to be set.
+      # @param options [Hash] Options to be set for the builder.
+      # @option options [Proc] :progress_calculation A custom calculation for progress percentage.
+      #   Receives step_index and steps_size as arguments and returns a Float.
       def options=(options)
         @options = Hash(options).except(STEP_KEY)
       end
@@ -91,7 +98,7 @@ module Onboardable
       #
       # @param name [String] The name of the step to be converted to a Step object.
       # @return [Step] The corresponding Step object.
-      # @raise [StepError] Raises if the specified step name is not present in the steps hash.
+      # @raise [StepError] Raises if the specified step name is not present in steps hash.
       def convert_to_step!(name)
         steps[name] || raise(StepError.new(name, steps.keys))
       end

data/lib/onboardable/step.rb

@@ -3,21 +3,27 @@
 module Onboardable
   # Represents a single step within an onboarding process, including its status and associated data.
   class Step
+    # Method name used for converting a class to a Step object.
     CONVERSION_METHOD = :to_onboarding_step
 
+    # The step is pending and has not yet been started.
     PENDING_STATUS = :pending
+    # The step is currently in progress.
     CURRENT_STATUS = :current
+    # The step has been completed.
     COMPLETED_STATUS = :completed
 
+    # The default status for a new step.
     DEFAULT_STATUS = PENDING_STATUS
 
+    # All valid statuses for a step.
     STATUSES = [PENDING_STATUS, CURRENT_STATUS, COMPLETED_STATUS].freeze
 
     class << self
       # Attempts to convert a class to a Step object using a specified conversion method.
       #
-      # @param klass [Class] The class to convert to a Step
-      # @return [Step, nil] The converted Step object, or nil if the class does not respond to the conversion method
+      # @param klass [Class] The class to convert to a Step.
+      # @return [Step, nil] The converted Step object, or nil if the class does not respond to the conversion method.
       def try_convert(klass)
         return unless klass.respond_to?(CONVERSION_METHOD)
 
@@ -30,26 +36,27 @@ module Onboardable
 
       # Raises an error for a failed conversion attempt.
       #
-      # @param klass [Class] The class that failed to convert
-      # @raise [StepConversionError] Raises an error for a failed conversion attempt
+      # @param klass [Class] The class that failed to convert.
+      # @param step [Object] The invalid object returned from the conversion method.
+      # @raise [StepConversionError] Raises an error for a failed conversion attempt.
       def conversion_error!(klass, step)
         raise StepConversionError.new(klass, step)
       end
     end
 
-    # @return [String] The name of the step
+    # @return [String] The name of the step.
     attr_reader :name
 
-    # @return [Hash] Custom data associated with the step
+    # @return [Hash] Custom data associated with the step.
     attr_reader :data
 
-    # @return [Symbol] The current status of the step
+    # @return [Symbol] The current status of the step.
     attr_reader :status
 
     # Initializes a new Step with a name, optional custom data, and a default status.
     #
-    # @param name [String] The name of the step
-    # @param data [Hash] The custom data associated with the step, defaults to an empty hash
+    # @param name [String] The name of the step.
+    # @param data [Hash] The custom data associated with the step.
     def initialize(name, data = {})
       self.name = name
       self.data = data
@@ -79,43 +86,44 @@ module Onboardable
 
     # Compares this step to another to determine if they are equivalent, based on the step name.
     #
-    # @param other [Step] The step to compare with
-    # @return [Boolean] True if both steps have the same name, false otherwise
+    # @param other [Step] The step to compare with.
+    # @return [Boolean] True if both steps have the same name, false otherwise.
     def ==(other)
       to_str == other.to_str
     end
 
     # Provides a string representation of the step, using its name.
     #
-    # @return [String] The name of the step
+    # @return [String] The name of the step.
     def to_str
       name
     end
 
     # Updates the status of the step based on a specified comparison result.
     #
-    # @param comparison_result [Integer] The result of a comparison with the current step (-1, 0, or 1)
-    # @return [Symbol] The new status of the step
+    # @param comparison_result [Integer] The result of a comparison operation.
+    # @return [Symbol] The new status of the step.
     def update_status!(comparison_result)
       self.status = case comparison_result
                     when -1 then COMPLETED_STATUS
                     when 0 then CURRENT_STATUS
                     when 1 then PENDING_STATUS
-                    else comparison_result_error!(comparison_result); end
+                    else comparison_result_error!(comparison_result)
+                    end
     end
 
     private
 
     # Sets the name of the step, ensuring it is a valid String.
     #
-    # @param name [String] The raw name of the step
+    # @param name [String] The raw name of the step.
     def name=(name)
       @name = String.new(name).freeze
     end
 
     # Sets the status of the step.
     #
-    # @param status [Symbol] The new status of the step
+    # @param status [Symbol] The new status of the step.
     def status=(status)
       STATUSES.include?(status) || raise(StepStatusError.new(status, STATUSES))
 
@@ -124,15 +132,15 @@ module Onboardable
 
     # Sets the custom data for the step, ensuring it is a valid Hash.
     #
-    # @param data [Hash] The raw custom data
+    # @param data [Hash] The raw custom data.
     def data=(data)
       @data = Hash(data).freeze
     end
 
     # Raises an error for an invalid comparison result.
     #
-    # @param comparison_result [Integer] The invalid comparison result
-    # @raise [ComparisonResultError] Raises an error for an invalid comparison result
+    # @param comparison_result [Integer] The invalid comparison result.
+    # @raise [ComparisonResultError] Raises an error for an invalid comparison result.
     def comparison_result_error!(comparison_result)
       raise ComparisonResultError.new(comparison_result, (-1..1).to_a)
     end

data/lib/onboardable/utils/warnings.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Onboardable
+  # The Utils module contains utility classes and modules for the Onboardable namespace.
   module Utils
     # The Warnings module provides utility methods for issuing warnings.
     module Warnings

data/lib/onboardable/version.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
 module Onboardable
-  VERSION = '1.4.0'
+  # The version of the Onboardable gem.
+  VERSION = '1.6.0'
 end

data/lib/onboardable.rb

@@ -13,7 +13,7 @@ module Onboardable
   # Initializes the Onboardable module when included in a class, extending it with class and instance methods.
   #
   # @param klass [Module] The class including the Onboardable module
-  # @return [untyped] The class including the Onboardable module.
+  # @return [void]
   def self.included(klass)
     klass.extend ClassMethods
     klass.include InstanceMethods
@@ -27,6 +27,8 @@ module Onboardable
     # Configures onboarding steps via a ListBuilder with a provided block.
     #
     # @param options [Hash] Optional configuration options for the ListBuilder.
+    # @option options [Proc] :progress_calculation A custom calculation for progress percentage.
+    #   Receives step_index and steps_size as arguments and returns a Float.
     # @yield [List::Builder] Executes block in the context of List::Builder.
     # @return [Step] The current step in the building process.
     def onboarding=(options = {}, &)

data/onboardable.gemspec

@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
   spec.description = 'Provides tools for easy setup of custom onboarding to boost engagement.'
   spec.homepage = 'https://github.com/dmrAnderson/onboardable'
   spec.license = 'MIT'
-  spec.required_ruby_version = '>= 3.1.0'
+  spec.required_ruby_version = '>= 3.2.0'
 
   # spec.metadata["allowed_push_host"] = "TODO: Set to your gem server 'https://example.com'"
 
@@ -26,7 +26,7 @@ Gem::Specification.new do |spec|
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(__dir__) do
     `git ls-files -z`.split("\x0").reject do |f|
-      (f == __FILE__) || f.match(%r{\A(?:(?:bin|spec)/|\.(?:git|rspec|rubocop))})
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|spec)/|\.(?:git|rspec|rubocop|yard))})
     end
   end
 
@@ -46,6 +46,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rubocop-rake', '~> 0.7.1'
   spec.add_development_dependency 'rubocop-rspec', '~> 3.0', '>= 3.0.4'
   spec.add_development_dependency 'simplecov', '~> 0.22.0'
+  spec.add_development_dependency 'yard-lint', '~> 1.2', '>= 1.2.3'
 
   spec.metadata['rubygems_mfa_required'] = 'true'
 end

data/sig/onboardable/errors.rbs

@@ -7,7 +7,7 @@ module Onboardable
   end
 
   class StepConversionError < Error
-    def initialize: (Class klass, untyped step) -> untyped
+    def initialize: (Class klass, Object step) -> untyped
   end
 
   class EmptyStepsError < Error

data/sig/onboardable.rbs

@@ -1,7 +1,7 @@
 module Onboardable
   VERSION: String
 
-  def self.included: (Class klass) -> untyped
+  def self.included: (Module klass) -> void
 
   module ClassMethods
     attr_accessor list_builder: List::Builder

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: onboardable
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Artem Skrynnyk
 bindir: exe
 cert_chain: []
-date: 2025-04-01 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -131,6 +131,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.22.0
+- !ruby/object:Gem::Dependency
+  name: yard-lint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.3
 description: Provides tools for easy setup of custom onboarding to boost engagement.
 email:
 - skrynnyk.artem@coaxsoft.com
@@ -177,14 +197,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Streamlines onboarding process integration
 test_files: []