Update InputfieldWrapper class so that you can now get new Inputfield object instances from it directly and in a manner that IDEs know what Inputfield module you are working with, so that phpdoc'ing it isn't necessary. This works from accesses to InputfieldWrapper, InputfieldForm, InputfieldFieldset. i.e. $f = $inputfields->InputfieldText; is equivalent to $modules->get('InputfieldText'); but more understandable to the IDE (like PhpStorm).

wire/core/Inputfield.php

@@ -1434,16 +1434,14 @@ abstract class Inputfield extends WireData implements Module {
 		$conditionsNote = $this->_('Read more about [how to use this](http://processwire.com/api/selectors/inputfield-dependencies/).'); 
 
 		/** @var InputfieldWrapper $fields */
-		$fields = $this->wire(new InputfieldWrapper());
+		$inputfields = $this->wire(new InputfieldWrapper());
 
-		/** @var InputfieldFieldset $fieldset */
+		$fieldset = $inputfields->InputfieldFieldset;
-		$fieldset = $this->modules->get('InputfieldFieldset');
 		$fieldset->label = $this->_('Visibility'); 
 		$fieldset->attr('name', 'visibility'); 
 		$fieldset->icon = 'eye';
 		
-		/** @var InputfieldSelect $field */
+		$field = $inputfields->InputfieldSelect;
-		$field = $this->modules->get("InputfieldSelect"); 
 		$field->attr('name', 'collapsed'); 
 		$field->label = $this->_('Presentation'); 
 		$field->icon = 'eye-slash';
@@ -1466,8 +1464,7 @@ abstract class Inputfield extends WireData implements Module {
 		$field->attr('value', (int) $this->collapsed); 
 		$fieldset->append($field); 
 
-		/** @var InputfieldText $field */
+		$field = $inputfields->InputfieldText;
-		$field = $this->modules->get("InputfieldText"); 
 		$field->label = $this->_('Show this field only if');
 		$field->description = $this->_('Enter the conditions under which the field will be shown.') . ' ' . $conditionsText; 
 		$field->notes = $conditionsNote; 
@@ -1479,10 +1476,9 @@ abstract class Inputfield extends WireData implements Module {
 		$fieldset->append($field);
 		
 		$fieldset->collapsed = $this->collapsed == Inputfield::collapsedNo && !$this->getSetting('showIf') ? Inputfield::collapsedYes : Inputfield::collapsedNo;
-		$fields->append($fieldset); 
+		$inputfields->append($fieldset); 
 
-		/** @var InputfieldInteger $field */
+		$field = $inputfields->InputfieldInteger;
-		$field = $this->modules->get('InputfieldInteger'); 
 		$value = (int) $this->getSetting('columnWidth'); 
 		if($value < 10 || $value >= 100) $value = 100;
 		$field->label = sprintf($this->_('Column width (%d%%)'), $value);
@@ -1497,12 +1493,11 @@ abstract class Inputfield extends WireData implements Module {
 		$field->description = $this->_("The percentage width of this field's container (10%-100%). If placed next to other fields with reduced widths, it will create floated columns."); // Description of colWidth option
 		$field->notes = $this->_("Note that not all fields will work at reduced widths, so you should test the result after changing this."); // Notes for colWidth option
 		if(!$this->wire('input')->get('process_template')) if($value == 100) $field->collapsed = Inputfield::collapsedYes; 
-		$fields->append($field); 
+		$inputfields->append($field); 
 
 		if(!$this instanceof InputfieldWrapper) {
 		
-			/** @var InputfieldCheckbox $field */
+			$field = $inputfields->InputfieldCheckbox;
-			$field = $this->modules->get('InputfieldCheckbox');
 			$field->label = $this->_('Required?');
 			$field->icon = 'asterisk';
 			$field->attr('name', 'required'); 
@@ -1510,14 +1505,13 @@ abstract class Inputfield extends WireData implements Module {
 			$field->attr('checked', $this->getSetting('required') ? 'checked' : ''); 
 			$field->description = $this->_("If checked, a value will be required for this field.");
 			$field->collapsed = $this->getSetting('required') ? Inputfield::collapsedNo : Inputfield::collapsedYes; 
-			$fields->add($field);
+			$inputfields->add($field);
 	
 			$requiredAttr = $this->getSetting('requiredAttr'); 
 			if($requiredAttr !== null) {
 				// Inputfield must have set requiredAttr to some non-null value before this will appear as option in config
 				$field->columnWidth = 50; // required checkbox
-				/** @var InputfieldCheckbox $f */
+				$f = $inputfields->InputfieldCheckbox;
-				$f = $this->modules->get('InputfieldCheckbox');
 				$f->attr('name', 'requiredAttr');
 				$f->label = $this->_('Also use HTML5 “required” attribute?');
 				$f->showIf = "required=1, showIf='', requiredIf=''";
@@ -1525,11 +1519,10 @@ abstract class Inputfield extends WireData implements Module {
 				$f->icon = 'html5';
 				$f->columnWidth = 50;
 				if($requiredAttr) $f->attr('checked', 'checked');
-				$fields->add($f);
+				$inputfields->add($f);
 			}
 		
-			/** @var InputfieldText $field */
+			$field = $inputfields->InputfieldText;
-			$field = $this->modules->get('InputfieldText'); 
 			$field->label = $this->_('Required only if');
 			$field->icon = 'asterisk';
 			$field->description = $this->_('Enter the conditions under which a value will be required for this field.') . ' ' . $conditionsText; 
@@ -1538,10 +1531,10 @@ abstract class Inputfield extends WireData implements Module {
 			$field->attr('value', $this->getSetting('requiredIf')); 
 			$field->collapsed = $field->attr('value') ? Inputfield::collapsedNo : Inputfield::collapsedYes; 
 			$field->showIf = "required>0"; 
-			$fields->add($field); 
+			$inputfields->add($field); 
 		}
 	
-		return $fields; 
+		return $inputfields; 
 	}
 
 	/**

wire/core/InputfieldWrapper.php

@@ -3,7 +3,7 @@
 /**
  * ProcessWire InputfieldWrapper
  *
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2021 by Ryan Cramer
  * https://processwire.com
  *
  * About InputfieldWrapper
@@ -25,6 +25,48 @@
  * 
  * @method string renderInputfield(Inputfield $inputfield, $renderValueMode = false) #pw-group-output
  * @method Inputfield new($typeName, $name = '', $label = '', array $settings = array()) #pw-group-manipulation
+ * 
+ * @property InputfieldAsmSelect $InputfieldAsmSelect
+ * @property InputfieldButton $InputfieldButton
+ * @property InputfieldCheckbox $InputfieldCheckbox
+ * @property InputfieldCheckboxes $InputfieldCheckboxes
+ * @property InputfieldCKEditor $InputfieldCkeditor
+ * @property InputfieldCommentsAdmin $InputfieldCommentsAdmin
+ * @property InputfieldDatetime $InputfieldDatetime
+ * @property InputfieldEmail $InputfieldEmail
+ * @property InputfieldFieldset $InputfieldFieldset
+ * @property InputfieldFieldsetClose $InputfieldlFieldsetClose
+ * @property InputfieldFieldsetOpen $InputfieldFieldsetOpen
+ * @property InputfieldFieldsetTabOpen $InputfieldFieldsetTabOpen
+ * @property InputfieldFile $InputfieldFile
+ * @property InputfieldFloat $InputfieldFloat
+ * @property InputfieldForm $InputfieldForm
+ * @property InputfieldHidden $InputfieldHidden
+ * @property InputfieldIcon $InputfieldIcon
+ * @property InputfieldImage $InputfieldImage
+ * @property InputfieldInteger $InputfieldInteger
+ * @property InputfieldMarkup $InputfieldMarkup
+ * @property InputfieldName $InputfieldName
+ * @property InputfieldPage $InputfieldPage
+ * @property InputfieldPageAutocomplete $InputfieldPageAutocomplete
+ * @property InputfieldPageListSelect $InputfieldPageListSelect
+ * @property InputfieldPageListSelectMultiple $InputfieldPageListSelectMultiple
+ * @property InputfieldPageName $InputfieldPageName
+ * @property InputfieldPageTable $InputfieldPageTable
+ * @property InputfieldPageTitle $InputfieldPageTitle
+ * @property InputfieldPassword $InputfieldPassword
+ * @property InputfieldRadios $InputfieldRadios
+ * @property InputfieldRepeater $InputfieldRepeater
+ * @property InputfieldSelect $InputfieldSelect
+ * @property InputfieldSelectMultiple $InputfieldSelectMultiple
+ * @property InputfieldSelector $InputfieldSelector
+ * @property InputfieldSubmit $InputfieldSubmit
+ * @property InputfieldText $InputfieldText
+ * @property InputfieldTextarea $InputfieldTextarea
+ * @property InputfieldTextTags $InputfieldTextTags
+ * @property InputfieldToggle $InputfieldToggle
+ * @property InputfieldURL $InputfieldURL
+ * @property InputfieldWrapper $InputfieldWrapper
  *
  */
 
@@ -197,6 +239,13 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 	 */
 	public function __get($key) {
 		if($key === 'children') return $this->children();
+		if(strpos($key, 'Inputfield') === 0 && strlen($key) > 10) {
+			if($key === 'InputfieldWrapper') return $this->wire(new InputfieldWrapper()); 
+			$value = $this->wire()->modules->get($key);
+			if($value && $value instanceof Inputfield) return $value;
+			if(wireClassExists($key)) return $this->wire(new $key()); 
+			$value = null;
+		}
 		$value = parent::get($key); 
 		if(is_null($value)) $value = $this->getChildByName($key);
 		return $value; 
@@ -1408,11 +1457,14 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 
 		$inputfields = parent::___getConfigInputfields();
 
-		// remove all options for 'collapsed' except collapsedYes and collapsedNo
+		/** @var InputfieldSelect $f */
-		foreach($inputfields as $f) {
+		$f = $inputfields->getChildByName('collapsed');
-			if($f->attr('name') != 'collapsed') continue; 
+		if($f) {
+			// remove all options for 'collapsed' except collapsedYes and collapsedNo
 			foreach($f->getOptions() as $value => $label) {
-				if(!in_array($value, array(Inputfield::collapsedNo, Inputfield::collapsedYes))) $f->removeOption($value); 
+				if(!in_array($value, array(Inputfield::collapsedNo, Inputfield::collapsedYes))) {
+					$f->removeOption($value);
+				}
 			}
 		}
 

wire/modules/Process/ProcessProfile/ProcessProfile.module

@@ -1,12 +1,11 @@
 <?php namespace ProcessWire;
 
 /**
- * ProcessWire Self Profile
+ * ProcessWire User Profile Editor
  *
- * ProcessWire 3.x, Copyright 2018 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2021 by Ryan Cramer
  * https://processwire.com
  *
- * 
  * @property array $profileFields Names of fields user is allowed to edit in their profile
  * @method bool|string isDisallowedUserName($value)
  *
@@ -18,10 +17,10 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 		return array(
 			'title' => __('User Profile', __FILE__), // getModuleInfo title          
 			'summary' => __('Enables user to change their password, email address and other settings that you define.', __FILE__), // getModuleInfo summary 
-			'version' => 104, 
+			'version' => 105, 
 			'permanent' => true, 
 			'permission' => 'profile-edit',
-			);
+		);
 	}
 	
 	/**
@@ -67,19 +66,19 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 		
 		$fieldName = '';
 		if(isset($_SERVER['HTTP_X_FIELDNAME'])) {
-			$fieldName = $this->sanitizer->fieldName($_SERVER['HTTP_X_FIELDNAME']);
+			$fieldName = $this->wire()->sanitizer->fieldName($_SERVER['HTTP_X_FIELDNAME']);
 		}
 
-		$this->user = $this->wire('user'); 
+		$this->user = $this->wire()->user; 
 		$this->headline($this->_("Profile:") . ' ' . $this->user->name); // Primary Headline (precedes the username)
 		$form = $this->buildForm($fieldName);
 		
-		if($this->input->post('submit_save_profile') || $fieldName) {
+		if($this->wire()->input->post('submit_save_profile') || $fieldName) {
 			$this->processInput($form, $fieldName); 
 			if($fieldName) {
 				// no need to redirect
 			} else {
-				$this->session->redirect("./");
+				$this->wire()->session->redirect("./");
 			}
 				
 		} else { 
@@ -99,10 +98,10 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 	
 		/** @var User $user */
 		$user = $this->user;
+		$modules = $this->wire()->modules;
 
 		/** @var InputfieldForm $form */
-		$form = $this->modules->get('InputfieldForm');
+		$form = $modules->get('InputfieldForm');
-
 		$form->attr('id', 'ProcessProfile'); 
 		$form->attr('action', './'); 
 		$form->attr('method', 'post'); 
@@ -118,14 +117,17 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 		$passRequired = false;
 		// Inputfields where password is required to change
 		$passRequiredInputfields = array();
-		$this->wire('config')->js('ProcessProfile', array(
+		$this->wire()->config->js('ProcessProfile', array(
 			'passRequiredAlert' => $this->_('For security, please enter your current password to save these changes:')
 		));
-		$this->wire('modules')->get('JqueryUI')->use('vex');
+		
+		/** @var JqueryUI $jQueryUI */
+		$jQueryUI = $modules->get('JqueryUI');
+		$jQueryUI->use('vex');
 		
 		if(in_array('name', $this->profileFields) && empty($fieldName)) {
 			/** @var InputfieldText $f */
-			$f = $this->wire('modules')->get('InputfieldText');
+			$f = $modules->get('InputfieldText');
 			$f->attr('id+name', '_user_name');
 			$f->label = $this->userNameLabel;
 			$f->description = $this->_('User name may contain lowercase a-z, 0-9, hyphen or underscore.'); 
@@ -185,7 +187,7 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 	
 		/** @var InputfieldHidden $f */
 		// note used for processing, present only for front-end JS compatibility with ProcessPageEdit
-		$f = $this->modules->get('InputfieldHidden');
+		$f = $modules->get('InputfieldHidden');
 		$f->attr('id', 'Inputfield_id');
 		$f->attr('name', 'id'); 
 		$f->attr('value', $user->id);
@@ -193,7 +195,7 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 		$fieldset->add($f);
 
 		/** @var InputfieldSubmit $field */
-		$field = $this->modules->get('InputfieldSubmit');
+		$field = $modules->get('InputfieldSubmit');
 		$field->attr('id+name', 'submit_save_profile'); 
 		$field->showInHeader();
 		$form->add($field); 
@@ -202,7 +204,6 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 			foreach($passRequiredInputfields as $f) {
 				$f->addClass('InputfieldPassRequired', 'wrapClass');
 				$this->passRequiredNames[$f->name] = $f->name;
-				// $f->notes = ($f->notes ? "$f->notes\n" : "") . $passRequiredNote;
 			}
 		}
 	
@@ -222,15 +223,16 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 		/** @var InputfieldForm $form */
 
 		$user = $this->user; 
-		$languages = $this->wire('languages');
+		$input = $this->wire()->input;
-		$form->processInput($this->input->post);
+		$languages = $this->wire()->languages;
+		$form->processInput($input->post);
 
 		if(count($form->getErrors())) {
 			$this->error($this->_("Profile not saved")); 
 			return;
 		}
 		
-		$passValue = $this->input->post->string('_old_pass');
+		$passValue = $input->post->string('_old_pass');
 		
 		if(strlen($passValue)) {
 			$passAuthenticated = $user->pass->matches($passValue);
@@ -259,7 +261,7 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 			if($field->name == 'roles' || !in_array($field->name, $this->profileFields)) continue;
 			if($fieldName && $field->name !== $fieldName) continue; 
 			
-			$field = $this->user->fields->getFieldContext($field);
+			$field = $user->fields->getFieldContext($field);
 			$inputfield = $form->getChildByName($field->name); 	
 			$value = $inputfield->attr('value');
 			
@@ -273,27 +275,36 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 				}
 			}
 			
-			$v = $user->get($field->name);
+			$userValue = $user->get($field->name);
-			if($field->type instanceof FieldtypeModule) $v = "$v";
+			if($field->type instanceof FieldtypeModule) $userValue = "$userValue";
+			$changed = false;
 			
-			if($inputfield->isChanged() || $v !== $value) {
+			if($inputfield->isChanged()) {
+				$changed = true;
+			} else if(is_array($value) && $userValue instanceof WireData) { // i.e. Combo
+				$userValueArray = $userValue->getArray();
+				$changed = $userValueArray != $value;
+			} else if($userValue !== $value) {
+				$changed = true;
+			}
+			
+			if(!$changed) continue;
 				
-				if(isset($this->passRequiredNames[$inputfield->name]) && !$passAuthenticated) {
+			if(isset($this->passRequiredNames[$inputfield->name]) && !$passAuthenticated) {
-					$inputfield->error($passFailedMessage);
+				$inputfield->error($passFailedMessage);
-					continue;	
+				continue;	
-				}
+			}
 
-				if($languages && $inputfield->getSetting('useLanguages')) {
+			if($languages && $inputfield->getSetting('useLanguages')) {
-					if(is_object($v)) {
+				if(is_object($userValue)) {
-						$v->setFromInputfield($inputfield);
+					$userValue->setFromInputfield($inputfield);
-						$user->set($field->name, $v);
+					$user->set($field->name, $userValue);
-						$user->trackChange($field->name);
+					$user->trackChange($field->name);
-					} else {
-						$user->set($field->name, $value);
-					}
 				} else {
 					$user->set($field->name, $value);
 				}
+			} else {
+				$user->set($field->name, $value);
 			}
 		}
 
@@ -301,18 +312,24 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 			$changes = implode(', ', array_unique($user->getChanges())); 
 			$message = $this->_('Profile saved') . ' - ' . $changes; 
 			$this->message($message);
-			$this->wire('log')->message($message); 
+			$this->wire()->log->message($message); 
-			$this->wire('users')->save($user);
+			$this->wire()->users->save($user);
 		}
 
 		$user->of(true); 
 	}
-	
+
+	/**
+	 * Process username inputfield
+	 * 
+	 * @param Inputfield $f The _user_name Inputfield
+	 * @return bool Returns true if username changed allowed, false if not
+	 * 
+	 */
 	protected function processInputUsername(Inputfield $f) {
 		
 		$user = $this->user;
-		
+		$userName = $this->wire()->sanitizer->pageName($f->val());
-		$userName = $this->wire('sanitizer')->pageName($f->val());
 		
 		if(empty($userName)) return false;
 		if($f->val() === $user->name) return false; // no change
@@ -328,8 +345,8 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 		
 		$user->name = $userName;
 	
-		if($this->wire('modules')->isInstalled('LanguageSupportPageNames')) {
+		if($this->wire()->modules->isInstalled('LanguageSupportPageNames')) {
-			foreach($this->wire('languages') as $language) {
+			foreach($this->wire()->languages as $language) {
 				if(!$language->isDefault()) $user->set("name$language->id", $userName);
 			}
 		}
@@ -355,10 +372,9 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 			'nobody',
 		);
 
-		/** @var Languages $languages */
+		$languages = $this->wire()->languages;
-		$languages = $this->wire('languages');
 		$notAllowedLabel = $this->_('Not allowed');
-		$userName = $this->wire('sanitizer')->pageName($value);
+		$userName = $this->wire()->sanitizer->pageName($value);
 		
 		if($userName !== $value) {
 			return sprintf($this->_('Sanitized to “%s”, which differs from what you entered'), $userName);
@@ -376,13 +392,13 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 
 		// check if user name is already in use
 		if($languages) $languages->setDefault();
-		$u = $this->wire('users')->get("name='$userName', include=all");
+		$u = $this->wire()->users->get("name='$userName', include=all");
 		if($languages) $languages->unsetDefault();
 		if($u->id) {
 			return $this->_('Already in use');
 		}
 
-		$role = $this->wire('roles')->get("name='$userName', include=all");
+		$role = $this->wire()->roles->get("name='$userName', include=all");
 		if($role->id) {
 			return "$notAllowedLabel (#2)";
 		}
@@ -411,7 +427,7 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 		$profileFields = isset($data['profileFields']) ? $data['profileFields'] : array();
 		$fieldOptions = array();
 		
-		foreach($this->wire('users')->getTemplates() as $template) {
+		foreach($this->wire()->users->getTemplates() as $template) {
 			foreach($template->fieldgroup as $field) {
 				$fieldOptions[$field->name] = $field;
 			}
@@ -420,7 +436,9 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 		ksort($fieldOptions);
 
 		$inputfields = $this->wire(new InputfieldWrapper());
-		$f = $this->wire('modules')->get('InputfieldCheckboxes');
+		
+		/** @var InputfieldCheckboxes $f */
+		$f = $this->wire()->modules->get('InputfieldCheckboxes');
 		$f->label = $this->_("What fields can a user edit in their own profile?");
 		$f->attr('id+name', 'profileFields');
 		$f->icon = 'user-circle';
@@ -450,7 +468,7 @@ class ProcessProfile extends Process implements ConfigurableModule, WirePageEdit
 	 * 
 	 */
 	public function getPage() {
-		return $this->wire('user');
+		return $this->wire()->user;
 	}