parameter_substitution 3.2.0.pre.2 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8217b83c3c18c7859547a4085b54d5e044eb112e5d3ecb0406e1d8c25eca05b
-  data.tar.gz: 95fecf90965e89d74232b9f9c9827f250cf540a29b5f9ca52a137c834c341e11
+  metadata.gz: b1ce2eb4a673fa4ca42d4bfef42b2b18a0b6011dcef6aeb6b8f4c0c0fb30f63b
+  data.tar.gz: 41b30435287d1dcb7b0b01686c238a49fad6f1d8bf6b414a96a65099dec17f4b
 SHA512:
-  metadata.gz: 952f7ff4d93e043221e3fd49f0143e8c770c3fb5242472852b46ddbf922b9d5ebaa4a3b483aeab769a5ce179ca735ed30970be017ce50c8655c17594adb76726
-  data.tar.gz: 5a7b43f9fd00781ca6f1eb4afc56340cc32fb05a16f4bf0a1aa707efc81ce0235ce23b75239199ffb7178348698fcfdcf4f81f797a44fb3d05a7ebd98b8bf9be
+  metadata.gz: 3bdabcf306d69fc596a6202bf718f0bcdf3fd53ef4fa3d1a00135e4fb3745846f80c3a21ccfc2e1e73d0488aab7e2ac45e8ae7b578cde55ddf0f9b98fddfe8d6
+  data.tar.gz: e86ae64208c6cdf3bdae88bb951d54b379d9a622af44c7a1a7cfc981886b21c80eaf2ad1315549c14785057804ec95580a69cd2d177369e3a44fd7fd21469e0e

data/lib/parameter_substitution/expression.rb

@@ -43,8 +43,13 @@ class ParameterSubstitution
     end
 
     # Recursively collects all substitution parameter names, including those
-    # nested inside method call arguments (e.g. <dclid.compare_string(<gclid>, 'a', 'b')>
-    # returns both "dclid" and "gclid").
+    # nested inside method call arguments.
+    #
+    # @example
+    #   # For "<dclid.compare_string(<gclid>, 'a', 'b')>"
+    #   # returns ["dclid", "gclid"]
+    #
+    # @return [Array<String>] all parameter names, including nested ones
     def all_substitution_parameter_names
       @expression_list.flat_map { |expr| parameter_names_from_expression(expr) }
     end
@@ -150,6 +155,11 @@ class ParameterSubstitution
       text + (amount > 1 ? 's' : '')
     end
 
+    # Extracts the parameter name from an expression and recursively collects
+    # any nested parameter names from its method call arguments.
+    #
+    # @param expr [TextExpression, SubstitutionExpression] a single expression node
+    # @return [Array<String>] parameter names found in this expression and its arguments
     def parameter_names_from_expression(expr)
       if (name = expr.parameter_name)
         [name] + parameter_names_from_method_calls(expr.try(:method_calls))
@@ -158,13 +168,19 @@ class ParameterSubstitution
       end
     end
 
+    # Collects parameter names from nested Expression arguments within method calls.
+    #
+    # @param method_calls [Array<MethodCallExpression>, nil] the method calls to inspect
+    # @return [Array<String>] parameter names found in nested expression arguments
     def parameter_names_from_method_calls(method_calls)
-      return [] unless method_calls
-
-      method_calls.flat_map do |mc|
-        mc.arguments.flat_map do |arg|
-          arg.is_a?(Expression) ? arg.all_substitution_parameter_names : []
+      if method_calls
+        method_calls.flat_map do |method_call|
+          method_call.arguments.flat_map do |arg|
+            arg.is_a?(Expression) ? arg.all_substitution_parameter_names : []
+          end
         end
+      else
+        []
       end
     end
   end

data/lib/parameter_substitution/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class ParameterSubstitution
-  VERSION = "3.2.0.pre.2"
+  VERSION = "3.2.0"
 end

data/lib/parameter_substitution.rb

@@ -69,6 +69,13 @@ class ParameterSubstitution
       parse_expression(context).substitution_parameter_names
     end
 
+    # Returns all substitution parameter names found in the input string, including
+    # those nested inside method call arguments.
+    #
+    # @param string_with_tokens [String] the input string containing tokens
+    # @param mapping [Hash] the mapping of parameters to values
+    # @param context_overrides [Hash] optional overrides for context attributes
+    # @return [Array<String>] all parameter names, including nested ones
     def find_all_tokens(string_with_tokens, mapping: {}, context_overrides: {})
       context = build_context(string_with_tokens, mapping, context_overrides)
       parse_expression(context).all_substitution_parameter_names

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parameter_substitution
 version: !ruby/object:Gem::Version
-  version: 3.2.0.pre.2
+  version: 3.2.0
 platform: ruby
 authors:
 - Invoca Development
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-18 00:00:00.000000000 Z
+date: 2026-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -148,9 +148,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.3.27
 signing_key: