]> git.openstreetmap.org Git - rails.git/blobdiff - vendor/assets/leaflet/leaflet.js
Update leaflet.locate (fixes #438)
[rails.git] / vendor / assets / leaflet / leaflet.js
index 5503592a0d2ec2bce818ab281060a2ac5bf79603..b972941d97a06cbb5705ce998d7382fa682e355c 100644 (file)
@@ -1,31 +1,35 @@
 /*
- Copyright (c) 2010-2012, CloudMade, Vladimir Agafonkin
- Leaflet is an open-source JavaScript library for mobile-friendly interactive maps.
- http://leafletjs.com
+ Leaflet, a JavaScript library for mobile-friendly interactive maps. http://leafletjs.com
+ (c) 2010-2013, Vladimir Agafonkin
+ (c) 2010-2011, CloudMade
 */
-(function (window, undefined) {
+(function (window, document, undefined) {
+var oldL = window.L,
+    L = {};
 
-var L, originalL;
+L.version = '0.6.3';
 
-if (typeof exports !== undefined + '') {
-       L = exports;
-} else {
-       originalL = window.L;
-       L = {};
+// define Leaflet for Node module pattern loaders, including Browserify
+if (typeof module === 'object' && typeof module.exports === 'object') {
+       module.exports = L;
 
-       L.noConflict = function () {
-               window.L = originalL;
-               return this;
-       };
-
-       window.L = L;
+// define Leaflet as an AMD module
+} else if (typeof define === 'function' && define.amd) {
+       define(L);
 }
 
-L.version = '0.4.4';
+// define Leaflet as a global L variable, saving the original L to restore later if needed
+
+L.noConflict = function () {
+       window.L = oldL;
+       return this;
+};
+
+window.L = L;
 
 
 /*
- * L.Util is a namespace for various utility functions.
+ * L.Util contains various utility functions used throughout Leaflet code.
  */
 
 L.Util = {
@@ -52,13 +56,29 @@ L.Util = {
        },
 
        stamp: (function () {
-               var lastId = 0, key = '_leaflet_id';
-               return function (/*Object*/ obj) {
+               var lastId = 0,
+                   key = '_leaflet_id';
+               return function (obj) {
                        obj[key] = obj[key] || ++lastId;
                        return obj[key];
                };
        }()),
 
+       invokeEach: function (obj, method, context) {
+               var i, args;
+
+               if (typeof obj === 'object') {
+                       args = Array.prototype.slice.call(arguments, 3);
+
+                       for (i in obj) {
+                               method.apply(context, [i, obj[i]].concat(args));
+                       }
+                       return true;
+               }
+
+               return false;
+       },
+
        limitExecByInterval: function (fn, time, context) {
                var lock, execOnUnlock;
 
@@ -94,8 +114,12 @@ L.Util = {
                return Math.round(num * pow) / pow;
        },
 
+       trim: function (str) {
+               return str.trim ? str.trim() : str.replace(/^\s+|\s+$/g, '');
+       },
+
        splitWords: function (str) {
-               return str.replace(/^\s+|\s+$/g, '').split(/\s+/);
+               return L.Util.trim(str).split(/\s+/);
        },
 
        setOptions: function (obj, options) {
@@ -103,26 +127,30 @@ L.Util = {
                return obj.options;
        },
 
-       getParamString: function (obj) {
+       getParamString: function (obj, existingUrl, uppercase) {
                var params = [];
                for (var i in obj) {
-                       if (obj.hasOwnProperty(i)) {
-                               params.push(i + '=' + obj[i]);
-                       }
+                       params.push(encodeURIComponent(uppercase ? i.toUpperCase() : i) + '=' + encodeURIComponent(obj[i]));
                }
-               return '?' + params.join('&');
+               return ((!existingUrl || existingUrl.indexOf('?') === -1) ? '?' : '&') + params.join('&');
        },
 
        template: function (str, data) {
                return str.replace(/\{ *([\w_]+) *\}/g, function (str, key) {
                        var value = data[key];
-                       if (!data.hasOwnProperty(key)) {
+                       if (value === undefined) {
                                throw new Error('No value provided for variable ' + str);
+                       } else if (typeof value === 'function') {
+                               value = value(data);
                        }
                        return value;
                });
        },
 
+       isArray: function (obj) {
+               return (Object.prototype.toString.call(obj) === '[object Array]');
+       },
+
        emptyImageUrl: 'data:image/gif;base64,R0lGODlhAQABAAD/ACwAAAAAAQABAAACADs='
 };
 
@@ -186,18 +214,26 @@ L.setOptions = L.Util.setOptions;
 
 
 /*
- * Class powers the OOP facilities of the library. Thanks to John Resig and Dean Edwards for inspiration!
+ * L.Class powers the OOP facilities of the library.
+ * Thanks to John Resig and Dean Edwards for inspiration!
  */
 
 L.Class = function () {};
 
-L.Class.extend = function (/*Object*/ props) /*-> Class*/ {
+L.Class.extend = function (props) {
 
        // extended class with the new prototype
        var NewClass = function () {
+
+               // call the constructor
                if (this.initialize) {
                        this.initialize.apply(this, arguments);
                }
+
+               // call all constructor hooks
+               if (this._initHooks) {
+                       this.callInitHooks();
+               }
        };
 
        // instantiate class without calling constructor
@@ -236,6 +272,28 @@ L.Class.extend = function (/*Object*/ props) /*-> Class*/ {
        // mix given properties into the prototype
        L.extend(proto, props);
 
+       proto._initHooks = [];
+
+       var parent = this;
+       // jshint camelcase: false
+       NewClass.__super__ = parent.prototype;
+
+       // add method for calling all hooks
+       proto.callInitHooks = function () {
+
+               if (this._initHooksCalled) { return; }
+
+               if (parent.prototype.callInitHooks) {
+                       parent.prototype.callInitHooks.call(this);
+               }
+
+               this._initHooksCalled = true;
+
+               for (var i = 0, len = proto._initHooks.length; i < len; i++) {
+                       proto._initHooks[i].call(this);
+               }
+       };
+
        return NewClass;
 };
 
@@ -245,80 +303,133 @@ L.Class.include = function (props) {
        L.extend(this.prototype, props);
 };
 
+// merge new default options to the Class
 L.Class.mergeOptions = function (options) {
        L.extend(this.prototype.options, options);
 };
 
+// add a constructor hook
+L.Class.addInitHook = function (fn) { // (Function) || (String, args...)
+       var args = Array.prototype.slice.call(arguments, 1);
+
+       var init = typeof fn === 'function' ? fn : function () {
+               this[fn].apply(this, args);
+       };
+
+       this.prototype._initHooks = this.prototype._initHooks || [];
+       this.prototype._initHooks.push(init);
+};
+
 
 /*
- * L.Mixin.Events adds custom events functionality to Leaflet classes
+ * L.Mixin.Events is used to add custom events functionality to Leaflet classes.
  */
 
-var key = '_leaflet_events';
+var eventsKey = '_leaflet_events';
 
 L.Mixin = {};
 
 L.Mixin.Events = {
 
        addEventListener: function (types, fn, context) { // (String, Function[, Object]) or (Object[, Object])
-               var events = this[key] = this[key] || {},
-                       type, i, len;
-
-               // Types can be a map of types/handlers
-               if (typeof types === 'object') {
-                       for (type in types) {
-                               if (types.hasOwnProperty(type)) {
-                                       this.addEventListener(type, types[type], fn);
-                               }
-                       }
 
-                       return this;
-               }
+               // types can be a map of types/handlers
+               if (L.Util.invokeEach(types, this.addEventListener, this, fn, context)) { return this; }
+
+               var events = this[eventsKey] = this[eventsKey] || {},
+                   contextId = context && L.stamp(context),
+                   i, len, event, type, indexKey, indexLenKey, typeIndex;
 
+               // types can be a string of space-separated words
                types = L.Util.splitWords(types);
 
                for (i = 0, len = types.length; i < len; i++) {
-                       events[types[i]] = events[types[i]] || [];
-                       events[types[i]].push({
+                       event = {
                                action: fn,
                                context: context || this
-                       });
+                       };
+                       type = types[i];
+
+                       if (context) {
+                               // store listeners of a particular context in a separate hash (if it has an id)
+                               // gives a major performance boost when removing thousands of map layers
+
+                               indexKey = type + '_idx';
+                               indexLenKey = indexKey + '_len';
+
+                               typeIndex = events[indexKey] = events[indexKey] || {};
+
+                               if (!typeIndex[contextId]) {
+                                       typeIndex[contextId] = [];
+
+                                       // keep track of the number of keys in the index to quickly check if it's empty
+                                       events[indexLenKey] = (events[indexLenKey] || 0) + 1;
+                               }
+
+                               typeIndex[contextId].push(event);
+
+
+                       } else {
+                               events[type] = events[type] || [];
+                               events[type].push(event);
+                       }
                }
 
                return this;
        },
 
        hasEventListeners: function (type) { // (String) -> Boolean
-               return (key in this) && (type in this[key]) && (this[key][type].length > 0);
+               var events = this[eventsKey];
+               return !!events && ((type in events && events[type].length > 0) ||
+                                   (type + '_idx' in events && events[type + '_idx_len'] > 0));
        },
 
-       removeEventListener: function (types, fn, context) { // (String[, Function, Object]) or (Object[, Object])
-               var events = this[key],
-                       type, i, len, listeners, j;
-
-               if (typeof types === 'object') {
-                       for (type in types) {
-                               if (types.hasOwnProperty(type)) {
-                                       this.removeEventListener(type, types[type], fn);
-                               }
-                       }
+       removeEventListener: function (types, fn, context) { // ([String, Function, Object]) or (Object[, Object])
 
+               if (!this[eventsKey]) {
                        return this;
                }
 
+               if (!types) {
+                       return this.clearAllEventListeners();
+               }
+
+               if (L.Util.invokeEach(types, this.removeEventListener, this, fn, context)) { return this; }
+
+               var events = this[eventsKey],
+                   contextId = context && L.stamp(context),
+                   i, len, type, listeners, j, indexKey, indexLenKey, typeIndex, removed;
+
                types = L.Util.splitWords(types);
 
                for (i = 0, len = types.length; i < len; i++) {
+                       type = types[i];
+                       indexKey = type + '_idx';
+                       indexLenKey = indexKey + '_len';
+
+                       typeIndex = events[indexKey];
+
+                       if (!fn) {
+                               // clear all listeners for a type if function isn't specified
+                               delete events[type];
+                               delete events[indexKey];
 
-                       if (this.hasEventListeners(types[i])) {
-                               listeners = events[types[i]];
+                       } else {
+                               listeners = context && typeIndex ? typeIndex[contextId] : events[type];
+
+                               if (listeners) {
+                                       for (j = listeners.length - 1; j >= 0; j--) {
+                                               if ((listeners[j].action === fn) && (!context || (listeners[j].context === context))) {
+                                                       removed = listeners.splice(j, 1);
+                                                       // set the old action to a no-op, because it is possible
+                                                       // that the listener is being iterated over as part of a dispatch
+                                                       removed[0].action = L.Util.falseFn;
+                                               }
+                                       }
 
-                               for (j = listeners.length - 1; j >= 0; j--) {
-                                       if (
-                                               (!fn || listeners[j].action === fn) &&
-                                               (!context || (listeners[j].context === context))
-                                       ) {
-                                               listeners.splice(j, 1);
+                                       if (context && typeIndex && (listeners.length === 0)) {
+                                               delete typeIndex[contextId];
+                                               events[indexLenKey]--;
                                        }
                                }
                        }
@@ -327,61 +438,106 @@ L.Mixin.Events = {
                return this;
        },
 
+       clearAllEventListeners: function () {
+               delete this[eventsKey];
+               return this;
+       },
+
        fireEvent: function (type, data) { // (String[, Object])
                if (!this.hasEventListeners(type)) {
                        return this;
                }
 
-               var event = L.extend({
-                       type: type,
-                       target: this
-               }, data);
+               var event = L.Util.extend({}, data, { type: type, target: this });
+
+               var events = this[eventsKey],
+                   listeners, i, len, typeIndex, contextId;
+
+               if (events[type]) {
+                       // make sure adding/removing listeners inside other listeners won't cause infinite loop
+                       listeners = events[type].slice();
+
+                       for (i = 0, len = listeners.length; i < len; i++) {
+                               listeners[i].action.call(listeners[i].context || this, event);
+                       }
+               }
+
+               // fire event for the context-indexed listeners as well
+               typeIndex = events[type + '_idx'];
 
-               var listeners = this[key][type].slice();
+               for (contextId in typeIndex) {
+                       listeners = typeIndex[contextId].slice();
 
-               for (var i = 0, len = listeners.length; i < len; i++) {
-                       listeners[i].action.call(listeners[i].context || this, event);
+                       if (listeners) {
+                               for (i = 0, len = listeners.length; i < len; i++) {
+                                       listeners[i].action.call(listeners[i].context || this, event);
+                               }
+                       }
                }
 
                return this;
+       },
+
+       addOneTimeEventListener: function (types, fn, context) {
+
+               if (L.Util.invokeEach(types, this.addOneTimeEventListener, this, fn, context)) { return this; }
+
+               var handler = L.bind(function () {
+                       this
+                           .removeEventListener(types, fn, context)
+                           .removeEventListener(types, handler, context);
+               }, this);
+
+               return this
+                   .addEventListener(types, fn, context)
+                   .addEventListener(types, handler, context);
        }
 };
 
 L.Mixin.Events.on = L.Mixin.Events.addEventListener;
 L.Mixin.Events.off = L.Mixin.Events.removeEventListener;
+L.Mixin.Events.once = L.Mixin.Events.addOneTimeEventListener;
 L.Mixin.Events.fire = L.Mixin.Events.fireEvent;
 
 
+/*
+ * L.Browser handles different browser and feature detections for internal Leaflet use.
+ */
+
 (function () {
 
        var ie = !!window.ActiveXObject,
-           // http://tanalin.com/en/articles/ie-version-js/
            ie6 = ie && !window.XMLHttpRequest,
            ie7 = ie && !document.querySelector,
+               ielt9 = ie && !document.addEventListener,
 
            // terrible browser detection to work around Safari / iOS / Android browser bugs
-           // see TileLayer._addTile and debug/hacks/jitter.html
-
            ua = navigator.userAgent.toLowerCase(),
-           webkit = ua.indexOf("webkit") !== -1,
-           chrome = ua.indexOf("chrome") !== -1,
-           android = ua.indexOf("android") !== -1,
-           android23 = ua.search("android [23]") !== -1,
+           webkit = ua.indexOf('webkit') !== -1,
+           chrome = ua.indexOf('chrome') !== -1,
+           phantomjs = ua.indexOf('phantom') !== -1,
+           android = ua.indexOf('android') !== -1,
+           android23 = ua.search('android [23]') !== -1,
 
            mobile = typeof orientation !== undefined + '',
-           msTouch = (window.navigator && window.navigator.msPointerEnabled && window.navigator.msMaxTouchPoints),
-           retina = (('devicePixelRatio' in window && window.devicePixelRatio > 1) ||
-                     ('matchMedia' in window && window.matchMedia("(min-resolution:144dpi)").matches)),
+           msTouch = window.navigator && window.navigator.msPointerEnabled &&
+                     window.navigator.msMaxTouchPoints,
+           retina = ('devicePixelRatio' in window && window.devicePixelRatio > 1) ||
+                    ('matchMedia' in window && window.matchMedia('(min-resolution:144dpi)') &&
+                     window.matchMedia('(min-resolution:144dpi)').matches),
 
            doc = document.documentElement,
            ie3d = ie && ('transition' in doc.style),
            webkit3d = ('WebKitCSSMatrix' in window) && ('m11' in new window.WebKitCSSMatrix()),
            gecko3d = 'MozPerspective' in doc.style,
            opera3d = 'OTransition' in doc.style,
-           any3d = !window.L_DISABLE_3D && (ie3d || webkit3d || gecko3d || opera3d);
+           any3d = !window.L_DISABLE_3D && (ie3d || webkit3d || gecko3d || opera3d) && !phantomjs;
 
 
-       var touch = !window.L_NO_TOUCH && (function () {
+       // PhantomJS has 'ontouchstart' in document.documentElement, but doesn't actually support touch.
+       // https://github.com/Leaflet/Leaflet/pull/1434#issuecomment-13843151
+
+       var touch = !window.L_NO_TOUCH && !phantomjs && (function () {
 
                var startName = 'ontouchstart';
 
@@ -411,8 +567,10 @@ L.Mixin.Events.fire = L.Mixin.Events.fireEvent;
 
 
        L.Browser = {
+               ie: ie,
                ie6: ie6,
                ie7: ie7,
+               ielt9: ielt9,
                webkit: webkit,
 
                android: android,
@@ -526,6 +684,20 @@ L.Point.prototype = {
                return Math.sqrt(x * x + y * y);
        },
 
+       equals: function (point) {
+               point = L.point(point);
+
+               return point.x === this.x &&
+                      point.y === this.y;
+       },
+
+       contains: function (point) {
+               point = L.point(point);
+
+               return Math.abs(point.x) <= Math.abs(this.x) &&
+                      Math.abs(point.y) <= Math.abs(this.y);
+       },
+
        toString: function () {
                return 'Point(' +
                        L.Util.formatNum(this.x) + ', ' +
@@ -537,10 +709,10 @@ L.point = function (x, y, round) {
        if (x instanceof L.Point) {
                return x;
        }
-       if (x instanceof Array) {
+       if (L.Util.isArray(x)) {
                return new L.Point(x[0], x[1]);
        }
-       if (isNaN(x)) {
+       if (x === undefined || x === null) {
                return x;
        }
        return new L.Point(x, y, round);
@@ -551,18 +723,17 @@ L.point = function (x, y, round) {
  * L.Bounds represents a rectangular area on the screen in pixel coordinates.
  */
 
-L.Bounds = L.Class.extend({
-
-       initialize: function (a, b) {   //(Point, Point) or Point[]
-               if (!a) { return; }
+L.Bounds = function (a, b) { //(Point, Point) or Point[]
+       if (!a) { return; }
 
-               var points = b ? [a, b] : a;
+       var points = b ? [a, b] : a;
 
-               for (var i = 0, len = points.length; i < len; i++) {
-                       this.extend(points[i]);
-               }
-       },
+       for (var i = 0, len = points.length; i < len; i++) {
+               this.extend(points[i]);
+       }
+};
 
+L.Bounds.prototype = {
        // extend the bounds to contain the given point
        extend: function (point) { // (Point)
                point = L.point(point);
@@ -593,6 +764,10 @@ L.Bounds = L.Class.extend({
                return new L.Point(this.max.x, this.min.y);
        },
 
+       getSize: function () {
+               return this.max.subtract(this.min);
+       },
+
        contains: function (obj) { // (Bounds) or (Point) -> Boolean
                var min, max;
 
@@ -631,7 +806,7 @@ L.Bounds = L.Class.extend({
        isValid: function () {
                return !!(this.min && this.max);
        }
-});
+};
 
 L.bounds = function (a, b) { // (Bounds) or (Point, Point) or (Point[])
        if (!a || a instanceof L.Bounds) {
@@ -645,33 +820,33 @@ L.bounds = function (a, b) { // (Bounds) or (Point, Point) or (Point[])
  * L.Transformation is an utility class to perform simple point transformations through a 2d-matrix.
  */
 
-L.Transformation = L.Class.extend({
-       initialize: function (/*Number*/ a, /*Number*/ b, /*Number*/ c, /*Number*/ d) {
-               this._a = a;
-               this._b = b;
-               this._c = c;
-               this._d = d;
-       },
+L.Transformation = function (a, b, c, d) {
+       this._a = a;
+       this._b = b;
+       this._c = c;
+       this._d = d;
+};
 
-       transform: function (point, scale) {
+L.Transformation.prototype = {
+       transform: function (point, scale) { // (Point, Number) -> Point
                return this._transform(point.clone(), scale);
        },
 
        // destructive transform (faster)
-       _transform: function (/*Point*/ point, /*Number*/ scale) /*-> Point*/ {
+       _transform: function (point, scale) {
                scale = scale || 1;
                point.x = scale * (this._a * point.x + this._b);
                point.y = scale * (this._c * point.y + this._d);
                return point;
        },
 
-       untransform: function (/*Point*/ point, /*Number*/ scale) /*-> Point*/ {
+       untransform: function (point, scale) {
                scale = scale || 1;
                return new L.Point(
                        (point.x / scale - this._b) / this._a,
                        (point.y / scale - this._d) / this._c);
        }
-});
+};
 
 
 /*
@@ -705,21 +880,43 @@ L.DomUtil = {
                    left = 0,
                    el = element,
                    docBody = document.body,
+                   docEl = document.documentElement,
                    pos,
                    ie7 = L.Browser.ie7;
 
                do {
                        top  += el.offsetTop  || 0;
                        left += el.offsetLeft || 0;
+
+                       //add borders
+                       top += parseInt(L.DomUtil.getStyle(el, 'borderTopWidth'), 10) || 0;
+                       left += parseInt(L.DomUtil.getStyle(el, 'borderLeftWidth'), 10) || 0;
+
                        pos = L.DomUtil.getStyle(el, 'position');
 
                        if (el.offsetParent === docBody && pos === 'absolute') { break; }
 
                        if (pos === 'fixed') {
-                               top  += docBody.scrollTop  || 0;
-                               left += docBody.scrollLeft || 0;
+                               top  += docBody.scrollTop  || docEl.scrollTop  || 0;
+                               left += docBody.scrollLeft || docEl.scrollLeft || 0;
                                break;
                        }
+
+                       if (pos === 'relative' && !el.offsetLeft) {
+                               var width = L.DomUtil.getStyle(el, 'width'),
+                                   maxWidth = L.DomUtil.getStyle(el, 'max-width'),
+                                   r = el.getBoundingClientRect();
+
+                               if (width !== 'none' || maxWidth !== 'none') {
+                                       left += r.left + el.clientLeft;
+                               }
+
+                               //calculate full y offset since we're breaking out of the loop
+                               top += r.top + (docBody.scrollTop  || docEl.scrollTop  || 0);
+
+                               break;
+                       }
+
                        el = el.offsetParent;
 
                } while (el);
@@ -754,7 +951,7 @@ L.DomUtil = {
        documentIsLtr: function () {
                if (!L.DomUtil._docIsLtrCached) {
                        L.DomUtil._docIsLtrCached = true;
-                       L.DomUtil._docIsLtr = L.DomUtil.getStyle(document.body, 'direction') === "ltr";
+                       L.DomUtil._docIsLtr = L.DomUtil.getStyle(document.body, 'direction') === 'ltr';
                }
                return L.DomUtil._docIsLtr;
        },
@@ -771,26 +968,9 @@ L.DomUtil = {
                return el;
        },
 
-       disableTextSelection: function () {
-               if (document.selection && document.selection.empty) {
-                       document.selection.empty();
-               }
-               if (!this._onselectstart) {
-                       this._onselectstart = document.onselectstart;
-                       document.onselectstart = L.Util.falseFn;
-               }
-       },
-
-       enableTextSelection: function () {
-               if (document.onselectstart === L.Util.falseFn) {
-                       document.onselectstart = this._onselectstart;
-                       this._onselectstart = null;
-               }
-       },
-
        hasClass: function (el, name) {
                return (el.className.length > 0) &&
-                       new RegExp("(^|\\s)" + name + "(\\s|$)").test(el.className);
+                       new RegExp('(^|\\s)' + name + '(\\s|$)').test(el.className);
        },
 
        addClass: function (el, name) {
@@ -800,15 +980,7 @@ L.DomUtil = {
        },
 
        removeClass: function (el, name) {
-
-               function replaceFn(w, match) {
-                       if (match === name) { return ''; }
-                       return w;
-               }
-
-               el.className = el.className
-                       .replace(/(\S+)\s*/g, replaceFn)
-                       .replace(/(^\s+|\s+$)/, '');
+               el.className = L.Util.trim((' ' + el.className + ' ').replace(' ' + name + ' ', ' '));
        },
 
        setOpacity: function (el, value) {
@@ -822,7 +994,13 @@ L.DomUtil = {
                            filterName = 'DXImageTransform.Microsoft.Alpha';
 
                        // filters collection throws an error if we try to retrieve a filter that doesn't exist
-                       try { filter = el.filters.item(filterName); } catch (e) {}
+                       try {
+                               filter = el.filters.item(filterName);
+                       } catch (e) {
+                               // don't set opacity to 1 if we haven't already set an opacity,
+                               // it isn't needed and breaks transparent pngs.
+                               if (value === 1) { return; }
+                       }
 
                        value = Math.round(value * 100);
 
@@ -869,6 +1047,7 @@ L.DomUtil = {
 
        setPosition: function (el, point, disable3D) { // (HTMLElement, Point[, Boolean])
 
+               // jshint camelcase: false
                el._leaflet_pos = point;
 
                if (!disable3D && L.Browser.any3d) {
@@ -887,6 +1066,8 @@ L.DomUtil = {
        getPosition: function (el) {
                // this method is only used for elements previously positioned using setPosition,
                // so it's safe to cache the position for performance
+
+               // jshint camelcase: false
                return el._leaflet_pos;
        }
 };
@@ -897,19 +1078,54 @@ L.DomUtil = {
 L.DomUtil.TRANSFORM = L.DomUtil.testProp(
         ['transform', 'WebkitTransform', 'OTransform', 'MozTransform', 'msTransform']);
 
+// webkitTransition comes first because some browser versions that drop vendor prefix don't do
+// the same for the transitionend event, in particular the Android 4.1 stock browser
+
 L.DomUtil.TRANSITION = L.DomUtil.testProp(
-        ['transition', 'webkitTransition', 'OTransition', 'MozTransition', 'msTransition']);
+        ['webkitTransition', 'transition', 'OTransition', 'MozTransition', 'msTransition']);
 
 L.DomUtil.TRANSITION_END =
         L.DomUtil.TRANSITION === 'webkitTransition' || L.DomUtil.TRANSITION === 'OTransition' ?
         L.DomUtil.TRANSITION + 'End' : 'transitionend';
 
+(function () {
+       var userSelectProperty = L.DomUtil.testProp(
+               ['userSelect', 'WebkitUserSelect', 'OUserSelect', 'MozUserSelect', 'msUserSelect']);
+
+       L.extend(L.DomUtil, {
+               disableTextSelection: function () {
+                       L.DomEvent.on(window, 'selectstart', L.DomEvent.preventDefault);
+                       if (userSelectProperty) {
+                               var style = document.documentElement.style;
+                               this._userSelect = style[userSelectProperty];
+                               style[userSelectProperty] = 'none';
+                       }
+               },
+
+               enableTextSelection: function () {
+                       L.DomEvent.off(window, 'selectstart', L.DomEvent.preventDefault);
+                       if (userSelectProperty) {
+                               document.documentElement.style[userSelectProperty] = this._userSelect;
+                               delete this._userSelect;
+                       }
+               },
+
+               disableImageDrag: function () {
+                       L.DomEvent.on(window, 'dragstart', L.DomEvent.preventDefault);
+               },
+
+               enableImageDrag: function () {
+                       L.DomEvent.off(window, 'dragstart', L.DomEvent.preventDefault);
+               }
+       });
+})();
+
 
 /*
      CM.LatLng represents a geographical point with latitude and longtitude coordinates.
-*/
* L.LatLng represents a geographical point with latitude and longitude coordinates.
+ */
 
-L.LatLng = function (rawLat, rawLng, noWrap) { // (Number, Number[, Boolean])
+L.LatLng = function (rawLat, rawLng) { // (Number, Number)
        var lat = parseFloat(rawLat),
            lng = parseFloat(rawLng);
 
@@ -917,11 +1133,6 @@ L.LatLng = function (rawLat, rawLng, noWrap) { // (Number, Number[, Boolean])
                throw new Error('Invalid LatLng object: (' + rawLat + ', ' + rawLng + ')');
        }
 
-       if (noWrap !== true) {
-               lat = Math.max(Math.min(lat, 90), -90);                                 // clamp latitude into -90..90
-               lng = (lng + 180) % 360 + ((lng < -180 || lng === 180) ? 180 : -180);   // wrap longtitude into -180..180
-       }
-
        this.lat = lat;
        this.lng = lng;
 };
@@ -938,17 +1149,21 @@ L.LatLng.prototype = {
 
                obj = L.latLng(obj);
 
-               var margin = Math.max(Math.abs(this.lat - obj.lat), Math.abs(this.lng - obj.lng));
+               var margin = Math.max(
+                       Math.abs(this.lat - obj.lat),
+                       Math.abs(this.lng - obj.lng));
+
                return margin <= L.LatLng.MAX_MARGIN;
        },
 
-       toString: function (precision) { // -> String
+       toString: function (precision) { // (Number) -> String
                return 'LatLng(' +
                        L.Util.formatNum(this.lat, precision) + ', ' +
                        L.Util.formatNum(this.lng, precision) + ')';
        },
 
        // Haversine distance formula, see http://en.wikipedia.org/wiki/Haversine_formula
+       // TODO move to projection code, LatLng shouldn't know about Earth
        distanceTo: function (other) { // (LatLng) -> Number
                other = L.latLng(other);
 
@@ -964,20 +1179,34 @@ L.LatLng.prototype = {
                var a = sin1 * sin1 + sin2 * sin2 * Math.cos(lat1) * Math.cos(lat2);
 
                return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+       },
+
+       wrap: function (a, b) { // (Number, Number) -> LatLng
+               var lng = this.lng;
+
+               a = a || -180;
+               b = b ||  180;
+
+               lng = (lng + b) % (b - a) + (lng < a || lng === b ? b : a);
+
+               return new L.LatLng(this.lat, lng);
        }
 };
 
-L.latLng = function (a, b, c) { // (LatLng) or ([Number, Number]) or (Number, Number, Boolean)
+L.latLng = function (a, b) { // (LatLng) or ([Number, Number]) or (Number, Number)
        if (a instanceof L.LatLng) {
                return a;
        }
-       if (a instanceof Array) {
+       if (L.Util.isArray(a)) {
                return new L.LatLng(a[0], a[1]);
        }
-       if (isNaN(a)) {
+       if (a === undefined || a === null) {
                return a;
        }
-       return new L.LatLng(a, b, c);
+       if (typeof a === 'object' && 'lat' in a) {
+               return new L.LatLng(a.lat, 'lng' in a ? a.lng : a.lon);
+       }
+       return new L.LatLng(a, b);
 };
 
 
@@ -986,20 +1215,22 @@ L.latLng = function (a, b, c) { // (LatLng) or ([Number, Number]) or (Number, Nu
  * L.LatLngBounds represents a rectangular area on the map in geographical coordinates.
  */
 
-L.LatLngBounds = L.Class.extend({
-       initialize: function (southWest, northEast) {   // (LatLng, LatLng) or (LatLng[])
-               if (!southWest) { return; }
+L.LatLngBounds = function (southWest, northEast) { // (LatLng, LatLng) or (LatLng[])
+       if (!southWest) { return; }
 
-               var latlngs = northEast ? [southWest, northEast] : southWest;
+       var latlngs = northEast ? [southWest, northEast] : southWest;
 
-               for (var i = 0, len = latlngs.length; i < len; i++) {
-                       this.extend(latlngs[i]);
-               }
-       },
+       for (var i = 0, len = latlngs.length; i < len; i++) {
+               this.extend(latlngs[i]);
+       }
+};
 
+L.LatLngBounds.prototype = {
        // extend the bounds to contain the given point or bounds
        extend: function (obj) { // (LatLng) or (LatLngBounds)
-               if (typeof obj[0] === 'number' || obj instanceof L.LatLng) {
+               if (!obj) { return this; }
+
+               if (typeof obj[0] === 'number' || typeof obj[0] === 'string' || obj instanceof L.LatLng) {
                        obj = L.latLng(obj);
                } else {
                        obj = L.latLngBounds(obj);
@@ -1007,8 +1238,8 @@ L.LatLngBounds = L.Class.extend({
 
                if (obj instanceof L.LatLng) {
                        if (!this._southWest && !this._northEast) {
-                               this._southWest = new L.LatLng(obj.lat, obj.lng, true);
-                               this._northEast = new L.LatLng(obj.lat, obj.lng, true);
+                               this._southWest = new L.LatLng(obj.lat, obj.lng);
+                               this._northEast = new L.LatLng(obj.lat, obj.lng);
                        } else {
                                this._southWest.lat = Math.min(obj.lat, this._southWest.lat);
                                this._southWest.lng = Math.min(obj.lng, this._southWest.lng);
@@ -1050,11 +1281,27 @@ L.LatLngBounds = L.Class.extend({
        },
 
        getNorthWest: function () {
-               return new L.LatLng(this._northEast.lat, this._southWest.lng, true);
+               return new L.LatLng(this.getNorth(), this.getWest());
        },
 
        getSouthEast: function () {
-               return new L.LatLng(this._southWest.lat, this._northEast.lng, true);
+               return new L.LatLng(this.getSouth(), this.getEast());
+       },
+
+       getWest: function () {
+               return this._southWest.lng;
+       },
+
+       getSouth: function () {
+               return this._southWest.lat;
+       },
+
+       getEast: function () {
+               return this._northEast.lng;
+       },
+
+       getNorth: function () {
+               return this._northEast.lat;
        },
 
        contains: function (obj) { // (LatLngBounds) or (LatLng) -> Boolean
@@ -1094,10 +1341,7 @@ L.LatLngBounds = L.Class.extend({
        },
 
        toBBoxString: function () {
-               var sw = this._southWest,
-                   ne = this._northEast;
-
-               return [sw.lng, sw.lat, ne.lng, ne.lat].join(',');
+               return [this.getWest(), this.getSouth(), this.getEast(), this.getNorth()].join(',');
        },
 
        equals: function (bounds) { // (LatLngBounds)
@@ -1112,7 +1356,7 @@ L.LatLngBounds = L.Class.extend({
        isValid: function () {
                return !!(this._southWest && this._northEast);
        }
-});
+};
 
 //TODO International date line?
 
@@ -1131,6 +1375,9 @@ L.latLngBounds = function (a, b) { // (LatLngBounds) or (LatLng, LatLng)
 L.Projection = {};
 
 
+/*
+ * Spherical Mercator is the most popular map projection, used by EPSG:3857 CRS used by default.
+ */
 
 L.Projection.SphericalMercator = {
        MAX_LATITUDE: 85.0511287798,
@@ -1152,12 +1399,14 @@ L.Projection.SphericalMercator = {
                    lng = point.x * d,
                    lat = (2 * Math.atan(Math.exp(point.y)) - (Math.PI / 2)) * d;
 
-               // TODO refactor LatLng wrapping
-               return new L.LatLng(lat, lng, true);
+               return new L.LatLng(lat, lng);
        }
 };
 
 
+/*
+ * Simple equirectangular (Plate Carree) projection, used by CRS like EPSG:4326 and Simple.
+ */
 
 L.Projection.LonLat = {
        project: function (latlng) {
@@ -1165,11 +1414,14 @@ L.Projection.LonLat = {
        },
 
        unproject: function (point) {
-               return new L.LatLng(point.y, point.x, true);
+               return new L.LatLng(point.y, point.x);
        }
 };
 
 
+/*
+ * L.CRS is a base object for all defined CRS (Coordinate Reference Systems) in Leaflet.
+ */
 
 L.CRS = {
        latLngToPoint: function (latlng, zoom) { // (LatLng, Number) -> Point
@@ -1196,13 +1448,24 @@ L.CRS = {
 };
 
 
+/*
+ * A simple CRS that can be used for flat non-Earth maps like panoramas or game maps.
+ */
 
 L.CRS.Simple = L.extend({}, L.CRS, {
        projection: L.Projection.LonLat,
-       transformation: new L.Transformation(1, 0, 1, 0)
+       transformation: new L.Transformation(1, 0, -1, 0),
+
+       scale: function (zoom) {
+               return Math.pow(2, zoom);
+       }
 });
 
 
+/*
+ * L.CRS.EPSG3857 (Spherical Mercator) is the most common CRS for web mapping
+ * and is used by Leaflet by default.
+ */
 
 L.CRS.EPSG3857 = L.extend({}, L.CRS, {
        code: 'EPSG:3857',
@@ -1222,6 +1485,9 @@ L.CRS.EPSG900913 = L.extend({}, L.CRS.EPSG3857, {
 });
 
 
+/*
+ * L.CRS.EPSG4326 is a CRS popular among advanced GIS specialists.
+ */
 
 L.CRS.EPSG4326 = L.extend({}, L.CRS, {
        code: 'EPSG:4326',
@@ -1258,7 +1524,6 @@ L.Map = L.Class.extend({
 
                this._initContainer(id);
                this._initLayout();
-               this._initHooks();
                this._initEvents();
 
                if (options.maxBounds) {
@@ -1266,10 +1531,18 @@ L.Map = L.Class.extend({
                }
 
                if (options.center && options.zoom !== undefined) {
-                       this.setView(L.latLng(options.center), options.zoom, true);
+                       this.setView(L.latLng(options.center), options.zoom, {reset: true});
                }
 
-               this._initLayers(options.layers);
+               this._handlers = [];
+
+               this._layers = {};
+               this._zoomBoundLayers = {};
+               this._tileLayersNum = 0;
+
+               this.callInitHooks();
+
+               this._addLayers(options.layers);
        },
 
 
@@ -1281,32 +1554,53 @@ L.Map = L.Class.extend({
                return this;
        },
 
-       setZoom: function (zoom) { // (Number)
-               return this.setView(this.getCenter(), zoom);
+       setZoom: function (zoom, options) {
+               return this.setView(this.getCenter(), zoom, {zoom: options});
        },
 
-       zoomIn: function (delta) {
-               return this.setZoom(this._zoom + (delta || 1));
+       zoomIn: function (delta, options) {
+               return this.setZoom(this._zoom + (delta || 1), options);
        },
 
-       zoomOut: function (delta) {
-               return this.setZoom(this._zoom - (delta || 1));
+       zoomOut: function (delta, options) {
+               return this.setZoom(this._zoom - (delta || 1), options);
        },
 
-       fitBounds: function (bounds) { // (LatLngBounds)
-               var zoom = this.getBoundsZoom(bounds);
-               return this.setView(L.latLngBounds(bounds).getCenter(), zoom);
+       setZoomAround: function (latlng, zoom, options) {
+               var scale = this.getZoomScale(zoom),
+                   viewHalf = this.getSize().divideBy(2),
+                   containerPoint = latlng instanceof L.Point ? latlng : this.latLngToContainerPoint(latlng),
+
+                   centerOffset = containerPoint.subtract(viewHalf).multiplyBy(1 - 1 / scale),
+                   newCenter = this.containerPointToLatLng(viewHalf.add(centerOffset));
+
+               return this.setView(newCenter, zoom, {zoom: options});
        },
 
-       fitWorld: function () {
-               var sw = new L.LatLng(-60, -170),
-                   ne = new L.LatLng(85, 179);
+       fitBounds: function (bounds, options) {
+
+               options = options || {};
+               bounds = bounds.getBounds ? bounds.getBounds() : L.latLngBounds(bounds);
+
+               var paddingTL = L.point(options.paddingTopLeft || options.padding || [0, 0]),
+                   paddingBR = L.point(options.paddingBottomRight || options.padding || [0, 0]),
+
+                   zoom = this.getBoundsZoom(bounds, false, paddingTL.add(paddingBR)),
+                   paddingOffset = paddingBR.subtract(paddingTL).divideBy(2),
+
+                   swPoint = this.project(bounds.getSouthWest(), zoom),
+                   nePoint = this.project(bounds.getNorthEast(), zoom),
+                   center = this.unproject(swPoint.add(nePoint).divideBy(2).add(paddingOffset), zoom);
+
+               return this.setView(center, zoom, options);
+       },
 
-               return this.fitBounds(new L.LatLngBounds(sw, ne));
+       fitWorld: function (options) {
+               return this.fitBounds([[-90, -180], [90, 180]], options);
        },
 
-       panTo: function (center) { // (LatLng)
-               return this.setView(center, this._zoom);
+       panTo: function (center, options) { // (LatLng)
+               return this.setView(center, this._zoom, {pan: options});
        },
 
        panBy: function (offset) { // (Point)
@@ -1319,13 +1613,14 @@ L.Map = L.Class.extend({
                return this.fire('moveend');
        },
 
-       setMaxBounds: function (bounds) {
+       setMaxBounds: function (bounds, options) {
                bounds = L.latLngBounds(bounds);
 
                this.options.maxBounds = bounds;
 
                if (!bounds) {
                        this._boundsMinZoom = null;
+                       this.off('moveend', this._panInsideMaxBounds, this);
                        return this;
                }
 
@@ -1335,40 +1630,46 @@ L.Map = L.Class.extend({
 
                if (this._loaded) {
                        if (this._zoom < minZoom) {
-                               this.setView(bounds.getCenter(), minZoom);
+                               this.setView(bounds.getCenter(), minZoom, options);
                        } else {
                                this.panInsideBounds(bounds);
                        }
                }
 
+               this.on('moveend', this._panInsideMaxBounds, this);
+
                return this;
        },
 
        panInsideBounds: function (bounds) {
                bounds = L.latLngBounds(bounds);
 
-               var viewBounds = this.getBounds(),
-                   viewSw = this.project(viewBounds.getSouthWest()),
-                   viewNe = this.project(viewBounds.getNorthEast()),
+               var viewBounds = this.getPixelBounds(),
+                   viewSw = viewBounds.getBottomLeft(),
+                   viewNe = viewBounds.getTopRight(),
                    sw = this.project(bounds.getSouthWest()),
                    ne = this.project(bounds.getNorthEast()),
                    dx = 0,
                    dy = 0;
 
                if (viewNe.y < ne.y) { // north
-                       dy = ne.y - viewNe.y;
+                       dy = Math.ceil(ne.y - viewNe.y);
                }
                if (viewNe.x > ne.x) { // east
-                       dx = ne.x - viewNe.x;
+                       dx = Math.floor(ne.x - viewNe.x);
                }
                if (viewSw.y > sw.y) { // south
-                       dy = sw.y - viewSw.y;
+                       dy = Math.floor(sw.y - viewSw.y);
                }
                if (viewSw.x < sw.x) { // west
-                       dx = sw.x - viewSw.x;
+                       dx = Math.ceil(sw.x - viewSw.x);
+               }
+
+               if (dx || dy) {
+                       return this.panBy([dx, dy]);
                }
 
-               return this.panBy(new L.Point(dx, dy, true));
+               return this;
        },
 
        addLayer: function (layer) {
@@ -1381,24 +1682,21 @@ L.Map = L.Class.extend({
                this._layers[id] = layer;
 
                // TODO getMaxZoom, getMinZoom in ILayer (instead of options)
-               if (layer.options && !isNaN(layer.options.maxZoom)) {
-                       this._layersMaxZoom = Math.max(this._layersMaxZoom || 0, layer.options.maxZoom);
-               }
-               if (layer.options && !isNaN(layer.options.minZoom)) {
-                       this._layersMinZoom = Math.min(this._layersMinZoom || Infinity, layer.options.minZoom);
+               if (layer.options && (!isNaN(layer.options.maxZoom) || !isNaN(layer.options.minZoom))) {
+                       this._zoomBoundLayers[id] = layer;
+                       this._updateZoomLevels();
                }
 
                // TODO looks ugly, refactor!!!
                if (this.options.zoomAnimation && L.TileLayer && (layer instanceof L.TileLayer)) {
                        this._tileLayersNum++;
-            this._tileLayersToLoad++;
-            layer.on('load', this._onTileLayerLoad, this);
+                       this._tileLayersToLoad++;
+                       layer.on('load', this._onTileLayerLoad, this);
                }
 
-               this.whenReady(function () {
-                       layer.onAdd(this);
-                       this.fire('layeradd', {layer: layer});
-               }, this);
+               if (this._loaded) {
+                       this._layerAdd(layer);
+               }
 
                return this;
        },
@@ -1408,29 +1706,53 @@ L.Map = L.Class.extend({
 
                if (!this._layers[id]) { return; }
 
-               layer.onRemove(this);
+               if (this._loaded) {
+                       layer.onRemove(this);
+               }
 
                delete this._layers[id];
 
+               if (this._loaded) {
+                       this.fire('layerremove', {layer: layer});
+               }
+
+               if (this._zoomBoundLayers[id]) {
+                       delete this._zoomBoundLayers[id];
+                       this._updateZoomLevels();
+               }
+
                // TODO looks ugly, refactor
                if (this.options.zoomAnimation && L.TileLayer && (layer instanceof L.TileLayer)) {
                        this._tileLayersNum--;
-            this._tileLayersToLoad--;
-            layer.off('load', this._onTileLayerLoad, this);
+                       this._tileLayersToLoad--;
+                       layer.off('load', this._onTileLayerLoad, this);
                }
 
-               return this.fire('layerremove', {layer: layer});
+               return this;
        },
 
        hasLayer: function (layer) {
-               var id = L.stamp(layer);
-               return this._layers.hasOwnProperty(id);
+               if (!layer) { return false; }
+
+               return (L.stamp(layer) in this._layers);
        },
 
-       invalidateSize: function (animate) {
-               var oldSize = this.getSize();
+       eachLayer: function (method, context) {
+               for (var i in this._layers) {
+                       method.call(context, this._layers[i]);
+               }
+               return this;
+       },
 
+       invalidateSize: function (options) {
+               options = L.extend({
+                       animate: false,
+                       pan: true
+               }, options === true ? {animate: true} : options);
+
+               var oldSize = this.getSize();
                this._sizeChanged = true;
+               this._initialCenter = null;
 
                if (this.options.maxBounds) {
                        this.setMaxBounds(this.options.maxBounds);
@@ -1438,43 +1760,80 @@ L.Map = L.Class.extend({
 
                if (!this._loaded) { return this; }
 
-               var offset = oldSize._subtract(this.getSize())._divideBy(2)._round();
+               var newSize = this.getSize(),
+                   offset = oldSize.subtract(newSize).divideBy(2).round();
 
-               if (animate === true) {
+               if (!offset.x && !offset.y) { return this; }
+
+               if (options.animate && options.pan) {
                        this.panBy(offset);
+
                } else {
-                       this._rawPanBy(offset);
+                       if (options.pan) {
+                               this._rawPanBy(offset);
+                       }
 
                        this.fire('move');
 
+                       // make sure moveend is not fired too often on resize
                        clearTimeout(this._sizeTimer);
                        this._sizeTimer = setTimeout(L.bind(this.fire, this, 'moveend'), 200);
                }
-               return this;
+
+               return this.fire('resize', {
+                       oldSize: oldSize,
+                       newSize: newSize
+               });
        },
 
        // TODO handler.addTo
        addHandler: function (name, HandlerClass) {
                if (!HandlerClass) { return; }
 
-               this[name] = new HandlerClass(this);
+               var handler = this[name] = new HandlerClass(this);
+
+               this._handlers.push(handler);
 
                if (this.options[name]) {
-                       this[name].enable();
+                       handler.enable();
                }
 
                return this;
        },
 
+       remove: function () {
+               if (this._loaded) {
+                       this.fire('unload');
+               }
 
-       // public methods for getting map state
+               this._initEvents('off');
 
-       getCenter: function () { // (Boolean) -> LatLng
-               return this.layerPointToLatLng(this._getCenterLayerPoint());
-       },
+               delete this._container._leaflet;
 
-       getZoom: function () {
-               return this._zoom;
+               this._clearPanes();
+               if (this._clearControlPos) {
+                       this._clearControlPos();
+               }
+
+               this._clearHandlers();
+
+               return this;
+       },
+
+
+       // public methods for getting map state
+
+       getCenter: function () { // (Boolean) -> LatLng
+               this._checkIfLoaded();
+
+               if (this._initialCenter && !this._moved()) {
+                       return this._initialCenter;
+               }
+               return this.layerPointToLatLng(this._getCenterLayerPoint());
+       },
+
+       getZoom: function () {
+               return this._zoom;
        },
 
        getBounds: function () {
@@ -1486,51 +1845,37 @@ L.Map = L.Class.extend({
        },
 
        getMinZoom: function () {
-               var z1 = this.options.minZoom || 0,
-                   z2 = this._layersMinZoom || 0,
-                   z3 = this._boundsMinZoom || 0;
-
-               return Math.max(z1, z2, z3);
+               var z1 = this._layersMinZoom === undefined ? -Infinity : this._layersMinZoom,
+                   z2 = this._boundsMinZoom === undefined ? -Infinity : this._boundsMinZoom;
+               return this.options.minZoom === undefined ? Math.max(z1, z2) : this.options.minZoom;
        },
 
        getMaxZoom: function () {
-               var z1 = this.options.maxZoom === undefined ? Infinity : this.options.maxZoom,
-                   z2 = this._layersMaxZoom  === undefined ? Infinity : this._layersMaxZoom;
-
-               return Math.min(z1, z2);
+               return this.options.maxZoom === undefined ?
+                       (this._layersMaxZoom === undefined ? Infinity : this._layersMaxZoom) :
+                       this.options.maxZoom;
        },
 
-       getBoundsZoom: function (bounds, inside) { // (LatLngBounds, Boolean) -> Number
+       getBoundsZoom: function (bounds, inside, padding) { // (LatLngBounds[, Boolean, Point]) -> Number
                bounds = L.latLngBounds(bounds);
 
-               var size = this.getSize(),
-                   zoom = this.options.minZoom || 0,
+               var zoom = this.getMinZoom() - (inside ? 1 : 0),
                    maxZoom = this.getMaxZoom(),
-                   ne = bounds.getNorthEast(),
-                   sw = bounds.getSouthWest(),
-                   boundsSize,
-                   nePoint,
-                   swPoint,
-                   zoomNotFound = true;
+                   size = this.getSize(),
 
-               if (inside) {
-                       zoom--;
-               }
+                   nw = bounds.getNorthWest(),
+                   se = bounds.getSouthEast(),
+
+                   zoomNotFound = true,
+                   boundsSize;
+
+               padding = L.point(padding || [0, 0]);
 
                do {
                        zoom++;
-                       nePoint = this.project(ne, zoom);
-                       swPoint = this.project(sw, zoom);
-
-                       boundsSize = new L.Point(
-                               Math.abs(nePoint.x - swPoint.x),
-                               Math.abs(swPoint.y - nePoint.y));
+                       boundsSize = this.project(se, zoom).subtract(this.project(nw, zoom)).add(padding);
+                       zoomNotFound = !inside ? size.contains(boundsSize) : boundsSize.x < size.x || boundsSize.y < size.y;
 
-                       if (!inside) {
-                               zoomNotFound = boundsSize.x <= size.x && boundsSize.y <= size.y;
-                       } else {
-                               zoomNotFound = boundsSize.x < size.x || boundsSize.y < size.y;
-                       }
                } while (zoomNotFound && zoom <= maxZoom);
 
                if (zoomNotFound && inside) {
@@ -1557,6 +1902,7 @@ L.Map = L.Class.extend({
        },
 
        getPixelOrigin: function () {
+               this._checkIfLoaded();
                return this._initialTopLeftPoint;
        },
 
@@ -1594,13 +1940,13 @@ L.Map = L.Class.extend({
        },
 
        layerPointToLatLng: function (point) { // (Point)
-               var projectedPoint = L.point(point).add(this._initialTopLeftPoint);
+               var projectedPoint = L.point(point).add(this.getPixelOrigin());
                return this.unproject(projectedPoint);
        },
 
        latLngToLayerPoint: function (latlng) { // (LatLng)
                var projectedPoint = this.project(L.latLng(latlng))._round();
-               return projectedPoint._subtract(this._initialTopLeftPoint);
+               return projectedPoint._subtract(this.getPixelOrigin());
        },
 
        containerPointToLayerPoint: function (point) { // (Point)
@@ -1638,8 +1984,10 @@ L.Map = L.Class.extend({
        _initContainer: function (id) {
                var container = this._container = L.DomUtil.get(id);
 
-               if (container._leaflet) {
-                       throw new Error("Map container is already initialized.");
+               if (!container) {
+                       throw new Error('Map container not found.');
+               } else if (container._leaflet) {
+                       throw new Error('Map container is already initialized.');
                }
 
                container._leaflet = true;
@@ -1648,16 +1996,10 @@ L.Map = L.Class.extend({
        _initLayout: function () {
                var container = this._container;
 
-               container.innerHTML = '';
-               L.DomUtil.addClass(container, 'leaflet-container');
-
-               if (L.Browser.touch) {
-                       L.DomUtil.addClass(container, 'leaflet-touch');
-               }
-
-               if (this.options.fadeAnimation) {
-                       L.DomUtil.addClass(container, 'leaflet-fade-anim');
-               }
+               L.DomUtil.addClass(container, 'leaflet-container' +
+                       (L.Browser.touch ? ' leaflet-touch' : '') +
+                       (L.Browser.retina ? ' leaflet-retina' : '') +
+                       (this.options.fadeAnimation ? ' leaflet-fade-anim' : ''));
 
                var position = L.DomUtil.getStyle(container, 'position');
 
@@ -1697,24 +2039,14 @@ L.Map = L.Class.extend({
                return L.DomUtil.create('div', className, container || this._panes.objectsPane);
        },
 
-       _initializers: [],
-
-       _initHooks: function () {
-               var i, len;
-               for (i = 0, len = this._initializers.length; i < len; i++) {
-                       this._initializers[i].call(this);
-               }
+       _clearPanes: function () {
+               this._container.removeChild(this._mapPane);
        },
 
-       _initLayers: function (layers) {
-               layers = layers ? (layers instanceof Array ? layers : [layers]) : [];
-
-               this._layers = {};
-               this._tileLayersNum = 0;
-
-               var i, len;
+       _addLayers: function (layers) {
+               layers = layers ? (L.Util.isArray(layers) ? layers : [layers]) : [];
 
-               for (i = 0, len = layers.length; i < len; i++) {
+               for (var i = 0, len = layers.length; i < len; i++) {
                        this.addLayer(layers[i]);
                }
        },
@@ -1735,6 +2067,7 @@ L.Map = L.Class.extend({
                }
 
                this._zoom = zoom;
+               this._initialCenter = center;
 
                this._initialTopLeftPoint = this._getNewTopLeftPoint(center);
 
@@ -1749,6 +2082,11 @@ L.Map = L.Class.extend({
                var loading = !this._loaded;
                this._loaded = true;
 
+               if (loading) {
+                       this.fire('load');
+                       this.eachLayer(this._layerAdd, this);
+               }
+
                this.fire('viewreset', {hard: !preserveMapOffset});
 
                this.fire('move');
@@ -1758,34 +2096,73 @@ L.Map = L.Class.extend({
                }
 
                this.fire('moveend', {hard: !preserveMapOffset});
-
-               if (loading) {
-                       this.fire('load');
-               }
        },
 
        _rawPanBy: function (offset) {
                L.DomUtil.setPosition(this._mapPane, this._getMapPanePos().subtract(offset));
        },
 
+       _getZoomSpan: function () {
+               return this.getMaxZoom() - this.getMinZoom();
+       },
+
+       _updateZoomLevels: function () {
+               var i,
+                       minZoom = Infinity,
+                       maxZoom = -Infinity,
+                       oldZoomSpan = this._getZoomSpan();
+
+               for (i in this._zoomBoundLayers) {
+                       var layer = this._zoomBoundLayers[i];
+                       if (!isNaN(layer.options.minZoom)) {
+                               minZoom = Math.min(minZoom, layer.options.minZoom);
+                       }
+                       if (!isNaN(layer.options.maxZoom)) {
+                               maxZoom = Math.max(maxZoom, layer.options.maxZoom);
+                       }
+               }
+
+               if (i === undefined) { // we have no tilelayers
+                       this._layersMaxZoom = this._layersMinZoom = undefined;
+               } else {
+                       this._layersMaxZoom = maxZoom;
+                       this._layersMinZoom = minZoom;
+               }
+
+               if (oldZoomSpan !== this._getZoomSpan()) {
+                       this.fire('zoomlevelschange');
+               }
+       },
+
+       _panInsideMaxBounds: function () {
+               this.panInsideBounds(this.options.maxBounds);
+       },
+
+       _checkIfLoaded: function () {
+               if (!this._loaded) {
+                       throw new Error('Set map center and zoom first.');
+               }
+       },
 
        // map events
 
-       _initEvents: function () {
+       _initEvents: function (onOff) {
                if (!L.DomEvent) { return; }
 
-               L.DomEvent.on(this._container, 'click', this._onMouseClick, this);
+               onOff = onOff || 'on';
+
+               L.DomEvent[onOff](this._container, 'click', this._onMouseClick, this);
 
                var events = ['dblclick', 'mousedown', 'mouseup', 'mouseenter',
                              'mouseleave', 'mousemove', 'contextmenu'],
                    i, len;
 
                for (i = 0, len = events.length; i < len; i++) {
-                       L.DomEvent.on(this._container, events[i], this._fireMouseEvent, this);
+                       L.DomEvent[onOff](this._container, events[i], this._fireMouseEvent, this);
                }
 
                if (this.options.trackResize) {
-                       L.DomEvent.on(window, 'resize', this._onResize, this);
+                       L.DomEvent[onOff](window, 'resize', this._onResize, this);
                }
        },
 
@@ -1796,14 +2173,15 @@ L.Map = L.Class.extend({
        },
 
        _onMouseClick: function (e) {
-               if (!this._loaded || (this.dragging && this.dragging.moved())) { return; }
+               if (!this._loaded || (!e._simulated && this.dragging && this.dragging.moved()) ||
+                       L.DomEvent._skipped(e)) { return; }
 
                this.fire('preclick');
                this._fireMouseEvent(e);
        },
 
        _fireMouseEvent: function (e) {
-               if (!this._loaded) { return; }
+               if (!this._loaded || L.DomEvent._skipped(e)) { return; }
 
                var type = e.type;
 
@@ -1828,12 +2206,15 @@ L.Map = L.Class.extend({
        },
 
        _onTileLayerLoad: function () {
-               // TODO super-ugly, refactor!!!
-               // clear scaled tiles after all new tiles are loaded (for performance)
                this._tileLayersToLoad--;
-               if (this._tileLayersNum && !this._tileLayersToLoad && this._tileBg) {
-                       clearTimeout(this._clearTileBgTimer);
-                       this._clearTileBgTimer = setTimeout(L.bind(this._clearTileBg, this), 500);
+               if (this._tileLayersNum && !this._tileLayersToLoad) {
+                       this.fire('tilelayersload');
+               }
+       },
+
+       _clearHandlers: function () {
+               for (var i = 0, len = this._handlers.length; i < len; i++) {
+                       this._handlers[i].disable();
                }
        },
 
@@ -1846,6 +2227,11 @@ L.Map = L.Class.extend({
                return this;
        },
 
+       _layerAdd: function (layer) {
+               layer.onAdd(this);
+               this.fire('layeradd', {layer: layer});
+       },
+
 
        // private methods for getting map state
 
@@ -1853,12 +2239,13 @@ L.Map = L.Class.extend({
                return L.DomUtil.getPosition(this._mapPane);
        },
 
-       _getTopLeftPoint: function () {
-               if (!this._loaded) {
-                       throw new Error('Set map center and zoom first.');
-               }
+       _moved: function () {
+               var pos = this._getMapPanePos();
+               return pos && !pos.equals([0, 0]);
+       },
 
-               return this._initialTopLeftPoint.subtract(this._getMapPanePos());
+       _getTopLeftPoint: function () {
+               return this.getPixelOrigin().subtract(this._getMapPanePos());
        },
 
        _getNewTopLeftPoint: function (center, zoom) {
@@ -1872,12 +2259,14 @@ L.Map = L.Class.extend({
                return this.project(latlng, newZoom)._subtract(topLeft);
        },
 
+       // layer point of the current center
        _getCenterLayerPoint: function () {
                return this.containerPointToLayerPoint(this.getSize()._divideBy(2));
        },
 
-       _getCenterOffset: function (center) {
-               return this.latLngToLayerPoint(center).subtract(this._getCenterLayerPoint());
+       // offset of the specified place to the current center in pixels
+       _getCenterOffset: function (latlng) {
+               return this.latLngToLayerPoint(latlng).subtract(this._getCenterLayerPoint());
        },
 
        _limitZoom: function (zoom) {
@@ -1888,26 +2277,20 @@ L.Map = L.Class.extend({
        }
 });
 
-L.Map.addInitHook = function (fn) {
-       var args = Array.prototype.slice.call(arguments, 1);
-
-       var init = typeof fn === 'function' ? fn : function () {
-               this[fn].apply(this, args);
-       };
-
-       this.prototype._initializers.push(init);
-};
-
 L.map = function (id, options) {
        return new L.Map(id, options);
 };
 
 
+/*
+ * Mercator projection that takes into account that the Earth is not a perfect sphere.
+ * Less popular than spherical mercator; used by projections like EPSG:3395.
+ */
 
 L.Projection.Mercator = {
        MAX_LATITUDE: 85.0840591556,
 
-       R_MINOR: 6356752.3142,
+       R_MINOR: 6356752.314245179,
        R_MAJOR: 6378137,
 
        project: function (latlng) { // (LatLng) -> Point
@@ -1925,7 +2308,7 @@ L.Projection.Mercator = {
                con = Math.pow((1 - con) / (1 + con), eccent * 0.5);
 
                var ts = Math.tan(0.5 * ((Math.PI * 0.5) - y)) / con;
-               y = -r2 * Math.log(ts);
+               y = -r * Math.log(ts);
 
                return new L.Point(x, y);
        },
@@ -1937,7 +2320,7 @@ L.Projection.Mercator = {
                    lng = point.x * d / r,
                    tmp = r2 / r,
                    eccent = Math.sqrt(1 - (tmp * tmp)),
-                   ts = Math.exp(- point.y / r2),
+                   ts = Math.exp(- point.y / r),
                    phi = (Math.PI / 2) - 2 * Math.atan(ts),
                    numIter = 15,
                    tol = 1e-7,
@@ -1952,7 +2335,7 @@ L.Projection.Mercator = {
                        phi += dphi;
                }
 
-               return new L.LatLng(phi * d, lng, true);
+               return new L.LatLng(phi * d, lng);
        }
 };
 
@@ -1997,6 +2380,7 @@ L.TileLayer = L.Class.extend({
                zoomReverse: false,
                detectRetina: false,
                reuseTiles: false,
+               bounds: false,
                */
                unloadInvisibleTiles: L.Browser.mobile,
                updateWhenIdle: L.Browser.mobile
@@ -2017,6 +2401,10 @@ L.TileLayer = L.Class.extend({
                        this.options.maxZoom--;
                }
 
+               if (options.bounds) {
+                       options.bounds = L.latLngBounds(options.bounds);
+               }
+
                this._url = url;
 
                var subdomains = this.options.subdomains;
@@ -2028,6 +2416,7 @@ L.TileLayer = L.Class.extend({
 
        onAdd: function (map) {
                this._map = map;
+               this._animated = map._zoomAnimated;
 
                // create a container div for tiles
                this._initContainer();
@@ -2037,10 +2426,17 @@ L.TileLayer = L.Class.extend({
 
                // set up events
                map.on({
-                       'viewreset': this._resetCallback,
+                       'viewreset': this._reset,
                        'moveend': this._update
                }, this);
 
+               if (this._animated) {
+                       map.on({
+                               'zoomanim': this._animateZoom,
+                               'zoomend': this._endZoomAnim
+                       }, this);
+               }
+
                if (!this.options.updateWhenIdle) {
                        this._limitedUpdate = L.Util.limitExecByInterval(this._update, 150, this);
                        map.on('move', this._limitedUpdate, this);
@@ -2056,13 +2452,20 @@ L.TileLayer = L.Class.extend({
        },
 
        onRemove: function (map) {
-               map._panes.tilePane.removeChild(this._container);
+               this._container.parentNode.removeChild(this._container);
 
                map.off({
-                       'viewreset': this._resetCallback,
+                       'viewreset': this._reset,
                        'moveend': this._update
                }, this);
 
+               if (this._animated) {
+                       map.off({
+                               'zoomanim': this._animateZoom,
+                               'zoomend': this._endZoomAnim
+                       }, this);
+               }
+
                if (!this.options.updateWhenIdle) {
                        map.off('move', this._limitedUpdate, this);
                }
@@ -2097,6 +2500,10 @@ L.TileLayer = L.Class.extend({
                return this.options.attribution;
        },
 
+       getContainer: function () {
+               return this._container;
+       },
+
        setOpacity: function (opacity) {
                this.options.opacity = opacity;
 
@@ -2126,8 +2533,7 @@ L.TileLayer = L.Class.extend({
 
        redraw: function () {
                if (this._map) {
-                       this._map._panes.tilePane.empty = false;
-                       this._reset(true);
+                       this._reset({hard: true});
                        this._update();
                }
                return this;
@@ -2141,8 +2547,8 @@ L.TileLayer = L.Class.extend({
 
        _setAutoZIndex: function (pane, compare) {
 
-               var layers = pane.getElementsByClassName('leaflet-layer'),
-                   edgeZIndex = -compare(Infinity, -Infinity), // -Ifinity for max, Infinity for min
+               var layers = pane.children,
+                   edgeZIndex = -compare(Infinity, -Infinity), // -Infinity for max, Infinity for min
                    zIndex, i, len;
 
                for (i = 0, len = layers.length; i < len; i++) {
@@ -2161,29 +2567,36 @@ L.TileLayer = L.Class.extend({
        },
 
        _updateOpacity: function () {
-               L.DomUtil.setOpacity(this._container, this.options.opacity);
-
-               // stupid webkit hack to force redrawing of tiles
                var i,
                    tiles = this._tiles;
 
-               if (L.Browser.webkit) {
+               if (L.Browser.ielt9) {
                        for (i in tiles) {
-                               if (tiles.hasOwnProperty(i)) {
-                                       tiles[i].style.webkitTransform += ' translate(0,0)';
-                               }
+                               L.DomUtil.setOpacity(tiles[i], this.options.opacity);
                        }
+               } else {
+                       L.DomUtil.setOpacity(this._container, this.options.opacity);
                }
        },
 
        _initContainer: function () {
                var tilePane = this._map._panes.tilePane;
 
-               if (!this._container || tilePane.empty) {
+               if (!this._container) {
                        this._container = L.DomUtil.create('div', 'leaflet-layer');
 
                        this._updateZIndex();
 
+                       if (this._animated) {
+                               var className = 'leaflet-tile-container leaflet-zoom-animated';
+
+                               this._bgBuffer = L.DomUtil.create('div', className, this._container);
+                               this._tileContainer = L.DomUtil.create('div', className, this._container);
+
+                       } else {
+                               this._tileContainer = this._container;
+                       }
+
                        tilePane.appendChild(this._container);
 
                        if (this.options.opacity < 1) {
@@ -2192,17 +2605,9 @@ L.TileLayer = L.Class.extend({
                }
        },
 
-       _resetCallback: function (e) {
-               this._reset(e.hard);
-       },
-
-       _reset: function (clearOldContainer) {
-               var tiles = this._tiles;
-
-               for (var key in tiles) {
-                       if (tiles.hasOwnProperty(key)) {
-                               this.fire('tileunload', {tile: tiles[key]});
-                       }
+       _reset: function (e) {
+               for (var key in this._tiles) {
+                       this.fire('tileunload', {tile: this._tiles[key]});
                }
 
                this._tiles = {};
@@ -2212,14 +2617,16 @@ L.TileLayer = L.Class.extend({
                        this._unusedTiles = [];
                }
 
-               if (clearOldContainer && this._container) {
-                       this._container.innerHTML = "";
+               this._tileContainer.innerHTML = '';
+
+               if (this._animated && e && e.hard) {
+                       this._clearBgBuffer();
                }
 
                this._initContainer();
        },
 
-       _update: function (e) {
+       _update: function () {
 
                if (!this._map) { return; }
 
@@ -2231,15 +2638,9 @@ L.TileLayer = L.Class.extend({
                        return;
                }
 
-               var nwTilePoint = new L.Point(
-                       Math.floor(bounds.min.x / tileSize),
-                       Math.floor(bounds.min.y / tileSize)),
-
-                   seTilePoint = new L.Point(
-                       Math.floor(bounds.max.x / tileSize),
-                       Math.floor(bounds.max.y / tileSize)),
-
-                   tileBounds = new L.Bounds(nwTilePoint, seTilePoint);
+               var tileBounds = L.bounds(
+                       bounds.min.divideBy(tileSize)._floor(),
+                       bounds.max.divideBy(tileSize)._floor());
 
                this._addTilesFromCenterOut(tileBounds);
 
@@ -2286,7 +2687,7 @@ L.TileLayer = L.Class.extend({
                        this._addTile(queue[i], fragment);
                }
 
-               this._container.appendChild(fragment);
+               this._tileContainer.appendChild(fragment);
        },
 
        _tileShouldBeLoaded: function (tilePoint) {
@@ -2294,13 +2695,31 @@ L.TileLayer = L.Class.extend({
                        return false; // already loaded
                }
 
-               if (!this.options.continuousWorld) {
+               var options = this.options;
+
+               if (!options.continuousWorld) {
                        var limit = this._getWrapTileNum();
 
-                       if (this.options.noWrap && (tilePoint.x < 0 || tilePoint.x >= limit) ||
-                                                       tilePoint.y < 0 || tilePoint.y >= limit) {
-                               return false; // exceeds world bounds
+                       // don't load if exceeds world bounds
+                       if ((options.noWrap && (tilePoint.x < 0 || tilePoint.x >= limit)) ||
+                               tilePoint.y < 0 || tilePoint.y >= limit) { return false; }
+               }
+
+               if (options.bounds) {
+                       var tileSize = options.tileSize,
+                           nwPoint = tilePoint.multiplyBy(tileSize),
+                           sePoint = nwPoint.add([tileSize, tileSize]),
+                           nw = this._map.unproject(nwPoint),
+                           se = this._map.unproject(sePoint);
+
+                       // TODO temporary hack, will be removed after refactoring projections
+                       // https://github.com/Leaflet/Leaflet/issues/1618
+                       if (!options.continuousWorld && !options.noWrap) {
+                               nw = nw.wrap();
+                               se = se.wrap();
                        }
+
+                       if (!options.bounds.intersects([nw, se])) { return false; }
                }
 
                return true;
@@ -2310,15 +2729,13 @@ L.TileLayer = L.Class.extend({
                var kArr, x, y, key;
 
                for (key in this._tiles) {
-                       if (this._tiles.hasOwnProperty(key)) {
-                               kArr = key.split(':');
-                               x = parseInt(kArr[0], 10);
-                               y = parseInt(kArr[1], 10);
-
-                               // remove tile if it's out of bounds
-                               if (x < bounds.min.x || x > bounds.max.x || y < bounds.min.y || y > bounds.max.y) {
-                                       this._removeTile(key);
-                               }
+                       kArr = key.split(':');
+                       x = parseInt(kArr[0], 10);
+                       y = parseInt(kArr[1], 10);
+
+                       // remove tile if it's out of bounds
+                       if (x < bounds.min.x || x > bounds.max.x || y < bounds.min.y || y > bounds.max.y) {
+                               this._removeTile(key);
                        }
                }
        },
@@ -2326,18 +2743,19 @@ L.TileLayer = L.Class.extend({
        _removeTile: function (key) {
                var tile = this._tiles[key];
 
-               this.fire("tileunload", {tile: tile, url: tile.src});
+               this.fire('tileunload', {tile: tile, url: tile.src});
 
                if (this.options.reuseTiles) {
                        L.DomUtil.removeClass(tile, 'leaflet-tile-loaded');
                        this._unusedTiles.push(tile);
 
-               } else if (tile.parentNode === this._container) {
-                       this._container.removeChild(tile);
+               } else if (tile.parentNode === this._tileContainer) {
+                       this._tileContainer.removeChild(tile);
                }
 
                // for https://github.com/CloudMade/Leaflet/issues/137
                if (!L.Browser.android) {
+                       tile.onload = null;
                        tile.src = L.Util.emptyImageUrl;
                }
 
@@ -2353,7 +2771,6 @@ L.TileLayer = L.Class.extend({
                /*
                Chrome 20 layouts much faster with top/left (verify with timeline, frames)
                Android 4 browser has display issues with top/left and requires transform instead
-               Android 3 browser not tested
                Android 2 browser requires top/left or tiles disappear on load or first drag
                (reappear after zoom) https://github.com/CloudMade/Leaflet/issues/866
                (other browsers don't currently care) - see debug/hacks/jitter.html for an example
@@ -2364,7 +2781,7 @@ L.TileLayer = L.Class.extend({
 
                this._loadTile(tile, tilePoint);
 
-               if (tile.parentNode !== this._container) {
+               if (tile.parentNode !== this._tileContainer) {
                        container.appendChild(tile);
                }
        },
@@ -2391,11 +2808,9 @@ L.TileLayer = L.Class.extend({
        // image-specific code (override to implement e.g. Canvas or SVG tile layer)
 
        getTileUrl: function (tilePoint) {
-               this._adjustTilePoint(tilePoint);
-
                return L.Util.template(this._url, L.extend({
                        s: this._getSubdomain(tilePoint),
-                       z: this._getZoomForUrl(),
+                       z: tilePoint.z,
                        x: tilePoint.x,
                        y: tilePoint.y
                }, this.options));
@@ -2418,10 +2833,12 @@ L.TileLayer = L.Class.extend({
                if (this.options.tms) {
                        tilePoint.y = limit - tilePoint.y - 1;
                }
+
+               tilePoint.z = this._getZoomForUrl();
        },
 
        _getSubdomain: function (tilePoint) {
-               var index = (tilePoint.x + tilePoint.y) % this.options.subdomains.length;
+               var index = Math.abs(tilePoint.x + tilePoint.y) % this.options.subdomains.length;
                return this.options.subdomains[index];
        },
 
@@ -2440,13 +2857,16 @@ L.TileLayer = L.Class.extend({
                return this._createTile();
        },
 
-       _resetTile: function (tile) {
-               // Override if data stored on a tile needs to be cleaned up before reuse
-       },
+       // Override if data stored on a tile needs to be cleaned up before reuse
+       _resetTile: function (/*tile*/) {},
 
        _createTile: function () {
                var tile = this._tileImg.cloneNode(false);
                tile.onselectstart = tile.onmousemove = L.Util.falseFn;
+
+               if (L.Browser.ielt9 && this.options.opacity !== undefined) {
+                       L.DomUtil.setOpacity(tile, this.options.opacity);
+               }
                return tile;
        },
 
@@ -2455,17 +2875,24 @@ L.TileLayer = L.Class.extend({
                tile.onload  = this._tileOnLoad;
                tile.onerror = this._tileOnError;
 
+               this._adjustTilePoint(tilePoint);
                tile.src     = this.getTileUrl(tilePoint);
        },
 
-    _tileLoaded: function () {
-        this._tilesToLoad--;
-        if (!this._tilesToLoad) {
-            this.fire('load');
-        }
-    },
+       _tileLoaded: function () {
+               this._tilesToLoad--;
+               if (!this._tilesToLoad) {
+                       this.fire('load');
+
+                       if (this._animated) {
+                               // clear scaled tiles after all new tiles are loaded (for performance)
+                               clearTimeout(this._clearBgBufferTimer);
+                               this._clearBgBufferTimer = setTimeout(L.bind(this._clearBgBuffer, this), 500);
+                       }
+               }
+       },
 
-       _tileOnLoad: function (e) {
+       _tileOnLoad: function () {
                var layer = this._layer;
 
                //Only if we are loading an actual image
@@ -2481,7 +2908,7 @@ L.TileLayer = L.Class.extend({
                layer._tileLoaded();
        },
 
-       _tileOnError: function (e) {
+       _tileOnError: function () {
                var layer = this._layer;
 
                layer.fire('tileerror', {
@@ -2494,8 +2921,8 @@ L.TileLayer = L.Class.extend({
                        this.src = newUrl;
                }
 
-        layer._tileLoaded();
-    }
+               layer._tileLoaded();
+       }
 });
 
 L.tileLayer = function (url, options) {
@@ -2503,6 +2930,10 @@ L.tileLayer = function (url, options) {
 };
 
 
+/*
+ * L.TileLayer.WMS is used for putting WMS tile layers on the map.
+ */
+
 L.TileLayer.WMS = L.TileLayer.extend({
 
        defaultWmsParams: {
@@ -2519,17 +2950,18 @@ L.TileLayer.WMS = L.TileLayer.extend({
 
                this._url = url;
 
-               var wmsParams = L.extend({}, this.defaultWmsParams);
+               var wmsParams = L.extend({}, this.defaultWmsParams),
+                   tileSize = options.tileSize || this.options.tileSize;
 
                if (options.detectRetina && L.Browser.retina) {
-                       wmsParams.width = wmsParams.height = this.options.tileSize * 2;
+                       wmsParams.width = wmsParams.height = tileSize * 2;
                } else {
-                       wmsParams.width = wmsParams.height = this.options.tileSize;
+                       wmsParams.width = wmsParams.height = tileSize;
                }
 
                for (var i in options) {
                        // all keys that are not TileLayer options go to WMS params
-                       if (!this.options.hasOwnProperty(i)) {
+                       if (!this.options.hasOwnProperty(i) && i !== 'crs') {
                                wmsParams[i] = options[i];
                        }
                }
@@ -2541,8 +2973,10 @@ L.TileLayer.WMS = L.TileLayer.extend({
 
        onAdd: function (map) {
 
+               this._crs = this.options.crs || map.options.crs;
+
                var projectionKey = parseFloat(this.wmsParams.version) >= 1.3 ? 'crs' : 'srs';
-               this.wmsParams[projectionKey] = map.options.crs.code;
+               this.wmsParams[projectionKey] = this._crs.code;
 
                L.TileLayer.prototype.onAdd.call(this, map);
        },
@@ -2550,20 +2984,19 @@ L.TileLayer.WMS = L.TileLayer.extend({
        getTileUrl: function (tilePoint, zoom) { // (Point, Number) -> String
 
                var map = this._map,
-                   crs = map.options.crs,
                    tileSize = this.options.tileSize,
 
                    nwPoint = tilePoint.multiplyBy(tileSize),
-                   sePoint = nwPoint.add(new L.Point(tileSize, tileSize)),
+                   sePoint = nwPoint.add([tileSize, tileSize]),
 
-                   nw = crs.project(map.unproject(nwPoint, zoom)),
-                   se = crs.project(map.unproject(sePoint, zoom)),
+                   nw = this._crs.project(map.unproject(nwPoint, zoom)),
+                   se = this._crs.project(map.unproject(sePoint, zoom)),
 
                    bbox = [nw.x, se.y, se.x, nw.y].join(','),
 
                    url = L.Util.template(this._url, {s: this._getSubdomain(tilePoint)});
 
-               return url + L.Util.getParamString(this.wmsParams) + "&bbox=" + bbox;
+               return url + L.Util.getParamString(this.wmsParams, url, true) + '&BBOX=' + bbox;
        },
 
        setParams: function (params, noRedraw) {
@@ -2583,6 +3016,11 @@ L.tileLayer.wms = function (url, options) {
 };
 
 
+/*
+ * L.TileLayer.Canvas is a class that you can use as a base for creating
+ * dynamically drawn Canvas-based tile layers.
+ */
+
 L.TileLayer.Canvas = L.TileLayer.extend({
        options: {
                async: false
@@ -2593,13 +3031,15 @@ L.TileLayer.Canvas = L.TileLayer.extend({
        },
 
        redraw: function () {
-               var tiles = this._tiles;
-
-               for (var i in tiles) {
-                       if (tiles.hasOwnProperty(i)) {
-                               this._redrawTile(tiles[i]);
-                       }
+               if (this._map) {
+                       this._reset({hard: true});
+                       this._update();
+               }
+               
+               for (var i in this._tiles) {
+                       this._redrawTile(this._tiles[i]);
                }
+               return this;
        },
 
        _redrawTile: function (tile) {
@@ -2628,7 +3068,7 @@ L.TileLayer.Canvas = L.TileLayer.extend({
                }
        },
 
-       drawTile: function (tile, tilePoint) {
+       drawTile: function (/*tile, tilePoint*/) {
                // override with rendering code
        },
 
@@ -2643,6 +3083,10 @@ L.tileLayer.canvas = function (options) {
 };
 
 
+/*
+ * L.ImageOverlay is used to overlay images over the map (to specific geographical bounds).
+ */
+
 L.ImageOverlay = L.Class.extend({
        includes: L.Mixin.Events,
 
@@ -2742,8 +3186,7 @@ L.ImageOverlay = L.Class.extend({
 
                    topLeft = map._latLngToNewLayerPoint(nw, e.zoom, e.center),
                    size = map._latLngToNewLayerPoint(se, e.zoom, e.center)._subtract(topLeft),
-                   currentSize = map.latLngToLayerPoint(se)._subtract(map.latLngToLayerPoint(nw)),
-                   origin = topLeft._add(size._subtract(currentSize)._divideBy(2));
+                   origin = topLeft._add(size._multiplyBy((1 / 2) * (1 - 1 / scale)));
 
                image.style[L.DomUtil.TRANSFORM] =
                        L.DomUtil.getTranslateString(origin) + ' scale(' + scale + ') ';
@@ -2752,7 +3195,7 @@ L.ImageOverlay = L.Class.extend({
        _reset: function () {
                var image   = this._image,
                    topLeft = this._map.latLngToLayerPoint(this._bounds.getNorthWest()),
-                   size    = this._map.latLngToLayerPoint(this._bounds.getSouthEast())._subtract(topLeft);
+                   size = this._map.latLngToLayerPoint(this._bounds.getSouthEast())._subtract(topLeft);
 
                L.DomUtil.setPosition(image, topLeft);
 
@@ -2774,14 +3217,20 @@ L.imageOverlay = function (url, bounds, options) {
 };
 
 
+/*
+ * L.Icon is an image-based icon class that you can use with L.Marker for custom markers.
+ */
+
 L.Icon = L.Class.extend({
        options: {
                /*
                iconUrl: (String) (required)
+               iconRetinaUrl: (String) (optional, used for retina devices if detected)
                iconSize: (Point) (can be set through CSS)
                iconAnchor: (Point) (centered by default, can be set in CSS with negative margins)
                popupAnchor: (Point) (if not specified, popup opens in the anchor point)
-               shadowUrl: (Point) (no shadow by default)
+               shadowUrl: (String) (no shadow by default)
+               shadowRetinaUrl: (String) (optional, used for retina devices if detected)
                shadowSize: (Point)
                shadowAnchor: (Point)
                */
@@ -2792,25 +3241,30 @@ L.Icon = L.Class.extend({
                L.setOptions(this, options);
        },
 
-       createIcon: function () {
-               return this._createIcon('icon');
+       createIcon: function (oldIcon) {
+               return this._createIcon('icon', oldIcon);
        },
 
-       createShadow: function () {
-               return this._createIcon('shadow');
+       createShadow: function (oldIcon) {
+               return this._createIcon('shadow', oldIcon);
        },
 
-       _createIcon: function (name) {
+       _createIcon: function (name, oldIcon) {
                var src = this._getIconUrl(name);
 
                if (!src) {
                        if (name === 'icon') {
-                               throw new Error("iconUrl not set in Icon options (see the docs).");
+                               throw new Error('iconUrl not set in Icon options (see the docs).');
                        }
                        return null;
                }
 
-               var img = this._createImg(src);
+               var img;
+               if (!oldIcon || oldIcon.tagName !== 'IMG') {
+                       img = this._createImg(src);
+               } else {
+                       img = this._createImg(src, oldIcon);
+               }
                this._setIconStyles(img, name);
 
                return img;
@@ -2844,14 +3298,17 @@ L.Icon = L.Class.extend({
                }
        },
 
-       _createImg: function (src) {
-               var el;
+       _createImg: function (src, el) {
 
                if (!L.Browser.ie6) {
-                       el = document.createElement('img');
+                       if (!el) {
+                               el = document.createElement('img');
+                       }
                        el.src = src;
                } else {
-                       el = document.createElement('div');
+                       if (!el) {
+                               el = document.createElement('div');
+                       }
                        el.style.filter =
                                'progid:DXImageTransform.Microsoft.AlphaImageLoader(src="' + src + '")';
                }
@@ -2859,6 +3316,9 @@ L.Icon = L.Class.extend({
        },
 
        _getIconUrl: function (name) {
+               if (L.Browser.retina && this.options[name + 'RetinaUrl']) {
+                       return this.options[name + 'RetinaUrl'];
+               }
                return this.options[name + 'Url'];
        }
 });
@@ -2868,15 +3328,18 @@ L.icon = function (options) {
 };
 
 
+/*
+ * L.Icon.Default is the blue marker icon used by default in Leaflet.
+ */
 
 L.Icon.Default = L.Icon.extend({
 
        options: {
-               iconSize: new L.Point(25, 41),
-               iconAnchor: new L.Point(12, 41),
-               popupAnchor: new L.Point(1, -34),
+               iconSize: [25, 41],
+               iconAnchor: [12, 41],
+               popupAnchor: [1, -34],
 
-               shadowSize: new L.Point(41, 41)
+               shadowSize: [41, 41]
        },
 
        _getIconUrl: function (name) {
@@ -2886,10 +3349,14 @@ L.Icon.Default = L.Icon.extend({
                        return this.options[key];
                }
 
+               if (L.Browser.retina && name === 'icon') {
+                       name += '-2x';
+               }
+
                var path = L.Icon.Default.imagePath;
 
                if (!path) {
-                       throw new Error("Couldn't autodetect L.Icon.Default.imagePath, set it manually.");
+                       throw new Error('Couldn\'t autodetect L.Icon.Default.imagePath, set it manually.');
                }
 
                return path + '/marker-' + name + '.png';
@@ -2898,16 +3365,17 @@ L.Icon.Default = L.Icon.extend({
 
 L.Icon.Default.imagePath = (function () {
        var scripts = document.getElementsByTagName('script'),
-           leafletRe = /\/?leaflet[\-\._]?([\w\-\._]*)\.js\??/;
+           leafletRe = /[\/^]leaflet[\-\._]?([\w\-\._]*)\.js\??/;
 
-       var i, len, src, matches;
+       var i, len, src, matches, path;
 
        for (i = 0, len = scripts.length; i < len; i++) {
                src = scripts[i].src;
                matches = src.match(leafletRe);
 
                if (matches) {
-                       return src.split(leafletRe)[0] + '/images';
+                       path = src.split(leafletRe)[0];
+                       return (path ? path + '/' : '') + 'images';
                }
        }
 }());
@@ -2926,6 +3394,7 @@ L.Marker = L.Class.extend({
                title: '',
                clickable: true,
                draggable: false,
+               keyboard: true,
                zIndexOffset: 0,
                opacity: 1,
                riseOnHover: false,
@@ -2956,7 +3425,12 @@ L.Marker = L.Class.extend({
        },
 
        onRemove: function (map) {
+               if (this.dragging) {
+                       this.dragging.disable();
+               }
+
                this._removeIcon();
+               this._removeShadow();
 
                this.fire('remove');
 
@@ -2977,18 +3451,17 @@ L.Marker = L.Class.extend({
 
                this.update();
 
-               this.fire('move', { latlng: this._latlng });
+               return this.fire('move', { latlng: this._latlng });
        },
 
        setZIndexOffset: function (offset) {
                this.options.zIndexOffset = offset;
                this.update();
+
+               return this;
        },
 
        setIcon: function (icon) {
-               if (this._map) {
-                       this._removeIcon();
-               }
 
                this.options.icon = icon;
 
@@ -2996,79 +3469,103 @@ L.Marker = L.Class.extend({
                        this._initIcon();
                        this.update();
                }
+
+               return this;
        },
 
        update: function () {
-               if (!this._icon) { return; }
+               if (this._icon) {
+                       var pos = this._map.latLngToLayerPoint(this._latlng).round();
+                       this._setPos(pos);
+               }
 
-               var pos = this._map.latLngToLayerPoint(this._latlng).round();
-               this._setPos(pos);
+               return this;
        },
 
        _initIcon: function () {
                var options = this.options,
                    map = this._map,
                    animation = (map.options.zoomAnimation && map.options.markerZoomAnimation),
-                   classToAdd = animation ? 'leaflet-zoom-animated' : 'leaflet-zoom-hide',
-                   needOpacityUpdate = false;
+                   classToAdd = animation ? 'leaflet-zoom-animated' : 'leaflet-zoom-hide';
 
-               if (!this._icon) {
-                       this._icon = options.icon.createIcon();
+               var icon = options.icon.createIcon(this._icon),
+                       addIcon = false;
+
+               // if we're not reusing the icon, remove the old one and init new one
+               if (icon !== this._icon) {
+                       if (this._icon) {
+                               this._removeIcon();
+                       }
+                       addIcon = true;
 
                        if (options.title) {
-                               this._icon.title = options.title;
+                               icon.title = options.title;
                        }
+               }
+
+               L.DomUtil.addClass(icon, classToAdd);
 
-                       this._initInteraction();
-                       needOpacityUpdate = (this.options.opacity < 1);
+               if (options.keyboard) {
+                       icon.tabIndex = '0';
+               }
 
-                       L.DomUtil.addClass(this._icon, classToAdd);
+               this._icon = icon;
 
-                       if (options.riseOnHover) {
-                               L.DomEvent
-                                       .on(this._icon, 'mouseover', this._bringToFront, this)
-                                       .on(this._icon, 'mouseout', this._resetZIndex, this);
-                       }
+               this._initInteraction();
+
+               if (options.riseOnHover) {
+                       L.DomEvent
+                               .on(icon, 'mouseover', this._bringToFront, this)
+                               .on(icon, 'mouseout', this._resetZIndex, this);
                }
 
-               if (!this._shadow) {
-                       this._shadow = options.icon.createShadow();
+               var newShadow = options.icon.createShadow(this._shadow),
+                       addShadow = false;
 
-                       if (this._shadow) {
-                               L.DomUtil.addClass(this._shadow, classToAdd);
-                               needOpacityUpdate = (this.options.opacity < 1);
-                       }
+               if (newShadow !== this._shadow) {
+                       this._removeShadow();
+                       addShadow = true;
+               }
+
+               if (newShadow) {
+                       L.DomUtil.addClass(newShadow, classToAdd);
                }
+               this._shadow = newShadow;
 
-               if (needOpacityUpdate) {
+
+               if (options.opacity < 1) {
                        this._updateOpacity();
                }
 
+
                var panes = this._map._panes;
 
-               panes.markerPane.appendChild(this._icon);
+               if (addIcon) {
+                       panes.markerPane.appendChild(this._icon);
+               }
 
-               if (this._shadow) {
+               if (newShadow && addShadow) {
                        panes.shadowPane.appendChild(this._shadow);
                }
        },
 
        _removeIcon: function () {
-               var panes = this._map._panes;
-
                if (this.options.riseOnHover) {
                        L.DomEvent
                            .off(this._icon, 'mouseover', this._bringToFront)
                            .off(this._icon, 'mouseout', this._resetZIndex);
                }
 
-               panes.markerPane.removeChild(this._icon);
+               this._map._panes.markerPane.removeChild(this._icon);
+
+               this._icon = null;
+       },
 
+       _removeShadow: function () {
                if (this._shadow) {
-                       panes.shadowPane.removeChild(this._shadow);
+                       this._map._panes.shadowPane.removeChild(this._shadow);
                }
-
-               this._icon = this._shadow = null;
+               this._shadow = null;
        },
 
        _setPos: function (pos) {
@@ -3094,15 +3591,17 @@ L.Marker = L.Class.extend({
        },
 
        _initInteraction: function () {
-               if (!this.options.clickable) {
-                       return;
-               }
+
+               if (!this.options.clickable) { return; }
+
+               // TODO refactor into something shared with Map/Path/etc. to DRY it up
 
                var icon = this._icon,
-                   events = ['dblclick', 'mousedown', 'mouseover', 'mouseout'];
+                   events = ['dblclick', 'mousedown', 'mouseover', 'mouseout', 'contextmenu'];
 
                L.DomUtil.addClass(icon, 'leaflet-clickable');
                L.DomEvent.on(icon, 'click', this._onMouseClick, this);
+               L.DomEvent.on(icon, 'keypress', this._onKeyPress, this);
 
                for (var i = 0; i < events.length; i++) {
                        L.DomEvent.on(icon, events[i], this._fireMouseEvent, this);
@@ -3119,22 +3618,46 @@ L.Marker = L.Class.extend({
 
        _onMouseClick: function (e) {
                var wasDragged = this.dragging && this.dragging.moved();
+
                if (this.hasEventListeners(e.type) || wasDragged) {
                        L.DomEvent.stopPropagation(e);
                }
+
                if (wasDragged) { return; }
-               if (this._map.dragging && this._map.dragging.moved()) { return; }
+
+               if ((!this.dragging || !this.dragging._enabled) && this._map.dragging && this._map.dragging.moved()) { return; }
+
                this.fire(e.type, {
-                       originalEvent: e
+                       originalEvent: e,
+                       latlng: this._latlng
                });
        },
 
+       _onKeyPress: function (e) {
+               if (e.keyCode === 13) {
+                       this.fire('click', {
+                               originalEvent: e,
+                               latlng: this._latlng
+                       });
+               }
+       },
+
        _fireMouseEvent: function (e) {
+
                this.fire(e.type, {
-                       originalEvent: e
+                       originalEvent: e,
+                       latlng: this._latlng
                });
+
+               // TODO proper custom event propagation
+               // this line will always be called if marker is in a FeatureGroup
+               if (e.type === 'contextmenu' && this.hasEventListeners(e.type)) {
+                       L.DomEvent.preventDefault(e);
+               }
                if (e.type !== 'mousedown') {
                        L.DomEvent.stopPropagation(e);
+               } else {
+                       L.DomEvent.preventDefault(e);
                }
        },
 
@@ -3143,6 +3666,8 @@ L.Marker = L.Class.extend({
                if (this._map) {
                        this._updateOpacity();
                }
+               
+               return this;
        },
 
        _updateOpacity: function () {
@@ -3166,24 +3691,32 @@ L.marker = function (latlng, options) {
 };
 
 
+/*
+ * L.DivIcon is a lightweight HTML-based icon class (as opposed to the image-based L.Icon)
+ * to use with L.Marker.
+ */
+
 L.DivIcon = L.Icon.extend({
        options: {
-               iconSize: new L.Point(12, 12), // also can be set through CSS
+               iconSize: [12, 12], // also can be set through CSS
                /*
                iconAnchor: (Point)
                popupAnchor: (Point)
                html: (String)
                bgPos: (Point)
                */
-               className: 'leaflet-div-icon'
+               className: 'leaflet-div-icon',
+               html: false
        },
 
-       createIcon: function () {
-               var div = document.createElement('div'),
+       createIcon: function (oldIcon) {
+               var div = (oldIcon && oldIcon.tagName === 'DIV') ? oldIcon : document.createElement('div'),
                    options = this.options;
 
-               if (options.html) {
+               if (options.html !== false) {
                        div.innerHTML = options.html;
+               } else {
+                       div.innerHTML = '';
                }
 
                if (options.bgPos) {
@@ -3205,6 +3738,9 @@ L.divIcon = function (options) {
 };
 
 
+/*
+ * L.Popup is used for displaying popups on the map.
+ */
 
 L.Map.mergeOptions({
        closePopupOnClick: true
@@ -3219,15 +3755,19 @@ L.Popup = L.Class.extend({
                maxHeight: null,
                autoPan: true,
                closeButton: true,
-               offset: new L.Point(0, 6),
-               autoPanPadding: new L.Point(5, 5),
-               className: ''
+               offset: [0, 7],
+               autoPanPadding: [5, 5],
+               keepInView: false,
+               className: '',
+               zoomAnimation: true
        },
 
        initialize: function (options, source) {
                L.setOptions(this, options);
 
                this._source = source;
+               this._animated = L.Browser.any3d && this.options.zoomAnimation;
+               this._isOpen = false;
        },
 
        onAdd: function (map) {
@@ -3245,21 +3785,21 @@ L.Popup = L.Class.extend({
                }
                map._panes.popupPane.appendChild(this._container);
 
-               map.on('viewreset', this._updatePosition, this);
-
-               if (L.Browser.any3d) {
-                       map.on('zoomanim', this._zoomAnimation, this);
-               }
-
-               if (map.options.closePopupOnClick) {
-                       map.on('preclick', this._close, this);
-               }
+               map.on(this._getEvents(), this);
 
                this._update();
 
                if (animFade) {
                        L.DomUtil.setOpacity(this._container, 1);
                }
+
+               this.fire('open');
+
+               map.fire('popupopen', {popup: this});
+
+               if (this._source) {
+                       this._source.fire('popupopen', {popup: this});
+               }
        },
 
        addTo: function (map) {
@@ -3277,17 +3817,21 @@ L.Popup = L.Class.extend({
 
                L.Util.falseFn(this._container.offsetWidth); // force reflow
 
-               map.off({
-                       viewreset: this._updatePosition,
-                       preclick: this._close,
-                       zoomanim: this._zoomAnimation
-               }, this);
+               map.off(this._getEvents(), this);
 
                if (map.options.fadeAnimation) {
                        L.DomUtil.setOpacity(this._container, 0);
                }
 
                this._map = null;
+
+               this.fire('close');
+
+               map.fire('popupclose', {popup: this});
+
+               if (this._source) {
+                       this._source.fire('popupclose', {popup: this});
+               }
        },
 
        setLatLng: function (latlng) {
@@ -3302,21 +3846,34 @@ L.Popup = L.Class.extend({
                return this;
        },
 
-       _close: function () {
-               var map = this._map;
-
-               if (map) {
-                       map._popup = null;
+       _getEvents: function () {
+               var events = {
+                       viewreset: this._updatePosition
+               };
 
-                       map
-                           .removeLayer(this)
-                           .fire('popupclose', {popup: this});
+               if (this._animated) {
+                       events.zoomanim = this._zoomAnimation;
                }
+               if ('closeOnClick' in this.options ? this.options.closeOnClick : this._map.options.closePopupOnClick) {
+                       events.preclick = this._close;
+               }
+               if (this.options.keepInView) {
+                       events.moveend = this._adjustPan;
+               }
+
+               return events;
        },
 
-       _initLayout: function () {
+       _close: function () {
+               if (this._map) {
+                       this._map.closePopup(this);
+               }
+       },
+
+       _initLayout: function () {
                var prefix = 'leaflet-popup',
-                       containerClass = prefix + ' ' + this.options.className + ' leaflet-zoom-animated',
+                       containerClass = prefix + ' ' + this.options.className + ' leaflet-zoom-' +
+                               (this._animated ? 'animated' : 'hide'),
                        container = this._container = L.DomUtil.create('div', containerClass),
                        closeButton;
 
@@ -3325,6 +3882,7 @@ L.Popup = L.Class.extend({
                                L.DomUtil.create('a', prefix + '-close-button', container);
                        closeButton.href = '#close';
                        closeButton.innerHTML = '&#215;';
+                       L.DomEvent.disableClickPropagation(closeButton);
 
                        L.DomEvent.on(closeButton, 'click', this._onCloseButtonClick, this);
                }
@@ -3335,7 +3893,8 @@ L.Popup = L.Class.extend({
 
                this._contentNode = L.DomUtil.create('div', prefix + '-content', wrapper);
                L.DomEvent.on(this._contentNode, 'mousewheel', L.DomEvent.stopPropagation);
-
+               L.DomEvent.on(this._contentNode, 'MozMousePixelScroll', L.DomEvent.stopPropagation);
+               L.DomEvent.on(wrapper, 'contextmenu', L.DomEvent.stopPropagation);
                this._tipContainer = L.DomUtil.create('div', prefix + '-tip-container', container);
                this._tip = L.DomUtil.create('div', prefix + '-tip', this._tipContainer);
        },
@@ -3402,17 +3961,17 @@ L.Popup = L.Class.extend({
                if (!this._map) { return; }
 
                var pos = this._map.latLngToLayerPoint(this._latlng),
-                   is3d = L.Browser.any3d,
-                   offset = this.options.offset;
+                   animated = this._animated,
+                   offset = L.point(this.options.offset);
 
-               if (is3d) {
+               if (animated) {
                        L.DomUtil.setPosition(this._container, pos);
                }
 
-               this._containerBottom = -offset.y - (is3d ? 0 : pos.y);
-               this._containerLeft = -Math.round(this._containerWidth / 2) + offset.x + (is3d ? 0 : pos.x);
+               this._containerBottom = -offset.y - (animated ? 0 : pos.y);
+               this._containerLeft = -Math.round(this._containerWidth / 2) + offset.x + (animated ? 0 : pos.x);
 
-               //Bottom position the popup in case the height of the popup changes (images loading etc)
+               // bottom position the popup in case the height of the popup changes (images loading etc)
                this._container.style.bottom = this._containerBottom + 'px';
                this._container.style.left = this._containerLeft + 'px';
        },
@@ -3432,31 +3991,33 @@ L.Popup = L.Class.extend({
 
                    layerPos = new L.Point(this._containerLeft, -containerHeight - this._containerBottom);
 
-               if (L.Browser.any3d) {
+               if (this._animated) {
                        layerPos._add(L.DomUtil.getPosition(this._container));
                }
 
                var containerPos = map.layerPointToContainerPoint(layerPos),
-                   padding = this.options.autoPanPadding,
+                   padding = L.point(this.options.autoPanPadding),
                    size = map.getSize(),
                    dx = 0,
                    dy = 0;
 
-               if (containerPos.x < 0) {
-                       dx = containerPos.x - padding.x;
-               }
-               if (containerPos.x + containerWidth > size.x) {
+               if (containerPos.x + containerWidth > size.x) { // right
                        dx = containerPos.x + containerWidth - size.x + padding.x;
                }
-               if (containerPos.y < 0) {
-                       dy = containerPos.y - padding.y;
+               if (containerPos.x - dx < 0) { // left
+                       dx = containerPos.x - padding.x;
                }
-               if (containerPos.y + containerHeight > size.y) {
+               if (containerPos.y + containerHeight > size.y) { // bottom
                        dy = containerPos.y + containerHeight - size.y + padding.y;
                }
+               if (containerPos.y - dy < 0) { // top
+                       dy = containerPos.y - padding.y;
+               }
 
                if (dx || dy) {
-                       map.panBy(new L.Point(dx, dy));
+                       map
+                           .fire('autopanstart')
+                           .panBy([dx, dy]);
                }
        },
 
@@ -3471,13 +4032,44 @@ L.popup = function (options, source) {
 };
 
 
+L.Map.include({
+       openPopup: function (popup, latlng, options) { // (Popup) or (String || HTMLElement, LatLng[, Object])
+               this.closePopup();
+
+               if (!(popup instanceof L.Popup)) {
+                       var content = popup;
+
+                       popup = new L.Popup(options)
+                           .setLatLng(latlng)
+                           .setContent(content);
+               }
+               popup._isOpen = true;
+
+               this._popup = popup;
+               return this.addLayer(popup);
+       },
+
+       closePopup: function (popup) {
+               if (!popup || popup === this._popup) {
+                       popup = this._popup;
+                       this._popup = null;
+               }
+               if (popup) {
+                       this.removeLayer(popup);
+                       popup._isOpen = false;
+               }
+               return this;
+       }
+});
+
+
 /*
- * Popup extension to L.Marker, adding openPopup & bindPopup methods.
+ * Popup extension to L.Marker, adding popup-related methods.
  */
 
 L.Marker.include({
        openPopup: function () {
-               if (this._popup && this._map) {
+               if (this._popup && this._map && !this._map.hasLayer(this._popup)) {
                        this._popup.setLatLng(this._latlng);
                        this._map.openPopup(this._popup);
                }
@@ -3492,8 +4084,19 @@ L.Marker.include({
                return this;
        },
 
+       togglePopup: function () {
+               if (this._popup) {
+                       if (this._popup._isOpen) {
+                               this.closePopup();
+                       } else {
+                               this.openPopup();
+                       }
+               }
+               return this;
+       },
+
        bindPopup: function (content, options) {
-               var anchor = L.point(this.options.icon.options.popupAnchor) || new L.Point(0, 0);
+               var anchor = L.point(this.options.icon.options.popupAnchor || [0, 0]);
 
                anchor = anchor.add(L.Popup.prototype.options.offset);
 
@@ -3505,14 +4108,26 @@ L.Marker.include({
 
                if (!this._popup) {
                        this
-                           .on('click', this.openPopup, this)
+                           .on('click', this.togglePopup, this)
                            .on('remove', this.closePopup, this)
                            .on('move', this._movePopup, this);
                }
 
-               this._popup = new L.Popup(options, this)
-                       .setContent(content);
+               if (content instanceof L.Popup) {
+                       L.setOptions(content, options);
+                       this._popup = content;
+               } else {
+                       this._popup = new L.Popup(options, this)
+                               .setContent(content);
+               }
+
+               return this;
+       },
 
+       setPopupContent: function (content) {
+               if (this._popup) {
+                       this._popup.setContent(content);
+               }
                return this;
        },
 
@@ -3520,7 +4135,7 @@ L.Marker.include({
                if (this._popup) {
                        this._popup = null;
                        this
-                           .off('click', this.openPopup)
+                           .off('click', this.togglePopup)
                            .off('remove', this.closePopup)
                            .off('move', this._movePopup);
                }
@@ -3533,29 +4148,9 @@ L.Marker.include({
 });
 
 
-
-L.Map.include({
-       openPopup: function (popup) {
-               this.closePopup();
-
-               this._popup = popup;
-
-               return this
-                   .addLayer(popup)
-                   .fire('popupopen', {popup: this._popup});
-       },
-
-       closePopup: function () {
-               if (this._popup) {
-                       this._popup._close();
-               }
-               return this;
-       }
-});
-
-
 /*
- * L.LayerGroup is a class to combine several layers so you can manipulate the group (e.g. add/remove it) as one layer.
+ * L.LayerGroup is a class to combine several layers into one so that
+ * you can manipulate the group (e.g. add/remove it) as one layer.
  */
 
 L.LayerGroup = L.Class.extend({
@@ -3572,7 +4167,7 @@ L.LayerGroup = L.Class.extend({
        },
 
        addLayer: function (layer) {
-               var id = L.stamp(layer);
+               var id = this.getLayerId(layer);
 
                this._layers[id] = layer;
 
@@ -3584,17 +4179,23 @@ L.LayerGroup = L.Class.extend({
        },
 
        removeLayer: function (layer) {
-               var id = L.stamp(layer);
-
-               delete this._layers[id];
+               var id = layer in this._layers ? layer : this.getLayerId(layer);
 
-               if (this._map) {
-                       this._map.removeLayer(layer);
+               if (this._map && this._layers[id]) {
+                       this._map.removeLayer(this._layers[id]);
                }
 
+               delete this._layers[id];
+
                return this;
        },
 
+       hasLayer: function (layer) {
+               if (!layer) { return false; }
+
+               return (layer in this._layers || this.getLayerId(layer) in this._layers);
+       },
+
        clearLayers: function () {
                this.eachLayer(this.removeLayer, this);
                return this;
@@ -3605,12 +4206,10 @@ L.LayerGroup = L.Class.extend({
                    i, layer;
 
                for (i in this._layers) {
-                       if (this._layers.hasOwnProperty(i)) {
-                               layer = this._layers[i];
+                       layer = this._layers[i];
 
-                               if (layer[methodName]) {
-                                       layer[methodName].apply(layer, args);
-                               }
+                       if (layer[methodName]) {
+                               layer[methodName].apply(layer, args);
                        }
                }
 
@@ -3634,10 +4233,30 @@ L.LayerGroup = L.Class.extend({
 
        eachLayer: function (method, context) {
                for (var i in this._layers) {
-                       if (this._layers.hasOwnProperty(i)) {
-                               method.call(context, this._layers[i]);
-                       }
+                       method.call(context, this._layers[i]);
+               }
+               return this;
+       },
+
+       getLayer: function (id) {
+               return this._layers[id];
+       },
+
+       getLayers: function () {
+               var layers = [];
+
+               for (var i in this._layers) {
+                       layers.push(this._layers[i]);
                }
+               return layers;
+       },
+
+       setZIndex: function (zIndex) {
+               return this.invoke('setZIndex', zIndex);
+       },
+
+       getLayerId: function (layer) {
+               return L.stamp(layer);
        }
 });
 
@@ -3647,18 +4266,19 @@ L.layerGroup = function (layers) {
 
 
 /*
- * L.FeatureGroup extends L.LayerGroup by introducing mouse events and bindPopup method shared between a group of layers.
+ * L.FeatureGroup extends L.LayerGroup by introducing mouse events and additional methods
+ * shared between a group of interactive layers (like vectors or markers).
  */
 
 L.FeatureGroup = L.LayerGroup.extend({
        includes: L.Mixin.Events,
 
        statics: {
-               EVENTS: 'click dblclick mouseover mouseout mousemove contextmenu'
+               EVENTS: 'click dblclick mouseover mouseout mousemove contextmenu popupopen popupclose'
        },
 
        addLayer: function (layer) {
-               if (this._layers[L.stamp(layer)]) {
+               if (this.hasLayer(layer)) {
                        return this;
                }
 
@@ -3667,18 +4287,24 @@ L.FeatureGroup = L.LayerGroup.extend({
                L.LayerGroup.prototype.addLayer.call(this, layer);
 
                if (this._popupContent && layer.bindPopup) {
-                       layer.bindPopup(this._popupContent);
+                       layer.bindPopup(this._popupContent, this._popupOptions);
                }
 
                return this.fire('layeradd', {layer: layer});
        },
 
        removeLayer: function (layer) {
+               if (!this.hasLayer(layer)) {
+                       return this;
+               }
+               if (layer in this._layers) {
+                       layer = this._layers[layer];
+               }
+
                layer.off(L.FeatureGroup.EVENTS, this._propagateEvent, this);
 
                L.LayerGroup.prototype.removeLayer.call(this, layer);
 
-
                if (this._popupContent) {
                        this.invoke('unbindPopup');
                }
@@ -3686,9 +4312,10 @@ L.FeatureGroup = L.LayerGroup.extend({
                return this.fire('layerremove', {layer: layer});
        },
 
-       bindPopup: function (content) {
+       bindPopup: function (content, options) {
                this._popupContent = content;
-               return this.invoke('bindPopup', content);
+               this._popupOptions = options;
+               return this.invoke('bindPopup', content, options);
        },
 
        setStyle: function (style) {
@@ -3714,7 +4341,9 @@ L.FeatureGroup = L.LayerGroup.extend({
        },
 
        _propagateEvent: function (e) {
-               e.layer  = e.target;
+               if (!e.layer) {
+                       e.layer = e.target;
+               }
                e.target = this;
 
                this.fire(e.type, e);
@@ -3737,9 +4366,11 @@ L.Path = L.Class.extend({
                // how much to extend the clip area around the map view
                // (relative to its size, e.g. 0.5 is half the screen in each direction)
                // set it so that SVG element doesn't exceed 1280px (vectors flicker on dragend if it is)
-               CLIP_PADDING: L.Browser.mobile ?
-                       Math.max(0, Math.min(0.5,
-                               (1280 / Math.max(window.innerWidth, window.innerHeight) - 1) / 2)) : 0.5
+               CLIP_PADDING: (function () {
+                       var max = L.Browser.mobile ? 1280 : 2000,
+                           target = (max / Math.max(window.outerWidth, window.outerHeight) - 1) / 2;
+                       return Math.max(0, Math.min(0.5, target));
+               })()
        },
 
        options: {
@@ -3775,6 +4406,8 @@ L.Path = L.Class.extend({
                        this._map._pathRoot.appendChild(this._container);
                }
 
+               this.fire('add');
+
                map.on({
                        'viewreset': this.projectLatlngs,
                        'moveend': this._updatePath
@@ -3789,6 +4422,8 @@ L.Path = L.Class.extend({
        onRemove: function (map) {
                map._pathRoot.removeChild(this._container);
 
+               // Need to fire remove event before we set _map to null as the event hooks might need the object
+               this.fire('remove');
                this._map = null;
 
                if (L.Browser.vml) {
@@ -3797,8 +4432,6 @@ L.Path = L.Class.extend({
                        this._fill = null;
                }
 
-               this.fire('remove');
-
                map.off({
                        'viewreset': this.projectLatlngs,
                        'moveend': this._updatePath
@@ -3841,6 +4474,10 @@ L.Map.include({
 });
 
 
+/*
+ * Extends L.Path with SVG-specific rendering code.
+ */
+
 L.Path.SVG_NS = 'http://www.w3.org/2000/svg';
 
 L.Browser.svg = !!(document.createElementNS && document.createElementNS(L.Path.SVG_NS, 'svg').createSVGRect);
@@ -3900,6 +4537,12 @@ L.Path = L.Path.extend({
                if (this.options.fill) {
                        this._path.setAttribute('fill-rule', 'evenodd');
                }
+               if (this.options.pointerEvents) {
+                       this._path.setAttribute('pointer-events', this.options.pointerEvents);
+               }
+               if (!this.options.clickable && !this.options.pointerEvents) {
+                       this._path.setAttribute('pointer-events', 'none');
+               }
                this._updateStyle();
        },
 
@@ -4002,13 +4645,12 @@ L.Map.include({
                }
        },
 
-       _animatePathZoom: function (opt) {
-               var scale = this.getZoomScale(opt.zoom),
-                   offset = this._getCenterOffset(opt.center),
-                   translate = offset.multiplyBy(-scale)._add(this._pathViewport.min);
+       _animatePathZoom: function (e) {
+               var scale = this.getZoomScale(e.zoom),
+                   offset = this._getCenterOffset(e.center)._multiplyBy(-scale)._add(this._pathViewport.min);
 
                this._pathRoot.style[L.DomUtil.TRANSFORM] =
-                       L.DomUtil.getTranslateString(translate) + ' scale(' + scale + ') ';
+                       L.DomUtil.getTranslateString(offset) + ' scale(' + scale + ') ';
 
                this._pathZooming = true;
        },
@@ -4054,19 +4696,22 @@ L.Map.include({
 
 
 /*
- * Popup extension to L.Path (polylines, polygons, circles), adding bindPopup method.
+ * Popup extension to L.Path (polylines, polygons, circles), adding popup-related methods.
  */
 
 L.Path.include({
 
        bindPopup: function (content, options) {
 
-               if (!this._popup || options) {
-                       this._popup = new L.Popup(options, this);
+               if (content instanceof L.Popup) {
+                       this._popup = content;
+               } else {
+                       if (!this._popup || options) {
+                               this._popup = new L.Popup(options, this);
+                       }
+                       this._popup.setContent(content);
                }
 
-               this._popup.setContent(content);
-
                if (!this._popupHandlersAdded) {
                        this
                            .on('click', this._openPopup, this)
@@ -4082,7 +4727,7 @@ L.Path.include({
                if (this._popup) {
                        this._popup = null;
                        this
-                           .off('click', this.openPopup)
+                           .off('click', this._openPopup)
                            .off('remove', this.closePopup);
 
                        this._popupHandlersAdded = false;
@@ -4193,11 +4838,15 @@ L.Path = L.Browser.svg || !L.Browser.vml ? L.Path : L.Path.extend({
                        stroke.weight = options.weight + 'px';
                        stroke.color = options.color;
                        stroke.opacity = options.opacity;
+
                        if (options.dashArray) {
-                               stroke.dashStyle = options.dashArray.replace(/ *, */g, ' ');
+                               stroke.dashStyle = options.dashArray instanceof Array ?
+                                   options.dashArray.join(' ') :
+                                   options.dashArray.replace(/( *, *)/g, ' ');
                        } else {
                                stroke.dashStyle = '';
                        }
+
                } else if (stroke) {
                        container.removeChild(stroke);
                        this._stroke = null;
@@ -4210,6 +4859,7 @@ L.Path = L.Browser.svg || !L.Browser.vml ? L.Path : L.Path.extend({
                        }
                        fill.color = options.fillColor || options.color;
                        fill.opacity = options.fillOpacity;
+
                } else if (fill) {
                        container.removeChild(fill);
                        this._fill = null;
@@ -4277,6 +4927,11 @@ L.Path = (L.Path.SVG && !window.L_PREFER_CANVAS) || !L.Browser.canvas ? L.Path :
                    .off('viewreset', this.projectLatlngs, this)
                    .off('moveend', this._updatePath, this);
 
+               if (this.options.clickable) {
+                       this._map.off('click', this._onClick, this);
+                       this._map.off('mousemove', this._onMouseMove, this);
+               }
+
                this._requestUpdate();
 
                this._map = null;
@@ -4344,16 +4999,12 @@ L.Path = (L.Path.SVG && !window.L_PREFER_CANVAS) || !L.Browser.canvas ? L.Path :
                this._updateStyle();
 
                if (options.fill) {
-                       if (options.fillOpacity < 1) {
-                               ctx.globalAlpha = options.fillOpacity;
-                       }
+                       ctx.globalAlpha = options.fillOpacity;
                        ctx.fill();
                }
 
                if (options.stroke) {
-                       if (options.opacity < 1) {
-                               ctx.globalAlpha = options.opacity;
-                       }
+                       ctx.globalAlpha = options.opacity;
                        ctx.stroke();
                }
 
@@ -4364,8 +5015,8 @@ L.Path = (L.Path.SVG && !window.L_PREFER_CANVAS) || !L.Browser.canvas ? L.Path :
 
        _initEvents: function () {
                if (this.options.clickable) {
-                       // TODO hand cursor
-                       // TODO mouseover, mouseout, dblclick
+                       // TODO dblclick
+                       this._map.on('mousemove', this._onMouseMove, this);
                        this._map.on('click', this._onClick, this);
                }
        },
@@ -4374,6 +5025,22 @@ L.Path = (L.Path.SVG && !window.L_PREFER_CANVAS) || !L.Browser.canvas ? L.Path :
                if (this._containsPoint(e.layerPoint)) {
                        this.fire('click', e);
                }
+       },
+
+       _onMouseMove: function (e) {
+               if (!this._map || this._map._animatingZoom) { return; }
+
+               // TODO don't do on each move
+               if (this._containsPoint(e.layerPoint)) {
+                       this._ctx.canvas.style.cursor = 'pointer';
+                       this._mouseInside = true;
+                       this.fire('mouseover', e);
+
+               } else if (this._mouseInside) {
+                       this._ctx.canvas.style.cursor = '';
+                       this._mouseInside = false;
+                       this.fire('mouseout', e);
+               }
        }
 });
 
@@ -4383,12 +5050,12 @@ L.Map.include((L.Path.SVG && !window.L_PREFER_CANVAS) || !L.Browser.canvas ? {}
                    ctx;
 
                if (!root) {
-                       root = this._pathRoot = document.createElement("canvas");
+                       root = this._pathRoot = document.createElement('canvas');
                        root.style.position = 'absolute';
                        ctx = this._canvasCtx = root.getContext('2d');
 
-                       ctx.lineCap = "round";
-                       ctx.lineJoin = "round";
+                       ctx.lineCap = 'round';
+                       ctx.lineJoin = 'round';
 
                        this._panes.overlayPane.appendChild(root);
 
@@ -4426,6 +5093,8 @@ L.Map.include((L.Path.SVG && !window.L_PREFER_CANVAS) || !L.Browser.canvas ? {}
  * and polylines (clipping, simplification, distances, etc.)
  */
 
+/*jshint bitwise:false */ // allow bitwise oprations for this file
+
 L.LineUtil = {
 
        // Simplify polyline with vertex reduction and Douglas-Peucker simplification.
@@ -4517,16 +5186,11 @@ L.LineUtil = {
                return reducedPoints;
        },
 
-       /*jshint bitwise:false */ // temporarily allow bitwise oprations
-
        // Cohen-Sutherland line clipping algorithm.
        // Used to avoid rendering parts of a polyline that are not currently visible.
 
        clipSegment: function (a, b, bounds, useLastCode) {
-               var min = bounds.min,
-                   max = bounds.max,
-
-                   codeA = useLastCode ? this._lastCode : this._getBitCode(a, bounds),
+               var codeA = useLastCode ? this._lastCode : this._getBitCode(a, bounds),
                    codeB = this._getBitCode(b, bounds),
 
                    codeOut, p, newCode;
@@ -4543,8 +5207,8 @@ L.LineUtil = {
                                return false;
                        // other cases
                        } else {
-                               codeOut = codeA || codeB,
-                               p = this._getEdgeIntersection(a, b, codeOut, bounds),
+                               codeOut = codeA || codeB;
+                               p = this._getEdgeIntersection(a, b, codeOut, bounds);
                                newCode = this._getBitCode(p, bounds);
 
                                if (codeOut === codeA) {
@@ -4592,8 +5256,6 @@ L.LineUtil = {
                return code;
        },
 
-       /*jshint bitwise:true */
-
        // square distance (to avoid unnecessary Math.sqrt calls)
        _sqDist: function (p1, p2) {
                var dx = p2.x - p1.x,
@@ -4630,20 +5292,15 @@ L.LineUtil = {
 };
 
 
+/*
+ * L.Polyline is used to display polylines on a map.
+ */
+
 L.Polyline = L.Path.extend({
        initialize: function (latlngs, options) {
                L.Path.prototype.initialize.call(this, options);
 
                this._latlngs = this._convertLatLngs(latlngs);
-
-               // TODO refactor: move to Polyline.Edit.js
-               if (L.Handler.PolyEdit) {
-                       this.editing = new L.Handler.PolyEdit(this);
-
-                       if (this.options.editable) {
-                               this.editing.enable();
-                       }
-               }
        },
 
        options: {
@@ -4682,9 +5339,9 @@ L.Polyline = L.Path.extend({
                return this.redraw();
        },
 
-       spliceLatLngs: function (index, howMany) {
+       spliceLatLngs: function () { // (Number index, Number howMany)
                var removed = [].splice.apply(this._latlngs, arguments);
-               this._convertLatLngs(this._latlngs);
+               this._convertLatLngs(this._latlngs, true);
                this.redraw();
                return removed;
        },
@@ -4711,43 +5368,19 @@ L.Polyline = L.Path.extend({
        },
 
        getBounds: function () {
-               var bounds = new L.LatLngBounds(),
-                   latLngs = this.getLatLngs(),
-                   i, len;
-
-               for (i = 0, len = latLngs.length; i < len; i++) {
-                       bounds.extend(latLngs[i]);
-               }
-
-               return bounds;
-       },
-
-       // TODO refactor: move to Polyline.Edit.js
-       onAdd: function (map) {
-               L.Path.prototype.onAdd.call(this, map);
-
-               if (this.editing && this.editing.enabled()) {
-                       this.editing.addHooks();
-               }
+               return new L.LatLngBounds(this.getLatLngs());
        },
 
-       onRemove: function (map) {
-               if (this.editing && this.editing.enabled()) {
-                       this.editing.removeHooks();
-               }
-
-               L.Path.prototype.onRemove.call(this, map);
-       },
+       _convertLatLngs: function (latlngs, overwrite) {
+               var i, len, target = overwrite ? latlngs : [];
 
-       _convertLatLngs: function (latlngs) {
-               var i, len;
                for (i = 0, len = latlngs.length; i < len; i++) {
-                       if (latlngs[i] instanceof Array && typeof latlngs[i][0] !== 'number') {
+                       if (L.Util.isArray(latlngs[i]) && typeof latlngs[i][0] !== 'number') {
                                return;
                        }
-                       latlngs[i] = L.latLng(latlngs[i]);
+                       target[i] = L.latLng(latlngs[i]);
                }
-               return latlngs;
+               return target;
        },
 
        _initEvents: function () {
@@ -4826,10 +5459,10 @@ L.polyline = function (latlngs, options) {
 
 
 /*
- * L.PolyUtil contains utilify functions for polygons (clipping, etc.).
+ * L.PolyUtil contains utility functions for polygons (clipping, etc.).
  */
 
-/*jshint bitwise:false */ // allow bitwise oprations here
+/*jshint bitwise:false */ // allow bitwise operations here
 
 L.PolyUtil = {};
 
@@ -4838,9 +5471,7 @@ L.PolyUtil = {};
  * Used to avoid rendering parts of a polygon that are not currently visible.
  */
 L.PolyUtil.clipPolygon = function (points, bounds) {
-       var min = bounds.min,
-           max = bounds.max,
-           clippedPoints,
+       var clippedPoints,
            edges = [1, 4, 2, 8],
            i, j, k,
            a, b,
@@ -4883,8 +5514,6 @@ L.PolyUtil.clipPolygon = function (points, bounds) {
        return points;
 };
 
-/*jshint bitwise:true */
-
 
 /*
  * L.Polygon is used to display polygons on a map.
@@ -4896,11 +5525,27 @@ L.Polygon = L.Polyline.extend({
        },
 
        initialize: function (latlngs, options) {
+               var i, len, hole;
+
                L.Polyline.prototype.initialize.call(this, latlngs, options);
 
-               if (latlngs && (latlngs[0] instanceof Array) && (typeof latlngs[0][0] !== 'number')) {
+               if (latlngs && L.Util.isArray(latlngs[0]) && (typeof latlngs[0][0] !== 'number')) {
                        this._latlngs = this._convertLatLngs(latlngs[0]);
                        this._holes = latlngs.slice(1);
+
+                       for (i = 0, len = this._holes.length; i < len; i++) {
+                               hole = this._holes[i] = this._convertLatLngs(this._holes[i]);
+                               if (hole[0].equals(hole[hole.length - 1])) {
+                                       hole.pop();
+                               }
+                       }
+               }
+
+               // filter out last point if its equal to the first one
+               latlngs = this._latlngs;
+
+               if (latlngs.length >= 2 && latlngs[0].equals(latlngs[latlngs.length - 1])) {
+                       latlngs.pop();
                }
        },
 
@@ -4913,7 +5558,7 @@ L.Polygon = L.Polyline.extend({
 
                if (!this._holes) { return; }
 
-               var i, j, len, len2, hole;
+               var i, j, len, len2;
 
                for (i = 0, len = this._holes.length; i < len; i++) {
                        this._holePoints[i] = [];
@@ -4985,6 +5630,16 @@ L.polygon = function (latlngs, options) {
                                }
 
                                return this;
+                       },
+
+                       getLatLngs: function () {
+                               var latlngs = [];
+
+                               this.eachLayer(function (layer) {
+                                       latlngs.push(layer.getLatLngs());
+                               });
+
+                               return latlngs;
                        }
                });
        }
@@ -5003,7 +5658,7 @@ L.polygon = function (latlngs, options) {
 
 
 /*
- * L.Rectangle extends Polygon and creates a rectangle when passed a LatLngBounds
+ * L.Rectangle extends Polygon and creates a rectangle when passed a LatLngBounds object.
  */
 
 L.Rectangle = L.Polygon.extend({
@@ -5021,8 +5676,7 @@ L.Rectangle = L.Polygon.extend({
                        latLngBounds.getSouthWest(),
                        latLngBounds.getNorthWest(),
                        latLngBounds.getNorthEast(),
-                       latLngBounds.getSouthEast(),
-                       latLngBounds.getSouthWest()
+                       latLngBounds.getSouthEast()
                ];
        }
 });
@@ -5060,21 +5714,21 @@ L.Circle = L.Path.extend({
 
        projectLatlngs: function () {
                var lngRadius = this._getLngRadius(),
-                   latlng2 = new L.LatLng(this._latlng.lat, this._latlng.lng - lngRadius, true),
-                   point2 = this._map.latLngToLayerPoint(latlng2);
+                   latlng = this._latlng,
+                   pointLeft = this._map.latLngToLayerPoint([latlng.lat, latlng.lng - lngRadius]);
 
-               this._point = this._map.latLngToLayerPoint(this._latlng);
-               this._radius = Math.max(Math.round(this._point.x - point2.x), 1);
+               this._point = this._map.latLngToLayerPoint(latlng);
+               this._radius = Math.max(this._point.x - pointLeft.x, 1);
        },
 
        getBounds: function () {
                var lngRadius = this._getLngRadius(),
                    latRadius = (this._mRadius / 40075017) * 360,
-                   latlng = this._latlng,
-                   sw = new L.LatLng(latlng.lat - latRadius, latlng.lng - lngRadius),
-                   ne = new L.LatLng(latlng.lat + latRadius, latlng.lng + lngRadius);
+                   latlng = this._latlng;
 
-               return new L.LatLngBounds(sw, ne);
+               return new L.LatLngBounds(
+                       [latlng.lat - latRadius, latlng.lng - lngRadius],
+                       [latlng.lat + latRadius, latlng.lng + lngRadius]);
        },
 
        getLatLng: function () {
@@ -5090,13 +5744,13 @@ L.Circle = L.Path.extend({
                }
 
                if (L.Browser.svg) {
-                       return "M" + p.x + "," + (p.y - r) +
-                              "A" + r + "," + r + ",0,1,1," +
-                              (p.x - 0.1) + "," + (p.y - r) + " z";
+                       return 'M' + p.x + ',' + (p.y - r) +
+                              'A' + r + ',' + r + ',0,1,1,' +
+                              (p.x - 0.1) + ',' + (p.y - r) + ' z';
                } else {
                        p._round();
                        r = Math.round(r);
-                       return "AL " + p.x + "," + p.y + " " + r + "," + r + " 0," + (65535 * 360);
+                       return 'AL ' + p.x + ',' + p.y + ' ' + r + ',' + r + ' 0,' + (65535 * 360);
                }
        },
 
@@ -5151,8 +5805,13 @@ L.CircleMarker = L.Circle.extend({
                this._point = this._map.latLngToLayerPoint(this._latlng);
        },
 
+       _updateStyle : function () {
+               L.Circle.prototype._updateStyle.call(this);
+               this.setRadius(this.options.radius);
+       },
+
        setRadius: function (radius) {
-               this._radius = radius;
+               this.options.radius = this._radius = radius;
                return this.redraw();
        }
 });
@@ -5162,6 +5821,9 @@ L.circleMarker = function (latlng, options) {
 };
 
 
+/*
+ * Extends L.Polyline to be able to manually detect clicks on Canvas-rendered polylines.
+ */
 
 L.Polyline.include(!L.Path.CANVAS ? {} : {
        _containsPoint: function (p, closed) {
@@ -5191,6 +5853,9 @@ L.Polyline.include(!L.Path.CANVAS ? {} : {
 });
 
 
+/*
+ * Extends L.Polygon to be able to manually detect clicks on Canvas-rendered polygons.
+ */
 
 L.Polygon.include(!L.Path.CANVAS ? {} : {
        _containsPoint: function (p) {
@@ -5228,7 +5893,7 @@ L.Polygon.include(!L.Path.CANVAS ? {} : {
 
 
 /*
- * Circle canvas specific drawing parts.
+ * Extends L.Circle with Canvas-specific code.
  */
 
 L.Circle.include(!L.Path.CANVAS ? {} : {
@@ -5247,7 +5912,23 @@ L.Circle.include(!L.Path.CANVAS ? {} : {
 });
 
 
+/*
+ * CircleMarker canvas specific drawing parts.
+ */
+
+L.CircleMarker.include(!L.Path.CANVAS ? {} : {
+       _updateStyle: function () {
+               L.Path.prototype._updateStyle.call(this);
+       }
+});
+
+
+/*
+ * L.GeoJSON turns any GeoJSON data into a Leaflet layer.
+ */
+
 L.GeoJSON = L.FeatureGroup.extend({
+
        initialize: function (geojson, options) {
                L.setOptions(this, options);
 
@@ -5259,12 +5940,16 @@ L.GeoJSON = L.FeatureGroup.extend({
        },
 
        addData: function (geojson) {
-               var features = geojson instanceof Array ? geojson : geojson.features,
-                   i, len;
+               var features = L.Util.isArray(geojson) ? geojson : geojson.features,
+                   i, len, feature;
 
                if (features) {
                        for (i = 0, len = features.length; i < len; i++) {
-                               this.addData(features[i]);
+                               // Only add this if geometry or geometries are set and not null
+                               feature = features[i];
+                               if (feature.geometries || feature.geometry || feature.features || feature.coordinates) {
+                                       this.addData(features[i]);
+                               }
                        }
                        return this;
                }
@@ -5273,9 +5958,10 @@ L.GeoJSON = L.FeatureGroup.extend({
 
                if (options.filter && !options.filter(geojson)) { return; }
 
-               var layer = L.GeoJSON.geometryToLayer(geojson, options.pointToLayer);
-               layer.feature = geojson;
+               var layer = L.GeoJSON.geometryToLayer(geojson, options.pointToLayer, options.coordsToLatLng);
+               layer.feature = L.GeoJSON.asFeature(geojson);
 
+               layer.defaultOptions = layer.options;
                this.resetStyle(layer);
 
                if (options.onEachFeature) {
@@ -5288,6 +5974,9 @@ L.GeoJSON = L.FeatureGroup.extend({
        resetStyle: function (layer) {
                var style = this.options.style;
                if (style) {
+                       // reset any custom styles
+                       L.Util.extend(layer.options, layer.defaultOptions);
+
                        this._setLayerStyle(layer, style);
                }
        },
@@ -5309,44 +5998,52 @@ L.GeoJSON = L.FeatureGroup.extend({
 });
 
 L.extend(L.GeoJSON, {
-       geometryToLayer: function (geojson, pointToLayer) {
+       geometryToLayer: function (geojson, pointToLayer, coordsToLatLng) {
                var geometry = geojson.type === 'Feature' ? geojson.geometry : geojson,
                    coords = geometry.coordinates,
                    layers = [],
                    latlng, latlngs, i, len, layer;
 
+               coordsToLatLng = coordsToLatLng || this.coordsToLatLng;
+
                switch (geometry.type) {
                case 'Point':
-                       latlng = this.coordsToLatLng(coords);
+                       latlng = coordsToLatLng(coords);
                        return pointToLayer ? pointToLayer(geojson, latlng) : new L.Marker(latlng);
 
                case 'MultiPoint':
                        for (i = 0, len = coords.length; i < len; i++) {
-                               latlng = this.coordsToLatLng(coords[i]);
+                               latlng = coordsToLatLng(coords[i]);
                                layer = pointToLayer ? pointToLayer(geojson, latlng) : new L.Marker(latlng);
                                layers.push(layer);
                        }
                        return new L.FeatureGroup(layers);
 
                case 'LineString':
-                       latlngs = this.coordsToLatLngs(coords);
+                       latlngs = this.coordsToLatLngs(coords, 0, coordsToLatLng);
                        return new L.Polyline(latlngs);
 
                case 'Polygon':
-                       latlngs = this.coordsToLatLngs(coords, 1);
+                       latlngs = this.coordsToLatLngs(coords, 1, coordsToLatLng);
                        return new L.Polygon(latlngs);
 
                case 'MultiLineString':
-                       latlngs = this.coordsToLatLngs(coords, 1);
+                       latlngs = this.coordsToLatLngs(coords, 1, coordsToLatLng);
                        return new L.MultiPolyline(latlngs);
 
-               case "MultiPolygon":
-                       latlngs = this.coordsToLatLngs(coords, 2);
+               case 'MultiPolygon':
+                       latlngs = this.coordsToLatLngs(coords, 2, coordsToLatLng);
                        return new L.MultiPolygon(latlngs);
 
-               case "GeometryCollection":
+               case 'GeometryCollection':
                        for (i = 0, len = geometry.geometries.length; i < len; i++) {
-                               layer = this.geometryToLayer(geometry.geometries[i], pointToLayer);
+
+                               layer = this.geometryToLayer({
+                                       geometry: geometry.geometries[i],
+                                       type: 'Feature',
+                                       properties: geojson.properties
+                               }, pointToLayer, coordsToLatLng);
+
                                layers.push(layer);
                        }
                        return new L.FeatureGroup(layers);
@@ -5356,27 +6053,136 @@ L.extend(L.GeoJSON, {
                }
        },
 
-       coordsToLatLng: function (coords, reverse) { // (Array, Boolean) -> LatLng
-               var lat = parseFloat(coords[reverse ? 0 : 1]),
-                   lng = parseFloat(coords[reverse ? 1 : 0]);
-
-               return new L.LatLng(lat, lng, true);
+       coordsToLatLng: function (coords) { // (Array[, Boolean]) -> LatLng
+               return new L.LatLng(coords[1], coords[0]);
        },
 
-       coordsToLatLngs: function (coords, levelsDeep, reverse) { // (Array, Number, Boolean) -> Array
-               var latlng,
-                   latlngs = [],
-                   i, len;
+       coordsToLatLngs: function (coords, levelsDeep, coordsToLatLng) { // (Array[, Number, Function]) -> Array
+               var latlng, i, len,
+                   latlngs = [];
 
                for (i = 0, len = coords.length; i < len; i++) {
                        latlng = levelsDeep ?
-                               this.coordsToLatLngs(coords[i], levelsDeep - 1, reverse) :
-                               this.coordsToLatLng(coords[i], reverse);
+                               this.coordsToLatLngs(coords[i], levelsDeep - 1, coordsToLatLng) :
+                               (coordsToLatLng || this.coordsToLatLng)(coords[i]);
 
                        latlngs.push(latlng);
                }
 
                return latlngs;
+       },
+
+       latLngToCoords: function (latLng) {
+               return [latLng.lng, latLng.lat];
+       },
+
+       latLngsToCoords: function (latLngs) {
+               var coords = [];
+
+               for (var i = 0, len = latLngs.length; i < len; i++) {
+                       coords.push(L.GeoJSON.latLngToCoords(latLngs[i]));
+               }
+
+               return coords;
+       },
+
+       getFeature: function (layer, newGeometry) {
+               return layer.feature ? L.extend({}, layer.feature, {geometry: newGeometry}) : L.GeoJSON.asFeature(newGeometry);
+       },
+
+       asFeature: function (geoJSON) {
+               if (geoJSON.type === 'Feature') {
+                       return geoJSON;
+               }
+
+               return {
+                       type: 'Feature',
+                       properties: {},
+                       geometry: geoJSON
+               };
+       }
+});
+
+var PointToGeoJSON = {
+       toGeoJSON: function () {
+               return L.GeoJSON.getFeature(this, {
+                       type: 'Point',
+                       coordinates: L.GeoJSON.latLngToCoords(this.getLatLng())
+               });
+       }
+};
+
+L.Marker.include(PointToGeoJSON);
+L.Circle.include(PointToGeoJSON);
+L.CircleMarker.include(PointToGeoJSON);
+
+L.Polyline.include({
+       toGeoJSON: function () {
+               return L.GeoJSON.getFeature(this, {
+                       type: 'LineString',
+                       coordinates: L.GeoJSON.latLngsToCoords(this.getLatLngs())
+               });
+       }
+});
+
+L.Polygon.include({
+       toGeoJSON: function () {
+               var coords = [L.GeoJSON.latLngsToCoords(this.getLatLngs())],
+                   i, len, hole;
+
+               coords[0].push(coords[0][0]);
+
+               if (this._holes) {
+                       for (i = 0, len = this._holes.length; i < len; i++) {
+                               hole = L.GeoJSON.latLngsToCoords(this._holes[i]);
+                               hole.push(hole[0]);
+                               coords.push(hole);
+                       }
+               }
+
+               return L.GeoJSON.getFeature(this, {
+                       type: 'Polygon',
+                       coordinates: coords
+               });
+       }
+});
+
+(function () {
+       function includeMulti(Klass, type) {
+               Klass.include({
+                       toGeoJSON: function () {
+                               var coords = [];
+
+                               this.eachLayer(function (layer) {
+                                       coords.push(layer.toGeoJSON().geometry.coordinates);
+                               });
+
+                               return L.GeoJSON.getFeature(this, {
+                                       type: type,
+                                       coordinates: coords
+                               });
+                       }
+               });
+       }
+
+       includeMulti(L.MultiPolyline, 'MultiLineString');
+       includeMulti(L.MultiPolygon, 'MultiPolygon');
+}());
+
+L.LayerGroup.include({
+       toGeoJSON: function () {
+               var features = [];
+
+               this.eachLayer(function (layer) {
+                       if (layer.toGeoJSON) {
+                               features.push(L.GeoJSON.asFeature(layer.toGeoJSON()));
+                       }
+               });
+
+               return {
+                       type: 'FeatureCollection',
+                       features: features
+               };
        }
 });
 
@@ -5390,7 +6196,7 @@ L.geoJson = function (geojson, options) {
  */
 
 L.DomEvent = {
-       /* inpired by John Resig, Dean Edwards and YUI addEvent implementations */
+       /* inspired by John Resig, Dean Edwards and YUI addEvent implementations */
        addListener: function (obj, type, fn, context) { // (HTMLElement, String, Function[, Object])
 
                var id = L.stamp(fn),
@@ -5405,10 +6211,12 @@ L.DomEvent = {
 
                if (L.Browser.msTouch && type.indexOf('touch') === 0) {
                        return this.addMsTouchListener(obj, type, handler, id);
-               } else if (L.Browser.touch && (type === 'dblclick') && this.addDoubleTapListener) {
-                       return this.addDoubleTapListener(obj, handler, id);
+               }
+               if (L.Browser.touch && (type === 'dblclick') && this.addDoubleTapListener) {
+                       this.addDoubleTapListener(obj, handler, id);
+               }
 
-               } else if ('addEventListener' in obj) {
+               if ('addEventListener' in obj) {
 
                        if (type === 'mousewheel') {
                                obj.addEventListener('DOMMouseScroll', handler, false);
@@ -5426,12 +6234,19 @@ L.DomEvent = {
 
                                obj.addEventListener(newType, handler, false);
 
+                       } else if (type === 'click' && L.Browser.android) {
+                               originalHandler = handler;
+                               handler = function (e) {
+                                       return L.DomEvent._filterClick(e, originalHandler);
+                               };
+
+                               obj.addEventListener(type, handler, false);
                        } else {
                                obj.addEventListener(type, handler, false);
                        }
 
                } else if ('attachEvent' in obj) {
-                       obj.attachEvent("on" + type, handler);
+                       obj.attachEvent('on' + type, handler);
                }
 
                obj[key] = handler;
@@ -5445,7 +6260,7 @@ L.DomEvent = {
                    key = '_leaflet_' + type + id,
                    handler = obj[key];
 
-               if (!handler) { return; }
+               if (!handler) { return this; }
 
                if (L.Browser.msTouch && type.indexOf('touch') === 0) {
                        this.removeMsTouchListener(obj, type, id);
@@ -5464,7 +6279,7 @@ L.DomEvent = {
                                obj.removeEventListener(type, handler, false);
                        }
                } else if ('detachEvent' in obj) {
-                       obj.detachEvent("on" + type, handler);
+                       obj.detachEvent('on' + type, handler);
                }
 
                obj[key] = null;
@@ -5483,12 +6298,14 @@ L.DomEvent = {
        },
 
        disableClickPropagation: function (el) {
-
                var stop = L.DomEvent.stopPropagation;
 
+               for (var i = L.Draggable.START.length - 1; i >= 0; i--) {
+                       L.DomEvent.addListener(el, L.Draggable.START[i], stop);
+               }
+
                return L.DomEvent
-                       .addListener(el, L.Draggable.START, stop)
-                       .addListener(el, 'click', stop)
+                       .addListener(el, 'click', L.DomEvent._fakeStop)
                        .addListener(el, 'dblclick', stop);
        },
 
@@ -5508,13 +6325,30 @@ L.DomEvent = {
 
        getMousePosition: function (e, container) {
 
-               var body = document.body,
+               var ie7 = L.Browser.ie7,
+                   body = document.body,
                    docEl = document.documentElement,
-                   x = e.pageX ? e.pageX : e.clientX + body.scrollLeft + docEl.scrollLeft,
-                   y = e.pageY ? e.pageY : e.clientY + body.scrollTop + docEl.scrollTop,
-                   pos = new L.Point(x, y);
+                   x = e.pageX ? e.pageX - body.scrollLeft - docEl.scrollLeft: e.clientX,
+                   y = e.pageY ? e.pageY - body.scrollTop - docEl.scrollTop: e.clientY,
+                   pos = new L.Point(x, y),
+                   rect = container.getBoundingClientRect(),
+                   left = rect.left - container.clientLeft,
+                   top = rect.top - container.clientTop;
+
+               // webkit (and ie <= 7) handles RTL scrollLeft different to everyone else
+               // https://code.google.com/p/closure-library/source/browse/trunk/closure/goog/style/bidi.js
+               if (!L.DomUtil.documentIsLtr() && (L.Browser.webkit || ie7)) {
+                       left += container.scrollWidth - container.clientWidth;
+
+                       // ie7 shows the scrollbar by default and provides clientWidth counting it, so we
+                       // need to add it back in if it is visible; scrollbar is on the left as we are RTL
+                       if (ie7 && L.DomUtil.getStyle(container, 'overflow-y') !== 'hidden' &&
+                                  L.DomUtil.getStyle(container, 'overflow') !== 'hidden') {
+                               left += 17;
+                       }
+               }
 
-               return (container ? pos._subtract(L.DomUtil.getViewportOffset(container)) : pos);
+               return pos._subtract(new L.Point(left, top));
        },
 
        getWheelDelta: function (e) {
@@ -5530,6 +6364,20 @@ L.DomEvent = {
                return delta;
        },
 
+       _skipEvents: {},
+
+       _fakeStop: function (e) {
+               // fakes stopPropagation by setting a special event flag, checked/reset with L.DomEvent._skipped(e)
+               L.DomEvent._skipEvents[e.type] = true;
+       },
+
+       _skipped: function (e) {
+               var skipped = this._skipEvents[e.type];
+               // reset when checking, as it's only used in map container and propagates outside of the map
+               this._skipEvents[e.type] = false;
+               return skipped;
+       },
+
        // check if element really left/entered the event target (for mouseenter/mouseleave)
        _checkMouse: function (el, e) {
 
@@ -5547,9 +6395,8 @@ L.DomEvent = {
                return (related !== el);
        },
 
-       /*jshint noarg:false */
        _getEvent: function () { // evil magic for IE
-
+               /*jshint noarg:false */
                var e = window.event;
                if (!e) {
                        var caller = arguments.callee.caller;
@@ -5562,8 +6409,26 @@ L.DomEvent = {
                        }
                }
                return e;
+       },
+
+       // this is a horrible workaround for a bug in Android where a single touch triggers two click events
+       _filterClick: function (e, handler) {
+               var timeStamp = (e.timeStamp || e.originalEvent.timeStamp),
+                       elapsed = L.DomEvent._lastClick && (timeStamp - L.DomEvent._lastClick);
+
+               // are they closer together than 1000ms yet more than 100ms?
+               // Android typically triggers them ~300ms apart while multiple listeners
+               // on the same event should be triggered far faster;
+               // or check if click is simulated on the element, and if it is, reject any non-simulated events
+
+               if ((elapsed && elapsed > 100 && elapsed < 1000) || (e.target._simulatedClick && !e._simulated)) {
+                       L.DomEvent.stop(e);
+                       return;
+               }
+               L.DomEvent._lastClick = timeStamp;
+
+               return handler(e);
        }
-       /*jshint noarg:false */
 };
 
 L.DomEvent.on = L.DomEvent.addListener;
@@ -5578,78 +6443,74 @@ L.Draggable = L.Class.extend({
        includes: L.Mixin.Events,
 
        statics: {
-               START: L.Browser.touch ? 'touchstart' : 'mousedown',
-               END: L.Browser.touch ? 'touchend' : 'mouseup',
-               MOVE: L.Browser.touch ? 'touchmove' : 'mousemove',
-               TAP_TOLERANCE: 15
+               START: L.Browser.touch ? ['touchstart', 'mousedown'] : ['mousedown'],
+               END: {
+                       mousedown: 'mouseup',
+                       touchstart: 'touchend',
+                       MSPointerDown: 'touchend'
+               },
+               MOVE: {
+                       mousedown: 'mousemove',
+                       touchstart: 'touchmove',
+                       MSPointerDown: 'touchmove'
+               }
        },
 
-       initialize: function (element, dragStartTarget, longPress) {
+       initialize: function (element, dragStartTarget) {
                this._element = element;
                this._dragStartTarget = dragStartTarget || element;
-               this._longPress = longPress && !L.Browser.msTouch;
        },
 
        enable: function () {
                if (this._enabled) { return; }
 
-               L.DomEvent.on(this._dragStartTarget, L.Draggable.START, this._onDown, this);
+               for (var i = L.Draggable.START.length - 1; i >= 0; i--) {
+                       L.DomEvent.on(this._dragStartTarget, L.Draggable.START[i], this._onDown, this);
+               }
+
                this._enabled = true;
        },
 
        disable: function () {
                if (!this._enabled) { return; }
 
-               L.DomEvent.off(this._dragStartTarget, L.Draggable.START, this._onDown);
+               for (var i = L.Draggable.START.length - 1; i >= 0; i--) {
+                       L.DomEvent.off(this._dragStartTarget, L.Draggable.START[i], this._onDown, this);
+               }
+
                this._enabled = false;
                this._moved = false;
        },
 
        _onDown: function (e) {
-               if ((!L.Browser.touch && e.shiftKey) ||
-                   ((e.which !== 1) && (e.button !== 1) && !e.touches)) { return; }
+               if (e.shiftKey || ((e.which !== 1) && (e.button !== 1) && !e.touches)) { return; }
 
-               L.DomEvent.preventDefault(e);
-               L.DomEvent.stopPropagation(e);
+               L.DomEvent
+                       .stopPropagation(e);
 
                if (L.Draggable._disabled) { return; }
 
-               this._simulateClick = true;
-
-               if (e.touches && e.touches.length > 1) {
-                       this._simulateClick = false;
-                       clearTimeout(this._longPressTimeout);
-                       return;
-               }
+               L.DomUtil.disableImageDrag();
+               L.DomUtil.disableTextSelection();
 
-               var first = (e.touches && e.touches.length === 1 ? e.touches[0] : e),
+               var first = e.touches ? e.touches[0] : e,
                    el = first.target;
 
+               // if touching a link, highlight it
                if (L.Browser.touch && el.tagName.toLowerCase() === 'a') {
                        L.DomUtil.addClass(el, 'leaflet-active');
                }
 
                this._moved = false;
+
                if (this._moving) { return; }
 
                this._startPoint = new L.Point(first.clientX, first.clientY);
                this._startPos = this._newPos = L.DomUtil.getPosition(this._element);
 
-               //Touch contextmenu event emulation
-               if (e.touches && e.touches.length === 1 && L.Browser.touch && this._longPress) {
-                       this._longPressTimeout = setTimeout(L.bind(function () {
-                               var dist = (this._newPos && this._newPos.distanceTo(this._startPos)) || 0;
-
-                               if (dist < L.Draggable.TAP_TOLERANCE) {
-                                       this._simulateClick = false;
-                                       this._onUp();
-                                       this._simulateEvent('contextmenu', first);
-                               }
-                       }, this), 1000);
-               }
-
-               L.DomEvent.on(document, L.Draggable.MOVE, this._onMove, this);
-               L.DomEvent.on(document, L.Draggable.END, this._onUp, this);
+               L.DomEvent
+                   .on(document, L.Draggable.MOVE[e.type], this._onMove, this)
+                   .on(document, L.Draggable.END[e.type], this._onUp, this);
        },
 
        _onMove: function (e) {
@@ -5657,25 +6518,24 @@ L.Draggable = L.Class.extend({
 
                var first = (e.touches && e.touches.length === 1 ? e.touches[0] : e),
                    newPoint = new L.Point(first.clientX, first.clientY),
-                   diffVec = newPoint.subtract(this._startPoint);
+                   offset = newPoint.subtract(this._startPoint);
 
-               if (!diffVec.x && !diffVec.y) { return; }
+               if (!offset.x && !offset.y) { return; }
 
                L.DomEvent.preventDefault(e);
 
                if (!this._moved) {
                        this.fire('dragstart');
-                       this._moved = true;
 
-                       this._startPos = L.DomUtil.getPosition(this._element).subtract(diffVec);
+                       this._moved = true;
+                       this._startPos = L.DomUtil.getPosition(this._element).subtract(offset);
 
                        if (!L.Browser.touch) {
-                               L.DomUtil.disableTextSelection();
-                               this._setMovingCursor();
+                               L.DomUtil.addClass(document.body, 'leaflet-dragging');
                        }
                }
 
-               this._newPos = this._startPos.add(diffVec);
+               this._newPos = this._startPos.add(offset);
                this._moving = true;
 
                L.Util.cancelAnimFrame(this._animRequest);
@@ -5688,30 +6548,19 @@ L.Draggable = L.Class.extend({
                this.fire('drag');
        },
 
-       _onUp: function (e) {
-               var simulateClickTouch;
-               clearTimeout(this._longPressTimeout);
-               if (this._simulateClick && e.changedTouches) {
-                       var first = e.changedTouches[0],
-                           el = first.target,
-                           dist = (this._newPos && this._newPos.distanceTo(this._startPos)) || 0;
-
-                       if (el.tagName.toLowerCase() === 'a') {
-                               L.DomUtil.removeClass(el, 'leaflet-active');
-                       }
-
-                       if (dist < L.Draggable.TAP_TOLERANCE) {
-                               simulateClickTouch = first;
-                       }
+       _onUp: function () {
+               if (!L.Browser.touch) {
+                       L.DomUtil.removeClass(document.body, 'leaflet-dragging');
                }
 
-               if (!L.Browser.touch) {
-                       L.DomUtil.enableTextSelection();
-                       this._restoreCursor();
+               for (var i in L.Draggable.MOVE) {
+                       L.DomEvent
+                           .off(document, L.Draggable.MOVE[i], this._onMove)
+                           .off(document, L.Draggable.END[i], this._onUp);
                }
 
-               L.DomEvent.off(document, L.Draggable.MOVE, this._onMove);
-               L.DomEvent.off(document, L.Draggable.END, this._onUp);
+               L.DomUtil.enableImageDrag();
+               L.DomUtil.enableTextSelection();
 
                if (this._moved) {
                        // ensure drag is not fired after dragend
@@ -5719,39 +6568,16 @@ L.Draggable = L.Class.extend({
 
                        this.fire('dragend');
                }
-               this._moving = false;
-
-               if (simulateClickTouch) {
-                       this._moved = false;
-                       this._simulateEvent('click', simulateClickTouch);
-               }
-       },
-
-       _setMovingCursor: function () {
-               L.DomUtil.addClass(document.body, 'leaflet-dragging');
-       },
-
-       _restoreCursor: function () {
-               L.DomUtil.removeClass(document.body, 'leaflet-dragging');
-       },
-
-       _simulateEvent: function (type, e) {
-               var simulatedEvent = document.createEvent('MouseEvents');
 
-               simulatedEvent.initMouseEvent(
-                       type, true, true, window, 1,
-                       e.screenX, e.screenY,
-                       e.clientX, e.clientY,
-                       false, false, false, false, 0, null);
-
-               e.target.dispatchEvent(simulatedEvent);
+               this._moving = false;
        }
 });
 
 
 /*
- * L.Handler classes are used internally to inject interaction features to classes like Map and Marker.
- */
+       L.Handler is a base class for handler classes that are used internally to inject
+       interaction features like dragging to classes like Map and Marker.
+*/
 
 L.Handler = L.Class.extend({
        initialize: function (map) {
@@ -5779,7 +6605,7 @@ L.Handler = L.Class.extend({
 
 
 /*
- * L.Handler.MapDrag is used internally by L.Map to make the map draggable.
+ * L.Handler.MapDrag is used to make the map draggable (with panning inertia), enabled by default.
  */
 
 L.Map.mergeOptions({
@@ -5791,10 +6617,8 @@ L.Map.mergeOptions({
        inertiaThreshold: L.Browser.touch ? 32 : 18, // ms
        easeLinearity: 0.25,
 
-       longPress: true,
-
        // TODO refactor, move to CRS
-       worldCopyJump: true
+       worldCopyJump: false
 });
 
 L.Map.Drag = L.Handler.extend({
@@ -5802,7 +6626,7 @@ L.Map.Drag = L.Handler.extend({
                if (!this._draggable) {
                        var map = this._map;
 
-                       this._draggable = new L.Draggable(map._mapPane, map._container, map.options.longPress);
+                       this._draggable = new L.Draggable(map._mapPane, map._container);
 
                        this._draggable.on({
                                'dragstart': this._onDragStart,
@@ -5813,6 +6637,8 @@ L.Map.Drag = L.Handler.extend({
                        if (map.options.worldCopyJump) {
                                this._draggable.on('predrag', this._onPreDrag, this);
                                map.on('viewreset', this._onViewReset, this);
+
+                               this._onViewReset();
                        }
                }
                this._draggable.enable();
@@ -5863,17 +6689,17 @@ L.Map.Drag = L.Handler.extend({
        },
 
        _onViewReset: function () {
+               // TODO fix hardcoded Earth values
                var pxCenter = this._map.getSize()._divideBy(2),
-                   pxWorldCenter = this._map.latLngToLayerPoint(new L.LatLng(0, 0));
+                   pxWorldCenter = this._map.latLngToLayerPoint([0, 0]);
 
                this._initialWorldOffset = pxWorldCenter.subtract(pxCenter).x;
-               this._worldWidth = this._map.project(new L.LatLng(0, 180)).x;
+               this._worldWidth = this._map.project([0, 180]).x;
        },
 
        _onPreDrag: function () {
                // TODO refactor to be able to adjust map pane position after zoom
-               var map = this._map,
-                   worldWidth = this._worldWidth,
+               var worldWidth = this._worldWidth,
                    halfWidth = Math.round(worldWidth / 2),
                    dx = this._initialWorldOffset,
                    x = this._draggable._newPos.x,
@@ -5889,9 +6715,9 @@ L.Map.Drag = L.Handler.extend({
                    options = map.options,
                    delay = +new Date() - this._lastTime,
 
-                   noInertia = !options.inertia ||
-                           delay > options.inertiaThreshold ||
-                           !this._positions[0];
+                   noInertia = !options.inertia || delay > options.inertiaThreshold || !this._positions[0];
+
+               map.fire('dragend');
 
                if (noInertia) {
                        map.fire('moveend');
@@ -5900,31 +6726,30 @@ L.Map.Drag = L.Handler.extend({
 
                        var direction = this._lastPos.subtract(this._positions[0]),
                            duration = (this._lastTime + delay - this._times[0]) / 1000,
+                           ease = options.easeLinearity,
 
-                           speedVector = direction.multiplyBy(options.easeLinearity / duration),
-                           speed = speedVector.distanceTo(new L.Point(0, 0)),
+                           speedVector = direction.multiplyBy(ease / duration),
+                           speed = speedVector.distanceTo([0, 0]),
 
                            limitedSpeed = Math.min(options.inertiaMaxSpeed, speed),
                            limitedSpeedVector = speedVector.multiplyBy(limitedSpeed / speed),
 
-                           decelerationDuration = limitedSpeed / (options.inertiaDeceleration * options.easeLinearity),
+                           decelerationDuration = limitedSpeed / (options.inertiaDeceleration * ease),
                            offset = limitedSpeedVector.multiplyBy(-decelerationDuration / 2).round();
 
-                       L.Util.requestAnimFrame(function () {
-                               map.panBy(offset, decelerationDuration, options.easeLinearity);
-                       });
-               }
-
-               map.fire('dragend');
+                       if (!offset.x || !offset.y) {
+                               map.fire('moveend');
 
-               if (options.maxBounds) {
-                       // TODO predrag validation instead of animation
-                       L.Util.requestAnimFrame(this._panInsideMaxBounds, map, true, map._container);
+                       } else {
+                               L.Util.requestAnimFrame(function () {
+                                       map.panBy(offset, {
+                                               duration: decelerationDuration,
+                                               easeLinearity: ease,
+                                               noMoveStart: true
+                                       });
+                               });
+                       }
                }
-       },
-
-       _panInsideMaxBounds: function () {
-               this.panInsideBounds(this.options.maxBounds);
        }
 });
 
@@ -5932,7 +6757,7 @@ L.Map.addInitHook('addHandler', 'dragging', L.Map.Drag);
 
 
 /*
- * L.Handler.DoubleClickZoom is used internally by L.Map to add double-click zooming.
+ * L.Handler.DoubleClickZoom is used to handle double-click zoom on the map, enabled by default.
  */
 
 L.Map.mergeOptions({
@@ -5941,36 +6766,46 @@ L.Map.mergeOptions({
 
 L.Map.DoubleClickZoom = L.Handler.extend({
        addHooks: function () {
-               this._map.on('dblclick', this._onDoubleClick);
+               this._map.on('dblclick', this._onDoubleClick, this);
        },
 
        removeHooks: function () {
-               this._map.off('dblclick', this._onDoubleClick);
+               this._map.off('dblclick', this._onDoubleClick, this);
        },
 
        _onDoubleClick: function (e) {
-               this.setView(e.latlng, this._zoom + 1);
+               var map = this._map,
+                   zoom = map.getZoom() + 1;
+
+               if (map.options.doubleClickZoom === 'center') {
+                       map.setZoom(zoom);
+               } else {
+                       map.setZoomAround(e.containerPoint, zoom);
+               }
        }
 });
 
 L.Map.addInitHook('addHandler', 'doubleClickZoom', L.Map.DoubleClickZoom);
 
+
 /*
  * L.Handler.ScrollWheelZoom is used by L.Map to enable mouse scroll wheel zoom on the map.
  */
 
 L.Map.mergeOptions({
-       scrollWheelZoom: !L.Browser.touch || L.Browser.msTouch
+       scrollWheelZoom: true
 });
 
 L.Map.ScrollWheelZoom = L.Handler.extend({
        addHooks: function () {
                L.DomEvent.on(this._map._container, 'mousewheel', this._onWheelScroll, this);
+               L.DomEvent.on(this._map._container, 'MozMousePixelScroll', L.DomEvent.preventDefault);
                this._delta = 0;
        },
 
        removeHooks: function () {
                L.DomEvent.off(this._map._container, 'mousewheel', this._onWheelScroll);
+               L.DomEvent.off(this._map._container, 'MozMousePixelScroll', L.DomEvent.preventDefault);
        },
 
        _onWheelScroll: function (e) {
@@ -5994,38 +6829,33 @@ L.Map.ScrollWheelZoom = L.Handler.extend({
 
        _performZoom: function () {
                var map = this._map,
-                   delta = Math.round(this._delta),
+                   delta = this._delta,
                    zoom = map.getZoom();
 
+               delta = delta > 0 ? Math.ceil(delta) : Math.floor(delta);
                delta = Math.max(Math.min(delta, 4), -4);
                delta = map._limitZoom(zoom + delta) - zoom;
 
                this._delta = 0;
-
                this._startTime = null;
 
                if (!delta) { return; }
 
-               var newZoom = zoom + delta,
-                   newCenter = this._getCenterForScrollWheelZoom(newZoom);
-
-               map.setView(newCenter, newZoom);
-       },
-
-       _getCenterForScrollWheelZoom: function (newZoom) {
-               var map = this._map,
-                   scale = map.getZoomScale(newZoom),
-                   viewHalf = map.getSize()._divideBy(2),
-                   centerOffset = this._lastMousePos._subtract(viewHalf)._multiplyBy(1 - 1 / scale),
-                   newCenterPoint = map._getTopLeftPoint()._add(viewHalf)._add(centerOffset);
-
-               return map.unproject(newCenterPoint);
+               if (map.options.scrollWheelZoom === 'center') {
+                       map.setZoom(zoom + delta);
+               } else {
+                       map.setZoomAround(this._lastMousePos, zoom + delta);
+               }
        }
 });
 
 L.Map.addInitHook('addHandler', 'scrollWheelZoom', L.Map.ScrollWheelZoom);
 
 
+/*
+ * Extends the event handling code with double tap support for mobile browsers.
+ */
+
 L.extend(L.DomEvent, {
 
        _touchstart: L.Browser.msTouch ? 'MSPointerDown' : 'touchstart',
@@ -6044,6 +6874,7 @@ L.extend(L.DomEvent, {
 
                function onTouchStart(e) {
                        var count;
+
                        if (L.Browser.msTouch) {
                                trackedTouches.push(e.pointerId);
                                count = trackedTouches.length;
@@ -6061,6 +6892,7 @@ L.extend(L.DomEvent, {
                        doubleTap = (delta > 0 && delta <= delay);
                        last = now;
                }
+
                function onTouchEnd(e) {
                        if (L.Browser.msTouch) {
                                var idx = trackedTouches.indexOf(e.pointerId);
@@ -6072,17 +6904,17 @@ L.extend(L.DomEvent, {
 
                        if (doubleTap) {
                                if (L.Browser.msTouch) {
-                                       //Work around .type being readonly with MSPointer* events
+                                       // work around .type being readonly with MSPointer* events
                                        var newTouch = { },
                                                prop;
+
+                                       // jshint forin:false
                                        for (var i in touch) {
-                                               if (true) { //Make JSHint happy, we want to copy all properties
-                                                       prop = touch[i];
-                                                       if (typeof prop === 'function') {
-                                                               newTouch[i] = prop.bind(touch);
-                                                       } else {
-                                                               newTouch[i] = prop;
-                                                       }
+                                               prop = touch[i];
+                                               if (typeof prop === 'function') {
+                                                       newTouch[i] = prop.bind(touch);
+                                               } else {
+                                                       newTouch[i] = prop;
                                                }
                                        }
                                        touch = newTouch;
@@ -6095,30 +6927,40 @@ L.extend(L.DomEvent, {
                obj[pre + touchstart + id] = onTouchStart;
                obj[pre + touchend + id] = onTouchEnd;
 
-               //On msTouch we need to listen on the document otherwise a drag starting on the map and moving off screen will not come through to us
-               // so we will lose track of how many touches are ongoing
+               // on msTouch we need to listen on the document, otherwise a drag starting on the map and moving off screen
+               // will not come through to us, so we will lose track of how many touches are ongoing
                var endElement = L.Browser.msTouch ? document.documentElement : obj;
 
                obj.addEventListener(touchstart, onTouchStart, false);
                endElement.addEventListener(touchend, onTouchEnd, false);
+
                if (L.Browser.msTouch) {
                        endElement.addEventListener('MSPointerCancel', onTouchEnd, false);
                }
+
                return this;
        },
 
        removeDoubleTapListener: function (obj, id) {
                var pre = '_leaflet_';
+
                obj.removeEventListener(this._touchstart, obj[pre + this._touchstart + id], false);
-               (L.Browser.msTouch ? document.documentElement : obj).removeEventListener(this._touchend, obj[pre + this._touchend + id], false);
+               (L.Browser.msTouch ? document.documentElement : obj).removeEventListener(
+                       this._touchend, obj[pre + this._touchend + id], false);
+
                if (L.Browser.msTouch) {
                        document.documentElement.removeEventListener('MSPointerCancel', obj[pre + this._touchend + id], false);
                }
+
                return this;
        }
 });
 
 
+/*
+ * Extends L.DomEvent to provide touch support for Internet Explorer and Windows-based devices.
+ */
+
 L.extend(L.DomEvent, {
 
        _msTouches: [],
@@ -6309,10 +7151,10 @@ L.Map.TouchZoom = L.Handler.extend({
        },
 
        _onTouchMove: function (e) {
-               if (!e.touches || e.touches.length !== 2) { return; }
-
                var map = this._map;
 
+               if (!e.touches || e.touches.length !== 2 || !this._zooming) { return; }
+
                var p1 = map.mouseEventToLayerPoint(e.touches[0]),
                    p2 = map.mouseEventToLayerPoint(e.touches[1]);
 
@@ -6322,12 +7164,11 @@ L.Map.TouchZoom = L.Handler.extend({
                if (this._scale === 1) { return; }
 
                if (!this._moved) {
-                       L.DomUtil.addClass(map._mapPane, 'leaflet-zoom-anim leaflet-touching');
+                       L.DomUtil.addClass(map._mapPane, 'leaflet-touching');
 
                        map
                            .fire('movestart')
-                           .fire('zoomstart')
-                           ._prepareTileBg();
+                           .fire('zoomstart');
 
                        this._moved = true;
                }
@@ -6342,28 +7183,23 @@ L.Map.TouchZoom = L.Handler.extend({
        _updateOnMove: function () {
                var map = this._map,
                    origin = this._getScaleOrigin(),
-                   center = map.layerPointToLatLng(origin);
-
-               map.fire('zoomanim', {
-                       center: center,
-                       zoom: map.getScaleZoom(this._scale)
-               });
-
-               // Used 2 translates instead of transform-origin because of a very strange bug -
-               // it didn't count the origin on the first touch-zoom but worked correctly afterwards
+                   center = map.layerPointToLatLng(origin),
+                   zoom = map.getScaleZoom(this._scale);
 
-               map._tileBg.style[L.DomUtil.TRANSFORM] =
-                       L.DomUtil.getTranslateString(this._delta) + ' ' +
-                       L.DomUtil.getScaleString(this._scale, this._startCenter);
+               map._animateZoom(center, zoom, this._startCenter, this._scale, this._delta);
        },
 
-       _onTouchEnd: function (e) {
-               if (!this._moved || !this._zooming) { return; }
+       _onTouchEnd: function () {
+               if (!this._moved || !this._zooming) {
+                       this._zooming = false;
+                       return;
+               }
 
                var map = this._map;
 
                this._zooming = false;
                L.DomUtil.removeClass(map._mapPane, 'leaflet-touching');
+               L.Util.cancelAnimFrame(this._animRequest);
 
                L.DomEvent
                    .off(document, 'touchmove', this._onTouchMove)
@@ -6377,14 +7213,10 @@ L.Map.TouchZoom = L.Handler.extend({
                    roundZoomDelta = (floatZoomDelta > 0 ?
                            Math.ceil(floatZoomDelta) : Math.floor(floatZoomDelta)),
 
-                   zoom = map._limitZoom(oldZoom + roundZoomDelta);
-
-               map.fire('zoomanim', {
-                       center: center,
-                       zoom: zoom
-               });
+                   zoom = map._limitZoom(oldZoom + roundZoomDelta),
+                   scale = map.getZoomScale(zoom) / this._scale;
 
-               map._runAnimation(center, zoom, map.getZoomScale(zoom) / this._scale, origin, true);
+               map._animateZoom(center, zoom, origin, scale);
        },
 
        _getScaleOrigin: function () {
@@ -6397,7 +7229,117 @@ L.Map.addInitHook('addHandler', 'touchZoom', L.Map.TouchZoom);
 
 
 /*
- * L.Handler.ShiftDragZoom is used internally by L.Map to add shift-drag zoom (zoom to a selected bounding box).
+ * L.Map.Tap is used to enable mobile hacks like quick taps and long hold.
+ */
+
+L.Map.mergeOptions({
+       tap: true,
+       tapTolerance: 15
+});
+
+L.Map.Tap = L.Handler.extend({
+       addHooks: function () {
+               L.DomEvent.on(this._map._container, 'touchstart', this._onDown, this);
+       },
+
+       removeHooks: function () {
+               L.DomEvent.off(this._map._container, 'touchstart', this._onDown, this);
+       },
+
+       _onDown: function (e) {
+               if (!e.touches) { return; }
+
+               L.DomEvent.preventDefault(e);
+
+               this._fireClick = true;
+
+               // don't simulate click or track longpress if more than 1 touch
+               if (e.touches.length > 1) {
+                       this._fireClick = false;
+                       clearTimeout(this._holdTimeout);
+                       return;
+               }
+
+               var first = e.touches[0],
+                   el = first.target;
+
+               this._startPos = this._newPos = new L.Point(first.clientX, first.clientY);
+
+               // if touching a link, highlight it
+               if (el.tagName.toLowerCase() === 'a') {
+                       L.DomUtil.addClass(el, 'leaflet-active');
+               }
+
+               // simulate long hold but setting a timeout
+               this._holdTimeout = setTimeout(L.bind(function () {
+                       if (this._isTapValid()) {
+                               this._fireClick = false;
+                               this._onUp();
+                               this._simulateEvent('contextmenu', first);
+                       }
+               }, this), 1000);
+
+               L.DomEvent
+                       .on(document, 'touchmove', this._onMove, this)
+                       .on(document, 'touchend', this._onUp, this);
+       },
+
+       _onUp: function (e) {
+               clearTimeout(this._holdTimeout);
+
+               L.DomEvent
+                       .off(document, 'touchmove', this._onMove, this)
+                       .off(document, 'touchend', this._onUp, this);
+
+               if (this._fireClick && e && e.changedTouches) {
+
+                       var first = e.changedTouches[0],
+                           el = first.target;
+
+                       if (el.tagName.toLowerCase() === 'a') {
+                               L.DomUtil.removeClass(el, 'leaflet-active');
+                       }
+
+                       // simulate click if the touch didn't move too much
+                       if (this._isTapValid()) {
+                               this._simulateEvent('click', first);
+                       }
+               }
+       },
+
+       _isTapValid: function () {
+               return this._newPos.distanceTo(this._startPos) <= this._map.options.tapTolerance;
+       },
+
+       _onMove: function (e) {
+               var first = e.touches[0];
+               this._newPos = new L.Point(first.clientX, first.clientY);
+       },
+
+       _simulateEvent: function (type, e) {
+               var simulatedEvent = document.createEvent('MouseEvents');
+
+               simulatedEvent._simulated = true;
+               e.target._simulatedClick = true;
+
+               simulatedEvent.initMouseEvent(
+                       type, true, true, window, 1,
+                       e.screenX, e.screenY,
+                       e.clientX, e.clientY,
+                       false, false, false, false, 0, null);
+
+               e.target.dispatchEvent(simulatedEvent);
+       }
+});
+
+if (L.Browser.touch && !L.Browser.msTouch) {
+       L.Map.addInitHook('addHandler', 'tap', L.Map.Tap);
+}
+
+
+/*
+ * L.Handler.ShiftDragZoom is used to add shift-drag zoom interaction to the map
+  * (zoom to a selected bounding box), enabled by default.
  */
 
 L.Map.mergeOptions({
@@ -6423,6 +7365,7 @@ L.Map.BoxZoom = L.Handler.extend({
                if (!e.shiftKey || ((e.which !== 1) && (e.button !== 1))) { return false; }
 
                L.DomUtil.disableTextSelection();
+               L.DomUtil.disableImageDrag();
 
                this._startLayerPoint = this._map.mouseEventToLayerPoint(e);
 
@@ -6435,9 +7378,9 @@ L.Map.BoxZoom = L.Handler.extend({
                L.DomEvent
                    .on(document, 'mousemove', this._onMouseMove, this)
                    .on(document, 'mouseup', this._onMouseUp, this)
-                   .preventDefault(e);
+                   .on(document, 'keydown', this._onKeyDown, this);
 
-               this._map.fire("boxzoomstart");
+               this._map.fire('boxzoomstart');
        },
 
        _onMouseMove: function (e) {
@@ -6458,34 +7401,53 @@ L.Map.BoxZoom = L.Handler.extend({
                box.style.height = (Math.max(0, Math.abs(offset.y) - 4)) + 'px';
        },
 
-       _onMouseUp: function (e) {
+       _finish: function () {
                this._pane.removeChild(this._box);
                this._container.style.cursor = '';
 
                L.DomUtil.enableTextSelection();
+               L.DomUtil.enableImageDrag();
 
                L.DomEvent
                    .off(document, 'mousemove', this._onMouseMove)
-                   .off(document, 'mouseup', this._onMouseUp);
+                   .off(document, 'mouseup', this._onMouseUp)
+                   .off(document, 'keydown', this._onKeyDown);
+       },
+
+       _onMouseUp: function (e) {
+
+               this._finish();
 
                var map = this._map,
-                   layerPoint = map.mouseEventToLayerPoint(e),
+                   layerPoint = map.mouseEventToLayerPoint(e);
+
+               if (this._startLayerPoint.equals(layerPoint)) { return; }
 
-                   bounds = new L.LatLngBounds(
+               var bounds = new L.LatLngBounds(
                        map.layerPointToLatLng(this._startLayerPoint),
                        map.layerPointToLatLng(layerPoint));
 
                map.fitBounds(bounds);
 
-               map.fire("boxzoomend", {
+               map.fire('boxzoomend', {
                        boxZoomBounds: bounds
                });
+       },
+
+       _onKeyDown: function (e) {
+               if (e.keyCode === 27) {
+                       this._finish();
+               }
        }
 });
 
 L.Map.addInitHook('addHandler', 'boxZoom', L.Map.BoxZoom);
 
 
+/*
+ * L.Map.Keyboard is handling keyboard interaction with the map, enabled by default.
+ */
+
 L.Map.mergeOptions({
        keyboard: true,
        keyboardPanOffset: 80,
@@ -6494,14 +7456,13 @@ L.Map.mergeOptions({
 
 L.Map.Keyboard = L.Handler.extend({
 
-       // list of e.keyCode values for particular actions
        keyCodes: {
                left:    [37],
                right:   [39],
                down:    [40],
                up:      [38],
                zoomIn:  [187, 107, 61],
-               zoomOut: [189, 109]
+               zoomOut: [189, 109, 173]
        },
 
        initialize: function (map) {
@@ -6516,13 +7477,13 @@ L.Map.Keyboard = L.Handler.extend({
 
                // make the container focusable by tabbing
                if (container.tabIndex === -1) {
-                       container.tabIndex = "0";
+                       container.tabIndex = '0';
                }
 
                L.DomEvent
-                   .addListener(container, 'focus', this._onFocus, this)
-                   .addListener(container, 'blur', this._onBlur, this)
-                   .addListener(container, 'mousedown', this._onMouseDown, this);
+                   .on(container, 'focus', this._onFocus, this)
+                   .on(container, 'blur', this._onBlur, this)
+                   .on(container, 'mousedown', this._onMouseDown, this);
 
                this._map
                    .on('focus', this._addHooks, this)
@@ -6535,9 +7496,9 @@ L.Map.Keyboard = L.Handler.extend({
                var container = this._map._container;
 
                L.DomEvent
-                   .removeListener(container, 'focus', this._onFocus, this)
-                   .removeListener(container, 'blur', this._onBlur, this)
-                   .removeListener(container, 'mousedown', this._onMouseDown, this);
+                   .off(container, 'focus', this._onFocus, this)
+                   .off(container, 'blur', this._onBlur, this)
+                   .off(container, 'mousedown', this._onMouseDown, this);
 
                this._map
                    .off('focus', this._addHooks, this)
@@ -6545,9 +7506,16 @@ L.Map.Keyboard = L.Handler.extend({
        },
 
        _onMouseDown: function () {
-               if (!this._focused) {
-                       this._map._container.focus();
-               }
+               if (this._focused) { return; }
+
+               var body = document.body,
+                   docEl = document.documentElement,
+                   top = body.scrollTop || docEl.scrollTop,
+                   left = body.scrollTop || docEl.scrollLeft;
+
+               this._map._container.focus();
+
+               window.scrollTo(left, top);
        },
 
        _onFocus: function () {
@@ -6593,21 +7561,29 @@ L.Map.Keyboard = L.Handler.extend({
        },
 
        _addHooks: function () {
-               L.DomEvent.addListener(document, 'keydown', this._onKeyDown, this);
+               L.DomEvent.on(document, 'keydown', this._onKeyDown, this);
        },
 
        _removeHooks: function () {
-               L.DomEvent.removeListener(document, 'keydown', this._onKeyDown, this);
+               L.DomEvent.off(document, 'keydown', this._onKeyDown, this);
        },
 
        _onKeyDown: function (e) {
-               var key = e.keyCode;
+               var key = e.keyCode,
+                   map = this._map;
+
+               if (key in this._panKeys) {
+
+                       if (map._panAnim && map._panAnim._inProgress) { return; }
 
-               if (this._panKeys.hasOwnProperty(key)) {
-                       this._map.panBy(this._panKeys[key]);
+                       map.panBy(this._panKeys[key]);
 
-               } else if (this._zoomKeys.hasOwnProperty(key)) {
-                       this._map.setZoom(this._map.getZoom() + this._zoomKeys[key]);
+                       if (map.options.maxBounds) {
+                               map.panInsideBounds(map.options.maxBounds);
+                       }
+
+               } else if (key in this._zoomKeys) {
+                       map.setZoom(map.getZoom() + this._zoomKeys[key]);
 
                } else {
                        return;
@@ -6632,15 +7608,22 @@ L.Handler.MarkerDrag = L.Handler.extend({
        addHooks: function () {
                var icon = this._marker._icon;
                if (!this._draggable) {
-                       this._draggable = new L.Draggable(icon, icon)
-                           .on('dragstart', this._onDragStart, this)
-                           .on('drag', this._onDrag, this)
-                           .on('dragend', this._onDragEnd, this);
+                       this._draggable = new L.Draggable(icon, icon);
                }
+
+               this._draggable
+                       .on('dragstart', this._onDragStart, this)
+                       .on('drag', this._onDrag, this)
+                       .on('dragend', this._onDragEnd, this);
                this._draggable.enable();
        },
 
        removeHooks: function () {
+               this._draggable
+                       .off('dragstart', this._onDragStart, this)
+                       .off('drag', this._onDrag, this)
+                       .off('dragend', this._onDragEnd, this);
+
                this._draggable.disable();
        },
 
@@ -6648,14 +7631,14 @@ L.Handler.MarkerDrag = L.Handler.extend({
                return this._draggable && this._draggable._moved;
        },
 
-       _onDragStart: function (e) {
+       _onDragStart: function () {
                this._marker
                    .closePopup()
                    .fire('movestart')
                    .fire('dragstart');
        },
 
-       _onDrag: function (e) {
+       _onDrag: function () {
                var marker = this._marker,
                    shadow = marker._shadow,
                    iconPos = L.DomUtil.getPosition(marker._icon),
@@ -6681,230 +7664,10 @@ L.Handler.MarkerDrag = L.Handler.extend({
 });
 
 
-L.Handler.PolyEdit = L.Handler.extend({
-       options: {
-               icon: new L.DivIcon({
-                       iconSize: new L.Point(8, 8),
-                       className: 'leaflet-div-icon leaflet-editing-icon'
-               })
-       },
-
-       initialize: function (poly, options) {
-               this._poly = poly;
-               L.setOptions(this, options);
-       },
-
-       addHooks: function () {
-               if (this._poly._map) {
-                       if (!this._markerGroup) {
-                               this._initMarkers();
-                       }
-                       this._poly._map.addLayer(this._markerGroup);
-               }
-       },
-
-       removeHooks: function () {
-               if (this._poly._map) {
-                       this._poly._map.removeLayer(this._markerGroup);
-                       delete this._markerGroup;
-                       delete this._markers;
-               }
-       },
-
-       updateMarkers: function () {
-               this._markerGroup.clearLayers();
-               this._initMarkers();
-       },
-
-       _initMarkers: function () {
-               if (!this._markerGroup) {
-                       this._markerGroup = new L.LayerGroup();
-               }
-               this._markers = [];
-
-               var latlngs = this._poly._latlngs,
-                   i, j, len, marker;
-
-               // TODO refactor holes implementation in Polygon to support it here
-
-               for (i = 0, len = latlngs.length; i < len; i++) {
-
-                       marker = this._createMarker(latlngs[i], i);
-                       marker.on('click', this._onMarkerClick, this);
-                       this._markers.push(marker);
-               }
-
-               var markerLeft, markerRight;
-
-               for (i = 0, j = len - 1; i < len; j = i++) {
-                       if (i === 0 && !(L.Polygon && (this._poly instanceof L.Polygon))) {
-                               continue;
-                       }
-
-                       markerLeft = this._markers[j];
-                       markerRight = this._markers[i];
-
-                       this._createMiddleMarker(markerLeft, markerRight);
-                       this._updatePrevNext(markerLeft, markerRight);
-               }
-       },
-
-       _createMarker: function (latlng, index) {
-               var marker = new L.Marker(latlng, {
-                       draggable: true,
-                       icon: this.options.icon
-               });
-
-               marker._origLatLng = latlng;
-               marker._index = index;
-
-               marker.on('drag', this._onMarkerDrag, this);
-               marker.on('dragend', this._fireEdit, this);
-
-               this._markerGroup.addLayer(marker);
-
-               return marker;
-       },
-
-       _fireEdit: function () {
-               this._poly.fire('edit');
-       },
-
-       _onMarkerDrag: function (e) {
-               var marker = e.target;
-
-               L.extend(marker._origLatLng, marker._latlng);
-
-               if (marker._middleLeft) {
-                       marker._middleLeft.setLatLng(this._getMiddleLatLng(marker._prev, marker));
-               }
-               if (marker._middleRight) {
-                       marker._middleRight.setLatLng(this._getMiddleLatLng(marker, marker._next));
-               }
-
-               this._poly.redraw();
-       },
-
-       _onMarkerClick: function (e) {
-               // we want to remove the marker on click, but if latlng count < 3, polyline would be invalid
-               if (this._poly._latlngs.length < 3) { return; }
-
-               var marker = e.target,
-                   i = marker._index;
-
-               // remove the marker
-               this._markerGroup.removeLayer(marker);
-               this._markers.splice(i, 1);
-               this._poly.spliceLatLngs(i, 1);
-               this._updateIndexes(i, -1);
-
-               // update prev/next links of adjacent markers
-               this._updatePrevNext(marker._prev, marker._next);
-
-               // remove ghost markers near the removed marker
-               if (marker._middleLeft) {
-                       this._markerGroup.removeLayer(marker._middleLeft);
-               }
-               if (marker._middleRight) {
-                       this._markerGroup.removeLayer(marker._middleRight);
-               }
-
-               // create a ghost marker in place of the removed one
-               if (marker._prev && marker._next) {
-                       this._createMiddleMarker(marker._prev, marker._next);
-
-               } else if (!marker._prev) {
-                       marker._next._middleLeft = null;
-
-               } else if (!marker._next) {
-                       marker._prev._middleRight = null;
-               }
-
-               this._poly.fire('edit');
-       },
-
-       _updateIndexes: function (index, delta) {
-               this._markerGroup.eachLayer(function (marker) {
-                       if (marker._index > index) {
-                               marker._index += delta;
-                       }
-               });
-       },
-
-       _createMiddleMarker: function (marker1, marker2) {
-               var latlng = this._getMiddleLatLng(marker1, marker2),
-                   marker = this._createMarker(latlng),
-                   onClick,
-                   onDragStart,
-                   onDragEnd;
-
-               marker.setOpacity(0.6);
-
-               marker1._middleRight = marker2._middleLeft = marker;
-
-               onDragStart = function () {
-                       var i = marker2._index;
-
-                       marker._index = i;
-
-                       marker
-                           .off('click', onClick)
-                           .on('click', this._onMarkerClick, this);
-
-                       latlng.lat = marker.getLatLng().lat;
-                       latlng.lng = marker.getLatLng().lng;
-                       this._poly.spliceLatLngs(i, 0, latlng);
-                       this._markers.splice(i, 0, marker);
-
-                       marker.setOpacity(1);
-
-                       this._updateIndexes(i, 1);
-                       marker2._index++;
-                       this._updatePrevNext(marker1, marker);
-                       this._updatePrevNext(marker, marker2);
-               };
-
-               onDragEnd = function () {
-                       marker.off('dragstart', onDragStart, this);
-                       marker.off('dragend', onDragEnd, this);
-
-                       this._createMiddleMarker(marker1, marker);
-                       this._createMiddleMarker(marker, marker2);
-               };
-
-               onClick = function () {
-                       onDragStart.call(this);
-                       onDragEnd.call(this);
-                       this._poly.fire('edit');
-               };
-
-               marker
-                   .on('click', onClick, this)
-                   .on('dragstart', onDragStart, this)
-                   .on('dragend', onDragEnd, this);
-
-               this._markerGroup.addLayer(marker);
-       },
-
-       _updatePrevNext: function (marker1, marker2) {
-               if (marker1) {
-                       marker1._next = marker2;
-               }
-               if (marker2) {
-                       marker2._prev = marker1;
-               }
-       },
-
-       _getMiddleLatLng: function (marker1, marker2) {
-               var map = this._poly._map,
-                   p1 = map.latLngToLayerPoint(marker1.getLatLng()),
-                   p2 = map.latLngToLayerPoint(marker2.getLatLng());
-
-               return map.layerPointToLatLng(p1._add(p2)._divideBy(2));
-       }
-});
-
-
+/*
+ * L.Control is a base class for implementing map controls. Handles positioning.
+ * All other controls extend from this class.
+ */
 
 L.Control = L.Class.extend({
        options: {
@@ -6935,6 +7698,10 @@ L.Control = L.Class.extend({
                return this;
        },
 
+       getContainer: function () {
+               return this._container;
+       },
+
        addTo: function (map) {
                this._map = map;
 
@@ -6973,6 +7740,8 @@ L.control = function (options) {
 };
 
 
+// adds control-related methods to L.Map
+
 L.Map.include({
        addControl: function (control) {
                control.addTo(this);
@@ -7000,27 +7769,43 @@ L.Map.include({
                createCorner('top', 'right');
                createCorner('bottom', 'left');
                createCorner('bottom', 'right');
+       },
+
+       _clearControlPos: function () {
+               this._container.removeChild(this._controlContainer);
        }
 });
 
 
+/*
+ * L.Control.Zoom is used for the default zoom buttons on the map.
+ */
+
 L.Control.Zoom = L.Control.extend({
        options: {
                position: 'topleft'
        },
 
        onAdd: function (map) {
-               var className = 'leaflet-control-zoom',
-                   container = L.DomUtil.create('div', className);
+               var zoomName = 'leaflet-control-zoom',
+                   container = L.DomUtil.create('div', zoomName + ' leaflet-bar');
 
                this._map = map;
 
-               this._createButton('Zoom in', className + '-in', container, this._zoomIn, this);
-               this._createButton('Zoom out', className + '-out', container, this._zoomOut, this);
+               this._zoomInButton  = this._createButton(
+                       '+', 'Zoom in',  zoomName + '-in',  container, this._zoomIn,  this);
+               this._zoomOutButton = this._createButton(
+                       '-', 'Zoom out', zoomName + '-out', container, this._zoomOut, this);
+
+               map.on('zoomend zoomlevelschange', this._updateDisabled, this);
 
                return container;
        },
 
+       onRemove: function (map) {
+               map.off('zoomend zoomlevelschange', this._updateDisabled, this);
+       },
+
        _zoomIn: function (e) {
                this._map.zoomIn(e.shiftKey ? 3 : 1);
        },
@@ -7029,19 +7814,37 @@ L.Control.Zoom = L.Control.extend({
                this._map.zoomOut(e.shiftKey ? 3 : 1);
        },
 
-       _createButton: function (title, className, container, fn, context) {
+       _createButton: function (html, title, className, container, fn, context) {
                var link = L.DomUtil.create('a', className, container);
+               link.innerHTML = html;
                link.href = '#';
                link.title = title;
 
+               var stop = L.DomEvent.stopPropagation;
+
                L.DomEvent
-                   .on(link, 'click', L.DomEvent.stopPropagation)
-                   .on(link, 'mousedown', L.DomEvent.stopPropagation)
-                   .on(link, 'dblclick', L.DomEvent.stopPropagation)
+                   .on(link, 'click', stop)
+                   .on(link, 'mousedown', stop)
+                   .on(link, 'dblclick', stop)
                    .on(link, 'click', L.DomEvent.preventDefault)
                    .on(link, 'click', fn, context);
 
                return link;
+       },
+
+       _updateDisabled: function () {
+               var map = this._map,
+                       className = 'leaflet-disabled';
+
+               L.DomUtil.removeClass(this._zoomInButton, className);
+               L.DomUtil.removeClass(this._zoomOutButton, className);
+
+               if (map._zoom === map.getMinZoom()) {
+                       L.DomUtil.addClass(this._zoomOutButton, className);
+               }
+               if (map._zoom === map.getMaxZoom()) {
+                       L.DomUtil.addClass(this._zoomInButton, className);
+               }
        }
 });
 
@@ -7062,10 +7865,14 @@ L.control.zoom = function (options) {
 
 
 
+/*
+ * L.Control.Attribution is used for displaying attribution on the map (added by default).
+ */
+
 L.Control.Attribution = L.Control.extend({
        options: {
                position: 'bottomright',
-               prefix: 'Powered by <a href="http://leafletjs.com">Leaflet</a>'
+               prefix: '<a href="http://leafletjs.com" title="A JS library for interactive maps">Leaflet</a>'
        },
 
        initialize: function (options) {
@@ -7116,8 +7923,10 @@ L.Control.Attribution = L.Control.extend({
        removeAttribution: function (text) {
                if (!text) { return; }
 
-               this._attributions[text]--;
-               this._update();
+               if (this._attributions[text]) {
+                       this._attributions[text]--;
+                       this._update();
+               }
 
                return this;
        },
@@ -7128,7 +7937,7 @@ L.Control.Attribution = L.Control.extend({
                var attribs = [];
 
                for (var i in this._attributions) {
-                       if (this._attributions.hasOwnProperty(i) && this._attributions[i]) {
+                       if (this._attributions[i]) {
                                attribs.push(i);
                        }
                }
@@ -7142,7 +7951,7 @@ L.Control.Attribution = L.Control.extend({
                        prefixAndAttribs.push(attribs.join(', '));
                }
 
-               this._container.innerHTML = prefixAndAttribs.join(' &#8212; ');
+               this._container.innerHTML = prefixAndAttribs.join(' | ');
        },
 
        _onLayerAdd: function (e) {
@@ -7173,6 +7982,10 @@ L.control.attribution = function (options) {
 };
 
 
+/*
+ * L.Control.Scale is used for displaying metric/imperial scale on the map.
+ */
+
 L.Control.Scale = L.Control.extend({
        options: {
                position: 'bottomleft',
@@ -7283,6 +8096,10 @@ L.control.scale = function (options) {
 };
 
 
+/*
+ * L.Control.Layers is a control to allow users to switch between different layers on the map.
+ */
+
 L.Control.Layers = L.Control.extend({
        options: {
                collapsed: true,
@@ -7298,15 +8115,11 @@ L.Control.Layers = L.Control.extend({
                this._handlingClick = false;
 
                for (var i in baseLayers) {
-                       if (baseLayers.hasOwnProperty(i)) {
-                               this._addLayer(baseLayers[i], i);
-                       }
+                       this._addLayer(baseLayers[i], i);
                }
 
                for (i in overlays) {
-                       if (overlays.hasOwnProperty(i)) {
-                               this._addLayer(overlays[i], i, true);
-                       }
+                       this._addLayer(overlays[i], i, true);
                }
        },
 
@@ -7315,16 +8128,16 @@ L.Control.Layers = L.Control.extend({
                this._update();
 
                map
-                   .on('layeradd', this._update, this)
-                   .on('layerremove', this._update, this);
+                   .on('layeradd', this._onLayerChange, this)
+                   .on('layerremove', this._onLayerChange, this);
 
                return this._container;
        },
 
        onRemove: function (map) {
                map
-                   .off('layeradd', this._update)
-                   .off('layerremove', this._update);
+                   .off('layeradd', this._onLayerChange)
+                   .off('layerremove', this._onLayerChange);
        },
 
        addBaseLayer: function (layer, name) {
@@ -7350,8 +8163,12 @@ L.Control.Layers = L.Control.extend({
                var className = 'leaflet-control-layers',
                    container = this._container = L.DomUtil.create('div', className);
 
+               //Makes this work on IE10 Touch devices by stopping it from firing a mouseout event when the touch is released
+               container.setAttribute('aria-haspopup', true);
+
                if (!L.Browser.touch) {
                        L.DomEvent.disableClickPropagation(container);
+                       L.DomEvent.on(container, 'mousewheel', L.DomEvent.stopPropagation);
                } else {
                        L.DomEvent.on(container, 'click', L.DomEvent.stopPropagation);
                }
@@ -7359,25 +8176,25 @@ L.Control.Layers = L.Control.extend({
                var form = this._form = L.DomUtil.create('form', className + '-list');
 
                if (this.options.collapsed) {
-                       L.DomEvent
-                           .on(container, 'mouseover', this._expand, this)
-                           .on(container, 'mouseout', this._collapse, this);
-
+                       if (!L.Browser.android) {
+                               L.DomEvent
+                                   .on(container, 'mouseover', this._expand, this)
+                                   .on(container, 'mouseout', this._collapse, this);
+                       }
                        var link = this._layersLink = L.DomUtil.create('a', className + '-toggle', container);
                        link.href = '#';
                        link.title = 'Layers';
 
                        if (L.Browser.touch) {
                                L.DomEvent
-                                   .on(link, 'click', L.DomEvent.stopPropagation)
-                                   .on(link, 'click', L.DomEvent.preventDefault)
+                                   .on(link, 'click', L.DomEvent.stop)
                                    .on(link, 'click', this._expand, this);
                        }
                        else {
                                L.DomEvent.on(link, 'focus', this._expand, this);
                        }
 
-                       this._map.on('movestart', this._collapse, this);
+                       this._map.on('click', this._collapse, this);
                        // TODO keyboard accessibility
                } else {
                        this._expand();
@@ -7406,7 +8223,7 @@ L.Control.Layers = L.Control.extend({
        },
 
        _update: function () {
-               if (!this._container || this._handlingClick) {
+               if (!this._container) {
                        return;
                }
 
@@ -7414,18 +8231,35 @@ L.Control.Layers = L.Control.extend({
                this._overlaysList.innerHTML = '';
 
                var baseLayersPresent = false,
-                   overlaysPresent = false;
+                   overlaysPresent = false,
+                   i, obj;
 
-               for (var i in this._layers) {
-                       if (this._layers.hasOwnProperty(i)) {
-                               var obj = this._layers[i];
-                               this._addItem(obj);
-                               overlaysPresent = overlaysPresent || obj.overlay;
-                               baseLayersPresent = baseLayersPresent || !obj.overlay;
-                       }
+               for (i in this._layers) {
+                       obj = this._layers[i];
+                       this._addItem(obj);
+                       overlaysPresent = overlaysPresent || obj.overlay;
+                       baseLayersPresent = baseLayersPresent || !obj.overlay;
                }
 
-               this._separator.style.display = (overlaysPresent && baseLayersPresent ? '' : 'none');
+               this._separator.style.display = overlaysPresent && baseLayersPresent ? '' : 'none';
+       },
+
+       _onLayerChange: function (e) {
+               var obj = this._layers[L.stamp(e.layer)];
+
+               if (!obj) { return; }
+
+               if (!this._handlingClick) {
+                       this._update();
+               }
+
+               var type = obj.overlay ?
+                       (e.type === 'layeradd' ? 'overlayadd' : 'overlayremove') :
+                       (e.type === 'layeradd' ? 'baselayerchange' : null);
+
+               if (type) {
+                       this._map.fire(type, obj);
+               }
        },
 
        // IE7 bugs out if you create a radio dynamically, so you have to do it this hacky way (see http://bit.ly/PqYLBe)
@@ -7469,13 +8303,14 @@ L.Control.Layers = L.Control.extend({
 
                var container = obj.overlay ? this._overlaysList : this._baseLayersList;
                container.appendChild(label);
+
+               return label;
        },
 
        _onInputClick: function () {
                var i, input, obj,
                    inputs = this._form.getElementsByTagName('input'),
-                   inputsLen = inputs.length,
-                   baseLayer;
+                   inputsLen = inputs.length;
 
                this._handlingClick = true;
 
@@ -7485,18 +8320,12 @@ L.Control.Layers = L.Control.extend({
 
                        if (input.checked && !this._map.hasLayer(obj.layer)) {
                                this._map.addLayer(obj.layer);
-                               if (!obj.overlay) {
-                                       baseLayer = obj.layer;
-                               }
+
                        } else if (!input.checked && this._map.hasLayer(obj.layer)) {
                                this._map.removeLayer(obj.layer);
                        }
                }
 
-               if (baseLayer) {
-                       this._map.fire('baselayerchange', {layer: baseLayer});
-               }
-
                this._handlingClick = false;
        },
 
@@ -7526,6 +8355,7 @@ L.PosAnimation = L.Class.extend({
 
                this._el = el;
                this._inProgress = true;
+               this._newPos = newPos;
 
                this.fire('start');
 
@@ -7538,8 +8368,8 @@ L.PosAnimation = L.Class.extend({
                // toggle reflow, Chrome flickers for some reason if you don't do this
                L.Util.falseFn(el.offsetWidth);
 
-               // there's no native way to track value updates of tranisitioned properties, so we imitate this
-               this._stepTimer = setInterval(L.bind(this.fire, this, 'step'), 50);
+               // there's no native way to track value updates of transitioned properties, so we imitate this
+               this._stepTimer = setInterval(L.bind(this._onStep, this), 50);
        },
 
        stop: function () {
@@ -7553,10 +8383,23 @@ L.PosAnimation = L.Class.extend({
                L.Util.falseFn(this._el.offsetWidth); // force reflow in case we are about to start a new animation
        },
 
+       _onStep: function () {
+               var stepPos = this._getPos();
+               if (!stepPos) {
+                       this._onTransitionEnd();
+                       return;
+               }
+               // jshint camelcase: false
+               // make L.DomUtil.getPosition return intermediate position value during animation
+               this._el._leaflet_pos = stepPos;
+
+               this.fire('step');
+       },
+
        // you can't easily get intermediate values of properties animated with CSS3 Transitions,
        // we need to parse computed style (in case of transform it returns matrix string)
 
-       _transformRe: /(-?[\d\.]+), (-?[\d\.]+)\)/,
+       _transformRe: /([-+]?(?:\d*\.)?\d+)\D*, ([-+]?(?:\d*\.)?\d+)\D*\)/,
 
        _getPos: function () {
                var left, top, matches,
@@ -7565,6 +8408,7 @@ L.PosAnimation = L.Class.extend({
 
                if (L.Browser.any3d) {
                        matches = style[L.DomUtil.TRANSFORM].match(this._transformRe);
+                       if (!matches) { return; }
                        left = parseFloat(matches[1]);
                        top  = parseFloat(matches[2]);
                } else {
@@ -7583,6 +8427,10 @@ L.PosAnimation = L.Class.extend({
 
                this._el.style[L.DomUtil.TRANSITION] = '';
 
+               // jshint camelcase: false
+               // make sure L.DomUtil.getPosition returns the final position value after animation
+               this._el._leaflet_pos = this._newPos;
+
                clearInterval(this._stepTimer);
 
                this.fire('step').fire('end');
@@ -7591,41 +8439,52 @@ L.PosAnimation = L.Class.extend({
 });
 
 
+/*
+ * Extends L.Map to handle panning animations.
+ */
 
 L.Map.include({
 
-       setView: function (center, zoom, forceReset) {
+       setView: function (center, zoom, options) {
+
                zoom = this._limitZoom(zoom);
+               center = L.latLng(center);
+               options = options || {};
 
-               var zoomChanged = (this._zoom !== zoom);
+               if (this._panAnim) {
+                       this._panAnim.stop();
+               }
 
-               if (this._loaded && !forceReset && this._layers) {
+               if (this._loaded && !options.reset && options !== true) {
 
-                       if (this._panAnim) {
-                               this._panAnim.stop();
+                       if (options.animate !== undefined) {
+                               options.zoom = L.extend({animate: options.animate}, options.zoom);
+                               options.pan = L.extend({animate: options.animate}, options.pan);
                        }
 
-                       var done = (zoomChanged ?
-                               this._zoomToIfClose && this._zoomToIfClose(center, zoom) :
-                               this._panByIfClose(center));
+                       // try animating pan or zoom
+                       var animated = (this._zoom !== zoom) ?
+                               this._tryAnimatedZoom && this._tryAnimatedZoom(center, zoom, options.zoom) :
+                               this._tryAnimatedPan(center, options.pan);
 
-                       // exit if animated pan or zoom started
-                       if (done) {
+                       if (animated) {
+                               // prevent resize handler call, the view will refresh after animation anyway
                                clearTimeout(this._sizeTimer);
                                return this;
                        }
                }
 
-               // reset the map view
+               // animation didn't start, just reset the map view
                this._resetView(center, zoom);
 
                return this;
        },
 
-       panBy: function (offset, duration, easeLinearity) {
-               offset = L.point(offset);
+       panBy: function (offset, options) {
+               offset = L.point(offset).round();
+               options = options || {};
 
-               if (!(offset.x || offset.y)) {
+               if (!offset.x && !offset.y) {
                        return this;
                }
 
@@ -7638,12 +8497,21 @@ L.Map.include({
                        }, this);
                }
 
-               this.fire('movestart');
+               // don't fire movestart if animating inertia
+               if (!options.noMoveStart) {
+                       this.fire('movestart');
+               }
 
-               L.DomUtil.addClass(this._mapPane, 'leaflet-pan-anim');
+               // animate pan unless animate: false specified
+               if (options.animate !== false) {
+                       L.DomUtil.addClass(this._mapPane, 'leaflet-pan-anim');
 
-               var newPos = L.DomUtil.getPosition(this._mapPane).subtract(offset);
-               this._panAnim.run(this._mapPane, newPos, duration || 0.25, easeLinearity);
+                       var newPos = this._getMapPanePos().subtract(offset);
+                       this._panAnim.run(this._mapPane, newPos, options.duration || 0.25, options.easeLinearity);
+               } else {
+                       this._rawPanBy(offset);
+                       this.fire('move').fire('moveend');
+               }
 
                return this;
        },
@@ -7657,23 +8525,16 @@ L.Map.include({
                this.fire('moveend');
        },
 
-       _panByIfClose: function (center) {
+       _tryAnimatedPan: function (center, options) {
                // difference between the new and current centers in pixels
                var offset = this._getCenterOffset(center)._floor();
 
-               if (this._offsetIsWithinView(offset)) {
-                       this.panBy(offset);
-                       return true;
-               }
-               return false;
-       },
+               // don't animate too far unless animate: true specified in options
+               if ((options && options.animate) !== true && !this.getSize().contains(offset)) { return false; }
 
-       _offsetIsWithinView: function (offset, multiplyFactor) {
-               var m = multiplyFactor || 1,
-                   size = this.getSize();
+               this.panBy(offset, options);
 
-               return (Math.abs(offset.x) <= size.x * m) &&
-                      (Math.abs(offset.y) <= size.y * m);
+               return true;
        }
 });
 
@@ -7747,113 +8608,183 @@ L.PosAnimation = L.DomUtil.TRANSITION ? L.PosAnimation : L.PosAnimation.extend({
 });
 
 
+/*
+ * Extends L.Map to handle zoom animations.
+ */
+
 L.Map.mergeOptions({
-       zoomAnimation: L.DomUtil.TRANSITION && !L.Browser.android23 && !L.Browser.mobileOpera
+       zoomAnimation: true,
+       zoomAnimationThreshold: 4
 });
 
 if (L.DomUtil.TRANSITION) {
+
        L.Map.addInitHook(function () {
-               L.DomEvent.on(this._mapPane, L.DomUtil.TRANSITION_END, this._catchTransitionEnd, this);
+               // don't animate on browsers without hardware-accelerated transitions or old Android/Opera
+               this._zoomAnimated = this.options.zoomAnimation && L.DomUtil.TRANSITION &&
+                               L.Browser.any3d && !L.Browser.android23 && !L.Browser.mobileOpera;
+
+               // zoom transitions run with the same duration for all layers, so if one of transitionend events
+               // happens after starting zoom animation (propagating to the map pane), we know that it ended globally
+               if (this._zoomAnimated) {
+                       L.DomEvent.on(this._mapPane, L.DomUtil.TRANSITION_END, this._catchTransitionEnd, this);
+               }
        });
 }
 
 L.Map.include(!L.DomUtil.TRANSITION ? {} : {
 
-       _zoomToIfClose: function (center, zoom) {
+       _catchTransitionEnd: function () {
+               if (this._animatingZoom) {
+                       this._onZoomTransitionEnd();
+               }
+       },
+
+       _nothingToAnimate: function () {
+               return !this._container.getElementsByClassName('leaflet-zoom-animated').length;
+       },
+
+       _tryAnimatedZoom: function (center, zoom, options) {
 
                if (this._animatingZoom) { return true; }
 
-               if (!this.options.zoomAnimation) { return false; }
+               options = options || {};
 
-               var scale = this.getZoomScale(zoom),
-                   offset = this._getCenterOffset(center)._divideBy(1 - 1 / scale);
+               // don't animate if disabled, not supported or zoom difference is too large
+               if (!this._zoomAnimated || options.animate === false || this._nothingToAnimate() ||
+                       Math.abs(zoom - this._zoom) > this.options.zoomAnimationThreshold) { return false; }
 
-               // if offset does not exceed half of the view
-               if (!this._offsetIsWithinView(offset, 1)) { return false; }
+               // offset is the pixel coords of the zoom origin relative to the current center
+               var scale = this.getZoomScale(zoom),
+                   offset = this._getCenterOffset(center)._divideBy(1 - 1 / scale),
+                       origin = this._getCenterLayerPoint()._add(offset);
 
-               L.DomUtil.addClass(this._mapPane, 'leaflet-zoom-anim');
+               // don't animate if the zoom origin isn't within one screen from the current center, unless forced
+               if (options.animate !== true && !this.getSize().contains(offset)) { return false; }
 
                this
                    .fire('movestart')
                    .fire('zoomstart');
 
-               this.fire('zoomanim', {
-                       center: center,
-                       zoom: zoom
-               });
-
-               var origin = this._getCenterLayerPoint().add(offset);
-
-               this._prepareTileBg();
-               this._runAnimation(center, zoom, scale, origin);
+               this._animateZoom(center, zoom, origin, scale, null, true);
 
                return true;
        },
 
-       _catchTransitionEnd: function (e) {
-               if (this._animatingZoom) {
-                       this._onZoomTransitionEnd();
-               }
-       },
+       _animateZoom: function (center, zoom, origin, scale, delta, backwards) {
 
-       _runAnimation: function (center, zoom, scale, origin, backwardsTransform) {
+               this._animatingZoom = true;
+
+               // put transform transition on all layers with leaflet-zoom-animated class
+               L.DomUtil.addClass(this._mapPane, 'leaflet-zoom-anim');
+
+               // remember what center/zoom to set after animation
                this._animateToCenter = center;
                this._animateToZoom = zoom;
-               this._animatingZoom = true;
 
+               // disable any dragging during animation
                if (L.Draggable) {
                        L.Draggable._disabled = true;
                }
 
-               var transform = L.DomUtil.TRANSFORM,
-                   tileBg = this._tileBg;
+               this.fire('zoomanim', {
+                       center: center,
+                       zoom: zoom,
+                       origin: origin,
+                       scale: scale,
+                       delta: delta,
+                       backwards: backwards
+               });
+       },
+
+       _onZoomTransitionEnd: function () {
+
+               this._animatingZoom = false;
+
+               L.DomUtil.removeClass(this._mapPane, 'leaflet-zoom-anim');
+
+               this._resetView(this._animateToCenter, this._animateToZoom, true, true);
+
+               if (L.Draggable) {
+                       L.Draggable._disabled = false;
+               }
+       }
+});
+
 
-               clearTimeout(this._clearTileBgTimer);
+/*
+       Zoom animation logic for L.TileLayer.
+*/
 
-               L.Util.falseFn(tileBg.offsetWidth); //hack to make sure transform is updated before running animation
+L.TileLayer.include({
+       _animateZoom: function (e) {
+               if (!this._animating) {
+                       this._animating = true;
+                       this._prepareBgBuffer();
+               }
 
-               var scaleStr = L.DomUtil.getScaleString(scale, origin),
-                   oldTransform = tileBg.style[transform];
+               var bg = this._bgBuffer,
+                   transform = L.DomUtil.TRANSFORM,
+                   initialTransform = e.delta ? L.DomUtil.getTranslateString(e.delta) : bg.style[transform],
+                   scaleStr = L.DomUtil.getScaleString(e.scale, e.origin);
 
-               tileBg.style[transform] = backwardsTransform ?
-                       oldTransform + ' ' + scaleStr :
-                       scaleStr + ' ' + oldTransform;
+               bg.style[transform] = e.backwards ?
+                               scaleStr + ' ' + initialTransform :
+                               initialTransform + ' ' + scaleStr;
        },
 
-       _prepareTileBg: function () {
-               var tilePane = this._tilePane,
-                   tileBg = this._tileBg;
+       _endZoomAnim: function () {
+               var front = this._tileContainer,
+                   bg = this._bgBuffer;
 
-               // If foreground layer doesn't have many tiles but bg layer does, keep the existing bg layer and just zoom it some more
-               if (tileBg && this._getLoadedTilesPercentage(tileBg) > 0.5 &&
-                                 this._getLoadedTilesPercentage(tilePane) < 0.5) {
+               front.style.visibility = '';
+               front.parentNode.appendChild(front); // Bring to fore
 
-                       tilePane.style.visibility = 'hidden';
-                       tilePane.empty = true;
-                       this._stopLoadingImages(tilePane);
-                       return;
-               }
+               // force reflow
+               L.Util.falseFn(bg.offsetWidth);
 
-               if (!tileBg) {
-                       tileBg = this._tileBg = this._createPane('leaflet-tile-pane', this._mapPane);
-                       tileBg.style.zIndex = 1;
+               this._animating = false;
+       },
+
+       _clearBgBuffer: function () {
+               var map = this._map;
+
+               if (map && !map._animatingZoom && !map.touchZoom._zooming) {
+                       this._bgBuffer.innerHTML = '';
+                       this._bgBuffer.style[L.DomUtil.TRANSFORM] = '';
                }
+       },
+
+       _prepareBgBuffer: function () {
+
+               var front = this._tileContainer,
+                   bg = this._bgBuffer;
+
+               // if foreground layer doesn't have many tiles but bg layer does,
+               // keep the existing bg layer and just zoom it some more
 
-               // prepare the background pane to become the main tile pane
-               tileBg.style[L.DomUtil.TRANSFORM] = '';
-               tileBg.style.visibility = 'hidden';
+               var bgLoaded = this._getLoadedTilesPercentage(bg),
+                   frontLoaded = this._getLoadedTilesPercentage(front);
 
-               // tells tile layers to reinitialize their containers
-               tileBg.empty = true; //new FG
-               tilePane.empty = false; //new BG
+               if (bg && bgLoaded > 0.5 && frontLoaded < 0.5) {
 
-               //Switch out the current layer to be the new bg layer (And vice-versa)
-               this._tilePane = this._panes.tilePane = tileBg;
-               var newTileBg = this._tileBg = tilePane;
+                       front.style.visibility = 'hidden';
+                       this._stopLoadingImages(front);
+                       return;
+               }
+
+               // prepare the buffer to become the front tile pane
+               bg.style.visibility = 'hidden';
+               bg.style[L.DomUtil.TRANSFORM] = '';
+
+               // switch out the current layer to be the new bg layer (and vice-versa)
+               this._tileContainer = bg;
+               bg = this._bgBuffer = front;
 
-               L.DomUtil.addClass(newTileBg, 'leaflet-zoom-animated');
+               this._stopLoadingImages(bg);
 
-               this._stopLoadingImages(newTileBg);
+               //prevent bg buffer from clearing right after zoom
+               clearTimeout(this._clearBgBufferTimer);
        },
 
        _getLoadedTilesPercentage: function (container) {
@@ -7884,38 +8815,12 @@ L.Map.include(!L.DomUtil.TRANSITION ? {} : {
                                tile.parentNode.removeChild(tile);
                        }
                }
-       },
-
-       _onZoomTransitionEnd: function () {
-               this._restoreTileFront();
-               L.Util.falseFn(this._tileBg.offsetWidth); // force reflow
-               this._resetView(this._animateToCenter, this._animateToZoom, true, true);
-
-               L.DomUtil.removeClass(this._mapPane, 'leaflet-zoom-anim');
-               this._animatingZoom = false;
-
-               if (L.Draggable) {
-                       L.Draggable._disabled = false;
-               }
-       },
-
-       _restoreTileFront: function () {
-               this._tilePane.innerHTML = '';
-               this._tilePane.style.visibility = '';
-               this._tilePane.style.zIndex = 2;
-               this._tileBg.style.zIndex = 1;
-       },
-
-       _clearTileBg: function () {
-               if (!this._animatingZoom && !this.touchZoom._zooming) {
-                       this._tileBg.innerHTML = '';
-               }
        }
 });
 
 
 /*
- * Provides L.Map with convenient shortcuts for W3C geolocation.
+ * Provides L.Map with convenient shortcuts for using browser geolocation features.
  */
 
 L.Map.include({
@@ -7930,12 +8835,12 @@ L.Map.include({
 
        locate: function (/*Object*/ options) {
 
-               options = this._locationOptions = L.extend(this._defaultLocateOptions, options);
+               options = this._locateOptions = L.extend(this._defaultLocateOptions, options);
 
                if (!navigator.geolocation) {
                        this._handleGeolocationError({
                                code: 0,
-                               message: "Geolocation not supported."
+                               message: 'Geolocation not supported.'
                        });
                        return this;
                }
@@ -7956,53 +8861,61 @@ L.Map.include({
                if (navigator.geolocation) {
                        navigator.geolocation.clearWatch(this._locationWatchId);
                }
+               if (this._locateOptions) {
+                       this._locateOptions.setView = false;
+               }
                return this;
        },
 
        _handleGeolocationError: function (error) {
                var c = error.code,
                    message = error.message ||
-                           (c === 1 ? "permission denied" :
-                           (c === 2 ? "position unavailable" : "timeout"));
+                           (c === 1 ? 'permission denied' :
+                           (c === 2 ? 'position unavailable' : 'timeout'));
 
-               if (this._locationOptions.setView && !this._loaded) {
+               if (this._locateOptions.setView && !this._loaded) {
                        this.fitWorld();
                }
 
                this.fire('locationerror', {
                        code: c,
-                       message: "Geolocation error: " + message + "."
+                       message: 'Geolocation error: ' + message + '.'
                });
        },
 
        _handleGeolocationResponse: function (pos) {
-               var latAccuracy = 180 * pos.coords.accuracy / 4e7,
-                   lngAccuracy = latAccuracy * 2,
-
-                   lat = pos.coords.latitude,
+               var lat = pos.coords.latitude,
                    lng = pos.coords.longitude,
                    latlng = new L.LatLng(lat, lng),
 
-                   sw = new L.LatLng(lat - latAccuracy, lng - lngAccuracy),
-                   ne = new L.LatLng(lat + latAccuracy, lng + lngAccuracy),
-                   bounds = new L.LatLngBounds(sw, ne),
+                   latAccuracy = 180 * pos.coords.accuracy / 40075017,
+                   lngAccuracy = latAccuracy / Math.cos(L.LatLng.DEG_TO_RAD * lat),
 
-                   options = this._locationOptions;
+                   bounds = L.latLngBounds(
+                           [lat - latAccuracy, lng - lngAccuracy],
+                           [lat + latAccuracy, lng + lngAccuracy]),
+
+                   options = this._locateOptions;
 
                if (options.setView) {
                        var zoom = Math.min(this.getBoundsZoom(bounds), options.maxZoom);
                        this.setView(latlng, zoom);
                }
 
-               this.fire('locationfound', {
+               var data = {
                        latlng: latlng,
-                       bounds: bounds,
-                       accuracy: pos.coords.accuracy
-               });
-       }
-});
+                       bounds: bounds
+               };
 
+               for (var i in pos.coords) {
+                       if (typeof pos.coords[i] === 'number') {
+                               data[i] = pos.coords[i];
+                       }
+               }
 
+               this.fire('locationfound', data);
+       }
+});
 
 
-}(this));
+}(window, document));
\ No newline at end of file