@angular-wave/angular.ts 0.0.39 → 0.0.40

package/src/router/directives/view-directive.spec.js

@@ -6,7 +6,7 @@
 //   }
 // }
 
-import { dealoc, jqLite } from "../../shared/jqlite/jqlite";
+import { dealoc, JQLite } from "../../shared/jqlite/jqlite";
 import { Angular } from "../../loader";
 import { publishExternalAPI } from "../../public";
 import { wait } from "../../shared/test-utils";
@@ -175,7 +175,7 @@ describe("ngView", () => {
         $state = _$state_;
         $q = _$q_;
         $timeout = _$timeout_;
-        elem = jqLite("<div>");
+        elem = JQLite("<div>");
         $ngViewScroll = _$ngViewScroll_;
       },
     );
@@ -355,7 +355,7 @@ describe("ngView", () => {
         ngViews = elem.find("ng-view");
 
       while (index++ < ngViews.length) {
-        const ngView = jqLite(ngViews[index]);
+        const ngView = JQLite(ngViews[index]);
         if (ngView.text() === bState.template) target = ngView;
       }
 
@@ -881,7 +881,7 @@ describe("UiView", () => {
         $state = _$state_;
         $q = _$q_;
         $timeout = _$timeout_;
-        elem = jqLite("<div>");
+        elem = JQLite("<div>");
         $ngViewScroll = _$ngViewScroll_;
       },
     );
@@ -966,7 +966,7 @@ describe("ngView transclusion", () => {
         scope = $rootScope.$new();
         $compile = _$compile_;
         $state = _$state_;
-        elem = jqLite("<div>");
+        elem = JQLite("<div>");
       },
     );
   });
