treaty 0.16.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc42fa86dd5dc35d49f0a07a189d9ddc59f619e2341905c1ed62193e0d3069b7
-  data.tar.gz: ffc66f03e0ced6e666bb12db50f405117831b48c26475ab034ab4a16f4c431b1
+  metadata.gz: 19f3a5ea2e7f34d9a6d01ccbd59acb738acce63f94f871f0e15da1ff1886f68d
+  data.tar.gz: 978fea08fd431936d1975eb0ed18562f90928eefd790224bdf04042e9a15cc0b
 SHA512:
-  metadata.gz: 0b31ad204ddb19df8a296007f334d29e2e220fbb771f9c5a3851309e0a9ec1909dae0dbef3608633f6a5203da0b827fb90c75132e83f5ebb3fcc28f36fd33cc9
-  data.tar.gz: 0c6ec71d1be9155da662498264667a63072c5ce513d1ae0987a54091d76aa35a9fd21b3c722db38a8f4154919a2894f442736c44e23ff88961c9a1aadc841c49
+  metadata.gz: 5569610ecda1c9fcc18fad93b50be238e8e96a26b430df119ca2da94bd02b44a8d1ffa6ff819c3926783589ea96e253e34cd4e8b6f55c06381b45760cc318dfa
+  data.tar.gz: 3236ffc1e64f646a35086fd42af3c00c387eaab1f188658a7f1f1320677ff3375572d302c583a822b511c8c9df12bc8ad692d2da27f22fd91bec1ab43696229b

data/README.md

@@ -13,7 +13,7 @@
 </div>
 
 > [!WARNING]
-> **Development Status**: Treaty is currently under active development in the 0.x version series. Breaking changes may occur between minor versions (0.x) as we refine the API and add new features. The library will stabilize with the 1.0 release. We recommend pinning to specific patch versions in your Gemfile (e.g., `gem "treaty", "~> 0.16.0"`) until the 1.0 release.
+> **Development Status**: Treaty is currently under active development in the 0.x version series. Breaking changes may occur between minor versions (0.x) as we refine the API and add new features. The library will stabilize with the 1.0 release. We recommend pinning to specific patch versions in your Gemfile (e.g., `gem "treaty", "~> 0.17.0"`) until the 1.0 release.
 
 ## 📚 Documentation
 

data/lib/treaty/attribute/option/registry.rb

@@ -19,26 +19,27 @@ module Treaty
       #
       # ## Registered Options
       #
-      # ### Validators
-      # - `:required` → RequiredValidator
-      # - `:type` → TypeValidator
-      # - `:inclusion` → InclusionValidator
-      # - `:format` → FormatValidator
+      # ### Validators (sorted by position)
+      # - `:type` → TypeValidator (position: 100)
+      # - `:required` → RequiredValidator (position: 200)
+      # - `:inclusion` → InclusionValidator (position: 300)
+      # - `:format` → FormatValidator (position: 400)
       #
-      # ### Modifiers
-      # - `:as` → AsModifier
-      # - `:default` → DefaultModifier
-      # - `:transform` → TransformModifier
-      # - `:cast` → CastModifier
+      # ### Modifiers (sorted by position)
+      # - `:transform` → TransformModifier (position: 500)
+      # - `:cast` → CastModifier (position: 600)
+      # - `:computed` → ComputedModifier (position: 700)
+      # - `:default` → DefaultModifier (position: 800)
+      # - `:as` → AsModifier (position: 900)
       #
-      # ### Conditionals
+      # ### Conditionals (no position - handled separately)
       # - `:if` → IfConditional
       # - `:unless` → UnlessConditional
       #
       # ## Usage
       #
       # Registration (done in RegistryInitializer):
-      #   Registry.register(:required, RequiredValidator, category: :validator)
+      #   Registry.register(:required, RequiredValidator, category: :validator, position: 200)
       #   Registry.register(:if, IfConditional, category: :conditional)
       #
       # Retrieval (done in OptionOrchestrator):
@@ -64,11 +65,13 @@ module Treaty
           #
           # @param option_name [Symbol] The name of the option (e.g., :required, :as, :default)
           # @param processor_class [Class] The processor class
-          # @param category [Symbol] The category (:validator or :modifier)
-          def register(option_name, processor_class, category:)
+          # @param category [Symbol] The category (:validator, :modifier, or :conditional)
+          # @param position [Integer, nil] Execution order position (nil for conditionals)
+          def register(option_name, processor_class, category:, position: nil)
             registry[option_name] = {
               processor_class:,
-              category:
+              category:,
+              position:
             }
           end
 
@@ -88,6 +91,14 @@ module Treaty
             registry.dig(option_name, :category)
           end
 
+          # Get position for an option
+          #
+          # @param option_name [Symbol] The name of the option
+          # @return [Integer, nil] The execution order position or nil if not set
+          def position_for(option_name)
+            registry.dig(option_name, :position)
+          end
+
           # Check if an option is registered
           #
           # @param option_name [Symbol] The name of the option

data/lib/treaty/attribute/option/registry_initializer.rb

@@ -17,22 +17,22 @@ module Treaty
       # 3. **Conditional Registration** - Registers all built-in conditionals
       # 4. **Auto-Loading** - Executes automatically when file is loaded
       #
