domainic-attributer 0.1.0 → 0.2.0

data/sig/domainic/attributer/attribute_set.rbs

@@ -1,13 +1,15 @@
 module Domainic
   module Attributer
-    # A class representing an ordered collection of attributes.
+    # A class responsible for managing an ordered collection of attributes
     #
     # This class manages a set of attributes for a given class or module. It maintains
     # attributes in a specific order determined by their type (argument vs option),
     # default values, and position. The collection supports standard operations like
     # adding, selecting, and merging attributes while maintaining proper ownership
-    # relationships with their base class.
+    # relationships with their base class
     #
+    # @api private
+    # @!visibility private
     # @author {https://aaronmallen.me Aaron Allen}
     # @since 0.1.0
     class AttributeSet
@@ -17,61 +19,61 @@ module Domainic
 
       @lookup: Hash[Symbol, Attribute]
 
-      # Initialize a new AttributeSet.
+      # Initialize a new AttributeSet
       #
       # @param base [Class, Module] the class or module this set belongs to
       # @param attributes [Array<Attribute>] initial attributes to add
       #
-      # @return [void]
+      # @return [AttributeSet] the new AttributeSet instance
       def initialize: (__todo__ base, ?Array[Attribute] attributes) -> void
 
-      # Get an attribute by name.
+      # Get an attribute by name
       #
       # @param attribute_name [String, Symbol] the name of the attribute
       #
       # @return [Attribute, nil] the attribute if found
       def []: (String | Symbol attribute_name) -> Attribute?
 
-      # Add an attribute to the set.
+      # Add an attribute to the set
       #
       # If an attribute with the same name exists, the attributes are merged.
       # If the attribute belongs to a different base class, it is duplicated
       # with the correct base. After adding, attributes are sorted by type
-      # and position.
+      # and position
       #
       # @param attribute [Attribute] the attribute to add
       #
-      # @raise [ArgumentError] if attribute is invalid
+      # @raise [ArgumentError] if attribute is not a valid {Attribute}
       # @return [void]
       def add: (Attribute attribute) -> void
 
-      # Check if an attribute exists in the set.
+      # Check if an attribute exists in the set
       #
       # @param attribute_name [String, Symbol] the name to check
       #
       # @return [Boolean] true if the attribute exists
       def attribute?: (untyped attribute_name) -> untyped
 
-      # Get all attribute names.
+      # Get all attribute names
       #
       # @return [Array<Symbol>] the attribute names
       def attribute_names: () -> Array[Symbol]
 
-      # Get all attributes.
+      # Get all attributes
       #
       # @return [Array<Attribute>] the attributes
       def attributes: () -> Array[Attribute]
 
       def count: () ?{ (Symbol, Attribute) -> boolish } -> Integer
 
-      # Create a duplicate set for a new base class.
+      # Create a duplicate set for a new base class
       #
       # @param new_base [Class, Module] the new base class
       #
       # @return [AttributeSet] the duplicated set
       def dup_with_base: (__todo__ base) -> AttributeSet
 
-      # Iterate over attribute name/value pairs.
+      # Iterate over attribute name/value pairs
       #
       # @yield [name, attribute] each name/attribute pair
       # @yieldparam name [Symbol] the attribute name
@@ -84,7 +86,7 @@ module Domainic
 
       def empty?: () -> bool
 
-      # Create a new set excluding specified attributes.
+      # Create a new set excluding specified attributes
       #
       # @param attribute_names [Array<String, Symbol>] names to exclude
       #
@@ -93,14 +95,14 @@ module Domainic
 
       def length: () -> Integer
 
-      # Merge another set into this one.
+      # Merge another set into this one
       #
       # @param other [AttributeSet] the set to merge
       #
       # @return [AttributeSet] new set with merged attributes
       def merge: (AttributeSet other) -> AttributeSet
 
-      # Create a new set with rejected attributes.
+      # Create a new set with rejected attributes
       #
       # @yield [name, attribute] each name/attribute pair
       # @yieldparam name [Symbol] the attribute name
@@ -109,7 +111,7 @@ module Domainic
       # @return [AttributeSet] new set without rejected attributes
       def reject: () { (Symbol, Attribute) -> boolish } -> AttributeSet
 
-      # Create a new set with selected attributes.
+      # Create a new set with selected attributes
       #
       # @yield [name, attribute] each name/attribute pair
       # @yieldparam name [Symbol] the attribute name
