Update models/ValidationManager.cfc

Co-authored-by: Copilot <[email protected]>

Author: elpete

models/ValidationManager.cfc

@@ -305,6 +305,19 @@ component accessors="true" serialize="false" singleton {
 		return filterTargetForConstraints( arguments.target, constraints );
 	}
 
+	/**
+	 * Recursively filters the given target structure or object according to the provided constraints.
+	 *
+	 * This method processes the target and returns a new structure containing only the keys that exist in the constraints.
+	 * It handles nested constraints (via "constraints" or "nestedConstraints" keys) and array item constraints (via "items" or "arrayItem" keys)
+	 * by recursively filtering nested objects and arrays as needed.
+	 *
+	 * @target      The target structure or object to filter. Can be a struct or an object containing fields to validate.
+	 * @constraints The structure of constraints to use for filtering the target. Keys correspond to fields in the target.
+	 *
+	 * @return struct: A new structure containing only the fields from the target that match the provided constraints,
+	 *                 with nested structures and arrays filtered recursively as specified by the constraints.
+	 */
 	private any function filterTargetForConstraints( required any target, required struct constraints ){
 		var filteredTarget = {};
 		for ( var key in arguments.target ) {