@angular-wave/angular.ts 0.0.38 → 0.0.40

package/types/core/location/location.d.ts

@@ -0,0 +1,209 @@
+/**
+ *
+ * @param {string} base
+ * @param {string} url
+ * @returns {string} returns text from `url` after `base` or `undefined` if it does not begin with
+ *                   the expected string.
+ */
+export function stripBaseUrl(base: string, url: string): string;
+export function stripHash(url: any): any;
+export function stripFile(url: any): any;
+export function serverBase(url: any): any;
+/**
+ * LocationHtml5Url represents a URL
+ * This object is exposed as $location service when HTML5 mode is enabled and supported
+ *
+ * @constructor
+ * @param {string} appBase application base URL
+ * @param {string} appBaseNoFile application base URL stripped of any filename
+ * @param {string} basePrefix URL path prefix
+ */
+export function LocationHtml5Url(appBase: string, appBaseNoFile: string, basePrefix: string): void;
+export class LocationHtml5Url {
+    /**
+     * LocationHtml5Url represents a URL
+     * This object is exposed as $location service when HTML5 mode is enabled and supported
+     *
+     * @constructor
+     * @param {string} appBase application base URL
+     * @param {string} appBaseNoFile application base URL stripped of any filename
+     * @param {string} basePrefix URL path prefix
+     */
+    constructor(appBase: string, appBaseNoFile: string, basePrefix: string);
+    $$html5: boolean;
+    /**
+     * Parse given HTML5 (regular) URL string into properties
+     * @param {string} url HTML5 URL
+     * @private
+     */
+    private $$parse;
+    $$normalizeUrl: (url: any) => string;
+    $$parseLinkUrl: (url: any, relHref: any) => boolean;
+}
+/**
+ * LocationHashbangUrl represents URL
+ * This object is exposed as $location service when developer doesn't opt into html5 mode.
+ * It also serves as the base class for html5 mode fallback on legacy browsers.
+ *
+ * @constructor
+ * @param {string} appBase application base URL
+ * @param {string} appBaseNoFile application base URL stripped of any filename
+ * @param {string} hashPrefix hashbang prefix
+ */
+export function LocationHashbangUrl(appBase: string, appBaseNoFile: string, hashPrefix: string): void;
+export class LocationHashbangUrl {
+    /**
+     * LocationHashbangUrl represents URL
+     * This object is exposed as $location service when developer doesn't opt into html5 mode.
+     * It also serves as the base class for html5 mode fallback on legacy browsers.
+     *
+     * @constructor
+     * @param {string} appBase application base URL
+     * @param {string} appBaseNoFile application base URL stripped of any filename
+     * @param {string} hashPrefix hashbang prefix
+     */
+    constructor(appBase: string, appBaseNoFile: string, hashPrefix: string);
+    /**
+     * Parse given hashbang URL into properties
+     * @param {string} url Hashbang URL
+     * @private
+     */
+    private $$parse;
+    $$normalizeUrl: (url: any) => string;
+    $$parseLinkUrl: (url: any) => boolean;
+}
+/**
+ * LocationHashbangUrl represents URL
+ * This object is exposed as $location service when html5 history api is enabled but the browser
+ * does not support it.
+ *
+ * @constructor
+ * @param {string} appBase application base URL
+ * @param {string} appBaseNoFile application base URL stripped of any filename
+ * @param {string} hashPrefix hashbang prefix
+ */
+export function LocationHashbangInHtml5Url(appBase: string, appBaseNoFile: string, hashPrefix: string, ...args: any[]): void;
+export class LocationHashbangInHtml5Url {
+    /**
+     * LocationHashbangUrl represents URL
+     * This object is exposed as $location service when html5 history api is enabled but the browser
+     * does not support it.
+     *
+     * @constructor
+     * @param {string} appBase application base URL
+     * @param {string} appBaseNoFile application base URL stripped of any filename
+     * @param {string} hashPrefix hashbang prefix
+     */
+    constructor(appBase: string, appBaseNoFile: string, hashPrefix: string, ...args: any[]);
+    $$html5: boolean;
+    $$parseLinkUrl: (url: any, relHref: any) => boolean;
+    $$normalizeUrl: (url: any) => string;
+}
+/**
+ * @ngdoc service
+ * @name $location
+ *
+ * @requires $rootElement
+ *
+ * @description
+ * The $location service parses the URL in the browser address bar (based on the
+ * [window.location](https://developer.mozilla.org/en/window.location)) and makes the URL
+ * available to your application. Changes to the URL in the address bar are reflected into
+ * $location service and changes to $location are reflected into the browser address bar.
+ *
+ * **The $location service:**
+ *
+ * - Exposes the current URL in the browser address bar, so you can
+ *   - Watch and observe the URL.
+ *   - Change the URL.
+ * - Synchronizes the URL with the browser when the user
+ *   - Changes the address bar.
+ *   - Clicks the back or forward button (or clicks a History link).
+ *   - Clicks on a link.
+ * - Represents the URL object as a set of methods (protocol, host, port, path, search, hash).
+ *
+ * For more information see {@link guide/$location Developer Guide: Using $location}
+ */
+/**
+ * @ngdoc provider
+ * @name $locationProvider
+ *
+ *
+ * @description
+ * Use the `$locationProvider` to configure how the application deep linking paths are stored.
+ */
+export function $LocationProvider(): void;
+export class $LocationProvider {
+    /**
+     * @ngdoc method
+     * @name $locationProvider#hashPrefix
+     * @description
+     * The default value for the prefix is `'!'`.
+     * @param {string=} prefix Prefix for hash part (containing path and search)
+     * @returns {*} current value if used as getter or itself (chaining) if used as setter
+     */
+    hashPrefix: (prefix?: string | undefined) => any;
+    /**
+     * @ngdoc method
+     * @name $locationProvider#html5Mode
+     * @description
+     * @param {(boolean|Object)=} mode If boolean, sets `html5Mode.enabled` to value.
+     *   If object, sets `enabled`, `requireBase` and `rewriteLinks` to respective values. Supported
+     *   properties:
+     *   - **enabled** – `{boolean}` – (default: false) If true, will rely on `history.pushState` to
+     *     change urls where supported. Will fall back to hash-prefixed paths in browsers that do not
+     *     support `pushState`.
+     *   - **requireBase** - `{boolean}` - (default: `true`) When html5Mode is enabled, specifies
+     *     whether or not a <base> tag is required to be present. If `enabled` and `requireBase` are
+     *     true, and a base tag is not present, an error will be thrown when `$location` is injected.
+     *     See the {@link guide/$location $location guide for more information}
+     *   - **rewriteLinks** - `{boolean|string}` - (default: `true`) When html5Mode is enabled,
+     *     enables/disables URL rewriting for relative links. If set to a string, URL rewriting will
+     *     only happen on links with an attribute that matches the given string. For example, if set
+     *     to `'internal-link'`, then the URL will only be rewritten for `<a internal-link>` links.
+     *     Note that [attribute name normalization](guide/directive#normalization) does not apply
+     *     here, so `'internalLink'` will **not** match `'internal-link'`.
+     *
+     * @returns {Object} html5Mode object if used as getter or itself (chaining) if used as setter
+     */
+    html5Mode: (mode?: (boolean | any) | undefined) => any;
+    /**
+     * @ngdoc event
+     * @name $location#$locationChangeStart
+     * @eventType broadcast on root scope
+     * @description
+     * Broadcasted before a URL will change.
+     *
+     * This change can be prevented by calling
+     * `preventDefault` method of the event. See {@link ng.$rootScope.Scope#$on} for more
+     * details about event object. Upon successful change
+     * {@link ng.$location#$locationChangeSuccess $locationChangeSuccess} is fired.
+     *
+     * The `newState` and `oldState` parameters may be defined only in HTML5 mode and when
+     * the browser supports the HTML5 History API.
+     *
+     * @param {Object} angularEvent Synthetic event object.
+     * @param {string} newUrl New URL
+     * @param {string=} oldUrl URL that was before it was changed.
+     * @param {string=} newState New history state object
+     * @param {string=} oldState History state object that was before it was changed.
+     */
+    /**
+     * @ngdoc event
+     * @name $location#$locationChangeSuccess
+     * @eventType broadcast on root scope
+     * @description
+     * Broadcasted after a URL was changed.
+     *
+     * The `newState` and `oldState` parameters may be defined only in HTML5 mode and when
+     * the browser supports the HTML5 History API.
+     *
+     * @param {Object} angularEvent Synthetic event object.
+     * @param {string} newUrl New URL
+     * @param {string=} oldUrl URL that was before it was changed.
+     * @param {string=} newState New history state object
+     * @param {string=} oldState History state object that was before it was changed.
+     */
+    $get: (string | (($rootScope: any, $browser: any, $rootElement: any) => LocationHtml5Url | LocationHashbangUrl))[];
+}
+export const PATH_MATCH: RegExp;

