@angular-wave/angular.ts 0.0.38 → 0.0.40

package/types/router/view/view.d.ts

@@ -15,123 +15,120 @@
  *
  */
 export class ViewService {
-  _ngViews: any[];
-  _viewConfigs: any[];
-  _viewConfigFactories: {};
-  _listeners: any[];
-  _pluginapi: {
-    _rootViewContext: any;
-    _viewConfigFactory: any;
-    _registeredUIView: (id: any) => undefined;
-    _registeredUIViews: () => any[];
-    _activeViewConfigs: () => any[];
-    _onSync: (listener: any) => () => any;
-  };
-  $get: (() => this)[];
-  _rootViewContext(context: any): any;
-  _rootContext: any;
-  _viewConfigFactory(viewType: any, factory: any): void;
-  createViewConfig(path: any, decl: any): any[];
-  /**
-   * Deactivates a ViewConfig.
-   *
-   * This function deactivates a `ViewConfig`.
-   * After calling [[sync]], it will un-pair from any `ui-view` with which it is currently paired.
-   *
-   * @param viewConfig The ViewConfig view to deregister.
-   */
-  deactivateViewConfig(viewConfig: any): void;
-  activateViewConfig(viewConfig: any): void;
-  sync(): void;
-  /**
-   * Registers a `ui-view` component
-   *
-   * When a `ui-view` component is created, it uses this method to register itself.
-   * After registration the [[sync]] method is used to ensure all `ui-view` are configured with the proper [[ViewConfig]].
-   *
-   * Note: the `ui-view` component uses the `ViewConfig` to determine what view should be loaded inside the `ui-view`,
-   * and what the view's state context is.
-   *
-   * Note: There is no corresponding `deregisterUIView`.
-   *       A `ui-view` should hang on to the return value of `registerUIView` and invoke it to deregister itself.
-   *
-   * @param ngView The metadata for a UIView
-   * @return a de-registration function used when the view is destroyed.
-   */
-  registerUIView(ngView: any): () => void;
-  /**
-   * Returns the list of views currently available on the page, by fully-qualified name.
-   *
-   * @return {Array} Returns an array of fully-qualified view names.
-   */
-  available(): any[];
-  /**
-   * Returns the list of views on the page containing loaded content.
-   *
-   * @return {Array} Returns an array of fully-qualified view names.
-   */
-  active(): any[];
+    _ngViews: any[];
+    _viewConfigs: any[];
+    _viewConfigFactories: {};
+    _listeners: any[];
+    _pluginapi: {
+        _rootViewContext: any;
+        _viewConfigFactory: any;
+        _registeredUIView: (id: any) => undefined;
+        _registeredUIViews: () => any[];
+        _activeViewConfigs: () => any[];
+        _onSync: (listener: any) => () => any;
+    };
+    $get: (() => this)[];
+    _rootViewContext(context: any): any;
+    _rootContext: any;
+    _viewConfigFactory(viewType: any, factory: any): void;
+    createViewConfig(path: any, decl: any): any[];
+    /**
+     * Deactivates a ViewConfig.
+     *
+     * This function deactivates a `ViewConfig`.
+     * After calling [[sync]], it will un-pair from any `ui-view` with which it is currently paired.
+     *
+     * @param viewConfig The ViewConfig view to deregister.
+     */
+    deactivateViewConfig(viewConfig: any): void;
+    activateViewConfig(viewConfig: any): void;
+    sync(): void;
+    /**
+     * Registers a `ui-view` component
+     *
+     * When a `ui-view` component is created, it uses this method to register itself.
+     * After registration the [[sync]] method is used to ensure all `ui-view` are configured with the proper [[ViewConfig]].
+     *
+     * Note: the `ui-view` component uses the `ViewConfig` to determine what view should be loaded inside the `ui-view`,
+     * and what the view's state context is.
+     *
+     * Note: There is no corresponding `deregisterUIView`.
+     *       A `ui-view` should hang on to the return value of `registerUIView` and invoke it to deregister itself.
+     *
+     * @param ngView The metadata for a UIView
+     * @return a de-registration function used when the view is destroyed.
+     */
+    registerUIView(ngView: any): () => void;
+    /**
+     * Returns the list of views currently available on the page, by fully-qualified name.
+     *
+     * @return {Array} Returns an array of fully-qualified view names.
+     */
+    available(): any[];
+    /**
+     * Returns the list of views on the page containing loaded content.
+     *
+     * @return {Array} Returns an array of fully-qualified view names.
+     */
+    active(): any[];
 }
 export namespace ViewService {
-  /**
-   * Given a ui-view and a ViewConfig, determines if they "match".
-   *
-   * A ui-view has a fully qualified name (fqn) and a context object.  The fqn is built from its overall location in
-   * the DOM, describing its nesting relationship to any parent ui-view tags it is nested inside of.
-   *
-   * A ViewConfig has a target ui-view name and a context anchor.  The ui-view name can be a simple name, or
-   * can be a segmented ui-view path, describing a portion of a ui-view fqn.
-   *
-   * In order for a ui-view to match ViewConfig, ui-view's $type must match the ViewConfig's $type
-   *
-   * If the ViewConfig's target ui-view name is a simple name (no dots), then a ui-view matches if:
-   * - the ui-view's name matches the ViewConfig's target name
-   * - the ui-view's context matches the ViewConfig's anchor
-   *
-   * If the ViewConfig's target ui-view name is a segmented name (with dots), then a ui-view matches if:
-   * - There exists a parent ui-view where:
-   *    - the parent ui-view's name matches the first segment (index 0) of the ViewConfig's target name
-   *    - the parent ui-view's context matches the ViewConfig's anchor
-   * - And the remaining segments (index 1..n) of the ViewConfig's target name match the tail of the ui-view's fqn
-   *
-   * Example:
-   *
-   * DOM:
-   * <ui-view>                        <!-- created in the root context (name: "") -->
-   *   <ui-view name="foo">                <!-- created in the context named: "A"      -->
-   *     <ui-view>                    <!-- created in the context named: "A.B"    -->
-   *       <ui-view name="bar">            <!-- created in the context named: "A.B.C"  -->
-   *       </ui-view>
-   *     </ui-view>
-   *   </ui-view>
-   * </ui-view>
-   *
-   * ngViews: [
-   *  { fqn: "$default",                  creationContext: { name: "" } },
-   *  { fqn: "$default.foo",              creationContext: { name: "A" } },
-   *  { fqn: "$default.foo.$default",     creationContext: { name: "A.B" } }
-   *  { fqn: "$default.foo.$default.bar", creationContext: { name: "A.B.C" } }
-   * ]
-   *
-   * These four view configs all match the ui-view with the fqn: "$default.foo.$default.bar":
-   *
-   * - ViewConfig1: { ngViewName: "bar",                       ngViewContextAnchor: "A.B.C" }
-   * - ViewConfig2: { ngViewName: "$default.bar",              ngViewContextAnchor: "A.B" }
-   * - ViewConfig3: { ngViewName: "foo.$default.bar",          ngViewContextAnchor: "A" }
-   * - ViewConfig4: { ngViewName: "$default.foo.$default.bar", ngViewContextAnchor: "" }
-   *
-   * Using ViewConfig3 as an example, it matches the ui-view with fqn "$default.foo.$default.bar" because:
-   * - The ViewConfig's segmented target name is: [ "foo", "$default", "bar" ]
-   * - There exists a parent ui-view (which has fqn: "$default.foo") where:
-   *    - the parent ui-view's name "foo" matches the first segment "foo" of the ViewConfig's target name
-   *    - the parent ui-view's context "A" matches the ViewConfig's anchor context "A"
-   * - And the remaining segments [ "$default", "bar" ].join("."_ of the ViewConfig's target name match
-   *   the tail of the ui-view's fqn "default.bar"
-   *
-   * @internal
-   */
-  function matches(
-    ngViewsByFqn: any,
-    ngView: any,
-  ): (viewConfig: any) => boolean;
+    /**
+     * Given a ui-view and a ViewConfig, determines if they "match".
+     *
+     * A ui-view has a fully qualified name (fqn) and a context object.  The fqn is built from its overall location in
+     * the DOM, describing its nesting relationship to any parent ui-view tags it is nested inside of.
+     *
+     * A ViewConfig has a target ui-view name and a context anchor.  The ui-view name can be a simple name, or
+     * can be a segmented ui-view path, describing a portion of a ui-view fqn.
+     *
+     * In order for a ui-view to match ViewConfig, ui-view's $type must match the ViewConfig's $type
+     *
+     * If the ViewConfig's target ui-view name is a simple name (no dots), then a ui-view matches if:
+     * - the ui-view's name matches the ViewConfig's target name
+     * - the ui-view's context matches the ViewConfig's anchor
+     *
+     * If the ViewConfig's target ui-view name is a segmented name (with dots), then a ui-view matches if:
+     * - There exists a parent ui-view where:
+     *    - the parent ui-view's name matches the first segment (index 0) of the ViewConfig's target name
+     *    - the parent ui-view's context matches the ViewConfig's anchor
+     * - And the remaining segments (index 1..n) of the ViewConfig's target name match the tail of the ui-view's fqn
+     *
+     * Example:
+     *
+     * DOM:
+     * <ui-view>                        <!-- created in the root context (name: "") -->
+     *   <ui-view name="foo">                <!-- created in the context named: "A"      -->
+     *     <ui-view>                    <!-- created in the context named: "A.B"    -->
+     *       <ui-view name="bar">            <!-- created in the context named: "A.B.C"  -->
+     *       </ui-view>
+     *     </ui-view>
+     *   </ui-view>
+     * </ui-view>
+     *
+     * ngViews: [
+     *  { fqn: "$default",                  creationContext: { name: "" } },
+     *  { fqn: "$default.foo",              creationContext: { name: "A" } },
+     *  { fqn: "$default.foo.$default",     creationContext: { name: "A.B" } }
+     *  { fqn: "$default.foo.$default.bar", creationContext: { name: "A.B.C" } }
+     * ]
+     *
+     * These four view configs all match the ui-view with the fqn: "$default.foo.$default.bar":
+     *
+     * - ViewConfig1: { ngViewName: "bar",                       ngViewContextAnchor: "A.B.C" }
+     * - ViewConfig2: { ngViewName: "$default.bar",              ngViewContextAnchor: "A.B" }
+     * - ViewConfig3: { ngViewName: "foo.$default.bar",          ngViewContextAnchor: "A" }
+     * - ViewConfig4: { ngViewName: "$default.foo.$default.bar", ngViewContextAnchor: "" }
+     *
+     * Using ViewConfig3 as an example, it matches the ui-view with fqn "$default.foo.$default.bar" because:
+     * - The ViewConfig's segmented target name is: [ "foo", "$default", "bar" ]
+     * - There exists a parent ui-view (which has fqn: "$default.foo") where:
+     *    - the parent ui-view's name "foo" matches the first segment "foo" of the ViewConfig's target name
+     *    - the parent ui-view's context "A" matches the ViewConfig's anchor context "A"
+     * - And the remaining segments [ "$default", "bar" ].join("."_ of the ViewConfig's target name match
+     *   the tail of the ui-view's fqn "default.bar"
+     *
+     * @internal
+     */
+    function matches(ngViewsByFqn: any, ngView: any): (viewConfig: any) => boolean;
 }