@@ -122,10 +124,10 @@ module Domainic
 
       private
 
-      # Sort attributes by type and position.
+      # Sort attributes by type and position
       #
       # Attributes are sorted first by type (required arguments, defaulted arguments,
-      # then options), and then by their position within those groups.
+      # then options), and then by their position within those groups
       #
       # @return [void]
       def sort_lookup: () -> void

data/sig/domainic/attributer/class_methods.rbs

@@ -1,94 +1,150 @@
 module Domainic
   module Attributer
-    # A module providing class-level methods for attribute definition.
-    #
-    # This module extends classes that include Domainic::Attributer with methods for
-    # defining and managing attributes. It supports two types of attributes:
+    # This module extends classes that include {Domainic::Attributer} with methods for defining and managing attributes.
+    # It supports two types of attributes:
     # 1. Arguments - Positional parameters that must be provided in a specific order
     # 2. Options - Named parameters that can be provided in any order
     #
+    # @note This module is automatically extended when {Domainic::Attributer} is included in a class
+    #
     # @example Defining arguments and options
     #   class Person
     #     include Domainic::Attributer
     #
-    #     argument :name, ->(value) { value.is_a?(String) }
-    #     argument :age do |value|
-    #       value.is_a?(Integer) && value >= 0
+    #     argument :name, String
+    #     argument :age, Integer do
+    #       validate_with ->(val) { val >= 0 }
     #     end
     #
-    #     option :email, ->(value) { value.is_a?(String) }, default: nil
-    #     option :role do |value|
-    #       %w[admin user guest].include?(value)
+    #     option :email, String, default: nil
+    #     option :role do
+    #       validate_with ->(val) { %w[admin user guest].include?(val) }
     #     end
     #   end
     #
+    #   person = Person.new('Alice', 30, email: 'alice123@gmail.com', role: 'user')
+    #   # => #<Person:0x0000000104bc5f98 @age=30, @email="alice123@gmail.com", @name="Alice", @role="user">
+    #
     # @author {https://aaronmallen.me Aaron Allen}
     # @since 0.1.0
     module ClassMethods
       @__attributes__: AttributeSet
 
