Validation logic: Added IASKValidationResultOkWithReplacement

indicating that the validation is OK with the replacement performed;
this is useful to auto-fix wrong content (the sample app adds an @ as the account name prefix);

InAppSettingsKit.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
 	s.name                  = 'InAppSettingsKit'
-	s.version               = '3.8.2'
+	s.version               = '3.8.3'
 	s.summary               = 'This iPhone framework allows settings to be in-app in addition to being in the Settings app.'
 
   s.description      = <<-DESC

InAppSettingsKitSampleApp/Classes/MainViewController.swift

@@ -91,6 +91,22 @@ extension MainViewController: IASKSettingsDelegate {
 			}
 			textField.textColor = .red
 			return .failed
+		} else if key == "account_name", let value = textField.text {
+			let regex = "^@?[\\w](?!.*?\\.{2})[\\w.]{1,28}[\\w]$"
+			if value.isEmpty {
+				return .ok
+			} else if value == "@" {
+				replacement?.pointee = "" as NSString
+				return .failed
+			} else if value.range(of: regex, options: .regularExpression) == nil {
+				if let previousValue {
+					replacement?.pointee = previousValue as NSString
+					return .failedWithShake
+				}
+			} else if !value.hasPrefix("@") {
+				replacement?.pointee = "@\(value)" as NSString
+				return .okWithReplacement
+			}
 		}
 		return .ok
 	}

InAppSettingsKitSampleApp/Settings.bundle/Complete.plist

@@ -304,6 +304,18 @@
 			<key>IASKCellImage</key>
 			<string>mail</string>
 		</dict>
+		<dict>
+			<key>Type</key>
+			<string>PSTextFieldSpecifier</string>
+			<key>Title</key>
+			<string>Account</string>
+			<key>Key</key>
+			<string>account_name</string>
+			<key>AutocorrectionType</key>
+			<string>No</string>
+			<key>IASKCellImage</key>
+			<string>person.crop.circle</string>
+		</dict>
 		<dict>
 			<key>Type</key>
 			<string>PSGroupSpecifier</string>

Sources/InAppSettingsKit/Controllers/IASKAppSettingsViewController.m

@@ -1204,6 +1204,9 @@ - (void)textFieldDidEndEditing:(IASKTextField *)textField {
 	};
 
 	switch (result) {
+		case IASKValidationResultOkWithReplacement:
+			restoreText();
+			// fallthrough
 		case IASKValidationResultOk: {
 			if (![self.settingsStore objectForSpecifier:specifier] && textField.text.length == 0) {
 				return;

Sources/InAppSettingsKit/include/IASKAppSettingsViewController.h

@@ -176,8 +176,16 @@ shouldPresentMailComposeViewController:(MFMailComposeViewController*)mailCompose
 
 #pragma mark - Validation
 typedef NS_ENUM(NSUInteger, IASKValidationResult) {
+	/** validation is OK, no replacement is performed. */
 	IASKValidationResultOk,
+
+	/** validation is OK with the replacement performed. */
+	IASKValidationResultOkWithReplacement,
+
+	/** validation has failed, the replacement is performed. */
 	IASKValidationResultFailed,
+
+	/** validation has failed, the replacement is performed, and the field shakes to indicate the error. */
 	IASKValidationResultFailedWithShake,
 };
 /** validate user input in text fields