package/types/router/view-scroll.d.ts

@@ -1,5 +1,5 @@
 export function $ViewScrollProvider(): void;
 export class $ViewScrollProvider {
-  useAnchorScroll: () => void;
-  $get: (string | (($anchorScroll: any, $timeout: any) => any))[];
+    useAnchorScroll: () => void;
+    $get: (string | (($anchorScroll: any, $timeout: any) => any))[];
 }

package/types/services/anchor-scroll.d.ts

@@ -1,11 +1,5 @@
 export function AnchorScrollProvider(): void;
 export class AnchorScrollProvider {
-  disableAutoScrolling: () => void;
-  $get: (
-    | string
-    | ((
-        $location: angular.IRootScopeService,
-        $rootScope: any,
-      ) => (hash: any) => void)
-  )[];
+    disableAutoScrolling: () => void;
+    $get: (string | (($location: angular.IRootScopeService, $rootScope: any) => (hash: any) => void))[];
 }

package/types/services/browser.d.ts

@@ -1,150 +1,172 @@
-export function trimEmptyHash(url: any): any;
+/**
+ * Removes a trailing hash ('#') from the given URL if it exists.
+ *
+ * @param {string} url
+ * @returns {string}
+ */
+export function trimEmptyHash(url: string): string;
+/**
+ * @typedef {function(string, string|null): any} UrlChangeListener
+ */
 /**
  * @name $browser
- * @requires $log
  * @description
  * This object has two goals:
  *
  * - hide all the global state in the browser caused by the window object
  * - abstract away all the browser specific features and inconsistencies
  *
+ *
  */
 /**
- * @param {object} $log window.console or an object with the same interface.
+ * @param {import('../core/task-tracker-factory').TaskTracker} taskTracker
  */