-      # Define a positional argument attribute.
-      #
-      # Arguments are required by default and must be provided in the order they are defined.
-      # They can be type-validated and configured with additional options like defaults
-      # and visibility.
-      #
-      # @param attribute_name [String, Symbol] the name of the attribute
-      # @param type_validator [Proc, Object, nil] optional validation handler for type checking
-      # @param options [Hash] additional configuration options
-      #
-      # @option options [Array<Proc>, Proc] :callbacks handlers for attribute change events (priority over :callback,
-      #   :on_change)
-      # @option options [Array<Proc>, Proc] :callback alias for :callbacks
-      # @option options [Array<Proc, Symbol>, Proc, Symbol] :coerce handlers for value coercion (priority over
-      #   :coercers, :coerce_with)
-      # @option options [Array<Proc, Symbol>, Proc, Symbol] :coercers alias for :coerce
-      # @option options [Array<Proc, Symbol>, Proc, Symbol] :coerce_with alias for :coerce
-      # @option options [Object] :default the default value (priority over :default_generator, :default_value)
-      # @option options [Object] :default_generator alias for :default
-      # @option options [Object] :default_value alias for :default
-      # @option options [String] :desc short description (overridden by :description)
-      # @option options [String] :description description text
-      # @option options [Boolean] :non_nil require non-nil values (priority over :non_null, :non_nullable, :not_nil,
-      #   :not_nilable, :not_null, :not_nullable)
-      # @option options [Boolean] :non_null alias for :non_nil
-      # @option options [Boolean] :non_nullable alias for :non_nil
-      # @option options [Boolean] :not_nil alias for :non_nil
-      # @option options [Boolean] :not_nilable alias for :non_nil
-      # @option options [Boolean] :not_null alias for :non_nil
-      # @option options [Boolean] :not_nullable alias for :non_nil
-      # @option options [Boolean] :null inverse of :non_nil
-      # @option options [Array<Proc>, Proc] :on_change alias for :callbacks
-      # @option options [Boolean] :optional whether attribute is optional (overridden by :required)
-      # @option options [Integer] :position specify order position
-      # @option options [Symbol] :read read visibility (:public, :protected, :private) (priority over :read_access,
-      #   :reader)
-      # @option options [Symbol] :read_access alias for :read
-      # @option options [Symbol] :reader alias for :read
-      # @option options [Boolean] :required whether attribute is required
-      # @option options [Array<Object>, Object] :validate validators for the attribute (priority over :validate_with,
-      #   :validators)
-      # @option options [Array<Object>, Object] :validate_with alias for :validate
-      # @option options [Array<Object>, Object] :validators alias for :validate
-      # @option options [Symbol] :write_access write visibility (:public, :protected, :private) (priority over :writer)
-      # @option options [Symbol] :writer alias for :write_access
-      #
-      # @yield [DSL::AttributeBuilder] optional configuration block
-      # @return [void]
+      # Define a positional argument attribute
+      #
+      # Arguments are required by default and must be provided in the order they are defined unless they have a default
+      # value. They can be type-validated and configured with additional options like defaults and visibility
+      #
+      # @see DSL::AttributeBuilder
+      #
+      # @example Using the options API
+      #   class Person
+      #     argument :name, String
+      #     argument :age, ->(val) { val.is_a?(Integer) && val >= 0 }
+      #     argument :role, default: 'user'
+      #   end
+      #
+      # @example Using the block API
+      #   class Person
+      #     argument :name, String do
+      #       validate_with ->(val) { val.length >= 3 }
+      #     end
+      #
+      #     argument :age, Integer do
+      #       coerce_with ->(val) { val.to_i }
+      #       validate_with ->(val) { val >= 0 }
+      #     end
+      #
+      #     argument :role, String do
+      #       validate_with ->(val) { VALID_USER_ROLES.include?(val) }
+      #       default 'user'
+      #     end
+      #   end
+      #
+      # @overload argument(attribute_name, type_validator = nil, **options)
+      #   @param attribute_name [String, Symbol] the name of the attribute
+      #   @param type_validator [Proc, Object, nil] optional validation handler for type checking
+      #   @param options [Hash{Symbol => Object}] additional configuration options
+      #   @option options [Array<Proc>, Proc] :callbacks handlers for attribute change events (priority over
+      #     :callback, :on_change)
+      #   @option options [Array<Proc>, Proc] :callback alias for :callbacks
+      #   @option options [Array<Proc, Symbol>, Proc, Symbol] :coerce handlers for value coercion (priority over
+      #     :coercers, :coerce_with)
+      #   @option options [Array<Proc, Symbol>, Proc, Symbol] :coercers alias for :coerce
+      #   @option options [Array<Proc, Symbol>, Proc, Symbol] :coerce_with alias for :coerce
+      #   @option options [Object] :default the default value (priority over :default_generator, :default_value)
+      #   @option options [Object] :default_generator alias for :default
+      #   @option options [Object] :default_value alias for :default
+      #   @option options [String] :desc short description (overridden by :description)
+      #   @option options [String] :description description text
+      #   @option options [Boolean] :non_nil require non-nil values (priority over :non_null, :non_nullable, :not_nil,
+      #     :not_nilable, :not_null, :not_nullable)
+      #   @option options [Boolean] :non_null alias for :non_nil
+      #   @option options [Boolean] :non_nullable alias for :non_nil
+      #   @option options [Boolean] :not_nil alias for :non_nil
+      #   @option options [Boolean] :not_nilable alias for :non_nil
+      #   @option options [Boolean] :not_null alias for :non_nil
+      #   @option options [Boolean] :not_nullable alias for :non_nil
+      #   @option options [Boolean] :null inverse of :non_nil
+      #   @option options [Array<Proc>, Proc] :on_change alias for :callbacks
+      #   @option options [Boolean] :optional whether attribute is optional (overridden by :required)
+      #   @option options [Integer] :position specify order position
+      #   @option options [Symbol] :read read visibility (:public, :protected, :private) (priority over :read_access,
+      #     :reader)
+      #   @option options [Symbol] :read_access alias for :read
+      #   @option options [Symbol] :reader alias for :read
+      #   @option options [Boolean] :required whether attribute is required
+      #   @option options [Array<Object>, Object] :validate validators for the attribute (priority over
+      #     :validate_with, :validators)
+      #   @option options [Array<Object>, Object] :validate_with alias for :validate
+      #   @option options [Array<Object>, Object] :validators alias for :validate
+      #   @option options [Symbol] :write_access write visibility (:public, :protected, :private) (priority over
+      #     :writer)
+      #   @option options [Symbol] :writer alias for :write_access
+      #
+      #   @yield [DSL::AttributeBuilder] configuration block for additional attribute settings
+      #   @return [void]
       def argument: (String | Symbol attribute_name, ?Attribute::Validator::handler type_validator, ?callbacks: Array[Attribute::Callback::handler] | Attribute::Callback::handler, ?callback: Array[Attribute::Callback::handler] | Attribute::Callback::handler, ?coerce: Array[Attribute::Coercer::handler] | Attribute::Coercer::handler, ?coercers: Array[Attribute::Coercer::handler], ?coerce_with: [ Attribute::Coercer::handler ] | Attribute::Coercer::handler, ?default: untyped, ?default_generator: untyped, ?default_value: untyped, ?desc: String?, ?description: String, ?non_nil: bool, ?non_null: bool, ?non_nullable: bool, ?not_nil: bool, ?not_nilable: bool, ?not_null: bool, ?not_nullable: bool, ?null: bool, ?on_change: Array[Attribute::Callback::handler] | Attribute::Callback::handler, ?optional: bool, ?position: Integer?, ?read: Attribute::Signature::visibility_symbol, ?read_access: Attribute::Signature::visibility_symbol, ?reader: Attribute::Signature::visibility_symbol, ?required: bool, ?validate: Array[Attribute::Validator::handler] | Attribute::Validator::handler, ?validate_with: Array[Attribute::Validator::handler] | Attribute::Validator::handler, ?validators: Array[Attribute::Validator::handler] | Attribute::Validator::handler, ?write_access: Attribute::Signature::visibility_symbol, ?writer: Attribute::Signature::visibility_symbol) ?{ (?) [self: DSL::AttributeBuilder] -> void } -> void
 
