google-closure-compiler 20170806.0.0 → 20170910.0.0

package/contrib/externs/angular-1.6.js

@@ -2299,7 +2299,7 @@ angular.$routeProvider.Params.prototype.controller;
 /** @type {string|undefined} */
 angular.$routeProvider.Params.prototype.controllerAs;
 
-/** @type {string|undefined} */
+/** @type {string|function(!Object<string, string>): string|undefined} */
 angular.$routeProvider.Params.prototype.template;
 
 /** @type {string|!Object|function(!Object<string,string>=)} */

package/contrib/externs/chai-3.5.js

@@ -130,10 +130,11 @@ ExpectChain.prototype.below = function(value, opt_message) {};
 ExpectChain.prototype.most = function(value, opt_message) {};
 
 /**
- * @param {number} value
+ * @param {number} start
+ * @param {number} finish
  * @param {string=} opt_message
  */
-ExpectChain.prototype.within = function(value, opt_message) {};
+ExpectChain.prototype.within = function(start, finish, opt_message) {};
 
 /**
  * @param {function(new: Object)} constructor

package/contrib/externs/chrome.js

@@ -0,0 +1,669 @@
+/*
+ * Copyright 2013 The Closure Compiler Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview Definitions for globals in Chrome.  This file describes the
+ * externs API for the chrome.* object when running in a normal browser
+ * context.  For APIs available in Chrome Extensions, see chrome_extensions.js
+ * in this directory.
+ * @externs
+ */
+
+
+/**
+ * namespace
+ * @const
+ */
+var chrome = {};
+
+
+/**
+ * @see http://developer.chrome.com/apps/runtime.html#type-Port
+ * @constructor
+ */
+function Port() {}
+
+
+/** @type {string} */
+Port.prototype.name;
+
+
+/** @type {!ChromeEvent} */
+Port.prototype.onDisconnect;
+
+
+/** @type {!ChromeEvent} */
+Port.prototype.onMessage;
+
+
+/** @type {!MessageSender|undefined} */
+Port.prototype.sender;
+
+
+/**
+ * @param {*} obj Message object.
+ * @return {undefined}
+ */
+Port.prototype.postMessage = function(obj) {};
+
+
+/** @return {undefined} */
+Port.prototype.disconnect = function() {};
+
+
+/**
+ * @see https://developer.chrome.com/extensions/events.html
+ * @constructor
+ * TODO(tbreisacher): Update *Listener methods to take {function()}
+ * instead of {!Function}. See discussion at go/ChromeEvent-TODO
+ */
+function ChromeEvent() {}
+
+
+/**
+ * @param {!Function} callback
+ * @return {undefined}
+ */
+ChromeEvent.prototype.addListener = function(callback) {};
+
+
+/**
+ * @param {!Function} callback
+ * @return {undefined}
+ */
+ChromeEvent.prototype.removeListener = function(callback) {};
+
+
+/**
+ * @param {!Function} callback
+ * @return {boolean}
+ */
+ChromeEvent.prototype.hasListener = function(callback) {};
+
+
+/** @return {boolean} */
+ChromeEvent.prototype.hasListeners = function() {};
+
+// TODO(tbreisacher): Add the addRules, getRules, and removeRules methods?
+
+
+
+/**
+ * Event whose listeners take a string parameter.
+ * @constructor
+ */
+function ChromeStringEvent() {}
+
+
+/**
+ * @param {function(string): void} callback
+ * @return {undefined}
+ */
+ChromeStringEvent.prototype.addListener = function(callback) {};
+
+
+/**
+ * @param {function(string): void} callback
+ * @return {undefined}
+ */
+ChromeStringEvent.prototype.removeListener = function(callback) {};
+
+
+/**
+ * @param {function(string): void} callback
+ * @return {boolean}
+ */
+ChromeStringEvent.prototype.hasListener = function(callback) {};
+
+
+/** @return {boolean} */
+ChromeStringEvent.prototype.hasListeners = function() {};
+
+
+
+/**
+ * Event whose listeners take a boolean parameter.
+ * @constructor
+ */
+
+function ChromeBooleanEvent() {}
+
+
+/**
+ * @param {function(boolean): void} callback
+ * @return {undefined}
+ */
+ChromeBooleanEvent.prototype.addListener = function(callback) {};
+
+
+/**
+ * @param {function(boolean): void} callback
+ * @return {undefined}
+ */
+ChromeBooleanEvent.prototype.removeListener = function(callback) {};
+
+
+/**
+ * @param {function(boolean): void} callback
+ * @return {boolean}
+ */
+ChromeBooleanEvent.prototype.hasListener = function(callback) {};
+
+
+/**
+ * @return {boolean}
+ */
+ChromeBooleanEvent.prototype.hasListeners = function() {};
+
+
+
+/**
+ * Event whose listeners take a number parameter.
+ * @constructor
+ */
+
+function ChromeNumberEvent() {}
+
+
+/**
+ * @param {function(number): void} callback
+ * @return {undefined}
+ */
+ChromeNumberEvent.prototype.addListener = function(callback) {};
+
+
+/**
+ * @param {function(number): void} callback
+ * @return {undefined}
+ */
+ChromeNumberEvent.prototype.removeListener = function(callback) {};
+
+
+/**
+ * @param {function(number): void} callback
+ * @return {boolean}
+ */
+ChromeNumberEvent.prototype.hasListener = function(callback) {};
+
+
+/**
+ * @return {boolean}
+ */
+ChromeNumberEvent.prototype.hasListeners = function() {};
+
+
+
+/**
+ * Event whose listeners take an Object parameter.
+ * @constructor
+ */
+function ChromeObjectEvent() {}
+
+
+/**
+ * @param {function(!Object): void} callback Callback.
+ * @return {undefined}
+ */
+ChromeObjectEvent.prototype.addListener = function(callback) {};
+
+
+/**
+ * @param {function(!Object): void} callback Callback.
+ * @return {undefined}
+ */
+ChromeObjectEvent.prototype.removeListener = function(callback) {};
+
+
+/**
+ * @param {function(!Object): void} callback Callback.
+ * @return {boolean}
+ */
+ChromeObjectEvent.prototype.hasListener = function(callback) {};
+
+
+/**
+ * @return {boolean}
+ */
+ChromeObjectEvent.prototype.hasListeners = function() {};
+
+
+
+/**
+ * Event whose listeners take a string array parameter.
+ * @constructor
+ */
+function ChromeStringArrayEvent() {}
+
+
+/**
+ * @param {function(!Array<string>): void} callback
+ * @return {undefined}
+ */
+ChromeStringArrayEvent.prototype.addListener = function(callback) {};
+
+
+/**
+ * @param {function(!Array<string>): void} callback
+ * @return {undefined}
+ */
+ChromeStringArrayEvent.prototype.removeListener = function(callback) {};
+
+
+/**
+ * @param {function(!Array<string>): void} callback
+ * @return {boolean}
+ */
+ChromeStringArrayEvent.prototype.hasListener = function(callback) {};
+
+
+/** @return {boolean} */
+ChromeStringArrayEvent.prototype.hasListeners = function() {};
+
+
+
+/**
+ * Event whose listeners take two strings as parameters.
+ * @constructor
+ */
+function ChromeStringStringEvent() {}
+
+
+/**
+ * @param {function(string, string): void} callback
+ * @return {undefined}
+ */
+ChromeStringStringEvent.prototype.addListener = function(callback) {};
+
+
+/**
+ * @param {function(string, string): void} callback
+ * @return {undefined}
+ */
+ChromeStringStringEvent.prototype.removeListener = function(callback) {};
+
+
+/**
+ * @param {function(string, string): void} callback
+ * @return {boolean}
+ */
+ChromeStringStringEvent.prototype.hasListener = function(callback) {};
+
+
+/** @return {boolean} */
+ChromeStringStringEvent.prototype.hasListeners = function() {};
+
+
+
+/**
+ * @see http://developer.chrome.com/extensions/runtime.html#type-MessageSender
+ * @constructor
+ */
+function MessageSender() {}
+
+
+/** @type {!Tab|undefined} */
+MessageSender.prototype.tab;
+
+
+/** @type {number|undefined} */
+MessageSender.prototype.frameId;
+
+
+/** @type {string|undefined} */
+MessageSender.prototype.id;
+
+
+/** @type {string|undefined} */
+MessageSender.prototype.url;
+
+
+/** @type {string|undefined} */
+MessageSender.prototype.tlsChannelId;
+
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/tabs#type-MutedInfoReason
+ */
+var MutedInfoReason = {
+  USER: '',
+  CAPTURE: '',
+  EXTENSION: '',
+};
+
+
+/**
+ * @see https://developer.chrome.com/extensions/tabs#type-MutedInfo
+ * @constructor
+ */
+var MutedInfo = function() {};
+
+
+/** @type {boolean} */
+MutedInfo.prototype.muted;
+
+
+/** @type {!MutedInfoReason|string|undefined} */
+MutedInfo.prototype.reason;
+
+
+/** @type {string|undefined} */
+MutedInfo.prototype.extensionId;
+
+
+
+
+/**
+ * @see https://developer.chrome.com/extensions/tabs#type-Tab
+ * @constructor
+ */
+function Tab() {}
+
+
+// TODO: Make this field optional once dependent projects have been updated.
+/** @type {number} */
+Tab.prototype.id;
+
+
+/** @type {number} */
+Tab.prototype.index;
+
+
+/** @type {number} */
+Tab.prototype.windowId;
+
+
+// TODO: Make this field optional once dependent projects have been updated.
+/** @type {number} */
+Tab.prototype.openerTabId;
+
+
+/** @type {boolean} */
+Tab.prototype.highlighted;
+
+
+/** @type {boolean} */
+Tab.prototype.active;
+
+
+/** @type {boolean} */
+Tab.prototype.pinned;
+
+
+/** @type {boolean|undefined} */
+Tab.prototype.audible;
+
+
+/** @type {boolean} */
+Tab.prototype.discarded;
+
+
+/** @type {boolean} */
+Tab.prototype.autoDiscardable;
+
+
+/** @type {!MutedInfo|undefined} */
+Tab.prototype.mutedInfo;
+
+
+// TODO: Make this field optional once dependent projects have been updated.
+/** @type {string} */
+Tab.prototype.url;
+
+
+// TODO: Make this field optional once dependent projects have been updated.
+/** @type {string} */
+Tab.prototype.title;
+
+
+// TODO: Make this field optional once dependent projects have been updated.
+/** @type {string} */
+Tab.prototype.favIconUrl;
+
+
+// TODO: Make this field optional once dependent projects have been updated.
+/** @type {string} */
+Tab.prototype.status;
+
+
+/** @type {boolean} */
+Tab.prototype.incognito;
+
+
+/** @type {number|undefined} */
+Tab.prototype.width;
+
+
+/** @type {number|undefined} */
+Tab.prototype.height;
+
+
+/** @type {string|undefined} */
+Tab.prototype.sessionId;
+
+
+/** @const */
+chrome.app = {};
+
+/**
+ * @see https://developer.chrome.com/webstore/inline_installation#already-installed
+ * @type {boolean}
+ */
+chrome.app.isInstalled;
+
+/**
+ * @const
+ * @see https://developer.chrome.com/apps/webstore
+ */
+chrome.webstore = {};
+
+
+/**
+ * @param {string|function()|function(string, string=)=}
+ *     opt_urlOrSuccessCallbackOrFailureCallback Either the URL to install or
+ *     the succcess callback taking no arg or the failure callback taking an
+ *     error string arg.
+ * @param {function()|function(string, string=)=}
+ *     opt_successCallbackOrFailureCallback Either the succcess callback taking
+ *     no arg or the failure callback taking an error string arg.
+ * @param {function(string, string=)=} opt_failureCallback The failure callback.
+ * @return {undefined}
+ */
+chrome.webstore.install = function(
+    opt_urlOrSuccessCallbackOrFailureCallback,
+    opt_successCallbackOrFailureCallback,
+    opt_failureCallback) {};
+
+
+/** @type {!ChromeStringEvent} */
+chrome.webstore.onInstallStageChanged;
+
+
+/** @type {!ChromeNumberEvent} */
+chrome.webstore.onDownloadProgress;
+
+
+/**
+ * @see https://developer.chrome.com/extensions/runtime.html
+ * @const
+ */
+chrome.runtime = {};
+
+
+/** @type {!Object|undefined} */
+chrome.runtime.lastError = {};
+
+
+/** @type {string|undefined} */
+chrome.runtime.lastError.message;
+
+
+/**
+ * @param {string|!Object=} opt_extensionIdOrConnectInfo Either the
+ *     extensionId to connect to, in which case connectInfo params can be
+ *     passed in the next optional argument, or the connectInfo params.
+ * @param {!Object=} opt_connectInfo The connectInfo object,
+ *     if arg1 was the extensionId to connect to.
+ * @return {!Port} New port.
+ */
+chrome.runtime.connect = function(
+    opt_extensionIdOrConnectInfo, opt_connectInfo) {};
+
+
+/**
+ * @param {string|*} extensionIdOrMessage Either the extensionId to send the
+ *     message to, in which case the message is passed as the next arg, or the
+ *     message itself.
+ * @param {(*|!Object|function(*): void)=} opt_messageOrOptsOrCallback
+ *     One of:
+ *     The message, if arg1 was the extensionId.
+ *     The options for message sending, if arg1 was the message and this
+ *     argument is not a function.
+ *     The callback, if arg1 was the message and this argument is a function.
+ * @param {(!Object|function(*): void)=} opt_optsOrCallback
+ *     Either the options for message sending, if arg2 was the message,
+ *     or the callback.
+ * @param {function(*): void=} opt_callback The callback function which
+ *     takes a JSON response object sent by the handler of the request.
+ * @return {undefined}
+ */
+chrome.runtime.sendMessage = function(
+    extensionIdOrMessage, opt_messageOrOptsOrCallback, opt_optsOrCallback,
+    opt_callback) {};
+
+
+/**
+ * Returns an object representing current load times. Note that the properties
+ * on the object do not change and the function must be called again to get
+ * up-to-date data.
+ *
+ * @return {!ChromeLoadTimes}
+ */
+chrome.loadTimes = function() {};
+
+
+
+/**
+ * The data object given by chrome.loadTimes().
+ * @constructor
+ */
+function ChromeLoadTimes() {}
+
+
+/** @type {number} */
+ChromeLoadTimes.prototype.requestTime;
+
+
+/** @type {number} */
+ChromeLoadTimes.prototype.startLoadTime;
+
+
+/** @type {number} */
+ChromeLoadTimes.prototype.commitLoadTime;
+
+
+/** @type {number} */
+ChromeLoadTimes.prototype.finishDocumentLoadTime;
+
+
+/** @type {number} */
+ChromeLoadTimes.prototype.finishLoadTime;
+
+
+/** @type {number} */
+ChromeLoadTimes.prototype.firstPaintTime;
+
+
+/** @type {number} */
+ChromeLoadTimes.prototype.firstPaintAfterLoadTime;
+
+
+/** @type {number} */
+ChromeLoadTimes.prototype.navigationType;
+
+
+/**
+ * True iff the resource was fetched over SPDY.
+ * @type {boolean}
+ */
+ChromeLoadTimes.prototype.wasFetchedViaSpdy;
+
+
+/** @type {boolean} */
+ChromeLoadTimes.prototype.wasNpnNegotiated;
+
+
+/** @type {string} */
+ChromeLoadTimes.prototype.npnNegotiatedProtocol;
+
+
+/** @type {boolean} */
+ChromeLoadTimes.prototype.wasAlternateProtocolAvailable;
+
+
+/** @type {string} */
+ChromeLoadTimes.prototype.connectionInfo;
+
+
+/**
+ * Returns an object containing timing information.
+ * @return {!ChromeCsiInfo}
+ */
+chrome.csi = function() {};
+
+
+
+/**
+ * The data object given by chrome.csi().
+ * @constructor
+ */
+function ChromeCsiInfo() {}
+
+
+/**
+ * Same as chrome.loadTimes().requestTime, if defined.
+ * Otherwise, gives the same value as chrome.loadTimes().startLoadTime.
+ * In milliseconds, truncated.
+ * @type {number}
+ */
+ChromeCsiInfo.prototype.startE;
+
+
+/**
+ * Same as chrome.loadTimes().finishDocumentLoadTime but in milliseconds and
+ * truncated.
+ * @type {number}
+ */
+ChromeCsiInfo.prototype.onloadT;
+
+
+/**
+ * The time since startE in milliseconds.
+ * @type {number}
+ */
+ChromeCsiInfo.prototype.pageT;
+
+
+/** @type {number} */
+ChromeCsiInfo.prototype.tran;
+
+
+/**
+ * @param {string|!ArrayBuffer|!Object} message
+ * @see https://developers.google.com/native-client/devguide/tutorial
+ * @return {undefined}
+ */
+HTMLEmbedElement.prototype.postMessage = function(message) {};