-export function Browser($log: object, $$taskTrackerFactory: any): void;
+export function Browser(taskTracker: import("../core/task-tracker-factory").TaskTracker): void;
 export class Browser {
-  /**
-   * @name $browser
-   * @requires $log
-   * @description
-   * This object has two goals:
-   *
-   * - hide all the global state in the browser caused by the window object
-   * - abstract away all the browser specific features and inconsistencies
-   *
-   */
-  /**
-   * @param {object} $log window.console or an object with the same interface.
-   */
-  constructor($log: object, $$taskTrackerFactory: any);
-  $$completeOutstandingRequest: any;
-  $$incOutstandingRequestCount: any;
-  notifyWhenNoOutstandingRequests: any;
-  /**
-   * @name $browser#url
-   *
-   * @description
-   * GETTER:
-   * Without any argument, this method just returns current value of `location.href` (with a
-   * trailing `#` stripped of if the hash is empty).
-   *
-   * SETTER:
-   * With at least one argument, this method sets url to new value.
-   * If html5 history api supported, `pushState`/`replaceState` is used, otherwise
-   * `location.href`/`location.replace` is used.
-   * Returns its own instance to allow chaining.
-   *
-   * NOTE: this api is intended for use only by the `$location` service. Please use the
-   * {@link ng.$location $location service} to change url.
-   *
-   * @param {string} url New url (when used as setter)
-   * @param {boolean=} replace Should new url replace current history record?
-   * @param {object=} state State object to use with `pushState`/`replaceState`
-   */
-  url: (
-    url: string,
-    replace?: boolean | undefined,
-    state?: object | undefined,
-  ) => any;
-  /**
-   * @name $browser#state
-   *
-   * @description
-   * This method is a getter.
-   *
-   * Return history.state or null if history.state is undefined.
-   *
-   * @returns {object} state
-   */
-  state: () => object;
-  /**
-   * @name $browser#onUrlChange
-   *
-   * @description
-   * Register callback function that will be called, when url changes.
-   *
-   * It's only called when the url is changed from outside of AngularJS:
-   * - user types different url into address bar
-   * - user clicks on history (forward/back) button
-   * - user clicks on a link
-   *
-   * It's not called when url is changed by $browser.url() method
-   *
-   * The listener gets called with new url as parameter.
-   *
-   * NOTE: this api is intended for use only by the $location service. Please use the
-   * {@link ng.$location $location service} to monitor url changes in AngularJS apps.
-   *
-   * @param {function(string)} listener Listener function to be called when url changes.
-   * @return {function(string)} Returns the registered listener fn - handy if the fn is anonymous.
-   */
-  onUrlChange: (callback: any) => (arg0: string) => any;
-  /**
-   * Remove popstate and hashchange handler from window.
-   *
-   * NOTE: this api is intended for use only by $rootScope.
-   */
-  $$applicationDestroyed: () => void;
-  /**
-   * Checks whether the url has changed outside of AngularJS.
-   * Needs to be exported to be able to check for changes that have been done in sync,
-   * as hashchange/popstate events fire in async.
-   */
-  $$checkUrlChange: () => void;
-  /**
-   * @name $browser#baseHref
-   *
-   * @description
-   * Returns current <base href>
-   * (always relative - without domain)
-   *
-   * @returns {string} The current base href
-   */
-  baseHref: () => string;
-  /**
-   * @name $browser#defer
-   * @param {function()} fn A function, who's execution should be deferred.
-   * @param {number=} [delay=0] Number of milliseconds to defer the function execution.
-   * @param {string=} [taskType=DEFAULT_TASK_TYPE] The type of task that is deferred.
-   * @returns {*} DeferId that can be used to cancel the task via `$browser.cancel()`.
-   *
-   * @description
-   * Executes a fn asynchronously via `setTimeout(fn, delay)`.
-   *
-   * Unlike when calling `setTimeout` directly, in test this function is mocked and instead of using
-   * `setTimeout` in tests, the fns are queued in an array, which can be programmatically flushed
-   * via `$browser.defer.flush()`.
-   *
-   */
-  defer: (
-    fn: () => any,
-    delay?: number | undefined,
-    taskType?: string | undefined,
-  ) => any;
-  /**
-   * @name $browser#cancel
-   *
-   * @description
-   * Cancels a deferred task identified with `deferId`.
-   *
-   * @param {*} deferId Token returned by the `$browser.defer` function.
-   * @returns {boolean} Returns `true` if the task hasn't executed yet and was successfully
-   *                    canceled.
-   */
-  cancel: (deferId: any) => boolean;
+    /**
+     * @typedef {function(string, string|null): any} UrlChangeListener
+     */
+    /**
+     * @name $browser
+     * @description
+     * This object has two goals:
+     *
+     * - hide all the global state in the browser caused by the window object
+     * - abstract away all the browser specific features and inconsistencies
+     *
+     *
+     */
+    /**
+     * @param {import('../core/task-tracker-factory').TaskTracker} taskTracker
+     */
+    constructor(taskTracker: import("../core/task-tracker-factory").TaskTracker);
+    $$completeOutstandingRequest: (fn: any, taskType: any) => void;
+    $$incOutstandingRequestCount: (taskType: any) => void;
+    notifyWhenNoOutstandingRequests: (callback: any, taskType: any) => void;
+    /**
+     * @name $browser#url
+     *
+     * @description
+     * GETTER:
+     * Without any argument, this method just returns current value of `location.href` (with a
+     * trailing `#` stripped of if the hash is empty).
+     *
+     * SETTER:
+     * With at least one argument, this method sets url to new value.
+     * If html5 history api supported, `pushState`/`replaceState` is used, otherwise
+     * `location.href`/`location.replace` is used.
+     * Returns its own instance to allow chaining.
+     *
+     * NOTE: this api is intended for use only by the `$location` service. Please use the
+     * {@link ng.$location $location service} to change url.
+     *
+     * @param {string=} url New url (when used as setter)
+     * @param {boolean=} replace Should new url replace current history record?
+     * @param {object=} state State object to use with `pushState`/`replaceState`
+     */
+    url: (url?: string | undefined, replace?: boolean | undefined, state?: object | undefined) => string | this;
+    /**
+     * @name $browser#state
+     *
+     * @description
+     * This method is a getter.
+     *
+     * Return history.state or null if history.state is undefined.
+     *
+     * @returns {object} state
+     */
+    state: () => object;
+    /**
+     * @name $browser#onUrlChange
+     *
+     * @description
+     * Register callback function that will be called, when url changes.
+     *
+     * It's only called when the url is changed from outside of AngularJS:
+     * - user types different url into address bar
+     * - user clicks on history (forward/back) button
+     * - user clicks on a link
+     *
+     * It's not called when url is changed by $browser.url() method
+     *
+     * The listener gets called with new url as parameter.
+     *
+     * NOTE: this api is intended for use only by the $location service. Please use the
+     * {@link ng.$location $location service} to monitor url changes in AngularJS apps.
+     *
+     * @param {UrlChangeListener} callback Listener function to be called when url changes.
+     * @return {UrlChangeListener} Returns the registered listener fn - handy if the fn is anonymous.
+     */
+    onUrlChange: (callback: UrlChangeListener) => UrlChangeListener;
+    /**
+     * Remove popstate and hashchange handler from window.
+     *
+     * NOTE: this api is intended for use only by $rootScope.
+     */
+    $$applicationDestroyed: () => void;
+    /**
+     * Checks whether the url has changed outside of AngularJS.
+     * Needs to be exported to be able to check for changes that have been done in sync,
+     * as hashchange/popstate events fire in async.
+     */
+    $$checkUrlChange: () => void;
+    /**
+     * @name $browser#baseHref
+     *
+     * @description
+     * Returns current <base href>
+     * (always relative - without domain)
+     *
+     * @returns {string} The current base href
+     */
+    baseHref: () => string;
+    /**
+     * @name $browser#defer
+     * @param {function():any} fn A function, who's execution should be deferred.
+     * @param {number=} [delay=0] Number of milliseconds to defer the function execution.
+     * @param {string=} [taskType=DEFAULT_TASK_TYPE] The type of task that is deferred.
+     * @returns {*} DeferId that can be used to cancel the task via `$browser.cancel()`.
+     *
+     * @description
+     * Executes a fn asynchronously via `setTimeout(fn, delay)`.
+     *
+     * Unlike when calling `setTimeout` directly, in test this function is mocked and instead of using
+     * `setTimeout` in tests, the fns are queued in an array, which can be programmatically flushed
+     * via `$browser.defer.flush()`.
+     *
+     */
+    defer: (fn: () => any, delay?: number | undefined, taskType?: string | undefined) => any;
+    /**
+     * @name $browser#cancel
+     *
+     * @description
+     * Cancels a deferred task identified with `deferId`.
+     *
+     * @param {number} deferId Token returned by the `$browser.defer` function.
+     * @returns {boolean} Returns `true` if the task hasn't executed yet and was successfully
+     *                    canceled.
+     */
+    cancel: (deferId: number) => boolean;
 }