-      # Define a named option attribute.
+      # Define a named option attribute
       #
       # Options are optional by default and can be provided in any order. They can be
-      # type-validated and configured with additional options like defaults and visibility.
+      # type-validated and configured with additional options like defaults and visibility
+      #
+      # @see DSL::AttributeBuilder
+      # @see DSL::AttributeBuilder::OptionParser#initialize
       #
-      # @overload option(attribute_name, type_validator = Undefined, **options, &block)
+      # @example Using the options API
+      #   class Person
+      #     option :email, String
+      #     option :age, ->(val) { val.is_a?(Integer) && val >= 0 }
+      #     option :role, default: 'user'
+      #   end
+      #
+      # @example Using the block API
+      #   class Person
+      #     option :email, String do
+      #       coerce_with ->(val) { val.downcase }
+      #       validate_with ->(val) { URI::MailTo::EMAIL_REGEXP.match?(val) }
+      #     end
+      #
+      #     option :age, Integer do
+      #       coerce_with ->(val) { val.to_i }
+      #       validate_with ->(val) { val >= 0 }
+      #     end
+      #
+      #     option :role, String do
+      #       validate_with ->(val) { VALID_USER_ROLES.include?(val) }
+      #       default 'user'
+      #     end
+      #   end
+      #
+      # @overload option(attribute_name, type_validator = nil, **options)
       #   @param attribute_name [String, Symbol] the name of the attribute
       #   @param type_validator [Proc, Object, nil] optional validation handler for type checking
-      #   @param options [Hash] additional configuration options
-      #
-      #   @option options [Array<Proc>, Proc] :callbacks handlers for attribute change events (priority over :callback,
-      #     :on_change)
+      #   @param options [Hash{Symbol => Object}] additional configuration options
+      #   @option options [Array<Proc>, Proc] :callbacks handlers for attribute change events (priority over
+      #     :callback, :on_change)
       #   @option options [Array<Proc>, Proc] :callback alias for :callbacks
       #   @option options [Array<Proc, Symbol>, Proc, Symbol] :coerce handlers for value coercion (priority over
       #     :coercers, :coerce_with)
@@ -116,36 +172,33 @@ module Domainic
       #   @option options [Symbol] :read_access alias for :read
       #   @option options [Symbol] :reader alias for :read
       #   @option options [Boolean] :required whether attribute is required
-      #   @option options [Array<Object>, Object] :validate validators for the attribute (priority over :validate_with,
-      #     :validators)
+      #   @option options [Array<Object>, Object] :validate validators for the attribute (priority over
+      #     :validate_with, :validators)
       #   @option options [Array<Object>, Object] :validate_with alias for :validate
       #   @option options [Array<Object>, Object] :validators alias for :validate
-      #   @option options [Symbol] :write_access write visibility (:public, :protected, :private)
-      #     (priority over :writer)
+      #   @option options [Symbol] :write_access write visibility (:public, :protected, :private) (priority over
+      #     :writer)
       #   @option options [Symbol] :writer alias for :write_access
       #
