google-closure-compiler 20161024.3.0 → 20170409.0.0

package/contrib/externs/angular-1.6-mocks.js

@@ -0,0 +1,267 @@
+/*
+ * Copyright 2012 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 Externs for v1_4 ngMock angular-mocks.js.
+ * @externs
+ *
+ * TODO: Remaining Mocks:
+ *     $browser
+ *     $exceptionHandler
+ *     $log
+ *     angular.mock.TzDate
+ *     angular.mock.dump
+ *     $RAFDecorator
+ *     $AsyncCallbackDecorator
+ *     $RootElementProvider
+ *     $httpBackendDecorator
+ *     $RootScopeDecorator
+ *     angular.mock.module
+ */
+
+angular.mock = {};
+
+
+
+/** @constructor */
+angular.mock.$httpBackend = function() {};
+
+
+
+/** @constructor */
+angular.mock.$httpBackend.RequestHandler = function() {};
+
+
+/**
+ * @param {(number|string|Object|function(string, string, Object, string):
+ *     !Array.<(number|string|Object)>)} statusOrDataOrFunction
+ * @param {(string|Object)=} opt_dataOrHeaders
+ * @param {(Object|string)=} opt_headersOrStatusText
+ * @param {string=} opt_statusText
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.RequestHandler.prototype.respond = function(
+    statusOrDataOrFunction, opt_dataOrHeaders, opt_headersOrStatusText,
+    opt_statusText) {};
+
+
+/** @return {!angular.mock.$httpBackend.RequestHandler} */
+angular.mock.$httpBackend.RequestHandler.prototype.passThrough = function() {};
+
+
+/**
+ * @param {string} method
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(string|RegExp|function(string): boolean)=} opt_data
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.when = function(
+    method, url, opt_data, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.whenGET = function(url, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.whenHEAD = function(url, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.whenDELETE = function(url, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(string|RegExp|function(string): boolean)=} opt_data
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.whenPOST = function(
+    url, opt_data, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(string|RegExp|function(string): boolean)=} opt_data
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.whenPUT = function(
+    url, opt_data, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(string|RegExp|function(string): boolean)=} opt_data
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.whenPATCH = function(
+    url, opt_data, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.whenJSONP = function(url) {};
+
+
+/**
+ * @param {string} method
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(string|RegExp|function(string): boolean|Object)=} opt_data
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.expect = function(
+    method, url, opt_data, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.expectGET = function(url, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.expectHEAD = function(url, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.expectDELETE = function(
+    url, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(string|RegExp|function(string): boolean|Object)=} opt_data
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.expectPOST = function(
+    url, opt_data, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(string|RegExp|function(string): boolean|Object)=} opt_data
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.expectPUT = function(
+    url, opt_data, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @param {(string|RegExp|function(string): boolean|Object)=} opt_data
+ * @param {(Object|function(Object): boolean)=} opt_headers
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.expectPATCH = function(
+    url, opt_data, opt_headers) {};
+
+
+/**
+ * @param {(string|RegExp|function(string): boolean)} url
+ * @return {!angular.mock.$httpBackend.RequestHandler}
+ */
+angular.mock.$httpBackend.prototype.expectJSONP = function(url) {};
+
+
+/**
+ * @param {number=} opt_count
+ * @return {void}
+ */
+angular.mock.$httpBackend.prototype.flush = function(opt_count) {};
+
+
+/** @return {void} */
+angular.mock.$httpBackend.prototype.verifyNoOutstandingExpectation =
+    function() {};
+
+
+/** @return {void} */
+angular.mock.$httpBackend.prototype.verifyNoOutstandingRequest = function() {};
+
+
+/** @return {void} */
+angular.mock.$httpBackend.prototype.resetExpectations = function() {};
+
+/** @constructor */
+angular.mock.$interval = function() {};
+
+/**
+ * @param {!angular.$q.Promise} promise
+ * @return {boolean}
+ */
+angular.mock.$interval.prototype.cancel = function(promise) {};
+
+/**
+ * @param {number=} opt_millis
+ * @return {number}
+ */
+angular.mock.$interval.prototype.flush = function(opt_millis) {};
+
+/** @constructor */
+angular.mock.$TimeoutDecorator = function() {};
+
+
+/** @param {number=} opt_delay */
+angular.mock.$TimeoutDecorator.prototype.flush = function(opt_delay) {};
+
+
+angular.mock.$TimeoutDecorator.prototype.verifyNoPendingTasks = function() {};
+
+
+/** @constructor */
+angular.mock.animate = function() {};
+
+
+angular.mock.animate.prototype.flush = function() {};
+
+
+/** @typedef {function((!Function|string), !Object, Object=): !Object} */
+angular.mock.$controller;
+
+
+/** @param {!Array|!Function} injectable */
+angular.mock.inject = function(injectable) {};

package/contrib/externs/angular-1.6-q_templated.js