-export function BrowserProvider(): void;
+/**
+ * @typedef {import('../index').angular.ServiceProvider} angular.BrowserProvider
+ * @description
+ * This object has two goals:
+ *
+ * - hide all the global state in the browser caused by the window object
+ * - abstract away all the browser specific features and inconsistencies
+ *
+ * Remove this in the future
+ */
+/**
+ * @constructor
+ * @this {angular.BrowserProvider}
+ */
+export function BrowserProvider(this: import("../index").angular.ServiceProvider): void;
 export class BrowserProvider {
-  $get: (string | (($log: any, $$taskTrackerFactory: any) => Browser))[];
+    $get: (string | (($$taskTrackerFactory: import("../core/task-tracker-factory").TaskTracker) => Browser))[];
+}
+export type UrlChangeListener = (arg0: string, arg1: string | null) => any;
+export namespace angular {
+    type BrowserProvider = import("../index").angular.ServiceProvider;
 }

package/types/services/cache-factory.d.ts

@@ -67,30 +67,30 @@
  */
 export function CacheFactoryProvider(): void;
 export class CacheFactoryProvider {
-  $get: () => {
-    (cacheId: string, options?: object | undefined): object;
-    /**
-     * @ngdoc method
-     * @name $cacheFactory#info
-     *
-     * @description
-     * Get information about all the caches that have been created
-     *
-     * @returns {Object} - key-value map of `cacheId` to the result of calling `cache#info`
-     */
-    info(): any;
-    /**
-     * @ngdoc method
-     * @name $cacheFactory#get
-     *
-     * @description
-     * Get access to a cache object by the `cacheId` used when it was created.
-     *
-     * @param {string} cacheId Name or id of a cache to access.
-     * @returns {object} Cache object identified by the cacheId or undefined if no such cache.
-     */
-    get(cacheId: string): object;
-  };
+    $get: () => {
+        (cacheId: string, options?: object | undefined): object;
+        /**
+         * @ngdoc method
+         * @name $cacheFactory#info
+         *
+         * @description
+         * Get information about all the caches that have been created
+         *
+         * @returns {Object} - key-value map of `cacheId` to the result of calling `cache#info`
+         */
+        info(): any;
+        /**
+         * @ngdoc method
+         * @name $cacheFactory#get
+         *
+         * @description
+         * Get access to a cache object by the `cacheId` used when it was created.
+         *
+         * @param {string} cacheId Name or id of a cache to access.
+         * @returns {object} Cache object identified by the cacheId or undefined if no such cache.
+         */
+        get(cacheId: string): object;
+    };
 }
 /**
  * @name $templateCache
@@ -139,5 +139,5 @@ export class CacheFactoryProvider {
  */
 export function TemplateCacheProvider(): void;
 export class TemplateCacheProvider {
-  $get: (string | (($cacheFactory: any) => any))[];
+    $get: (string | (($cacheFactory: any) => any))[];
 }