-      # @yield [DSL::AttributeBuilder] optional configuration block
-      # @return [void]
-      #
-      #   @yield [DSL::AttributeBuilder] optional configuration block
+      #   @yield [DSL::AttributeBuilder] configuration block for additional attribute settings
       #   @return [void]
       def option: (String | Symbol attribute_name, ?Attribute::Validator::handler type_validator, ?callbacks: Array[Attribute::Callback::handler] | Attribute::Callback::handler, ?callback: Array[Attribute::Callback::handler] | Attribute::Callback::handler, ?coerce: Array[Attribute::Coercer::handler] | Attribute::Coercer::handler, ?coercers: Array[Attribute::Coercer::handler], ?coerce_with: [ Attribute::Coercer::handler ] | Attribute::Coercer::handler, ?default: untyped, ?default_generator: untyped, ?default_value: untyped, ?desc: String?, ?description: String, ?non_nil: bool, ?non_null: bool, ?non_nullable: bool, ?not_nil: bool, ?not_nilable: bool, ?not_null: bool, ?not_nullable: bool, ?null: bool, ?on_change: Array[Attribute::Callback::handler] | Attribute::Callback::handler, ?optional: bool, ?position: Integer?, ?read: Attribute::Signature::visibility_symbol, ?read_access: Attribute::Signature::visibility_symbol, ?reader: Attribute::Signature::visibility_symbol, ?required: bool, ?validate: Array[Attribute::Validator::handler] | Attribute::Validator::handler, ?validate_with: Array[Attribute::Validator::handler] | Attribute::Validator::handler, ?validators: Array[Attribute::Validator::handler] | Attribute::Validator::handler, ?write_access: Attribute::Signature::visibility_symbol, ?writer: Attribute::Signature::visibility_symbol) ?{ (?) [self: DSL::AttributeBuilder] -> void } -> void
 
       private
 
-      # Handle class inheritance for attributes.
+      # Get the attribute set for this class
+      #
+      # @return [AttributeSet] the set of attributes defined for this class
+      def __attributes__: () -> AttributeSet
+
+      # Handle class inheritance for attributes
       #
       # Ensures that subclasses inherit a copy of their parent's attributes while
-      # maintaining proper ownership relationships.
+      # maintaining proper ownership relationships
       #
       # @param subclass [Class] the inheriting class
       # @return [void]
       def inherited: (Class | Module subclass) -> void
-
-      # Get the attribute set for this class.
-      #
-      # @return [AttributeSet] the set of attributes defined for this class
-      def __attributes__: () -> AttributeSet
     end
   end
 end

data/sig/domainic/attributer/dsl/attribute_builder/option_parser.rbs

@@ -2,12 +2,15 @@ module Domainic
   module Attributer
     module DSL
       class AttributeBuilder
-        # A class responsible for parsing and normalizing attribute options.
+        # A class responsible for parsing and normalizing attribute options
         #
         # This class handles the conversion of flexible DSL options into a normalized
         # format for attribute creation. It supports multiple ways of specifying common
         # options (like visibility, nullability, validation) and consolidates them
-        # into a consistent internal representation.
+        # into a consistent internal representation
+        #
+        # @!visibility private
+        # @api private
         #
         # @author {https://aaronmallen.me Aaron Allen}
         # @since 0.1.0
@@ -47,79 +50,116 @@ module Domainic
 
           @options: options
 
-          # Parse attribute options into a normalized format.
+          # Parse attribute options into a normalized format
           #
           # @param attribute_name [String, Symbol] the name of the attribute
           # @param attribute_type [String, Symbol] the type of attribute
-          # @param options [Hash] the options to parse
+          # @param options [Hash{String, Symbol => Object}] the options to parse. See {#initialize} for details.
           #
-          # @return [Hash] normalized options suitable for attribute creation
+          # @return [Hash{Symbol => Object}] normalized options suitable for attribute creation
           def self.parse!: (String | Symbol attribute_name, String | Symbol attribute_type, options options) -> void
 
-          # Initialize a new OptionParser.
+          # Initialize a new OptionParser instance
           #
           # @param attribute_name [String, Symbol] the name of the attribute
           # @param attribute_type [String, Symbol] the type of attribute