package/contrib/externs/chrome_extensions.js

@@ -2184,6 +2184,22 @@ chrome.copresence.onStatusUpdated;
 chrome.enterprise = {};
 
 
+/**
+ * @constructor
+ * deviceAttributes allows for reading device attributes.
+ * @see https://developer.chrome.com/extensions/enterprise_deviceAttributes.
+ */
+chrome.enterprise.deviceAttributes = function() {};
+
+
+/**
+ * @param {function(string): void} callback Called with the device identifier
+ *     of the directory API when received.
+ * @return {undefined}
+ */
+chrome.enterprise.deviceAttributes.getDirectoryDeviceId = function(callback) {};
+
+
 /**
  * @constructor
  * platformKeys allows for generating hardware-backed keys and the installation
@@ -2449,9 +2465,16 @@ chrome.runtime.openOptionsPage = function(opt_callback) {};
 
 /**
  * Manifest information returned from chrome.runtime.getManifest. See
- * http://developer.chrome.com/extensions/manifest.html. Note that there are
- * several other fields not included here. They should be added to these externs
- * as needed.
+ * https://developer.chrome.com/extensions/manifest.html and
+ * https://developer.chrome.com/apps/manifest.html
+ *
+ * Note that:
+ * 1) There are several other fields not included here. They should be
+ *    added to these externs as needed.
+ * 2) There are some distinct fields for app vs extension manifests. The
+ *    below manifest definition contains the union of all fields; unique
+ *    fields should be annotated as such (see e.g. kiosk_only property
+ *    below).
  * @constructor
  */
 chrome.runtime.Manifest = function() {};
