intl_phone_picker 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 318e1c5b9ab34da80c63ac464f0238904d9631e9
+  data.tar.gz: abcfe47d4c66a86b5be532e28b187707b96b2420
+SHA512:
+  metadata.gz: 5d76cfdd5d7f62c53b45d98850d068a3224dc7e7adc0e3f82aae9f3a00157063bc9091160f2fd1f4cdc98a7e832f4df3e1192a29b33705819cbc92028f5865a0
+  data.tar.gz: 43ded395b15f12a51f906f77de61f38c243d825baa0548e216671fb4a10174826ddd12b78b5fa705df47ded2aee138656ee48648858257ef3eda4b66657f2203

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+# Version 0.0.1
+
+  - Import javascript and css libraries

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in intl_phone_picker.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,23 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Fabien Dobat
+
+
+
+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.

data/README.md

@@ -0,0 +1,65 @@
+## Sources
+
+  - Javascript based library : https://github.com/Bluefieldscom/intl-tel-input
+  - Ruby based gem : https://github.com/ispyropoulos/intl-tel-input-rails
+  - French language generator : https://github.com/harold-s/harold-s/tree/master/intl-tel-input-french-translation
+
+# IntlPhonePicker
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/intl_phone_picker`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'intl_phone_picker'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install intl_phone_picker
+
+To use javascript and stylesheet libraries you need to add :
+
+  - In application default stylesheet file :
+
+    ```ruby
+    //= require intlTelInput
+    ```
+
+  - In application default javascript file :
+
+    ```ruby
+    //= require intlTelInput
+    ```
+
+  - If you want to enable it on all tel fields by default, add :
+
+    ```ruby
+    //= require intl_phone_picker
+    ```
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/intl_phone_picker/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "intl_phone_picker"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/intl_phone_picker.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'intl_phone_picker/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "intl_phone_picker"
+  spec.version       = "0.0.1"
+  spec.authors       = ["Fabien Dobat\n\n"]
+  spec.email         = ["fabien.dobat@seniormedia.fr"]
+
+  if spec.respond_to?(:metadata)
+    # spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com' to prevent pushes to rubygems.org, or delete to allow pushes to any server."
+  end
+
+  spec.summary       = %q{Write a short summary, because Rubygems requires one.}
+  spec.description   = %q{Write a longer description or delete this line.}
+  # spec.homepage      = "Put your gem's website or public repo URL here."
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split("\n")
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.8"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_dependency "railties", "~> 4.2.1"
+end

data/lib/intl_phone_picker.rb

@@ -0,0 +1,6 @@
+require "intl_phone_picker/version"
+
+module IntlPhonePicker
+  class Engine < ::Rails::Engine
+  end
+end

data/lib/intl_phone_picker/version.rb

@@ -0,0 +1,3 @@
+module IntlPhonePicker
+  VERSION = "0.1.0"
+end

data/vendor/assets/javascripts/intlTelInput.js

@@ -0,0 +1,1007 @@
+/*
+International Telephone Input v4.0.0
+https://github.com/Bluefieldscom/intl-tel-input.git
+*/
+// wrap in UMD - see https://github.com/umdjs/umd/blob/master/jqueryPlugin.js
+(function(factory) {
+    if (typeof define === "function" && define.amd) {
+        define([ "jquery" ], function($) {
+            factory($, window, document);
+        });
+    } else {
+        factory(jQuery, window, document);
+    }
+})(function($, window, document, undefined) {
+    "use strict";
+    var pluginName = "intlTelInput", id = 1, // give each instance it's own id for namespaced event handling
+    defaults = {
+        // automatically format the number according to the selected country
+        autoFormat: true,
+        // if there is just a dial code in the input: remove it on blur, and re-add it on focus
+        autoHideDialCode: true,
+        // default country
+        defaultCountry: "",
+        // token for ipinfo - required for https or over 1000 daily page views support
+        ipinfoToken: "",
+        // don't insert international dial codes
+        nationalMode: true,
+        // number type to use for placeholders
+        numberType: "MOBILE",
+        // display only these countries
+        onlyCountries: [],
+        // the countries at the top of the list. defaults to united states and united kingdom
+        preferredCountries: [ "us", "gb" ],
+        // stop the user from typing invalid numbers
+        preventInvalidNumbers: false,
+        // specify the path to the libphonenumber script to enable validation/formatting
+        utilsScript: ""
+    }, keys = {
+        UP: 38,
+        DOWN: 40,
+        ENTER: 13,
+        ESC: 27,
+        PLUS: 43,
+        A: 65,
+        Z: 90,
+        ZERO: 48,
+        NINE: 57,
+        SPACE: 32,
+        BSPACE: 8,
+        DEL: 46,
+        CTRL: 17,
+        CMD1: 91,
+        // Chrome
+        CMD2: 224
+    }, windowLoaded = false;
+    // keep track of if the window.load event has fired as impossible to check after the fact
+    $(window).load(function() {
+        windowLoaded = true;
+    });
+    function Plugin(element, options) {
+        this.element = element;
+        this.options = $.extend({}, defaults, options);
+        this._defaults = defaults;
+        // event namespace
+        this.ns = "." + pluginName + id++;
+        // Chrome, FF, Safari, IE9+
+        this.isGoodBrowser = Boolean(element.setSelectionRange);
+        this.hadInitialPlaceholder = Boolean($(element).attr("placeholder"));
+        this._name = pluginName;
+        this.init();
+    }
+    Plugin.prototype = {
+        init: function() {
+            var that = this;
+            // if defaultCountry is set to "auto", we must do a lookup first
+            if (this.options.defaultCountry == "auto") {
+                // reset this in case lookup fails
+                this.options.defaultCountry = "";
+                var ipinfoURL = "//ipinfo.io";
+                if (this.options.ipinfoToken) {
+                    ipinfoURL += "?token=" + this.options.ipinfoToken;
+                }
+                $.get(ipinfoURL, function(response) {
+                    if (response && response.country) {
+                        that.options.defaultCountry = response.country.toLowerCase();
+                    }
+                }, "jsonp").always(function() {
+                    that._ready();
+                });
+            } else {
+                this._ready();
+            }
+        },
+        _ready: function() {
+            // if in nationalMode, disable options relating to dial codes
+            if (this.options.nationalMode) {
+                this.options.autoHideDialCode = false;
+            }
+            // IE Mobile doesn't support the keypress event (see issue 68) which makes autoFormat impossible
+            if (navigator.userAgent.match(/IEMobile/i)) {
+                this.options.autoFormat = false;
+            }
+            // process all the data: onlyCountries, preferredCountries etc
+            this._processCountryData();
+            // generate the markup
+            this._generateMarkup();
+            // set the initial state of the input value and the selected flag
+            this._setInitialState();
+            // start all of the event listeners: autoHideDialCode, input keydown, selectedFlag click
+            this._initListeners();
+        },
+        /********************
+   *  PRIVATE METHODS
+   ********************/
+        // prepare all of the country data, including onlyCountries and preferredCountries options
+        _processCountryData: function() {
+            // set the instances country data objects
+            this._setInstanceCountryData();
+            // set the preferredCountries property
+            this._setPreferredCountries();
+        },
+        // add a country code to this.countryCodes
+        _addCountryCode: function(iso2, dialCode, priority) {
+            if (!(dialCode in this.countryCodes)) {
+                this.countryCodes[dialCode] = [];
+            }
+            var index = priority || 0;
+            this.countryCodes[dialCode][index] = iso2;
+        },
+        // process onlyCountries array if present, and generate the countryCodes map
+        _setInstanceCountryData: function() {
+            var i;
+            // process onlyCountries option
+            if (this.options.onlyCountries.length) {
+                this.countries = [];
+                for (i = 0; i < allCountries.length; i++) {
+                    if ($.inArray(allCountries[i].iso2, this.options.onlyCountries) != -1) {
+                        this.countries.push(allCountries[i]);
+                    }
+                }
+            } else {
+                this.countries = allCountries;
+            }
+            // generate countryCodes map
+            this.countryCodes = {};
+            for (i = 0; i < this.countries.length; i++) {
+                var c = this.countries[i];
+                this._addCountryCode(c.iso2, c.dialCode, c.priority);
+                // area codes
+                if (c.areaCodes) {
+                    for (var j = 0; j < c.areaCodes.length; j++) {
+                        // full dial code is country code + dial code
+                        this._addCountryCode(c.iso2, c.dialCode + c.areaCodes[j]);
+                    }
+                }
+            }
+        },
+        // process preferred countries - iterate through the preferences,
+        // fetching the country data for each one
+        _setPreferredCountries: function() {
+            this.preferredCountries = [];
+            for (var i = 0; i < this.options.preferredCountries.length; i++) {
+                var countryCode = this.options.preferredCountries[i], countryData = this._getCountryData(countryCode, false, true);
+                if (countryData) {
+                    this.preferredCountries.push(countryData);
+                }
+            }
+        },
+        // generate all of the markup for the plugin: the selected flag overlay, and the dropdown
+        _generateMarkup: function() {
+            // telephone input
+            this.telInput = $(this.element);
+            // prevent autocomplete as there's no safe, cross-browser event we can react to, so it can easily put the plugin in an inconsistent state e.g. the wrong flag selected for the autocompleted number, which on submit could mean the wrong number is saved (esp in nationalMode)
+            this.telInput.attr("autocomplete", "off");
+            // containers (mostly for positioning)
+            this.telInput.wrap($("<div>", {
+                "class": "intl-tel-input"
+            }));
+            var flagsContainer = $("<div>", {
+                "class": "flag-dropdown"
+            }).insertAfter(this.telInput);
+            // currently selected flag (displayed to left of input)
+            var selectedFlag = $("<div>", {
+                "class": "selected-flag"
+            }).appendTo(flagsContainer);
+            this.selectedFlagInner = $("<div>", {
+                "class": "iti-flag"
+            }).appendTo(selectedFlag);
+            // CSS triangle
+            $("<div>", {
+                "class": "arrow"
+            }).appendTo(this.selectedFlagInner);
+            // country list contains: preferred countries, then divider, then all countries
+            this.countryList = $("<ul>", {
+                "class": "country-list v-hide"
+            }).appendTo(flagsContainer);
+            if (this.preferredCountries.length) {
+                this._appendListItems(this.preferredCountries, "preferred");
+                $("<li>", {
+                    "class": "divider"
+                }).appendTo(this.countryList);
+            }
+            this._appendListItems(this.countries, "");
+            // now we can grab the dropdown height, and hide it properly
+            this.dropdownHeight = this.countryList.outerHeight();
+            this.countryList.removeClass("v-hide").addClass("hide");
+            // on small screens make the dropdown the same width as the input
+            if (window.innerWidth < 500) {
+                this.countryList.outerWidth(this.telInput.outerWidth());
+            }
+            // this is useful in lots of places
+            this.countryListItems = this.countryList.children(".country");
+        },
+        // add a country <li> to the countryList <ul> container
+        _appendListItems: function(countries, className) {
+            // we create so many DOM elements, I decided it was faster to build a temp string
+            // and then add everything to the DOM in one go at the end
+            var tmp = "";
+            // for each country
+            for (var i = 0; i < countries.length; i++) {
+                var c = countries[i];
+                // open the list item
+                tmp += "<li class='country " + className + "' data-dial-code='" + c.dialCode + "' data-country-code='" + c.iso2 + "'>";
+                // add the flag
+                tmp += "<div class='iti-flag " + c.iso2 + "'></div>";
+                // and the country name and dial code
+                tmp += "<span class='country-name'>" + c.name + "</span>";
+                tmp += "<span class='dial-code'>+" + c.dialCode + "</span>";
+                // close the list item
+                tmp += "</li>";
+            }
+            this.countryList.append(tmp);
+        },
+        // set the initial state of the input value and the selected flag
+        _setInitialState: function() {
+            var val = this.telInput.val();
+            // if there is a number, and it's valid, we can go ahead and set the flag, else fall back to default
+            if (this._getDialCode(val)) {
+                this._updateFlagFromNumber(val);
+            } else {
+                var defaultCountry;
+                // check the defaultCountry option, else fall back to the first in the list
+                if (this.options.defaultCountry) {
+                    defaultCountry = this._getCountryData(this.options.defaultCountry, false, false);
+                } else {
+                    defaultCountry = this.preferredCountries.length ? this.preferredCountries[0] : this.countries[0];
+                }
+                this._selectFlag(defaultCountry.iso2);
+                // if empty, insert the default dial code (this function will check !nationalMode and !autoHideDialCode)
+                if (!val) {
+                    this._updateDialCode(defaultCountry.dialCode, false);
+                }
+            }
+            // format
+            if (val) {
+                // this wont be run after _updateDialCode as that's only called if no val
+                this._updateVal(val, false);
+            }
+        },
+        // initialise the main event listeners: input keyup, and click selected flag
+        _initListeners: function() {
+            var that = this;
+            this._initKeyListeners();
+            // autoFormat prevents the change event from firing, so we need to check for changes between focus and blur in order to manually trigger it
+            if (this.options.autoHideDialCode || this.options.autoFormat) {
+                this._initFocusListeners();
+            }
+            // hack for input nested inside label: clicking the selected-flag to open the dropdown would then automatically trigger a 2nd click on the input which would close it again
+            var label = this.telInput.closest("label");
+            if (label.length) {
+                label.on("click" + this.ns, function(e) {
+                    // if the dropdown is closed, then focus the input, else ignore the click
+                    if (that.countryList.hasClass("hide")) {
+                        that.telInput.focus();
+                    } else {
+                        e.preventDefault();
+                    }
+                });
+            }
+            // toggle country dropdown on click
+            var selectedFlag = this.selectedFlagInner.parent();
+            selectedFlag.on("click" + this.ns, function(e) {
+                // only intercept this event if we're opening the dropdown
+                // else let it bubble up to the top ("click-off-to-close" listener)
+                // we cannot just stopPropagation as it may be needed to close another instance
+                if (that.countryList.hasClass("hide") && !that.telInput.prop("disabled") && !that.telInput.prop("readonly")) {
+                    that._showDropdown();
+                }
+            });
+            // if the user has specified the path to the utils script, fetch it on window.load
+            if (this.options.utilsScript) {
+                // if the plugin is being initialised after the window.load event has already been fired
+                if (windowLoaded) {
+                    this.loadUtils();
+                } else {
+                    // wait until the load event so we don't block any other requests e.g. the flags image
+                    $(window).load(function() {
+                        that.loadUtils();
+                    });
+                }
+            }
+        },
+        _initKeyListeners: function() {
+            var that = this;
+            if (this.options.autoFormat) {
+                // format number and update flag on keypress
+                // use keypress event as we want to ignore all input except for a select few keys,
+                // but we dont want to ignore the navigation keys like the arrows etc.
+                // NOTE: no point in refactoring this to only bind these listeners on focus/blur because then you would need to have those 2 listeners running the whole time anyway...
+                this.telInput.on("keypress" + this.ns, function(e) {
+                    // 32 is space, and after that it's all chars (not meta/nav keys)
+                    // this fix is needed for Firefox, which triggers keypress event for some meta/nav keys
+                    // Update: also ignore if this is a metaKey e.g. FF and Safari trigger keypress on the v of Ctrl+v
+                    // Update: also check that we have utils before we do any autoFormat stuff
+                    if (e.which >= keys.SPACE && !e.metaKey && window.intlTelInputUtils && !that.telInput.prop("readonly")) {
+                        e.preventDefault();
+                        // allowed keys are just numeric keys and plus
+                        // we must allow plus for the case where the user does select-all and then hits plus to start typing a new number. we could refine this logic to first check that the selection contains a plus, but that wont work in old browsers, and I think it's overkill anyway
+                        var isAllowedKey = e.which >= keys.ZERO && e.which <= keys.NINE || e.which == keys.PLUS, input = that.telInput[0], noSelection = that.isGoodBrowser && input.selectionStart == input.selectionEnd, max = that.telInput.attr("maxlength"), val = that.telInput.val(), // assumes that if max exists, it is >0
+                        isBelowMax = max ? val.length < max : true;
+                        // first: ensure we dont go over maxlength. we must do this here to prevent adding digits in the middle of the number
+                        // still reformat even if not an allowed key as they could by typing a formatting char, but ignore if there's a selection as doesn't make sense to replace selection with illegal char and then immediately remove it
+                        if (isBelowMax && (isAllowedKey || noSelection)) {
+                            var newChar = isAllowedKey ? String.fromCharCode(e.which) : null;
+                            that._handleInputKey(newChar, true);
+                            // if something has changed, trigger the input event (which was otherwised squashed by the preventDefault)
+                            if (val != that.telInput.val()) {
+                                that.telInput.trigger("input");
+                            }
+                        }
+                        if (!isAllowedKey) {
+                            that.telInput.trigger("invalidkey");
+                        }
+                    }
+                });
+            }
+            // handle keyup event
+            // for autoFormat: we use keyup to catch cut/paste events and also delete events (after the fact)
+            this.telInput.on("keyup" + this.ns, function(e) {
+                // the "enter" key event from selecting a dropdown item is triggered here on the input, because the document.keydown handler that initially handles that event triggers a focus on the input, and so the keyup for that same key event gets triggered here. weird, but just make sure we dont bother doing any re-formatting in this case (we've already done preventDefault in the keydown handler, so it wont actually submit the form or anything).
+                // ALSO: ignore keyup if readonly
+                if (e.which == keys.ENTER || that.telInput.prop("readonly")) {} else if (that.options.autoFormat && window.intlTelInputUtils) {
+                    var isCtrl = e.which == keys.CTRL || e.which == keys.CMD1 || e.which == keys.CMD2, input = that.telInput[0], // noSelection defaults to false for bad browsers, else would be reformatting on all ctrl keys e.g. select-all/copy
+                    noSelection = that.isGoodBrowser && input.selectionStart == input.selectionEnd, // cursorAtEnd defaults to false for bad browsers else they would never get a reformat on delete
+                    cursorAtEnd = that.isGoodBrowser && input.selectionStart == that.telInput.val().length;
+                    // if delete in the middle: reformat with no suffix (no need to reformat if delete at end)
+                    // if backspace: reformat with no suffix (need to reformat if at end to remove any lingering suffix - this is a feature)
+                    // if ctrl and no selection (i.e. could have just been a paste): reformat (if cursorAtEnd: add suffix)
+                    if (e.which == keys.DEL && !cursorAtEnd || e.which == keys.BSPACE || isCtrl && noSelection) {
+                        // important to remember never to add suffix on any delete key as can fuck up in ie8 so you can never delete a formatting char at the end
+                        that._handleInputKey(null, isCtrl && cursorAtEnd);
+                    }
+                    // prevent deleting the plus (if not in nationalMode)
+                    if (!that.options.nationalMode) {
+                        var val = that.telInput.val();
+                        if (val.substr(0, 1) != "+") {
+                            // newCursorPos is current pos + 1 to account for the plus we are about to add
+                            var newCursorPos = that.isGoodBrowser ? input.selectionStart + 1 : 0;
+                            that.telInput.val("+" + val);
+                            if (that.isGoodBrowser) {
+                                input.setSelectionRange(newCursorPos, newCursorPos);
+                            }
+                        }
+                    }
+                } else {
+                    // if no autoFormat, just update flag
+                    that._updateFlagFromNumber(that.telInput.val());
+                }
+            });
+        },
+        // when autoFormat is enabled: handle various key events on the input: the 2 main situations are 1) adding a new number character, which will replace any selection, reformat, and preserve the cursor position. and 2) reformatting on backspace, or paste event (etc)
+        _handleInputKey: function(newNumericChar, addSuffix) {
+            var val = this.telInput.val(), numericBefore = this._getNumeric(val), originalLeftChar, // raw DOM element
+            input = this.telInput[0], digitsOnRight = 0;
+            if (this.isGoodBrowser) {
+                // cursor strategy: maintain the number of digits on the right. we use the right instead of the left so that A) we dont have to account for the new digit (or digits if paste event), and B) we're always on the right side of formatting suffixes
+                digitsOnRight = this._getDigitsOnRight(val, input.selectionEnd);
+                // if handling a new number character: insert it in the right place
+                if (newNumericChar) {
+                    // replace any selection they may have made with the new char
+                    val = val.substr(0, input.selectionStart) + newNumericChar + val.substring(input.selectionEnd, val.length);
+                } else {
+                    // here we're not handling a new char, we're just doing a re-format (e.g. on delete/backspace/paste, after the fact), but we still need to maintain the cursor position. so make note of the char on the left, and then after the re-format, we'll count in the same number of digits from the right, and then keep going through any formatting chars until we hit the same left char that we had before.
+                    originalLeftChar = val.charAt(input.selectionStart - 1);
+                }
+            } else if (newNumericChar) {
+                val += newNumericChar;
+            }
+            // update the number and flag
+            this.setNumber(val, addSuffix);
+            val = this.telInput.val();
+            var numericAfter = this._getNumeric(val), numericIsSame = numericBefore == numericAfter;
+            if (this.options.preventInvalidNumbers && newNumericChar) {
+                if (numericIsSame) {
+                    // if we're trying to add a new numeric char and the numeric digits haven't changed, then trigger invalid
+                    this.telInput.trigger("invalidkey");
+                } else if (numericBefore.length == numericAfter.length) {
+                    // preventInvalidNumbers edge case: adding digit in middle of full number, so a digit gets dropped from the end (numeric digits have changed but are same length)
+                    digitsOnRight--;
+                }
+            }
+            // update the cursor position
+            if (this.isGoodBrowser) {
+                var newCursor;
+                // if it was at the end, keep it there
+                if (!digitsOnRight) {
+                    newCursor = val.length;
+                } else {
+                    // else count in the same number of digits from the right
+                    newCursor = this._getCursorFromDigitsOnRight(val, digitsOnRight);
+                    // but if delete/paste etc, keep going left until hit the same left char as before
+                    if (!newNumericChar) {
+                        newCursor = this._getCursorFromLeftChar(val, newCursor, originalLeftChar);
+                    }
+                }
+                // set the new cursor
+                input.setSelectionRange(newCursor, newCursor);
+            }
+        },
+        // we start from the position in guessCursor, and work our way left until we hit the originalLeftChar or a number to make sure that after reformatting the cursor has the same char on the left in the case of a delete etc
+        _getCursorFromLeftChar: function(val, guessCursor, originalLeftChar) {
+            for (var i = guessCursor; i > 0; i--) {
+                var leftChar = val.charAt(i - 1);
+                if (leftChar == originalLeftChar || $.isNumeric(leftChar)) {
+                    return i;
+                }
+            }
+            return 0;
+        },
+        // after a reformat we need to make sure there are still the same number of digits to the right of the cursor
+        _getCursorFromDigitsOnRight: function(val, digitsOnRight) {
+            for (var i = val.length - 1; i >= 0; i--) {
+                if ($.isNumeric(val.charAt(i))) {
+                    if (--digitsOnRight === 0) {
+                        return i;
+                    }
+                }
+            }
+            return 0;
+        },
+        // get the number of numeric digits to the right of the cursor so we can reposition the cursor correctly after the reformat has happened
+        _getDigitsOnRight: function(val, selectionEnd) {
+            var digitsOnRight = 0;
+            for (var i = selectionEnd; i < val.length; i++) {
+                if ($.isNumeric(val.charAt(i))) {
+                    digitsOnRight++;
+                }
+            }
+            return digitsOnRight;
+        },
+        // listen for focus and blur
+        _initFocusListeners: function() {
+            var that = this;
+            if (this.options.autoHideDialCode) {
+                // mousedown decides where the cursor goes, so if we're focusing we must preventDefault as we'll be inserting the dial code, and we want the cursor to be at the end no matter where they click
+                this.telInput.on("mousedown" + this.ns, function(e) {
+                    if (!that.telInput.is(":focus") && !that.telInput.val()) {
+                        e.preventDefault();
+                        // but this also cancels the focus, so we must trigger that manually
+                        that.telInput.focus();
+                    }
+                });
+            }
+            this.telInput.on("focus" + this.ns, function(e) {
+                var value = that.telInput.val();
+                // save this to compare on blur
+                that.telInput.data("focusVal", value);
+                // on focus: if empty, insert the dial code for the currently selected flag
+                if (that.options.autoHideDialCode && !value && !that.telInput.prop("readonly")) {
+                    that._updateVal("+" + that.selectedCountryData.dialCode, true);
+                    // after auto-inserting a dial code, if the first key they hit is '+' then assume they are entering a new number, so remove the dial code. use keypress instead of keydown because keydown gets triggered for the shift key (required to hit the + key), and instead of keyup because that shows the new '+' before removing the old one
+                    that.telInput.one("keypress.plus" + that.ns, function(e) {
+                        if (e.which == keys.PLUS) {
+                            // if autoFormat is enabled, this key event will have already have been handled by another keypress listener (hence we need to add the "+"). if disabled, it will be handled after this by a keyup listener (hence no need to add the "+").
+                            var newVal = that.options.autoFormat && window.intlTelInputUtils ? "+" : "";
+                            that.telInput.val(newVal);
+                        }
+                    });
+                    // after tabbing in, make sure the cursor is at the end we must use setTimeout to get outside of the focus handler as it seems the selection happens after that
+                    setTimeout(function() {
+                        var input = that.telInput[0];
+                        if (that.isGoodBrowser) {
+                            var len = that.telInput.val().length;
+                            input.setSelectionRange(len, len);
+                        }
+                    });
+                }
+            });
+            this.telInput.on("blur" + this.ns, function() {
+                if (that.options.autoHideDialCode) {
+                    // on blur: if just a dial code then remove it
+                    var value = that.telInput.val(), startsPlus = value.substr(0, 1) == "+";
+                    if (startsPlus) {
+                        var numeric = that._getNumeric(value);
+                        // if just a plus, or if just a dial code
+                        if (!numeric || that.selectedCountryData.dialCode == numeric) {
+                            that.telInput.val("");
+                        }
+                    }
+                    // remove the keypress listener we added on focus
+                    that.telInput.off("keypress.plus" + that.ns);
+                }
+                // if autoFormat, we must manually trigger change event if value has changed
+                if (that.options.autoFormat && window.intlTelInputUtils && that.telInput.val() != that.telInput.data("focusVal")) {
+                    that.telInput.trigger("change");
+                }
+            });
+        },
+        // extract the numeric digits from the given string
+        _getNumeric: function(s) {
+            return s.replace(/\D/g, "");
+        },
+        // show the dropdown
+        _showDropdown: function() {
+            this._setDropdownPosition();
+            // update highlighting and scroll to active list item
+            var activeListItem = this.countryList.children(".active");
+            this._highlightListItem(activeListItem);
+            // show it
+            this.countryList.removeClass("hide");
+            this._scrollTo(activeListItem);
+            // bind all the dropdown-related listeners: mouseover, click, click-off, keydown
+            this._bindDropdownListeners();
+            // update the arrow
+            this.selectedFlagInner.children(".arrow").addClass("up");
+        },
+        // decide where to position dropdown (depends on position within viewport, and scroll)
+        _setDropdownPosition: function() {
+            var inputTop = this.telInput.offset().top, windowTop = $(window).scrollTop(), // dropdownFitsBelow = (dropdownBottom < windowBottom)
+            dropdownFitsBelow = inputTop + this.telInput.outerHeight() + this.dropdownHeight < windowTop + $(window).height(), dropdownFitsAbove = inputTop - this.dropdownHeight > windowTop;
+            // dropdownHeight - 1 for border
+            var cssTop = !dropdownFitsBelow && dropdownFitsAbove ? "-" + (this.dropdownHeight - 1) + "px" : "";
+            this.countryList.css("top", cssTop);
+        },
+        // we only bind dropdown listeners when the dropdown is open
+        _bindDropdownListeners: function() {
+            var that = this;
+            // when mouse over a list item, just highlight that one
+            // we add the class "highlight", so if they hit "enter" we know which one to select
+            this.countryList.on("mouseover" + this.ns, ".country", function(e) {
+                that._highlightListItem($(this));
+            });
+            // listen for country selection
+            this.countryList.on("click" + this.ns, ".country", function(e) {
+                that._selectListItem($(this));
+            });
+            // click off to close
+            // (except when this initial opening click is bubbling up)
+            // we cannot just stopPropagation as it may be needed to close another instance
+            var isOpening = true;
+            $("html").on("click" + this.ns, function(e) {
+                if (!isOpening) {
+                    that._closeDropdown();
+                }
+                isOpening = false;
+            });
+            // listen for up/down scrolling, enter to select, or letters to jump to country name.
+            // use keydown as keypress doesn't fire for non-char keys and we want to catch if they
+            // just hit down and hold it to scroll down (no keyup event).
+            // listen on the document because that's where key events are triggered if no input has focus
+            var query = "", queryTimer = null;
+            $(document).on("keydown" + this.ns, function(e) {
+                // prevent down key from scrolling the whole page,
+                // and enter key from submitting a form etc
+                e.preventDefault();
+                if (e.which == keys.UP || e.which == keys.DOWN) {
+                    // up and down to navigate
+                    that._handleUpDownKey(e.which);
+                } else if (e.which == keys.ENTER) {
+                    // enter to select
+                    that._handleEnterKey();
+                } else if (e.which == keys.ESC) {
+                    // esc to close
+                    that._closeDropdown();
+                } else if (e.which >= keys.A && e.which <= keys.Z || e.which == keys.SPACE) {
+                    // upper case letters (note: keyup/keydown only return upper case letters)
+                    // jump to countries that start with the query string
+                    if (queryTimer) {
+                        clearTimeout(queryTimer);
+                    }
+                    query += String.fromCharCode(e.which);
+                    that._searchForCountry(query);
+                    // if the timer hits 1 second, reset the query
+                    queryTimer = setTimeout(function() {
+                        query = "";
+                    }, 1e3);
+                }
+            });
+        },
+        // highlight the next/prev item in the list (and ensure it is visible)
+        _handleUpDownKey: function(key) {
+            var current = this.countryList.children(".highlight").first();
+            var next = key == keys.UP ? current.prev() : current.next();
+            if (next.length) {
+                // skip the divider
+                if (next.hasClass("divider")) {
+                    next = key == keys.UP ? next.prev() : next.next();
+                }
+                this._highlightListItem(next);
+                this._scrollTo(next);
+            }
+        },
+        // select the currently highlighted item
+        _handleEnterKey: function() {
+            var currentCountry = this.countryList.children(".highlight").first();
+            if (currentCountry.length) {
+                this._selectListItem(currentCountry);
+            }
+        },
+        // find the first list item whose name starts with the query string
+        _searchForCountry: function(query) {
+            for (var i = 0; i < this.countries.length; i++) {
+                if (this._startsWith(this.countries[i].name, query)) {
+                    var listItem = this.countryList.children("[data-country-code=" + this.countries[i].iso2 + "]").not(".preferred");
+                    // update highlighting and scroll
+                    this._highlightListItem(listItem);
+                    this._scrollTo(listItem, true);
+                    break;
+                }
+            }
+        },
+        // check if (uppercase) string a starts with string b
+        _startsWith: function(a, b) {
+            return a.substr(0, b.length).toUpperCase() == b;
+        },
+        // update the input's value to the given val
+        // if autoFormat=true, format it first according to the country-specific formatting rules
+        _updateVal: function(val, addSuffix) {
+            var formatted;
+            if (this.options.autoFormat && window.intlTelInputUtils) {
+                formatted = intlTelInputUtils.formatNumber(val, this.selectedCountryData.iso2, addSuffix, this.options.preventInvalidNumbers);
+                // ensure we dont go over maxlength. we must do this here to truncate any formatting suffix, and also handle paste events
+                var max = this.telInput.attr("maxlength");
+                if (max && formatted.length > max) {
+                    formatted = formatted.substr(0, max);
+                }
+            } else {
+                // no autoFormat, so just insert the original value
+                formatted = val;
+            }
+            this.telInput.val(formatted);
+        },
+        // check if need to select a new flag based on the given number
+        _updateFlagFromNumber: function(number) {
+            // if we're in nationalMode and we're on US/Canada, make sure the number starts with a +1 so _getDialCode will be able to extract the area code
+            // update: if we dont yet have selectedCountryData, but we're here (trying to update the flag from the number), that means we're initialising the plugin with a number that already has a dial code, so fine to ignore this bit
+            if (this.options.nationalMode && this.selectedCountryData && this.selectedCountryData.dialCode == "1" && number.substr(0, 1) != "+") {
+                number = "+1" + number;
+            }
+            // try and extract valid dial code from input
+            var dialCode = this._getDialCode(number);
+            if (dialCode) {
+                // check if one of the matching countries is already selected
+                var countryCodes = this.countryCodes[this._getNumeric(dialCode)], alreadySelected = false;
+                if (this.selectedCountryData) {
+                    for (var i = 0; i < countryCodes.length; i++) {
+                        if (countryCodes[i] == this.selectedCountryData.iso2) {
+                            alreadySelected = true;
+                        }
+                    }
+                }
+                // if a matching country is not already selected (or this is an unknown NANP area code): choose the first in the list
+                if (!alreadySelected || this._isUnknownNanp(number, dialCode)) {
+                    // if using onlyCountries option, countryCodes[0] may be empty, so we must find the first non-empty index
+                    for (var j = 0; j < countryCodes.length; j++) {
+                        if (countryCodes[j]) {
+                            this._selectFlag(countryCodes[j]);
+                            break;
+                        }
+                    }
+                }
+            }
+        },
+        // check if the given number contains an unknown area code from the North American Numbering Plan i.e. the only dialCode that could be extracted was +1 but the actual number's length is >=4
+        _isUnknownNanp: function(number, dialCode) {
+            return dialCode == "+1" && this._getNumeric(number).length >= 4;
+        },
+        // remove highlighting from other list items and highlight the given item
+        _highlightListItem: function(listItem) {
+            this.countryListItems.removeClass("highlight");
+            listItem.addClass("highlight");
+        },
+        // find the country data for the given country code
+        // the ignoreOnlyCountriesOption is only used during init() while parsing the onlyCountries array
+        _getCountryData: function(countryCode, ignoreOnlyCountriesOption, allowFail) {
+            var countryList = ignoreOnlyCountriesOption ? allCountries : this.countries;
+            for (var i = 0; i < countryList.length; i++) {
+                if (countryList[i].iso2 == countryCode) {
+                    return countryList[i];
+                }
+            }
+            if (allowFail) {
+                return null;
+            } else {
+                throw new Error("No country data for '" + countryCode + "'");
+            }
+        },
+        // select the given flag, update the placeholder and the active list item
+        _selectFlag: function(countryCode) {
+            // do this first as it will throw an error and stop if countryCode is invalid
+            this.selectedCountryData = this._getCountryData(countryCode, false, false);
+            this.selectedFlagInner.attr("class", "iti-flag " + countryCode);
+            // update the selected country's title attribute
+            var title = this.selectedCountryData.name + ": +" + this.selectedCountryData.dialCode;
+            this.selectedFlagInner.parent().attr("title", title);
+            // and the input's placeholder
+            this._updatePlaceholder();
+            // update the active list item
+            var listItem = this.countryListItems.children(".iti-flag." + countryCode).first().parent();
+            this.countryListItems.removeClass("active");
+            listItem.addClass("active");
+        },
+        // update the input placeholder to an example number from the currently selected country
+        _updatePlaceholder: function() {
+            if (window.intlTelInputUtils && !this.hadInitialPlaceholder) {
+                var iso2 = this.selectedCountryData.iso2, numberType = intlTelInputUtils.numberType[this.options.numberType || "FIXED_LINE"], placeholder = intlTelInputUtils.getExampleNumber(iso2, this.options.nationalMode, numberType);
+                this.telInput.attr("placeholder", placeholder);
+            }
+        },
+        // called when the user selects a list item from the dropdown
+        _selectListItem: function(listItem) {
+            // update selected flag and active list item
+            var countryCode = listItem.attr("data-country-code");
+            this._selectFlag(countryCode);
+            this._closeDropdown();
+            this._updateDialCode(listItem.attr("data-dial-code"), true);
+            // always fire the change event as even if nationalMode=true (and we haven't updated the input val), the system as a whole has still changed - see country-sync example. think of it as making a selection from a select element.
+            this.telInput.trigger("change");
+            // focus the input
+            this.telInput.focus();
+        },
+        // close the dropdown and unbind any listeners
+        _closeDropdown: function() {
+            this.countryList.addClass("hide");
+            // update the arrow
+            this.selectedFlagInner.children(".arrow").removeClass("up");
+            // unbind key events
+            $(document).off(this.ns);
+            // unbind click-off-to-close
+            $("html").off(this.ns);
+            // unbind hover and click listeners
+            this.countryList.off(this.ns);
+        },
+        // check if an element is visible within it's container, else scroll until it is
+        _scrollTo: function(element, middle) {
+            var container = this.countryList, containerHeight = container.height(), containerTop = container.offset().top, containerBottom = containerTop + containerHeight, elementHeight = element.outerHeight(), elementTop = element.offset().top, elementBottom = elementTop + elementHeight, newScrollTop = elementTop - containerTop + container.scrollTop(), middleOffset = containerHeight / 2 - elementHeight / 2;
+            if (elementTop < containerTop) {
+                // scroll up
+                if (middle) {
+                    newScrollTop -= middleOffset;
+                }
+                container.scrollTop(newScrollTop);
+            } else if (elementBottom > containerBottom) {
+                // scroll down
+                if (middle) {
+                    newScrollTop += middleOffset;
+                }
+                var heightDifference = containerHeight - elementHeight;
+                container.scrollTop(newScrollTop - heightDifference);
+            }
+        },
+        // replace any existing dial code with the new one (if not in nationalMode)
+        // also we need to know if we're focusing for a couple of reasons e.g. if so, we want to add any formatting suffix, also if the input is empty and we're not in nationalMode, then we want to insert the dial code
+        _updateDialCode: function(newDialCode, focusing) {
+            var inputVal = this.telInput.val(), newNumber;
+            // save having to pass this every time
+            newDialCode = "+" + newDialCode;
+            if (this.options.nationalMode && inputVal.substr(0, 1) != "+") {
+                // if nationalMode, we just want to re-format
+                newNumber = inputVal;
+            } else if (inputVal) {
+                // if the previous number contained a valid dial code, replace it
+                // (if more than just a plus character)
+                var prevDialCode = this._getDialCode(inputVal);
+                if (prevDialCode.length > 1) {
+                    newNumber = inputVal.replace(prevDialCode, newDialCode);
+                } else {
+                    // if the previous number didn't contain a dial code, we should persist it
+                    var existingNumber = inputVal.substr(0, 1) != "+" ? $.trim(inputVal) : "";
+                    newNumber = newDialCode + existingNumber;
+                }
+            } else {
+                newNumber = !this.options.autoHideDialCode || focusing ? newDialCode : "";
+            }
+            this._updateVal(newNumber, focusing);
+        },
+        // try and extract a valid international dial code from a full telephone number
+        // Note: returns the raw string inc plus character and any whitespace/dots etc
+        _getDialCode: function(number) {
+            var dialCode = "";
+            // only interested in international numbers (starting with a plus)
+            if (number.charAt(0) == "+") {
+                var numericChars = "";
+                // iterate over chars
+                for (var i = 0; i < number.length; i++) {
+                    var c = number.charAt(i);
+                    // if char is number
+                    if ($.isNumeric(c)) {
+                        numericChars += c;
+                        // if current numericChars make a valid dial code
+                        if (this.countryCodes[numericChars]) {
+                            // store the actual raw string (useful for matching later)
+                            dialCode = number.substr(0, i + 1);
+                        }
+                        // longest dial code is 4 chars
+                        if (numericChars.length == 4) {
+                            break;
+                        }
+                    }
+                }
+            }
+            return dialCode;
+        },
+        /********************
+   *  PUBLIC METHODS
+   ********************/
+        // remove plugin
+        destroy: function() {
+            // make sure the dropdown is closed (and unbind listeners)
+            this._closeDropdown();
+            // key events, and focus/blur events if autoHideDialCode=true
+            this.telInput.off(this.ns);
+            // click event to open dropdown
+            this.selectedFlagInner.parent().off(this.ns);
+            // label click hack
+            this.telInput.closest("label").off(this.ns);
+            // remove markup
+            var container = this.telInput.parent();
+            container.before(this.telInput).remove();
+        },
+        // format the number to the given type
+        getNumber: function(type) {
+            if (window.intlTelInputUtils) {
+                return intlTelInputUtils.formatNumberByType(this.telInput.val(), this.selectedCountryData.iso2, type);
+            }
+            return "";
+        },
+        // get the type of the entered number e.g. landline/mobile
+        getNumberType: function() {
+            if (window.intlTelInputUtils) {
+                return intlTelInputUtils.getNumberType(this.telInput.val(), this.selectedCountryData.iso2);
+            }
+            return -99;
+        },
+        // get the country data for the currently selected flag
+        getSelectedCountryData: function() {
+            // if this is undefined, the plugin will return it's instance instead, so in that case an empty object makes more sense
+            return this.selectedCountryData || {};
+        },
+        // get the validation error
+        getValidationError: function() {
+            if (window.intlTelInputUtils) {
+                return intlTelInputUtils.getValidationError(this.telInput.val(), this.selectedCountryData.iso2);
+            }
+            return -99;
+        },
+        // validate the input val - assumes the global function isValidNumber (from utilsScript)
+        isValidNumber: function() {
+            var val = $.trim(this.telInput.val()), countryCode = this.options.nationalMode ? this.selectedCountryData.iso2 : "", // libphonenumber allows alpha chars, but in order to allow that, we'd need a method to retrieve the processed number, with letters replaced with numbers
+            containsAlpha = /[a-zA-Z]/.test(val);
+            if (!containsAlpha && window.intlTelInputUtils) {
+                return intlTelInputUtils.isValidNumber(val, countryCode);
+            }
+            return false;
+        },
+        // load the utils script
+        loadUtils: function(path) {
+            var utilsScript = path || this.options.utilsScript;
+            if (!$.fn[pluginName].loadedUtilsScript && utilsScript) {
+                // don't do this twice! (dont just check if the global intlTelInputUtils exists as if init plugin multiple times in quick succession, it may not have finished loading yet)
+                $.fn[pluginName].loadedUtilsScript = true;
+                // dont use $.getScript as it prevents caching
+                $.ajax({
+                    url: utilsScript,
+                    success: function() {
+                        // tell all instances the utils are ready
+                        $(".intl-tel-input input").intlTelInput("utilsLoaded");
+                    },
+                    dataType: "script",
+                    cache: true
+                });
+            }
+        },
+        // update the selected flag, and update the input val accordingly
+        selectCountry: function(countryCode) {
+            // check if already selected
+            if (!this.selectedFlagInner.hasClass(countryCode)) {
+                this._selectFlag(countryCode);
+                this._updateDialCode(this.selectedCountryData.dialCode, false);
+            }
+        },
+        // set the input value and update the flag
+        setNumber: function(number, addSuffix) {
+            // ensure starts with plus
+            if (!this.options.nationalMode && number.substr(0, 1) != "+") {
+                number = "+" + number;
+            }
+            // we must update the flag first, which updates this.selectedCountryData, which is used later for formatting the number before displaying it
+            this._updateFlagFromNumber(number);
+            this._updateVal(number, addSuffix);
+        },
+        // this is called when the utils are ready
+        utilsLoaded: function() {
+            // if autoFormat is enabled and there's an initial value in the input, then format it
+            if (this.options.autoFormat && this.telInput.val()) {
+                this._updateVal(this.telInput.val());
+            }
+            this._updatePlaceholder();
+        }
+    };
+    // adapted to allow public functions
+    // using https://github.com/jquery-boilerplate/jquery-boilerplate/wiki/Extending-jQuery-Boilerplate
+    $.fn[pluginName] = function(options) {
+        var args = arguments;
+        // Is the first parameter an object (options), or was omitted,
+        // instantiate a new instance of the plugin.
+        if (options === undefined || typeof options === "object") {
+            return this.each(function() {
+                if (!$.data(this, "plugin_" + pluginName)) {
+                    $.data(this, "plugin_" + pluginName, new Plugin(this, options));
+                }
+            });
+        } else if (typeof options === "string" && options[0] !== "_" && options !== "init") {
+            // If the first parameter is a string and it doesn't start
+            // with an underscore or "contains" the `init`-function,
+            // treat this as a call to a public method.
+            // Cache the method call to make it possible to return a value
+            var returns;
+            this.each(function() {
+                var instance = $.data(this, "plugin_" + pluginName);
+                // Tests that there's already a plugin-instance
+                // and checks that the requested public method exists
+                if (instance instanceof Plugin && typeof instance[options] === "function") {
+                    // Call the method of our plugin instance,
+                    // and pass it the supplied arguments.
+                    returns = instance[options].apply(instance, Array.prototype.slice.call(args, 1));
+                }
+                // Allow instances to be destroyed via the 'destroy' method
+                if (options === "destroy") {
+                    $.data(this, "plugin_" + pluginName, null);
+                }
+            });
+            // If the earlier cached method gives a value back return the value,
+            // otherwise return this to preserve chainability.
+            return returns !== undefined ? returns : this;
+        }
+    };
+    /********************
+ *  STATIC METHODS
+ ********************/
+    // get the country data object
+    $.fn[pluginName].getCountryData = function() {
+        return allCountries;
+    };
+    // Tell JSHint to ignore this warning: "character may get silently deleted by one or more browsers"
+    // jshint -W100
+    // Array of country objects for the flag dropdown.
+    // Each contains a name, country code (ISO 3166-1 alpha-2) and dial code.
+    // Originally from https://github.com/mledoze/countries
+    // then modified using the following JavaScript (NOW OUT OF DATE):
+    /*
+var result = [];
+_.each(countries, function(c) {
+  // ignore countries without a dial code
+  if (c.callingCode[0].length) {
+    result.push({
+      // var locals contains country names with localised versions in brackets
+      n: _.findWhere(locals, {
+        countryCode: c.cca2
+      }).name,
+      i: c.cca2.toLowerCase(),
+      d: c.callingCode[0]
+    });
+  }
+});
+JSON.stringify(result);
+*/
+    // then with a couple of manual re-arrangements to be alphabetical
+    // then changed Kazakhstan from +76 to +7
+    // and Vatican City from +379 to +39 (see issue 50)
+    // and Caribean Netherlands from +5997 to +599
+    // and Curacao from +5999 to +599
+    // Removed: Åland Islands, Christmas Island, Cocos Islands, Guernsey, Isle of Man, Jersey, Kosovo, Mayotte, Pitcairn Islands, South Georgia, Svalbard, Western Sahara
+    // Update: converted objects to arrays to save bytes!
+    // Update: added "priority" for countries with the same dialCode as others
+    // Update: added array of area codes for countries with the same dialCode as others
+    // So each country array has the following information:
+    // [
+    //    Country name,
+    //    iso2 code,
+    //    International dial code,
+    //    Order (if >1 country with same dial code),
+    //    Area codes (if >1 country with same dial code)
+    // ]
+    var allCountries = [ [ "Afghanistan (‫افغانستان‬‎)", "af", "93" ], [ "Albania (Shqipëri)", "al", "355" ], [ "Algeria (‫الجزائر‬‎)", "dz", "213" ], [ "American Samoa", "as", "1684" ], [ "Andorra", "ad", "376" ], [ "Angola", "ao", "244" ], [ "Anguilla", "ai", "1264" ], [ "Antigua and Barbuda", "ag", "1268" ], [ "Argentina", "ar", "54" ], [ "Armenia (Հայաստան)", "am", "374" ], [ "Aruba", "aw", "297" ], [ "Australia", "au", "61" ], [ "Austria (Österreich)", "at", "43" ], [ "Azerbaijan (Azərbaycan)", "az", "994" ], [ "Bahamas", "bs", "1242" ], [ "Bahrain (‫البحرين‬‎)", "bh", "973" ], [ "Bangladesh (বাংলাদেশ)", "bd", "880" ], [ "Barbados", "bb", "1246" ], [ "Belarus (Беларусь)", "by", "375" ], [ "Belgium (België)", "be", "32" ], [ "Belize", "bz", "501" ], [ "Benin (Bénin)", "bj", "229" ], [ "Bermuda", "bm", "1441" ], [ "Bhutan (འབྲུག)", "bt", "975" ], [ "Bolivia", "bo", "591" ], [ "Bosnia and Herzegovina (Босна и Херцеговина)", "ba", "387" ], [ "Botswana", "bw", "267" ], [ "Brazil (Brasil)", "br", "55" ], [ "British Indian Ocean Territory", "io", "246" ], [ "British Virgin Islands", "vg", "1284" ], [ "Brunei", "bn", "673" ], [ "Bulgaria (България)", "bg", "359" ], [ "Burkina Faso", "bf", "226" ], [ "Burundi (Uburundi)", "bi", "257" ], [ "Cambodia (កម្ពុជា)", "kh", "855" ], [ "Cameroon (Cameroun)", "cm", "237" ], [ "Canada", "ca", "1", 1, [ "204", "226", "236", "249", "250", "289", "306", "343", "365", "387", "403", "416", "418", "431", "437", "438", "450", "506", "514", "519", "548", "579", "581", "587", "604", "613", "639", "647", "672", "705", "709", "742", "778", "780", "782", "807", "819", "825", "867", "873", "902", "905" ] ], [ "Cape Verde (Kabu Verdi)", "cv", "238" ], [ "Caribbean Netherlands", "bq", "599", 1 ], [ "Cayman Islands", "ky", "1345" ], [ "Central African Republic (République centrafricaine)", "cf", "236" ], [ "Chad (Tchad)", "td", "235" ], [ "Chile", "cl", "56" ], [ "China (中国)", "cn", "86" ], [ "Colombia", "co", "57" ], [ "Comoros (‫جزر القمر‬‎)", "km", "269" ], [ "Congo (DRC) (Jamhuri ya Kidemokrasia ya Kongo)", "cd", "243" ], [ "Congo (Republic) (Congo-Brazzaville)", "cg", "242" ], [ "Cook Islands", "ck", "682" ], [ "Costa Rica", "cr", "506" ], [ "Côte d’Ivoire", "ci", "225" ], [ "Croatia (Hrvatska)", "hr", "385" ], [ "Cuba", "cu", "53" ], [ "Curaçao", "cw", "599", 0 ], [ "Cyprus (Κύπρος)", "cy", "357" ], [ "Czech Republic (Česká republika)", "cz", "420" ], [ "Denmark (Danmark)", "dk", "45" ], [ "Djibouti", "dj", "253" ], [ "Dominica", "dm", "1767" ], [ "Dominican Republic (República Dominicana)", "do", "1", 2, [ "809", "829", "849" ] ], [ "Ecuador", "ec", "593" ], [ "Egypt (‫مصر‬‎)", "eg", "20" ], [ "El Salvador", "sv", "503" ], [ "Equatorial Guinea (Guinea Ecuatorial)", "gq", "240" ], [ "Eritrea", "er", "291" ], [ "Estonia (Eesti)", "ee", "372" ], [ "Ethiopia", "et", "251" ], [ "Falkland Islands (Islas Malvinas)", "fk", "500" ], [ "Faroe Islands (Føroyar)", "fo", "298" ], [ "Fiji", "fj", "679" ], [ "Finland (Suomi)", "fi", "358" ], [ "France", "fr", "33" ], [ "French Guiana (Guyane française)", "gf", "594" ], [ "French Polynesia (Polynésie française)", "pf", "689" ], [ "Gabon", "ga", "241" ], [ "Gambia", "gm", "220" ], [ "Georgia (საქართველო)", "ge", "995" ], [ "Germany (Deutschland)", "de", "49" ], [ "Ghana (Gaana)", "gh", "233" ], [ "Gibraltar", "gi", "350" ], [ "Greece (Ελλάδα)", "gr", "30" ], [ "Greenland (Kalaallit Nunaat)", "gl", "299" ], [ "Grenada", "gd", "1473" ], [ "Guadeloupe", "gp", "590", 0 ], [ "Guam", "gu", "1671" ], [ "Guatemala", "gt", "502" ], [ "Guinea (Guinée)", "gn", "224" ], [ "Guinea-Bissau (Guiné Bissau)", "gw", "245" ], [ "Guyana", "gy", "592" ], [ "Haiti", "ht", "509" ], [ "Honduras", "hn", "504" ], [ "Hong Kong (香港)", "hk", "852" ], [ "Hungary (Magyarország)", "hu", "36" ], [ "Iceland (Ísland)", "is", "354" ], [ "India (भारत)", "in", "91" ], [ "Indonesia", "id", "62" ], [ "Iran (‫ایران‬‎)", "ir", "98" ], [ "Iraq (‫العراق‬‎)", "iq", "964" ], [ "Ireland", "ie", "353" ], [ "Israel (‫ישראל‬‎)", "il", "972" ], [ "Italy (Italia)", "it", "39", 0 ], [ "Jamaica", "jm", "1876" ], [ "Japan (日本)", "jp", "81" ], [ "Jordan (‫الأردن‬‎)", "jo", "962" ], [ "Kazakhstan (Казахстан)", "kz", "7", 1 ], [ "Kenya", "ke", "254" ], [ "Kiribati", "ki", "686" ], [ "Kuwait (‫الكويت‬‎)", "kw", "965" ], [ "Kyrgyzstan (Кыргызстан)", "kg", "996" ], [ "Laos (ລາວ)", "la", "856" ], [ "Latvia (Latvija)", "lv", "371" ], [ "Lebanon (‫لبنان‬‎)", "lb", "961" ], [ "Lesotho", "ls", "266" ], [ "Liberia", "lr", "231" ], [ "Libya (‫ليبيا‬‎)", "ly", "218" ], [ "Liechtenstein", "li", "423" ], [ "Lithuania (Lietuva)", "lt", "370" ], [ "Luxembourg", "lu", "352" ], [ "Macau (澳門)", "mo", "853" ], [ "Macedonia (FYROM) (Македонија)", "mk", "389" ], [ "Madagascar (Madagasikara)", "mg", "261" ], [ "Malawi", "mw", "265" ], [ "Malaysia", "my", "60" ], [ "Maldives", "mv", "960" ], [ "Mali", "ml", "223" ], [ "Malta", "mt", "356" ], [ "Marshall Islands", "mh", "692" ], [ "Martinique", "mq", "596" ], [ "Mauritania (‫موريتانيا‬‎)", "mr", "222" ], [ "Mauritius (Moris)", "mu", "230" ], [ "Mexico (México)", "mx", "52" ], [ "Micronesia", "fm", "691" ], [ "Moldova (Republica Moldova)", "md", "373" ], [ "Monaco", "mc", "377" ], [ "Mongolia (Монгол)", "mn", "976" ], [ "Montenegro (Crna Gora)", "me", "382" ], [ "Montserrat", "ms", "1664" ], [ "Morocco (‫المغرب‬‎)", "ma", "212" ], [ "Mozambique (Moçambique)", "mz", "258" ], [ "Myanmar (Burma) (မြန်မာ)", "mm", "95" ], [ "Namibia (Namibië)", "na", "264" ], [ "Nauru", "nr", "674" ], [ "Nepal (नेपाल)", "np", "977" ], [ "Netherlands (Nederland)", "nl", "31" ], [ "New Caledonia (Nouvelle-Calédonie)", "nc", "687" ], [ "New Zealand", "nz", "64" ], [ "Nicaragua", "ni", "505" ], [ "Niger (Nijar)", "ne", "227" ], [ "Nigeria", "ng", "234" ], [ "Niue", "nu", "683" ], [ "Norfolk Island", "nf", "672" ], [ "North Korea (조선 민주주의 인민 공화국)", "kp", "850" ], [ "Northern Mariana Islands", "mp", "1670" ], [ "Norway (Norge)", "no", "47" ], [ "Oman (‫عُمان‬‎)", "om", "968" ], [ "Pakistan (‫پاکستان‬‎)", "pk", "92" ], [ "Palau", "pw", "680" ], [ "Palestine (‫فلسطين‬‎)", "ps", "970" ], [ "Panama (Panamá)", "pa", "507" ], [ "Papua New Guinea", "pg", "675" ], [ "Paraguay", "py", "595" ], [ "Peru (Perú)", "pe", "51" ], [ "Philippines", "ph", "63" ], [ "Poland (Polska)", "pl", "48" ], [ "Portugal", "pt", "351" ], [ "Puerto Rico", "pr", "1", 3, [ "787", "939" ] ], [ "Qatar (‫قطر‬‎)", "qa", "974" ], [ "Réunion (La Réunion)", "re", "262" ], [ "Romania (România)", "ro", "40" ], [ "Russia (Россия)", "ru", "7", 0 ], [ "Rwanda", "rw", "250" ], [ "Saint Barthélemy (Saint-Barthélemy)", "bl", "590", 1 ], [ "Saint Helena", "sh", "290" ], [ "Saint Kitts and Nevis", "kn", "1869" ], [ "Saint Lucia", "lc", "1758" ], [ "Saint Martin (Saint-Martin (partie française))", "mf", "590", 2 ], [ "Saint Pierre and Miquelon (Saint-Pierre-et-Miquelon)", "pm", "508" ], [ "Saint Vincent and the Grenadines", "vc", "1784" ], [ "Samoa", "ws", "685" ], [ "San Marino", "sm", "378" ], [ "São Tomé and Príncipe (São Tomé e Príncipe)", "st", "239" ], [ "Saudi Arabia (‫المملكة العربية السعودية‬‎)", "sa", "966" ], [ "Senegal (Sénégal)", "sn", "221" ], [ "Serbia (Србија)", "rs", "381" ], [ "Seychelles", "sc", "248" ], [ "Sierra Leone", "sl", "232" ], [ "Singapore", "sg", "65" ], [ "Sint Maarten", "sx", "1721" ], [ "Slovakia (Slovensko)", "sk", "421" ], [ "Slovenia (Slovenija)", "si", "386" ], [ "Solomon Islands", "sb", "677" ], [ "Somalia (Soomaaliya)", "so", "252" ], [ "South Africa", "za", "27" ], [ "South Korea (대한민국)", "kr", "82" ], [ "South Sudan (‫جنوب السودان‬‎)", "ss", "211" ], [ "Spain (España)", "es", "34" ], [ "Sri Lanka (ශ්‍රී ලංකාව)", "lk", "94" ], [ "Sudan (‫السودان‬‎)", "sd", "249" ], [ "Suriname", "sr", "597" ], [ "Swaziland", "sz", "268" ], [ "Sweden (Sverige)", "se", "46" ], [ "Switzerland (Schweiz)", "ch", "41" ], [ "Syria (‫سوريا‬‎)", "sy", "963" ], [ "Taiwan (台灣)", "tw", "886" ], [ "Tajikistan", "tj", "992" ], [ "Tanzania", "tz", "255" ], [ "Thailand (ไทย)", "th", "66" ], [ "Timor-Leste", "tl", "670" ], [ "Togo", "tg", "228" ], [ "Tokelau", "tk", "690" ], [ "Tonga", "to", "676" ], [ "Trinidad and Tobago", "tt", "1868" ], [ "Tunisia (‫تونس‬‎)", "tn", "216" ], [ "Turkey (Türkiye)", "tr", "90" ], [ "Turkmenistan", "tm", "993" ], [ "Turks and Caicos Islands", "tc", "1649" ], [ "Tuvalu", "tv", "688" ], [ "U.S. Virgin Islands", "vi", "1340" ], [ "Uganda", "ug", "256" ], [ "Ukraine (Україна)", "ua", "380" ], [ "United Arab Emirates (‫الإمارات العربية المتحدة‬‎)", "ae", "971" ], [ "United Kingdom", "gb", "44" ], [ "United States", "us", "1", 0 ], [ "Uruguay", "uy", "598" ], [ "Uzbekistan (Oʻzbekiston)", "uz", "998" ], [ "Vanuatu", "vu", "678" ], [ "Vatican City (Città del Vaticano)", "va", "39", 1 ], [ "Venezuela", "ve", "58" ], [ "Vietnam (Việt Nam)", "vn", "84" ], [ "Wallis and Futuna", "wf", "681" ], [ "Yemen (‫اليمن‬‎)", "ye", "967" ], [ "Zambia", "zm", "260" ], [ "Zimbabwe", "zw", "263" ] ];
+    // loop over all of the countries above
+    for (var i = 0; i < allCountries.length; i++) {
+        var c = allCountries[i];
+        allCountries[i] = {
+            name: c[0],
+            iso2: c[1],
+            dialCode: c[2],
+            priority: c[3] || 0,
+            areaCodes: c[4] || null
+        };
+    }
+});