-      # ## Built-in Validators
+      # ## Built-in Validators (sorted by position)
       #
-      # - `:required` → RequiredValidator - Validates required/optional attributes
-      # - `:type` → TypeValidator - Validates value types
-      # - `:inclusion` → InclusionValidator - Validates value is in allowed set
-      # - `:format` → FormatValidator - Validates string values match specific formats
+      # - `:type` → TypeValidator (position: 100) - Validates value types
+      # - `:required` → RequiredValidator (position: 200) - Validates required/optional attributes
+      # - `:inclusion` → InclusionValidator (position: 300) - Validates value is in allowed set
+      # - `:format` → FormatValidator (position: 400) - Validates string values match specific formats
       #
-      # ## Built-in Modifiers
+      # ## Built-in Modifiers (sorted by position)
       #
-      # - `:computed` → ComputedModifier - Computes values from all raw data (executes first)
-      # - `:transform` → TransformModifier - Transforms values using custom lambdas
-      # - `:cast` → CastModifier - Converts values between types automatically
-      # - `:default` → DefaultModifier - Provides default values
-      # - `:as` → AsModifier - Renames attributes
+      # - `:transform` → TransformModifier (position: 500) - Transforms values using custom lambdas
+      # - `:cast` → CastModifier (position: 600) - Converts values between types automatically
+      # - `:computed` → ComputedModifier (position: 700) - Computes values from all raw data
+      # - `:default` → DefaultModifier (position: 800) - Provides default values
+      # - `:as` → AsModifier (position: 900) - Renames attributes
       #
-      # ## Built-in Conditionals
+      # ## Built-in Conditionals (no position - handled separately)
       #
       # - `:if` → IfConditional - Conditionally includes attributes based on runtime data
       # - `:unless` → UnlessConditional - Conditionally excludes attributes based on runtime data
@@ -76,25 +76,26 @@ module Treaty
           private
 
           # Registers all built-in validators
+          # Position determines execution order (lower = earlier)
           #
           # @return [void]
           def register_validators!
-            Registry.register(:required, Validators::RequiredValidator, category: :validator)
-            Registry.register(:type, Validators::TypeValidator, category: :validator)
-            Registry.register(:inclusion, Validators::InclusionValidator, category: :validator)
-            Registry.register(:format, Validators::FormatValidator, category: :validator)
+            Registry.register(:type, Validators::TypeValidator, category: :validator, position: 100)
+            Registry.register(:required, Validators::RequiredValidator, category: :validator, position: 200)
+            Registry.register(:inclusion, Validators::InclusionValidator, category: :validator, position: 300)
+            Registry.register(:format, Validators::FormatValidator, category: :validator, position: 400)
           end
 
           # Registers all built-in modifiers
-          # Order matters: computed runs first, then transform, cast, default, as
+          # Position determines execution order (lower = earlier)
           #
           # @return [void]
           def register_modifiers!
-            Registry.register(:computed, Modifiers::ComputedModifier, category: :modifier)
-            Registry.register(:transform, Modifiers::TransformModifier, category: :modifier)
-            Registry.register(:cast, Modifiers::CastModifier, category: :modifier)
-            Registry.register(:default, Modifiers::DefaultModifier, category: :modifier)
-            Registry.register(:as, Modifiers::AsModifier, category: :modifier)
+            Registry.register(:transform, Modifiers::TransformModifier, category: :modifier, position: 500)
+            Registry.register(:cast, Modifiers::CastModifier, category: :modifier, position: 600)
+            Registry.register(:computed, Modifiers::ComputedModifier, category: :modifier, position: 700)
+            Registry.register(:default, Modifiers::DefaultModifier, category: :modifier, position: 800)
+            Registry.register(:as, Modifiers::AsModifier, category: :modifier, position: 900)
           end
 
           # Registers all built-in conditionals

data/lib/treaty/attribute/option_normalizer.rb

@@ -87,18 +87,32 @@ module Treaty
 
       class << self
         # Normalizes all options from simple mode to advanced mode
+        # and sorts them by position for consistent execution order.
         #
         # @param options [Hash] Options hash in simple or advanced mode
-        # @return [Hash] Normalized options in advanced mode
+        # @return [Hash] Normalized options in advanced mode, sorted by position
         def normalize(options)
-          options.each_with_object({}) do |(key, value), result|
+          normalized = options.each_with_object({}) do |(key, value), result|
             advanced_key, normalized_value = normalize_option(key, value)
             result[advanced_key] = normalized_value
           end
+
+          sort_by_position(normalized)
         end
 
         private
 
+        # Sorts options by their registered position.
+        # Options without position (like conditionals) sort first (position 0).
+        #
+        # @param options_hash [Hash] Normalized options hash
+        # @return [Hash] Options sorted by position
+        def sort_by_position(options_hash)
+          options_hash.sort_by do |option_name, _|
+            Option::Registry.position_for(option_name) || 0
+          end.to_h
+        end
+
         # Normalizes a single option to advanced mode
         #
         # @param key [Symbol] Option key

data/lib/treaty/version.rb

@@ -3,7 +3,7 @@
 module Treaty
   module VERSION
     MAJOR = 0
-    MINOR = 16
+    MINOR = 17
     PATCH = 0
     PRE = nil
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: treaty
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.17.0
 platform: ruby
 authors:
 - Anton Sokolov