@angular-wave/angular.ts 0.0.38 → 0.0.39

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,31 @@
+/**
+ * @ngdoc provider
+ * @name $qProvider
+ *
+ *
+ * @description
+ */
+export function $QProvider(): void;
+export class $QProvider {
+    $get: (string | (($rootScope: any, $exceptionHandler: any) => 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;

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;
 }