package/types/core/pubsub/pubsub.d.ts

@@ -0,0 +1,156 @@
+export class PubSub {
+    /**
+     * Runs a function asynchronously.
+     *
+     * @private
+     * @param {Function} fn Function to run.
+     * @param {Object} context Context in which to run the function.
+     * @param {Array} args Arguments to pass to the function.
+     */
+    private static runAsync_;
+    /**
+     * Topic-based publish/subscribe channel.  Maintains a map of topics to
+     * subscriptions.  When a message is published to a topic, all functions
+     * subscribed to that topic are invoked in the order they were added.
+     * Uncaught errors abort publishing.
+     *
+     * Topics may be identified by any nonempty string, <strong>except</strong>
+     * strings corresponding to native Object properties, e.g. "constructor",
+     * "toString", "hasOwnProperty", etc.
+     *
+     * @param {boolean=} opt_async Enable asynchronous behavior.  Recommended for
+     *     new code.  See notes on the publish() method.
+     */
+    constructor(opt_async?: boolean | undefined);
+    disposed: boolean;
+    /**
+     * The next available subscription key.  Internally, this is an index into the
+     * sparse array of subscriptions.
+     *
+     * @private {number}
+     */
+    private key;
+    /**
+     * Array of subscription keys pending removal once publishing is done.
+     *
+     * @private {!Array<number>}
+     * @const
+     */
+    private pendingKeys;
+    /**
+     * Lock to prevent the removal of subscriptions during publishing. Incremented
+     * at the beginning of {@link #publish}, and decremented at the end.
+     *
+     * @private {number}
+     */
+    private publishDepth;
+    /**
+     * Sparse array of subscriptions. Each subscription is represented by a tuple
+     * comprising a topic identifier, a function, and an optional context object.
+     * Each tuple occupies three consecutive positions in the array, with the
+     * topic identifier at index n, the function at index (n + 1), the context
+     * object at index (n + 2), the next topic at index (n + 3), etc. (This
+     * representation minimizes the number of object allocations and has been
+     * shown to be faster than an array of objects with three key-value pairs or
+     * three parallel arrays, especially on IE.) Once a subscription is removed
+     * via {@link #unsubscribe} or {@link #unsubscribeByKey}, the three
+     * corresponding array elements are deleted, and never reused. This means the
+     * total number of subscriptions during the lifetime of the pubsub channel is
+     * limited by the maximum length of a JavaScript array to (2^32 - 1) / 3 =
+     * 1,431,655,765 subscriptions, which should suffice for most applications.
+     *
+     * @private {!Array<?>}
+     * @const
+     */
+    private subscriptions;
+    /**
+     * Map of topics to arrays of subscription keys.
+     *
+     * @private {!Object<!Array<number>>}
+     */
+    private topics;
+    /**
+     * @private @const {boolean}
+     */
+    private async_;
+    /**
+     * Subscribes a function to a topic.  The function is invoked as a method on
+     * the given `opt_context` object, or in the global scope if no context
+     * is specified.  Subscribing the same function to the same topic multiple
+     * times will result in multiple function invocations while publishing.
+     * Returns a subscription key that can be used to unsubscribe the function from
+     * the topic via {@link #unsubscribeByKey}.
+     *
+     * @param {string} topic Topic to subscribe to.
+     * @param {Function} fn Function to be invoked when a message is published to
+     *     the given topic.
+     * @param {Object=} opt_context Object in whose context the function is to be
+     *     called (the global scope if none).
+     * @return {number} Subscription key.
+     */
+    subscribe(topic: string, fn: Function, opt_context?: any | undefined): number;
+    /**
+     * Subscribes a single-use function to a topic.  The function is invoked as a
+     * method on the given `opt_context` object, or in the global scope if
+     * no context is specified, and is then unsubscribed.  Returns a subscription
+     * key that can be used to unsubscribe the function from the topic via
+     * {@link #unsubscribeByKey}.
+     *
+     * @param {string} topic Topic to subscribe to.
+     * @param {Function} fn Function to be invoked once and then unsubscribed when
+     *     a message is published to the given topic.
+     * @param {Object=} opt_context Object in whose context the function is to be
+     *     called (the global scope if none).
+     * @return {number} Subscription key.
+     */
+    subscribeOnce(topic: string, fn: Function, opt_context?: any | undefined): number;
+    /**
+     * Unsubscribes a function from a topic.  Only deletes the first match found.
+     * Returns a Boolean indicating whether a subscription was removed.
+     *
+     * @param {string} topic Topic to unsubscribe from.
+     * @param {Function} fn Function to unsubscribe.
+     * @param {Object=} opt_context Object in whose context the function was to be
+     *     called (the global scope if none).
+     * @return {boolean} Whether a matching subscription was removed.
+     */
+    unsubscribe(topic: string, fn: Function, opt_context?: any | undefined): boolean;
+    /**
+     * Removes a subscription based on the key returned by {@link #subscribe}.
+     * No-op if no matching subscription is found.  Returns a Boolean indicating
+     * whether a subscription was removed.
+     *
+     * @param {number} key Subscription key.
+     * @return {boolean} Whether a matching subscription was removed.
+     */
+    unsubscribeByKey(key: number): boolean;
+    /**
+     * Publishes a message to a topic.  Calls functions subscribed to the topic in
+     * the order in which they were added, passing all arguments along.
+     *
+     * If this object was created with async=true, subscribed functions are called
+     * via setTimeout().  Otherwise, the functions are called directly, and if
+     * any of them throw an uncaught error, publishing is aborted.
+     *
+     * @param {string} topic Topic to publish to.
+     * @param {...*} var_args Arguments that are applied to each subscription
+     *     function.
+     * @return {boolean} Whether any subscriptions were called.
+     */
+    publish(topic: string, ...var_args: any[]): boolean;
+    /**
+     * Clears the subscription list for a topic, or all topics if unspecified.
+     * @param {string=} opt_topic Topic to clear (all topics if unspecified).
+     */
+    clear(opt_topic?: string | undefined): void;
+    /**
+     * Returns the number of subscriptions to the given topic (or all topics if
+     * unspecified). This number will not change while publishing any messages.
+     * @param {string=} opt_topic The topic (all topics if unspecified).
+     * @return {number} Number of subscriptions to the topic.
+     */
+    getCount(opt_topic?: string | undefined): number;
+    isDisposed(): boolean;
+    dispose(): void;
+}
+export const EventBus: PubSub;