-          # @param options [Hash] the options to parse
-          #
-          # @return [void]
+          # @param options [Hash{String, Symbol => Object}] the options to parse
+          #
+          # @option options [Array<Proc>, Proc] :callbacks handlers for attribute change events (priority over
+          #   :callback, :on_change)
+          # @option options [Array<Proc>, Proc] :callback alias for :callbacks
+          # @option options [Array<Proc, Symbol>, Proc, Symbol] :coerce handlers for value coercion (priority over
+          #   :coercers, :coerce_with)
+          # @option options [Array<Proc, Symbol>, Proc, Symbol] :coercers alias for :coerce
+          # @option options [Array<Proc, Symbol>, Proc, Symbol] :coerce_with alias for :coerce
+          # @option options [Object] :default the default value (priority over :default_generator, :default_value)
+          # @option options [Object] :default_generator alias for :default
+          # @option options [Object] :default_value alias for :default
+          # @option options [String] :desc short description (overridden by :description)
+          # @option options [String] :description description text
+          # @option options [Boolean] :non_nil require non-nil values (priority over :non_null, :non_nullable, :not_nil,
+          #   :not_nilable, :not_null, :not_nullable)
+          # @option options [Boolean] :non_null alias for :non_nil
+          # @option options [Boolean] :non_nullable alias for :non_nil
+          # @option options [Boolean] :not_nil alias for :non_nil
+          # @option options [Boolean] :not_nilable alias for :non_nil
+          # @option options [Boolean] :not_null alias for :non_nil
+          # @option options [Boolean] :not_nullable alias for :non_nil
+          # @option options [Boolean] :null inverse of :non_nil
+          # @option options [Array<Proc>, Proc] :on_change alias for :callbacks
+          # @option options [Boolean] :optional whether attribute is optional (overridden by :required)
+          # @option options [Integer] :position specify order position
+          # @option options [Symbol] :read read visibility (:public, :protected, :private) (priority over :read_access,
+          #   :reader)
+          # @option options [Symbol] :read_access alias for :read
+          # @option options [Symbol] :reader alias for :read
+          # @option options [Boolean] :required whether attribute is required
+          # @option options [Array<Object>, Object] :validate validators for the attribute (priority over
+          #   :validate_with, :validators)
+          # @option options [Array<Object>, Object] :validate_with alias for :validate
+          # @option options [Array<Object>, Object] :validators alias for :validate
+          # @option options [Symbol] :write_access write visibility (:public, :protected, :private) (priority over
+          #   :writer)
+          # @option options [Symbol] :writer alias for :write_access
+          #
+          # @return [OptionParser] the new OptionParser instance
           def initialize: (String | Symbol attribute_name, String | Symbol attribute_type, options options) -> void
 
-          # Parse the options into a normalized format.
+          # Parse the options into a normalized format
           #
-          # @return [Hash] normalized options suitable for attribute creation
+          # @return [Hash{Symbol => Object}] normalized options suitable for attribute creation
           def parse!: () -> result
 
           private
 
-          # Find the last set value among multiple option keys.
+          # Find the last set value among multiple option keys
           #
           # @param keys [Array<Symbol>] the keys to check
           #
-          # @return [Object] the last set value or Undefined
+          # @return [Object] the last set value or {Undefined}
           def find_last_option: (Array[Symbol]) -> untyped
 
-          # Parse accessor (reader/writer) visibility options.
+          # Parse accessor (reader/writer) visibility options
           #
           # @return [void]
           def parse_accessor_options!: () -> void
 
-          # Parse callback handler options.
+          # Parse callback handler options
           #
           # @return [void]
           def parse_callbacks_options!: () -> void
 
-          # Parse coercion handler options.
+          # Parse coercion handler options
           #
           # @return [void]
           def parse_coercers_options!: () -> void
 
-          # Parse default value options.
+          # Parse default value options
           #
           # @return [void]
           def parse_default_options!: () -> void
 
-          # Parse description options.
+          # Parse description options
           #
           # @return [void]
           def parse_description_options!: () -> void
 
-          # Parse nilability options.
+          # Parse nilability options
           #
           # @return [void]
           def parse_nilable_options!: () -> void
 
-          # Parse all option types.
+          # Parse all option types
           #
           # @return [void]
           def parse_options!: () -> void
 
-          # Parse required/optional options.
+          # Parse required/optional options
           #
           # @return [void]
           def parse_required_options!: () -> void
 
-          # Parse validator options.
+          # Parse validator options
           #
           # @return [void]
           def parse_validator_options!: () -> void