@@ -2481,6 +2504,14 @@ chrome.runtime.Manifest.prototype.oauth2;
 chrome.runtime.Manifest.prototype.permissions;
 
 
+/**
+ * App-only manifest field.
+ * @see https://developer.chrome.com/apps/manifest
+ * @type {boolean|undefined}
+ */
+chrome.runtime.Manifest.prototype.kiosk_only;
+
+
 
 /**
  * Oauth2 info in the manifest.
@@ -2499,7 +2530,8 @@ chrome.runtime.Manifest.Oauth2.prototype.scopes;
 
 
 /**
- * http://developer.chrome.com/extensions/runtime.html#method-getManifest
+ * https://developer.chrome.com/extensions/runtime.html#method-getManifest
+ * https://developer.chrome.com/apps/runtime#method-getManifest
  * @return {!chrome.runtime.Manifest} The full manifest file of the app or
  *     extension.
  */
@@ -6574,12 +6606,9 @@ WebRequestOptionallySynchronousEvent.prototype.hasListener = function(
 
 
 /**
- * @param {function(!Object): (undefined|!BlockingResponse)} listener Listener
- *     function.
- * @return {undefined}
+ * @return {boolean}
  */
-WebRequestOptionallySynchronousEvent.prototype.hasListeners = function(
-    listener) {};
+WebRequestOptionallySynchronousEvent.prototype.hasListeners = function() {};
 
 
 /**

package/contrib/externs/google_youtube_iframe.js

@@ -42,40 +42,78 @@ var YT = {};
 YT.Player = function(container, opts) {};
 
 
+/** @typedef {!{
+ *    videoId: string,
+ *    startSeconds: (number|undefined),
+ *    endSeconds: (number|undefined),
+ *    suggestedQuality: (string|undefined),
+ *  }} */
+YT.Player.VideoIdParams;
+
+
 /**
- * @param {string} videoId
- * @param {number=} startSeconds
- * @param {string=} suggestedQuality
+ * Loads the specified video's thumbnail and prepares the player to play the
+ * video.
+ * @param {!YT.Player.VideoIdParams|string} videoIdOrObject YouTube Video ID or
+ *     parameters object.
+ * @param {number=} opt_startSeconds Float/integer that specifies the time
+ *     from which the video should start playing.
+ * @param {string=} opt_suggestedQuality The suggested playback quality for
+ *     the video.
  */
-YT.Player.prototype.cueVideoById =
-    function(videoId, startSeconds, suggestedQuality) {};
+YT.Player.prototype.cueVideoById = function(
+    videoIdOrObject, opt_startSeconds, opt_suggestedQuality) {};
 
 
 /**
- * @param {string} videoId
- * @param {number=} startSeconds
- * @param {string=} suggestedQuality
+ * Loads and plays the specified video.
+ * @param {!YT.Player.VideoIdParams|string} videoIdOrObject YouTube Video ID or
+ *     parameters object.
+ * @param {number=} opt_startSeconds Float/integer that specifies the time
+ *     from which the video should start playing.
+ * @param {string=} opt_suggestedQuality The suggested playback quality for
+ *     the video.
  */
-YT.Player.prototype.loadVideoById =
-    function(videoId, startSeconds, suggestedQuality) {};
+YT.Player.prototype.loadVideoById = function(
+    videoIdOrObject, opt_startSeconds, opt_suggestedQuality) {};
+
+
+/** @typedef {!{
+ *    mediaContentUrl: string,
+ *    startSeconds: (number|undefined),
+ *    endSeconds: (number|undefined),
+ *    suggestedQuality: (string|undefined),
+ *  }} */
+YT.Player.MediaContentUrlParams;
 
 
 /**
- * @param {string} mediaContentUrl
- * @param {number} startSeconds
- * @param {string=} suggestedQuality
+ * Loads the specified video's thumbnail and prepares the player to play the
+ * video.
+ * @param {!YT.Player.MediaContentUrlParams|string} mediaContentUrlOrObject
+ *     YouTube player URL in the format http://www.youtube.com/v/VIDEO_ID or
+ *     parameters object.
+ * @param {number=} opt_startSeconds Float/integer that specifies the time
+ *     from which the video should start playing.
+ * @param {string=} opt_suggestedQuality The suggested playback quality for
+ *     the video.
  */
-YT.Player.prototype.cueVideoByUrl =
-    function(mediaContentUrl, startSeconds, suggestedQuality) {};
+YT.Player.prototype.cueVideoByUrl = function(
+    mediaContentUrlOrObject, opt_startSeconds, opt_suggestedQuality) {};
 
 
 /**
- * @param {string} mediaContentUrl
- * @param {number} startSeconds
- * @param {string=} suggestedQuality
+ * Loads and plays the specified video.
+ * @param {!YT.Player.MediaContentUrlParams|string} mediaContentUrlOrObject
+ *     YouTube player URL in the format http://www.youtube.com/v/VIDEO_ID or
+ *     parameters object.
+ * @param {number=} opt_startSeconds Float/integer that specifies the time
+ *     from which the video should start playing.
+ * @param {string=} opt_suggestedQuality The suggested playback quality for
+ *     the video.
  */
-YT.Player.prototype.loadVideoByUrl =
-    function(mediaContentUrl, startSeconds, suggestedQuality) {};
+YT.Player.prototype.loadVideoByUrl = function(
+    mediaContentUrlOrObject, opt_startSeconds, opt_suggestedQuality) {};
 
 
 /**
@@ -282,6 +320,13 @@ YT.Player.prototype.addEventListener = function(eventName, listenerName) {};
 YT.Player.prototype.destroy = function() {};
 
 
+/**
+ * @return {HTMLIFrameElement} The DOM node for the embedded iframe.
+ * @nosideeffects
+ */
+YT.Player.prototype.getIframe = function() {};
+
+
 /**
  * @return {number}
  * @nosideeffects

package/contrib/externs/maps/google_maps_api_v3.js

@@ -636,7 +636,7 @@ google.maps.Data.LinearRing.prototype.getType = function() {};
 
 /**
  * @extends {google.maps.MouseEvent}
- * @constructor
+ * @record
  */
 google.maps.Data.MouseEvent = function() {};
 
@@ -2206,7 +2206,7 @@ google.maps.Icon.prototype.url;
 
 /**
  * @extends {google.maps.MouseEvent}
- * @constructor
+ * @record
  */
 google.maps.IconMouseEvent = function() {};
 
@@ -2957,7 +2957,7 @@ google.maps.MVCObject.prototype.notify = function(key) {};
 
 /**
  * @param {string} key
- * @param {*} value
+ * @param {?} value
  * @return {undefined}
  */
 google.maps.MVCObject.prototype.set = function(key, value) {};
@@ -3522,7 +3522,7 @@ google.maps.MapsEventListener = function() {};
 google.maps.MapsEventListener.prototype.remove = function() {};
 
 /**
- * @param {(google.maps.MarkerOptions|Object.<string>)=} opt_opts
+ * @param {(google.maps.MarkerOptions|Object<string, ?>)=} opt_opts
  * @extends {google.maps.MVCObject}
  * @constructor
  */

package/contrib/externs/maps/google_maps_api_v3_28.js

@@ -636,7 +636,7 @@ google.maps.Data.LinearRing.prototype.getType = function() {};
 
 /**
  * @extends {google.maps.MouseEvent}
- * @constructor
+ * @record
  */
 google.maps.Data.MouseEvent = function() {};
 
@@ -2206,7 +2206,7 @@ google.maps.Icon.prototype.url;
 
 /**
  * @extends {google.maps.MouseEvent}
- * @constructor
+ * @record
  */
 google.maps.IconMouseEvent = function() {};
 
@@ -2957,7 +2957,7 @@ google.maps.MVCObject.prototype.notify = function(key) {};
 
 /**
  * @param {string} key
- * @param {*} value
+ * @param {?} value
  * @return {undefined}
  */
 google.maps.MVCObject.prototype.set = function(key, value) {};

package/contrib/externs/maps/google_maps_api_v3_29.js

@@ -2957,7 +2957,7 @@ google.maps.MVCObject.prototype.notify = function(key) {};
 
 /**
  * @param {string} key
- * @param {*} value
+ * @param {?} value
  * @return {undefined}
  */
 google.maps.MVCObject.prototype.set = function(key, value) {};

package/contrib/externs/maps/google_maps_api_v3_exp.js

@@ -2957,7 +2957,7 @@ google.maps.MVCObject.prototype.notify = function(key) {};
 
 /**
  * @param {string} key
- * @param {*} value
+ * @param {?} value
  * @return {undefined}
  */
 google.maps.MVCObject.prototype.set = function(key, value) {};

package/contrib/externs/polymer-1.0.js

@@ -159,6 +159,21 @@ PolymerElement.prototype.hostAttributes;
  */
 PolymerElement.prototype.listeners;
 
+/**
+ * Force this element to distribute its children to its local dom.
+ * A user should call `distributeContent` if distribution has been
+ * invalidated due to changes to selectors on child elements that
+ * effect distribution that were not made via `Polymer.dom`.
+ * For example, if an element contains an insertion point with
+ * `<content select=".foo">` and a `foo` class is added to a child,
+ * then `distributeContent` must be called to update
+ * local dom distribution.
+ * @param {boolean} updateInsertionPoints Shady DOM does not detect
+ *   <content> insertion that is nested in a sub-tree being appended.
+ *   Set to true to distribute to newly added nested <content>'s.
+ */
+PolymerElement.prototype.distributeContent = function(updateInsertionPoints) {};
+
 /**
  * Return the element whose local dom within which this element is contained.
  * @type {?Element}
@@ -564,6 +579,13 @@ Polymer.Base.get = function(path, root) {};
  */
 Polymer.Base.fire = function(type, detail, options) {};
 
+/**
+ * For Polymer internal use only, except for
+ * github.com/Polymer/polymer/issues/4138
+ * @type {!function (!Node, ?string, *, ?Object)}
+ */
+Polymer.Base._computeFinalAnnotationValue;
+
 /**
  * @param {...*} var_args
  * For Polymer-internal use only.

package/contrib/externs/sinon-1.17.js

@@ -719,12 +719,17 @@ sinon.match.has = function(property, expect) {};
  */
 sinon.match.hasOwn = function(property, expect) {};
 
-sinon.clock = {};
+/**
+ * @interface
+ */
+var SinonClock = function() {};
 
 /**
  * @param {!number} ticks
  */
-sinon.clock.tick = function(ticks) {};
+SinonClock.prototype.tick = function(ticks) {};
+
+SinonClock.prototype.restore = function() {};
 
 sinon.sandbox = {};
 
@@ -765,7 +770,7 @@ SinonSandbox.prototype.stub = function(obj, method, func) {};
 
 /**
  * @param {...?} params
- * @return {Object}
+ * @return {SinonClock}
  */
 SinonSandbox.prototype.useFakeTimers = function(params) {};
 
@@ -841,6 +846,6 @@ SinonFakeXmlHttpRequest.prototype.respond = function(status, headers, body) {};
 
 /**
  * @param {...?} params
- * @return {Object}
+ * @return {SinonClock}
  */
 sinon.useFakeTimers = function(params) {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "google-closure-compiler",
-  "version": "20170806.0.0",
+  "version": "20170910.0.0",
   "description": "Check, compile, optimize and compress Javascript with Closure-Compiler",
   "repository": {
     "type": "git",