package/types/core/q/q.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @ngdoc provider
+ * @name $qProvider
+ *
+ *
+ * @description
+ */
+export function $QProvider(): void;
+export class $QProvider {
+    $get: (string | (($rootScope: any, $exceptionHandler: import("../exception-handler").angular.ErrorHandler) => any))[];
+    /**
+     * @ngdoc method
+     * @name $qProvider#errorOnUnhandledRejections
+     * @kind function
+     *
+     * @description
+     * Retrieves or overrides whether to generate an error when a rejected promise is not handled.
+     * This feature is enabled by default.
+     *
+     * @param {boolean=} value Whether to generate an error when a rejected promise is not handled.
+     * @returns {boolean|ng.$qProvider} Current value when called without a new value or self for
+     *    chaining otherwise.
+     */
+    errorOnUnhandledRejections: (value?: boolean | undefined) => boolean | ng.$qProvider;
+}
+export function $$QProvider(): void;
+export class $$QProvider {
+    $get: (string | (($browser: any, $exceptionHandler: any) => any))[];
+    errorOnUnhandledRejections: (value: any) => boolean | this;
+}
+export function markQExceptionHandled(q: any): void;
+export namespace angular {
+    type QPromise<T> = {
+        /**
+         * - Calls one of the success or error callbacks asynchronously as soon as the result is available.
+         */
+        then: (arg0: ((value: T) => (PromiseLike<never> | PromiseLike<T> | T)) | null, arg1: ((reason: any) => (PromiseLike<never> | PromiseLike<T> | T)) | null, arg2: ((state: any) => any)) => angular.QPromise<T | never>;
+        /**
+         * - Shorthand for promise.then(null, errorCallback).
+         */
+        catch: (arg0: ((reason: any) => (PromiseLike<never> | PromiseLike<T> | T)) | null) => angular.QPromise<T> | T;
+        /**
+         * - Allows you to observe either the fulfillment or rejection of a promise, but to do so without modifying the final value.
+         */
+        finally: (arg0: () => void) => angular.QPromise<T>;
+    };
+    type Deferred<T> = {
+        /**
+         * - Resolves the promise with a value or another promise.
+         */
+        resolve: (arg0: T | angular.QPromise<T>) => void;
+        /**
+         * - Rejects the promise with a reason.
+         */
+        reject: (arg0: any) => void;
+        /**
+         * - Provides a progress notification.
+         */
+        notify: (arg0: any) => void;
+        /**
+         * - The promise associated with this deferred object.
+         */
+        promise: angular.QPromise<T>;
+    };
+}

