<?xml version="1.0" encoding="utf-8"?>
<mx:VBox xmlns:mx="http://www.adobe.com/2006/mxml"   >
  
  <!-- 
  		Flex Password Entry with Strength Indicator
  		(c) 2008 Darkened Sky Studios.
  		Matt Holden, Technical Director
  		mholden@darkenedsky.com
  		
  		This Flex component provides the following functionality:
  		* Two TextInput controls to enter password and confirmation (displayed as password, whitespace trimmed)
  		* Indicator when the passwords do not match
  		* Optional minimum length validation
  		* Optional ability to show plain text passwords when controls are moused over
  		* Password strength calculation and indicator in both words and graphically
  		* Methods to access the completed password and validate that the password is legitimate.
  		
  		Known Issues:
  		* The cursor jumps when displayAsPassword is toggled. This sometimes causes trailing spaces (hence the trimming).
  		
  		Future Improvements:
  		* Add hash table of common English words to the scoring algorithm
  		* Consider a custom Validator instead of the errorLine to display when the passwords don't match  		
  		
  		This code is offered under the MIT license, below. For non-lawyers, it goes like this:
  		Leave this notice in here, and we don't care if you use it intact, change every line (except this notice), learn from it, teach people with it, 
  		sell it on eBay, eat it, send it to Scandinavia via singing telegram, or print it out and wallpaper your bathroom with it. 
  		
  		Password strength algorithm adapted, with modifications, from code found at http://www.geekwisdom.com/dyn/passwdmeter.
  		
  		Enjoy. ;)
  		
  		===========================
  		Revision Log
  		===========================
  		1.00			06/25/2008			Initial release.
  		
  		
  -->
  <!--
	    The MIT License Copyright (c) 2008 Darkened Sky Studios.
	    Permission is hereby granted, free of charge, to any person obtaining a copy
		of this software and associated documentation files (the "Software"), to deal
		in the Software without restriction, including without limitation the rights
		to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
		copies of the Software, and to permit persons to whom the Software is
		furnished to do so, subject to the following conditions: The above copyright 
		notice and this permission notice shall be included in all copies or substantial 
		portions of the Software. 
		
		THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
		IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
		FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
		AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
		LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
		OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
		THE SOFTWARE.   
 -->
 
  <!-- Validate the length of the passwords -->
  <mx:StringValidator 
        id="passlength1validator"
        source="{password}" 
        property="text"
        minLength="{minLength}"
        required="true"
    />
    
   
  <!-- Validate the length of the passwords -->
     <mx:StringValidator 
        id="passlength2validator"
        source="{password2}" 
        property="text"
        minLength="{minLength}"
        required="true"
    />
    
    <!-- use hboxes and vboxes to make a table-like alignment of controls -->
		 	<mx:HBox>
		 	
		 			<!-- Labels for the controls -->
					 <mx:VBox width="50%">
					 	<mx:Label text="Enter a Password:"  />
					 	<mx:Label text="Confirm Password:"  />
					 </mx:VBox>
					 
					<!-- The password enter boxes -->			 
					  <mx:VBox width="50%">
					  
					  	<!-- the mouseOver and mouseOut properties will allow password hiding to be turned on and off. To use this, the 'showOnMouseOver' property must be set to true. -->
					 	<mx:TextInput id="password"     displayAsPassword="true"   mouseOver="hidePassword(password, false);" mouseOut="hidePassword(password, true);" change="score(); match();" />
					  	<mx:TextInput id="password2"   displayAsPassword="true"   mouseOver="hidePassword(password2, false);" mouseOut="hidePassword(password2, true);" change="match();" />
							
					   </mx:VBox>
								
		 </mx:HBox>
		
		<!-- Show the error line (where we tell the users when the passwords don't match) centered in the control.
		        TODO: Try to use a custom Validator to handle this condition -->
		 <mx:HBox  verticalAlign="top" width="100%" >
			 <mx:Spacer width="100%" />
					<mx:Label id="errorLine" text="Passwords do not match." visible = "false" 
							textAlign="center"  color="0xFF0000" fontStyle="bold" fontSize="9" height="20" paddingTop = "0" paddingBottom="0" />
			 <mx:Spacer width="100%" />
	  	</mx:HBox>
	  	
	  	
	  <!-- Center the progress bar on the control.
	  		  Use the max/min settings to match the scorePassword values and place the label dead center on the bar.
	  -->
	  <mx:HBox width="100%">
	  	<mx:Spacer width="10%" />
	  	<mx:ProgressBar id="meter" width="80%" maximum="40" minimum = "0"  mode="manual"  trackHeight="20" label = "Password Strength"  borderColor="0x000000" labelPlacement = "center" />		
	  	<mx:Spacer width="10%" />
	  </mx:HBox>
	  
	 	<mx:Script>
				<![CDATA[
				  import mx.events.ValidationResultEvent;
              	  import mx.controls.TextInput;
				  import mx.utils.StringUtil;
		
						// The minimum length of a password
						[Bindable]	public var minLength : Number = 6;
					
						// If 'true', show the passwords on mouseover
						[Bindable]	public var showOnMouseOver : Boolean = true;
						 String
						// Return the password if there are no error conditions and both fields are filled in and match.
						public function getPassword() : String { 
							return (StringUtil.trim(password.text).length >= minLength &&
								 StringUtil.trim(password.text) === StringUtil.trim(password2.text)) ? StringUtil.trim(password.text) : null;
						}
						
						// Toggle the mouse out/mouse over display
						// Known issue: The cursor jumps when switching back and forth between modes
						public function hidePassword(tbox : TextInput, hide : Boolean) : void { 
							if (showOnMouseOver)
									tbox.displayAsPassword= hide;
						}
										
						// give parent controls a way to ask if we can trust the data. Use this before allowing actions like clicking a Submit button.
						public function validate() : Boolean { 
							  var vResult : ValidationResultEvent = passlength1validator.validate();
							  if (vResult.type == ValidationResultEvent.INVALID)
							  	return false;
							  vResult  = passlength2validator.validate();
							  if (vResult.type == ValidationResultEvent.INVALID)
							  	return false;
							  
							  return (getPassword() != null);
						}
        
          				// Calculate the password's score and update the meter accordingly.
						private function score() : void { 
									
							var score : Number = scorePassword(password.text);
							
							meter.setProgress(Math.min(score, 40), 40);													
							meter.setStyle("barColor", getColor(score));
							meter.label = getDescriptor(score);
							
						}
											
						// Show the error if password1 and password2 don't match
						private function match() : void { 
									errorLine.visible =  (
											 StringUtil.trim(password.text).length   > 0 && 
											 StringUtil.trim(password2.text).length > 0 && 
											(StringUtil.trim(password.text) === StringUtil.trim(password2.text)) == false);
						}
						
					// Shortcut to determine if the string is an uppercase character for counting
					public static function isUpperCase(char : Number) : Boolean { 
						return (char >= 65 && char <= 90);
					}
					
					// Shortcut to determine if the string is a lowercase character for counting
					public static function isLowerCase(char : Number) : Boolean { 
						return (char >= 97 && char <= 122);
					}
					
					// Shortcut to determine if the character is a digit
					public static function isDigit(char : Number) : Boolean { 
						return (char >= 48 && char <=57);
					}
					
					// anything but a space, a letter, a number, or a key like control or escape is considered a special character
					public static function isSpecial(char : Number) : Boolean { 
						return ( char >= 33 && char != 127 && !isUpperCase(char) && !isLowerCase(char) && !isDigit(char) );
					}
					
					// get the score based on the password length
					public  static function scoreLength(length : Number) : Number { 
						if (length == 0) return 0;
						if (length <= 4) return 3;
						if (length <= 7) return 6;
						if (length <= 10) return 9;
						if (length <= 15) return 12;
						return 15;
					}
					
					// return the scoring of the password
					public static  function scorePassword(pass : String) : Number { 
						var score : Number = 0;
						
						// score for length
						var pass : String = pass;
						var length : Number = pass.length;						
						score += scoreLength(length);
						
						// we'll count how many of these we see
						var lcase : Number = 0;
						var ucase : Number = 0;
						var numbers : Number = 0;
						var special : Number = 0;
				
						// count characters of type for future use
						for (var i : int = 0; i < pass.length; i++) { 
						 	var char : Number = pass.charCodeAt(i);
						 	if (isLowerCase(char)) 
						 		lcase++;
						 	if (isUpperCase(char)) 
						 		ucase++;
						 	if (isSpecial(char)) 
						 		special++;
						 	if (isDigit(char)) 
						 		numbers++;						
						}
						
						// at least 1 lowercase
						if (lcase >= 1)
							score += 1;
							
						// at least 1 capital 
						if (ucase >= 1)
							score += 5;
							
						// at least 3 capital
						if (ucase >= 3)
							score += 2;
						
						// at least 1 number
						if (numbers >= 1)
							score += 5;
							
						// at least 3 #s
						if (numbers >= 3)
							score += 5;
							
						// at least 1 special
						if (special >= 1)
							score += 5;
							
						// at least 2 special
						if (special >= 2) 
							score += 5;
							
						// combo : number and special
						if (numbers >= 1 && special >= 1)
							score += 1;
						
						// combo : letter and special
						var letters : Number = ucase + lcase;
						
						if (letters >= 1 && special >= 1)
							score += 1;
						
						// combo: Letter and number
						if (letters >= 1 && numbers >= 1)
							score += 2;
							
						// combo: upper and lower case
						if (ucase >= 1 && lcase >= 1)
							score += 2;
												
						return score;												
					}
									
					// returns the label for the bar based on the score
					public static function getDescriptor (score : Number) : String { 
						
						if (score < 10) return ("Very Weak");
						if (score < 20) return  ("Weak")
						if (score < 30) return ("Medium")
						if (score < 40) return  ("Strong")
						return ("Very Strong")					
					}
					
					// returns the color of the bar based on the score
					public static function getColor (score : Number) : Number { 
						
						if (score < 10) return 0xFF0000;
						if (score < 20) return 0xFF3300;
						if (score < 30) return 0xFFCC00;
						if (score < 40) return 0x33CC33;
						return 0x00FF00;						
					}

				]]>
			</mx:Script>
			
</mx:VBox>