@@ -0,0 +1,194 @@
+/*
+ * Copyright 2014 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 Externs for the $q service in Angular 1.4
+ * NOTE: Due to a JS compiler bug, any use of a templated class must occur after
+ * the class is defined. Please be careful with the ordering of the classes and
+ * functions.
+ * @see https://docs.angularjs.org/api/ng/service/$q
+ * @externs
+ */
+
+/******************************************************************************
+ * $q Service
+ *****************************************************************************/
+
+/**
+ * @interface
+ */
+angular.$q = function() {};
+
+/**
+ * @interface
+ * @template T
+ */
+angular.$q.Promise = function() {};
+
+/**
+ * Apply Type Transformation Language to allow more accurate templated type
+ * definition.
+ * This is copied from <code>goog.Thenable.prototype.then</code>, with the only
+ * difference being the raw type as angular.$q.Promise instead of goog.Promise.
+ *
+ * @param {?(function(this:THIS, T): VALUE)=} opt_onFulfilled
+ * @param {?(function(?): ?)=} opt_onRejected
+ * @param {?(function(?): ?)=} opt_notifyCallback
+ * @return {RESULT}
+ * @template THIS
+ * @template VALUE
+ * @template RESULT := type('angular.$q.Promise',
+ *     cond(isUnknown(VALUE), unknown(),
+ *       mapunion(VALUE, (V) =>
+ *         cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
+ *           templateTypeOf(V, 0),
+ *           cond(sub(V, 'angular.$q.Promise'),
+ *              unknown(),
+ *              V)))))
+ *  =:
+ */
+angular.$q.Promise.prototype.then = function(
+    opt_onFulfilled, opt_onRejected, opt_notifyCallback) {};
+
+/**
+ * @param {?function(?)} callback
+ * @return {!angular.$q.Promise.<T>}
+ */
+angular.$q.Promise.prototype.catch = function(callback) {};
+
+/**
+ * @param {?function(?)} callback
+ * @param {?(function(?): ?)=} opt_notifyCallback
+ * @return {!angular.$q.Promise.<T>}
+ */
+angular.$q.Promise.prototype.finally = function(callback, opt_notifyCallback) {
+};
+
+/**
+ * @interface
+ * @template T
+ */
+angular.$q.Deferred = function() {};
+
+/** @param {T=} opt_value */
+angular.$q.Deferred.prototype.resolve = function(opt_value) {};
+
+/** @param {?=} opt_reason */
+angular.$q.Deferred.prototype.reject = function(opt_reason) {};
+
+/** @param {?=} opt_value */
+angular.$q.Deferred.prototype.notify = function(opt_value) {};
+
+/** @type {!angular.$q.Promise.<T>} */
+angular.$q.Deferred.prototype.promise;
+
+/**
+ * $q.all has different output type based on the input type.
+ * When {@code promise} is an array, the output is an array too: for each item n
+ * in the input array, the corresponding item in the returned array would be the
+ * the same type of n, or if n is a templated $q.Promise, the type of the
+ * resolve value.
+ * When {@code promise} is in form of a record, the output should be also be a
+ * record with the same properties.
+ * When {@code promise} is other forms, the returned type is an Object.
+ *
+ * @param {VALUE} promises
+ * @template VALUE
+ * @return {ALLTYPE}
+ * @template ALLTYPE := type('angular.$q.Promise',
+ *   cond(isUnknown(VALUE), unknown(),
+ *     mapunion(VALUE, (x) =>
+ *       cond(sub(x, 'Array'),
+ *         cond(isTemplatized(x) && sub(rawTypeOf(x), 'IThenable'),
+ *           type('Array', templateTypeOf(x, 0)),
+ *           'Array'
+ *         ),
+ *         cond(isRecord(x),
+ *           maprecord(record(x), (kx, vx) => record({[kx]:
+ *             cond(isTemplatized(vx) && sub(rawTypeOf(vx), 'IThenable'),
+ *               templateTypeOf(vx, 0),
+ *               cond(sub(vx, 'angular.$q.Promise'),
+ *                 unknown(),
+ *                 vx
+ *               )
+ *             )
+ *           })),
+ *           'Object')))))
+ * =:
+ */
+angular.$q.prototype.all = function(promises) {};
+
+/**
+ * @param {!Array<!angular.$q.Promise>|!Object<string,!angular.$q.Promise>}
+ *     promises
+ * @return {!angular.$q.Promise}
+ */
+angular.$q.prototype.race = function(promises) {};
+
+/**
+ * @return {!angular.$q.Deferred}
+ */
+angular.$q.prototype.defer = function() {};
+
+/**
+ * @param {?=} opt_reason
+ * @return {!angular.$q.Promise}
+ */
+angular.$q.prototype.reject = function(opt_reason) {};
+
+/**
+ * @see "https://github.com/google/closure-compiler/commit/be3f15e58812b0843ad0ccc0bcddb5a1506d56e8"
+ * @param {VALUE=} opt_value
+ * @param {Function=} opt_successCallback
+ * @param {Function=} opt_errorCallback
+ * @param {Function=} opt_progressCallback
+ * @return {RESULT}
+ * @template VALUE
+ * @template RESULT := type('angular.$q.Promise',
+ *     cond(isUnknown(VALUE),
+ *       unknown(),
+ *       mapunion(VALUE, (V) =>
+ *         cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
+ *           templateTypeOf(V, 0),
+ *           cond(sub(V, 'Thenable'),
+ *              unknown(),
+ *              V)))))
+ * =:
+ */
+angular.$q.prototype.when = function(
+    opt_value, opt_successCallback, opt_errorCallback, opt_progressCallback) {};
+
+/**
+ * @see "https://github.com/google/closure-compiler/commit/be3f15e58812b0843ad0ccc0bcddb5a1506d56e8"
+ * @param {VALUE=} opt_value
+ * @param {Function=} opt_successCallback
+ * @param {Function=} opt_errorCallback
+ * @param {Function=} opt_progressCallback
+ * @return {RESULT}
+ * @template VALUE
+ * @template RESULT := type('angular.$q.Promise',
+ *     cond(isUnknown(VALUE),
+ *       unknown(),
+ *       mapunion(VALUE, (V) =>
+ *         cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
+ *           templateTypeOf(V, 0),
+ *           cond(sub(V, 'Thenable'),
+ *              unknown(),
+ *              V)))))
+ * =:
+ */
+angular.$q.prototype.resolve = function(
+    opt_value, opt_successCallback, opt_errorCallback, opt_progressCallback) {};