package/types/core/sanitize/sanitize-uri.d.ts

@@ -0,0 +1,53 @@
+/**
+ *
+ * @description
+ * Private service to sanitize uris for links and images. Used by $compile.
+ */
+export function SanitizeUriProvider(): void;
+export class SanitizeUriProvider {
+    /**
+     * @description
+     * Retrieves or overrides the default regular expression that is used for determining trusted safe
+     * urls during a[href] sanitization.
+     *
+     * The sanitization is a security measure aimed at prevent XSS attacks via HTML anchor links.
+     *
+     * Any url due to be assigned to an `a[href]` attribute via interpolation is marked as requiring
+     * the $sce.URL security context. When interpolation occurs a call is made to `$sce.trustAsUrl(url)`
+     * which in turn may call `$$sanitizeUri(url, isMedia)` to sanitize the potentially malicious URL.
+     *
+     * If the URL matches the `aHrefSanitizationTrustedUrlList` regular expression, it is returned unchanged.
+     *
+     * If there is no match the URL is returned prefixed with `'unsafe:'` to ensure that when it is written
+     * to the DOM it is inactive and potentially malicious code will not be executed.
+     *
+     * @param {RegExp=} regexp New regexp to trust urls with.
+     * @returns {RegExp|ng.ICompileProvider} Current RegExp if called without value or self for
+     *    chaining otherwise.
+     */
+    aHrefSanitizationTrustedUrlList: (regexp?: RegExp | undefined) => RegExp | ng.ICompileProvider;
+    /**
+     * @description
+     * Retrieves or overrides the default regular expression that is used for determining trusted safe
+     * urls during img[src] sanitization.
+     *
+     * The sanitization is a security measure aimed at prevent XSS attacks via HTML image src links.
+     *
+     * Any URL due to be assigned to an `img[src]` attribute via interpolation is marked as requiring
+     * the $sce.MEDIA_URL security context. When interpolation occurs a call is made to
+     * `$sce.trustAsMediaUrl(url)` which in turn may call `$$sanitizeUri(url, isMedia)` to sanitize
+     * the potentially malicious URL.
+     *
+     * If the URL matches the `imgSrcSanitizationTrustedUrlList` regular expression, it is returned
+     * unchanged.
+     *
+     * If there is no match the URL is returned prefixed with `'unsafe:'` to ensure that when it is written
+     * to the DOM it is inactive and potentially malicious code will not be executed.
+     *
+     * @param {RegExp=} regexp New regexp to trust urls with.
+     * @returns {RegExp|ng.$compileProvider} Current RegExp if called without value or self for
+     *    chaining otherwise.
+     */
+    imgSrcSanitizationTrustedUrlList: (regexp?: RegExp | undefined) => RegExp | ng.$compileProvider;
+    $get: () => (uri: any, isMediaUrl: any) => any;
+}