@@ -1045,13 +1045,13 @@ describe("ngView controllers or onEnter handlers", () => {
         scope = $rootScope.$new();
         $compile = _$compile_;
         $state = _$state_;
-        elem = jqLite("<div>");
+        elem = JQLite("<div>");
       },
     );
   });
 
   it("should not go into an infinite loop when controller uses $state.go", async () => {
-    el = jqLite("<div><ng-view></ng-view></div>");
+    el = JQLite("<div><ng-view></ng-view></div>");
     template = $compile(el)($rootScope);
     $rootScope.$digest();
 
@@ -1200,7 +1200,7 @@ describe("angular 1.5+ style .component()", () => {
         $rootScope = _$rootScope_;
         scope = $rootScope.$new();
         log = "";
-        el = jqLite("<div><ng-view></ng-view></div>");
+        el = JQLite("<div><ng-view></ng-view></div>");
         svcs.$compile(el)(scope);
         $templateCache = _$templateCache_;
       },
@@ -1770,7 +1770,7 @@ describe("angular 1.5+ style .component()", () => {
         },
       };
 
-      el = jqLite(
+      el = JQLite(
         '<div><div ng-view="header"></div><div ng-view="content"</div>',
       );
       svcs.$compile(el)(scope);

package/src/router/state/state.spec.js

@@ -1,4 +1,4 @@
-import { dealoc, jqLite } from "../../shared/jqlite/jqlite";
+import { dealoc, JQLite } from "../../shared/jqlite/jqlite";
 import { Angular } from "../../loader";
 import { publishExternalAPI } from "../../public";
 import { isFunction } from "../../shared/utils";
@@ -6,8 +6,6 @@ import { wait } from "../../shared/test-utils";
 
 describe("$state", () => {
   let $injector, template, ctrlName, $provide, $compile, module, $stateRegistry;
-
-  /** @type {import("../../router/stateProvider").StateProvider} */
   let $stateProvider;
 
   function $get(what) {
@@ -101,7 +99,7 @@ describe("$state", () => {
   describe("provider", () => {
     beforeEach(() => {
       dealoc(document.getElementById("dummy"));
-      jqLite.CACHE.clear(); // some tests are polluting the cache
+      // some tests are polluting the cache
       window.angular = new Angular();
       publishExternalAPI();
       module = window.angular.module("defaultModule", ["ng.router"]);

package/src/router/template-factory.spec.js

@@ -1,4 +1,4 @@
-import { dealoc, jqLite } from "../shared/jqlite/jqlite";
+import { dealoc, JQLite } from "../shared/jqlite/jqlite";
 import { Angular } from "../loader";
 import { publishExternalAPI } from "../public";
 import { wait } from "../shared/test-utils";
@@ -124,7 +124,7 @@ describe("templateFactory", () => {
           $compile = _$compile_;
         },
       );
-      el = $compile(jqLite("<div><ng-view></ng-view></div>"))($scope.$new());
+      el = $compile(JQLite("<div><ng-view></ng-view></div>"))($scope.$new());
     });
 
     it("should not prefix the components dom element with anything", async () => {

package/src/router/transition/hook-registry.js

@@ -1,4 +1,4 @@
-import { removeFrom, tail, identity, mapObj } from "../../shared/common";
+import { removeFrom, tail, mapObj } from "../../shared/common";
 import { isString, isFunction } from "../../shared/utils";
 import { Glob } from "../common/glob";
 import { TransitionHookScope } from "./interface";
@@ -139,7 +139,7 @@ export class RegisteredHook {
   matches(treeChanges, transition) {
     const matches = this._getMatchingNodes(treeChanges, transition);
     // Check if all the criteria matched the TreeChanges object
-    const allMatched = Object.values(matches).every(identity);
+    const allMatched = Object.values(matches).every((x) => x);
     return allMatched ? matches : null;
   }
   deregister() {

package/src/router/view/view.spec.js

@@ -1,4 +1,4 @@
-import { dealoc, jqLite } from "../../shared/jqlite/jqlite";
+import { dealoc, JQLite } from "../../shared/jqlite/jqlite";
 import { Angular } from "../../loader";
 import { publishExternalAPI } from "../../public";
 import { curry } from "../../shared/hof";

package/src/services/browser.js

@@ -1,34 +1,44 @@
-import { jqLite } from "../shared/jqlite/jqlite";
+import { JQLite } from "../shared/jqlite/jqlite";
 import { urlResolve } from "../core/url-utils/url-utils";
-import { forEach, isUndefined, equals } from "../shared/utils";
+import { isUndefined, equals } from "../shared/utils";
 
 // This variable should be used *only* inside the cacheState function.
 let lastCachedState = null;
 
+/**
+ * Removes a trailing hash ('#') from the given URL if it exists.
+ *
+ * @param {string} url
+ * @returns {string}
+ */
 export function trimEmptyHash(url) {
   return url.replace(/#$/, "");
 }
 
+/**
+ * @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, $$taskTrackerFactory) {
+export function Browser(taskTracker) {
   const self = this;
-  const { setTimeout } = window;
-  const { clearTimeout } = window;
   const pendingDeferIds = {};
-  const taskTracker = $$taskTrackerFactory($log);
+  /** @type {Array<UrlChangeListener>} */
+  const urlChangeListeners = [];
+  let urlChangeInit = false;
 
   /// ///////////////////////////////////////////////////////////
   // Task-tracking API
@@ -48,11 +58,7 @@ export function Browser($log, $$taskTrackerFactory) {
   let cachedState;
   let lastHistoryState;
   let lastBrowserUrl = window.location.href;
-  const baseElement = jqLite(Array.from(document.getElementsByTagName("base")));
-  let pendingLocation = null;
-  const getCurrentState = function getCurrentState() {
-    return history.state;
-  };
+  const baseElement = JQLite(Array.from(document.getElementsByTagName("base")));
 
   cacheState();
 
@@ -73,7 +79,7 @@ export function Browser($log, $$taskTrackerFactory) {
    * 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 {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`
    */
@@ -87,15 +93,13 @@ export function Browser($log, $$taskTrackerFactory) {
 
     // setter
     if (url) {
-      const sameState = lastHistoryState === state;
-
       // Normalize the inputted URL
       url = urlResolve(url).href;
 
       // Don't change anything if previous and current URLs and states match. This also prevents
       // IE<10 from getting into redirect loop when in LocationHashbangInHtml5Url mode.
       // See https://github.com/angular/angular.js/commit/ffb2701
-      if (lastBrowserUrl === url && sameState) {
+      if (lastBrowserUrl === url && lastHistoryState === state) {
         return self;
       }
       // const sameBase =
@@ -110,7 +114,7 @@ export function Browser($log, $$taskTrackerFactory) {
     // - pendingLocation is needed as browsers don't allow to read out
     //   the new location.href if a reload happened or if there is a bug like in iOS 9 (see
     //   https://openradar.appspot.com/22186109).
-    return trimEmptyHash(pendingLocation || window.location.href);
+    return trimEmptyHash(window.location.href);
   };
 
   /**
@@ -127,17 +131,13 @@ export function Browser($log, $$taskTrackerFactory) {
     return cachedState;
   };
 
-  const urlChangeListeners = [];
-  let urlChangeInit = false;
-
   function cacheStateAndFireUrlChange() {
-    pendingLocation = null;
     fireStateOrUrlChange();
   }
 
   function cacheState() {
     // This should be the only place in $browser where `history.state` is read.
-    cachedState = getCurrentState();
+    cachedState = history.state;
     cachedState = isUndefined(cachedState) ? null : cachedState;
 
     // Prevent callbacks fo fire twice if both hashchange & popstate were fired.
@@ -156,11 +156,10 @@ export function Browser($log, $$taskTrackerFactory) {
     if (lastBrowserUrl === self.url() && prevLastHistoryState === cachedState) {
       return;
     }
-
-    lastBrowserUrl = self.url();
+    lastBrowserUrl = /** @type {string} */ (self.url());
     lastHistoryState = cachedState;
-    forEach(urlChangeListeners, (listener) => {
-      listener(self.url(), cachedState);
+    urlChangeListeners.forEach((listener) => {
+      listener(trimEmptyHash(window.location.href), cachedState);
     });
   }
 
@@ -182,8 +181,8 @@ export function Browser($log, $$taskTrackerFactory) {
    * 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.
+   * @param {UrlChangeListener} callback Listener function to be called when url changes.
+   * @return {UrlChangeListener} Returns the registered listener fn - handy if the fn is anonymous.
    */
   self.onUrlChange = function (callback) {
     // TODO(vojta): refactor to use node's syntax for events
@@ -193,9 +192,9 @@ export function Browser($log, $$taskTrackerFactory) {
       // changed by push/replaceState
 
       // html5 history api - popstate event
-      jqLite(window).on("popstate", cacheStateAndFireUrlChange);
+      JQLite(window).on("popstate", cacheStateAndFireUrlChange);
       // hashchange event
-      jqLite(window).on("hashchange", cacheStateAndFireUrlChange);
+      JQLite(window).on("hashchange", cacheStateAndFireUrlChange);
 
       urlChangeInit = true;
     }
@@ -210,7 +209,7 @@ export function Browser($log, $$taskTrackerFactory) {
    * NOTE: this api is intended for use only by $rootScope.
    */
   self.$$applicationDestroyed = function () {
-    jqLite(window).off("hashchange popstate", cacheStateAndFireUrlChange);
+    JQLite(window).off("hashchange popstate", cacheStateAndFireUrlChange);
   };
 
   /**
@@ -240,7 +239,7 @@ export function Browser($log, $$taskTrackerFactory) {
 
   /**
    * @name $browser#defer
-   * @param {function()} fn A function, who's execution should be deferred.
+   * @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()`.
@@ -260,7 +259,7 @@ export function Browser($log, $$taskTrackerFactory) {
     taskType = taskType || taskTracker.DEFAULT_TASK_TYPE;
 
     taskTracker.incTaskCount(taskType);
-    timeoutId = setTimeout(() => {
+    timeoutId = window.setTimeout(() => {
       delete pendingDeferIds[timeoutId];
       taskTracker.completeTask(fn, taskType);
     }, delay);
@@ -275,7 +274,7 @@ export function Browser($log, $$taskTrackerFactory) {
    * @description
    * Cancels a deferred task identified with `deferId`.
    *
-   * @param {*} deferId Token returned by the `$browser.defer` function.
+   * @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.
    */
@@ -283,7 +282,7 @@ export function Browser($log, $$taskTrackerFactory) {
     if (Object.prototype.hasOwnProperty.call(pendingDeferIds, deferId)) {
       const taskType = pendingDeferIds[deferId];
       delete pendingDeferIds[deferId];
-      clearTimeout(deferId);
+      window.clearTimeout(deferId);
       taskTracker.completeTask(() => {}, taskType);
       return true;
     }
@@ -291,12 +290,30 @@ export function Browser($log, $$taskTrackerFactory) {
   };
 }
 
+/**
+ * @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.$get = [
-    "$log",
     "$$taskTrackerFactory",
-    function ($log, $$taskTrackerFactory) {
-      return new Browser($log, $$taskTrackerFactory);
+    /**
+     * @param {import('../core/task-tracker-factory').TaskTracker} $$taskTrackerFactory
+     * @returns
+     */
+    function ($$taskTrackerFactory) {
+      return new Browser($$taskTrackerFactory);
     },
   ];
 }

package/src/services/document.js

@@ -1,12 +1,9 @@
-import { jqLite } from "../shared/jqlite/jqlite";
+import { JQLite } from "../shared/jqlite/jqlite";
 
 /**
- * @ngdoc service
- * @name $document
- * 
- *
+ * @typedef {import('../index').angular.ServiceProvider} angular.DocumentProvider
  * @description
- * A {@link angular.element jQuery or jqLite} wrapper for the browser's `window.document` object.
+ * A {@link angular.element jQuery or JQLite} wrapper for the browser's `window.document` object.
  *
  * @example
    <example module="documentExample" name="document">
@@ -25,25 +22,31 @@ import { jqLite } from "../shared/jqlite/jqlite";
      </file>
    </example>
  */
+
+/**
+ * @constructor
+ * @this {angular.DocumentProvider}
+ */
 export function $DocumentProvider() {
-  this.$get = [
-    function () {
-      return jqLite(window.document);
-    },
-  ];
+  this.$get = () => JQLite(window.document);
 }
 
 /**
  * @private
  *
-s * Listens for document visibility change and makes the current status accessible.
+ * Listens for document visibility change and makes the current status accessible.
  */
 export function $$IsDocumentHiddenProvider() {
   this.$get = [
     "$document",
     "$rootScope",
+    /**
+     * @param {import("../shared/jqlite/jqlite").JQLite} $document
+     * @param {import("../core/scope/scope").Scope} $rootScope
+     * @returns
+     */
     function ($document, $rootScope) {
-      const doc = $document[0];
+      const doc = /** @type {typeof window.document} */ ($document[0]);
       let hidden = doc && doc.hidden;
 
       $document.on("visibilitychange", changeListener);

package/src/services/log.js

@@ -1,9 +1,44 @@
 import { isError } from "../shared/utils";
 
+///////////////////////////////////////////////////////////////////////////
+// LogService
+// see http://docs.angularjs.org/api/ng/service/$log
+// see http://docs.angularjs.org/api/ng/provider/$logProvider
+///////////////////////////////////////////////////////////////////////////
+
+/**
+ * @typedef {(...args: any[]) => void} LogCall
+ */
+
+/**
+ * @typedef {Object} angular.LogService
+ * @property {LogCall} debug - Log a debug messages
+ * @property {LogCall} error - Log a error message
+ * @property {LogCall} info - Log a info message
+ * @property {LogCall} log - Log a general message
+ * @property {LogCall} warn - Log a warning message
+ */
+
+/**
+ * @type {angular.LogService}
+ */
+export let LogService = {
+  debug: undefined,
+  error: undefined,
+  info: undefined,
+  log: undefined,
+  warn: undefined,
+};
+
+/**
+ * @typedef {import('../index').ServiceProvider} angular.LogProvider
+ * @property {function(): boolean} debugEnabled - Function to get the current debug state.
+ * @property {function(boolean): angular.LogProvider} debugEnabled - Function to enable or disable debug.
+ */
+
 /**
- * @ngdoc provider
  * @name $logProvider
- * @type {ng.ILogProvider}
+ * @type {angular.LogProvider}
  *
  * @description
  * Use the `$logProvider` to configure how the application logs messages
@@ -14,7 +49,6 @@ export class $LogProvider {
   }
 
   /**
-   * @ngdoc method
    * @name $logProvider#debugEnabled
    * @description
    * @param {boolean=} flag enable or disable debug level messages
@@ -53,50 +87,11 @@ export class $LogProvider {
   }
 
   $get() {
-    return {
-      /**
-       * @ngdoc method
-       * @name $log#log
-       *
-       * @description
-       * Write a log message
-       */
+    LogService = {
       log: this.consoleLog("log"),
-
-      /**
-       * @ngdoc method
-       * @name $log#info
-       *
-       * @description
-       * Write an information message
-       */
       info: this.consoleLog("info"),
-
-      /**
-       * @ngdoc method
-       * @name $log#warn
-       *
-       * @description
-       * Write a warning message
-       */
       warn: this.consoleLog("warn"),
-
-      /**
-       * @ngdoc method
-       * @name $log#error
-       *
-       * @description
-       * Write an error message
-       */
       error: this.consoleLog("error"),
-
-      /**
-       * @ngdoc method
-       * @name $log#debug
-       *
-       * @description
-       * Write a debug message
-       */
       debug: (() => {
         const fn = this.consoleLog("debug");
         return (...args) => {
@@ -106,5 +101,6 @@ export class $LogProvider {
         };
       })(),
     };
+    return LogService;
   }
 }

package/src/services/template-request.js

@@ -72,6 +72,15 @@ export function TemplateRequestProvider() {
     "$http",
     "$q",
     "$sce",
+    /**
+     *
+     * @param {import('../core/exception-handler').angular.ErrorHandler} $exceptionHandler
+     * @param {*} $templateCache
+     * @param {*} $http
+     * @param {*} $q
+     * @param {*} $sce
+     * @returns
+     */
     function ($exceptionHandler, $templateCache, $http, $q, $sce) {
       function handleRequestFn(tpl, ignoreRequestError) {
         handleRequestFn.totalPendingRequests++;

package/src/shared/common.js

@@ -15,9 +15,6 @@ export const fromJson = JSON.parse.bind(JSON);
 export const toJson = JSON.stringify.bind(JSON);
 export const forEach = _forEach;
 export const equals = _equals;
-export function identity(x) {
-  return x;
-}
 /**
  * Builds proxy functions on the `to` object which pass through to the `from` object.
  *