package/types/core/{sce.d.ts → sce/sce.d.ts}

@@ -91,76 +91,70 @@ export function adjustMatcher(matcher: any): any;
  */
 export function $SceDelegateProvider(): void;
 export class $SceDelegateProvider {
-  SCE_CONTEXTS: {
-    HTML: string;
-    CSS: string;
-    MEDIA_URL: string;
-    URL: string;
-    RESOURCE_URL: string;
-    JS: string;
-  };
-  /**
-   * @ngdoc method
-   * @name $sceDelegateProvider#trustedResourceUrlList
-   * @kind function
-   *
-   * @param {Array=} trustedResourceUrlList When provided, replaces the trustedResourceUrlList with
-   *     the value provided.  This must be an array or null.  A snapshot of this array is used so
-   *     further changes to the array are ignored.
-   *     Follow {@link ng.$sce#resourceUrlPatternItem this link} for a description of the items
-   *     allowed in this array.
-   *
-   * @return {Array} The currently set trusted resource URL array.
-   *
-   * @description
-   * Sets/Gets the list trusted of resource URLs.
-   *
-   * The **default value** when no `trustedResourceUrlList` has been explicitly set is `['self']`
-   * allowing only same origin resource requests.
-   *
-   * <div class="alert alert-warning">
-   * **Note:** the default `trustedResourceUrlList` of 'self' is not recommended if your app shares
-   * its origin with other apps! It is a good idea to limit it to only your application's directory.
-   * </div>
-   */
-  trustedResourceUrlList: (value: any, ...args: any[]) => any[];
-  /**
-   * @ngdoc method
-   * @name $sceDelegateProvider#bannedResourceUrlList
-   * @kind function
-   *
-   * @param {Array=} bannedResourceUrlList When provided, replaces the `bannedResourceUrlList` with
-   *     the value provided. This must be an array or null. A snapshot of this array is used so
-   *     further changes to the array are ignored.</p><p>
-   *     Follow {@link ng.$sce#resourceUrlPatternItem this link} for a description of the items
-   *     allowed in this array.</p><p>
-   *     The typical usage for the `bannedResourceUrlList` is to **block
-   *     [open redirects](http://cwe.mitre.org/data/definitions/601.html)** served by your domain as
-   *     these would otherwise be trusted but actually return content from the redirected domain.
-   *     </p><p>
-   *     Finally, **the banned resource URL list overrides the trusted resource URL list** and has
-   *     the final say.
-   *
-   * @return {Array} The currently set `bannedResourceUrlList` array.
-   *
-   * @description
-   * Sets/Gets the `bannedResourceUrlList` of trusted resource URLs.
-   *
-   * The **default value** when no trusted resource URL list has been explicitly set is the empty
-   * array (i.e. there is no `bannedResourceUrlList`.)
-   */
-  bannedResourceUrlList: (value: any, ...args: any[]) => any[];
-  $get: (
-    | string
-    | ((
-        $injector: any,
-        $$sanitizeUri: any,
-      ) => {
+    SCE_CONTEXTS: {
+        HTML: string;
+        CSS: string;
+        MEDIA_URL: string;
+        URL: string;
+        RESOURCE_URL: string;
+        JS: string;
+    };
+    /**
+     * @ngdoc method
+     * @name $sceDelegateProvider#trustedResourceUrlList
+     * @kind function
+     *
+     * @param {Array=} trustedResourceUrlList When provided, replaces the trustedResourceUrlList with
+     *     the value provided.  This must be an array or null.  A snapshot of this array is used so
+     *     further changes to the array are ignored.
+     *     Follow {@link ng.$sce#resourceUrlPatternItem this link} for a description of the items
+     *     allowed in this array.
+     *
+     * @return {Array} The currently set trusted resource URL array.
+     *
+     * @description
+     * Sets/Gets the list trusted of resource URLs.
+     *
+     * The **default value** when no `trustedResourceUrlList` has been explicitly set is `['self']`
+     * allowing only same origin resource requests.
+     *
+     * <div class="alert alert-warning">
+     * **Note:** the default `trustedResourceUrlList` of 'self' is not recommended if your app shares
+     * its origin with other apps! It is a good idea to limit it to only your application's directory.
+     * </div>
+     */
+    trustedResourceUrlList: (value: any, ...args: any[]) => any[];
+    /**
+     * @ngdoc method
+     * @name $sceDelegateProvider#bannedResourceUrlList
+     * @kind function
+     *
+     * @param {Array=} bannedResourceUrlList When provided, replaces the `bannedResourceUrlList` with
+     *     the value provided. This must be an array or null. A snapshot of this array is used so
+     *     further changes to the array are ignored.</p><p>
+     *     Follow {@link ng.$sce#resourceUrlPatternItem this link} for a description of the items
+     *     allowed in this array.</p><p>
+     *     The typical usage for the `bannedResourceUrlList` is to **block
+     *     [open redirects](http://cwe.mitre.org/data/definitions/601.html)** served by your domain as
+     *     these would otherwise be trusted but actually return content from the redirected domain.
+     *     </p><p>
+     *     Finally, **the banned resource URL list overrides the trusted resource URL list** and has
+     *     the final say.
+     *
+     * @return {Array} The currently set `bannedResourceUrlList` array.
+     *
+     * @description
+     * Sets/Gets the `bannedResourceUrlList` of trusted resource URLs.
+     *
+     * The **default value** when no trusted resource URL list has been explicitly set is the empty
+     * array (i.e. there is no `bannedResourceUrlList`.)
+     */
+    bannedResourceUrlList: (value: any, ...args: any[]) => any[];
+    $get: (string | (($injector: any, $$sanitizeUri: any) => {
         trustAs: (type: string, trustedValue: any) => any;
         getTrusted: (type: string, maybeTrusted: any) => any;
         valueOf: (maybeTrusted: any) => any;
-      })
-  )[];
+    }))[];
 }
 /**
  * @ngdoc provider
@@ -408,25 +402,25 @@ export class $SceDelegateProvider {
  */
 export function $SceProvider(): void;
 export class $SceProvider {
-  /**
-   * @ngdoc method
-   * @name $sceProvider#enabled
-   * @kind function
-   *
-   * @param {boolean=} value If provided, then enables/disables SCE application-wide.
-   * @return {boolean} True if SCE is enabled, false otherwise.
-   *
-   * @description
-   * Enables/disables SCE and returns the current value.
-   */
-  enabled: (value?: boolean | undefined, ...args: any[]) => boolean;
-  $get: (string | (($parse: any, $sceDelegate: any) => any))[];
+    /**
+     * @ngdoc method
+     * @name $sceProvider#enabled
+     * @kind function
+     *
+     * @param {boolean=} value If provided, then enables/disables SCE application-wide.
+     * @return {boolean} True if SCE is enabled, false otherwise.
+     *
+     * @description
+     * Enables/disables SCE and returns the current value.
+     */
+    enabled: (value?: boolean | undefined, ...args: any[]) => boolean;
+    $get: (string | (($parse: any, $sceDelegate: any) => any))[];
 }
 export namespace SCE_CONTEXTS {
-  let HTML: string;
-  let CSS: string;
-  let MEDIA_URL: string;
-  let URL: string;
-  let RESOURCE_URL: string;
-  let JS: string;
+    let HTML: string;
+    let CSS: string;
+    let MEDIA_URL: string;
+    let URL: string;
+    let RESOURCE_URL: string;
+    let JS: string;
 }