@angular-wave/angular.ts 0.1.1 → 0.1.3

package/src/directive/form/form.js

@@ -36,9 +36,6 @@ function nullFormRenameControl(control, name) {
 }
 
 /**
- * @ngdoc type
- * @name form.FormController
- *
  * @property {boolean} $pristine True if user has not interacted with the form yet.
  * @property {boolean} $dirty True if user has already interacted with the form.
  * @property {boolean} $valid True if all of the containing forms and controls are valid.
@@ -121,10 +118,6 @@ export function FormController(
 
 FormController.prototype = {
   /**
-   * @ngdoc method
-   * @name form.FormController#$rollbackViewValue
-   *
-   * @description
    * Rollback all form controls pending updates to the `$modelValue`.
    *
    * Updates may be pending by a debounced event or because the input is waiting for a some future
@@ -138,10 +131,6 @@ FormController.prototype = {
   },
 
   /**
-   * @ngdoc method
-   * @name form.FormController#$commitViewValue
-   *
-   * @description
    * Commit all form controls pending updates to the `$modelValue`.
    *
    * Updates may be pending by a debounced event or because the input is waiting for a some future
@@ -253,10 +242,6 @@ FormController.prototype = {
   },
 
   /**
-   * @ngdoc method
-   * @name form.FormController#$setDirty
-   *
-   * @description
    * Sets the form to a dirty state.
    *
    * This method can be called to add the 'ng-dirty' class and set the form to a dirty
@@ -271,10 +256,6 @@ FormController.prototype = {
   },
 
   /**
-   * @ngdoc method
-   * @name form.FormController#$setPristine
-   *
-   * @description
    * Sets the form to its pristine state.
    *
    * This method sets the form's `$pristine` state to true, the `$dirty` state to false, removes
@@ -301,10 +282,6 @@ FormController.prototype = {
   },
 
   /**
-   * @ngdoc method
-   * @name form.FormController#$setUntouched
-   *
-   * @description
    * Sets the form to its untouched state.
    *
    * This method can be called to remove the 'ng-touched' class and set the form controls to their
@@ -320,10 +297,6 @@ FormController.prototype = {
   },
 
   /**
-   * @ngdoc method
-   * @name form.FormController#$setSubmitted
-   *
-   * @description
    * Sets the form to its `$submitted` state. This will also set `$submitted` on all child and
    * parent forms of the form.
    */
@@ -348,10 +321,6 @@ FormController.prototype = {
 };
 
 /**
- * @ngdoc method
- * @name form.FormController#$setValidity
- *
- * @description
  * Change the validity state of the form, and notify the parent form (if any).
  *
  * Application developers will rarely need to call this method directly. It is used internally, by
@@ -397,11 +366,6 @@ addSetValidityMethod({
 });
 
 /**
- * @ngdoc directive
- * @name ngForm
- * @restrict EA
- *
- * @description
  * Helper directive that makes it possible to create control groups inside a
  * {@link ng.directive:form `form`} directive.
  * These "child forms" can be used, for example, to determine the validity of a sub-group of
@@ -421,11 +385,6 @@ addSetValidityMethod({
  */
 
 /**
- * @ngdoc directive
- * @name form
- * @restrict E
- *
- * @description
  * Directive that instantiates
  * {@link form.FormController FormController}.
  *

package/src/directive/model/model.js

@@ -300,10 +300,6 @@ export class NgModelController {
   }
 
   /**
-   * @ngdoc method
-   * @name ngModel.NgModelController#$render
-   *
-   * @description
    * Called when the view needs to be updated. It is expected that the user of the ng-model
    * directive will implement this method.
    *
@@ -322,10 +318,6 @@ export class NgModelController {
   $render() {}
 
   /**
-   * @ngdoc method
-   * @name ngModel.NgModelController#$isEmpty
-   *
-   * @description
    * This is called when we need to determine if the value of an input is empty.
    *
    * For instance, the required directive does this to work out if the input has data or not.
@@ -366,10 +358,6 @@ export class NgModelController {
   }
 
   /**
-   * @ngdoc method
-   * @name ngModel.NgModelController#$setPristine
-   *
-   * @description
    * Sets the control to its pristine state.
    *
    * This method can be called to remove the `ng-dirty` class and set the control to its pristine
@@ -389,10 +377,6 @@ export class NgModelController {
   }
 
   /**
-   * @ngdoc method
-   * @name ngModel.NgModelController#$setDirty
-   *
-   * @description
    * Sets the control to its dirty state.
    *
    * This method can be called to remove the `ng-pristine` class and set the control to its dirty
@@ -413,10 +397,6 @@ export class NgModelController {
   }
 
   /**
-   * @ngdoc method
-   * @name ngModel.NgModelController#$setUntouched
-   *
-   * @description
    * Sets the control to its untouched state.
    *
    * This method can be called to remove the `ng-touched` class and set the control to its
@@ -436,10 +416,6 @@ export class NgModelController {
   }
 
   /**
-   * @ngdoc method
-   * @name ngModel.NgModelController#$setTouched
-   *
-   * @description
    * Sets the control to its touched state.
    *
    * This method can be called to remove the `ng-untouched` class and set the control to its
@@ -458,10 +434,6 @@ export class NgModelController {
   }
 
   /**
-   * @ngdoc method
-   * @name ngModel.NgModelController#$rollbackViewValue
-   *
-   * @description
    * Cancel an update and reset the input element's value to prevent an update to the `$modelValue`,
    * which may be caused by a pending debounced event or because the input is waiting for some
    * future event.
@@ -553,10 +525,6 @@ export class NgModelController {
   }
 
   /**
-   * @ngdoc method
-   * @name ngModel.NgModelController#$validate
-   *
-   * @description
    * Runs each of the registered validators (first synchronous validators and then
    * asynchronous validators).
    * If the validity changes to invalid, the model will be set to `undefined`,

package/src/directive/ref/ref.js

@@ -1,11 +1,6 @@
 import { getNodeName, minErr, directiveNormalize } from "../../shared/utils";
 
 /**
- * @ngdoc directive
- * @name ngRef
- * @restrict A
- *
- * @description
  * The `ngRef` attribute tells AngularJS to assign the controller of a component (or a directive)
  * to the given property in the current scope. It is also possible to add the jqlite-wrapped DOM
  * element to the scope.

package/src/directive/script/script.js

@@ -1,18 +1,3 @@
-/**
- * @ngdoc directive
- * @name script
- * @restrict E
- *
- * @description
- * Load the content of a `<script>` element into {@link ng.$templateCache `$templateCache`}, so that the
- * template can be used by {@link ng.directive:ngInclude `ngInclude`},
- * {@link ngRoute.directive:ngView `ngView`}, or {@link guide/directive directives}. The type of the
- * `<script>` element must be specified as `text/ng-template`, and a cache name for the template must be
- * assigned through the element's `id`, which can then be used as a directive's `templateUrl`.
- *
- * @param {string} type Must be set to `'text/ng-template'`.
- * @param {string} id Cache name of the template.
- */
 export const scriptDirective = [
   "$templateCache",
   ($templateCache) => ({

package/src/directive/script/script.md

@@ -0,0 +1,11 @@
+/\*\*
+
+- Load the content of a `<script>` element into {@link ng.$templateCache `$templateCache`}, so that the
+- template can be used by {@link ng.directive:ngInclude `ngInclude`},
+- {@link ngRoute.directive:ngView `ngView`}, or {@link guide/directive directives}. The type of the
+- `<script>` element must be specified as `text/ng-template`, and a cache name for the template must be
+- assigned through the element's `id`, which can then be used as a directive's `templateUrl`.
+-
+- @param {string} type Must be set to `'text/ng-template'`.
+- @param {string} id Cache name of the template.
+  \*/

package/src/directive/select/select.js

@@ -179,10 +179,6 @@ function SelectController($element, $scope) {
   };
 
   /**
-   * @ngdoc method
-   * @name select.SelectController#$hasEmptyOption
-   *
-   * @description
    *
    * Returns `true` if the select element currently has an empty option
    * element, i.e. an option that signifies that the select is empty / the selection is null.
@@ -193,10 +189,6 @@ function SelectController($element, $scope) {
   };
 
   /**
-   * @ngdoc method
-   * @name select.SelectController#$isUnknownOptionSelected
-   *
-   * @description
    *
    * Returns `true` if the select element's unknown option is selected. The unknown option is added
    * and automatically selected whenever the select model doesn't match any option.
@@ -208,11 +200,6 @@ function SelectController($element, $scope) {
   };
 
   /**
-   * @ngdoc method
-   * @name select.SelectController#$isEmptyOptionSelected
-   *
-   * @description
-   *
    * Returns `true` if the select element has an empty option and this empty option is currently
    * selected. Returns `false` if the select element has no empty option or it is not selected.
    *

package/src/directive/transclude/transclude.js

@@ -2,11 +2,6 @@ import { minErr } from "../../shared/utils";
 import { startingTag } from "../../shared/jqlite/jqlite";
 
 /**
- * @ngdoc directive
- * @name ngTransclude
- * @restrict EA
- *
- * @description
  * Directive that marks the insertion point for the transcluded DOM of the nearest parent directive that uses transclusion.
  *
  * You can specify that you want to insert a named transclusion slot, instead of the default slot, by providing the slot name

package/src/directive/validators/validators.js

@@ -9,15 +9,11 @@ import { REGEX_STRING_REGEXP } from "./../attrs/attrs";
 import { startingTag } from "../../shared/jqlite/jqlite";
 
 /**
- * @ngdoc directive
- * @name ngRequiredf
- * @restrict A
  *
  * @param {String} ngRequired AngularJS expression. If it evaluates to `true`, it sets the
  *                                `required` attribute to the element and adds the `required`
  *                                {@link ngModel.NgModelController#$validators `validator`}.
  *
- * @description
  *
  * ngRequired adds the required {@link ngModel.NgModelController#$validators `validator`} to {@link ngModel `ngModel`}.
  * It is most often used for {@link input `input`} and {@link select `select`} controls, but can also be
@@ -68,10 +64,6 @@ export const requiredDirective = [
 ];
 
 /**
- * @ngdoc directive
- * @name ngPattern
- * @restrict A
- *
  * @param {String|RegExp} ngPattern AngularJS expression that must evaluate to a `RegExp` or a `String`
  *                                      parsable into a `RegExp`, or a `RegExp` literal. See above for
  *                                      more details.
@@ -178,10 +170,6 @@ export const patternDirective = [
 ];
 
 /**
- * @ngdoc directive
- * @name ngMaxlength
- * @restrict A
- *
  * @param {String} ngMaxlength AngularJS expression that must evaluate to a `Number` or `String`
  *                                 parsable into a `Number`. Used as value for the `maxlength`
  *                                 {@link ngModel.NgModelController#$validators validator}.
@@ -241,9 +229,6 @@ export const maxlengthDirective = [
 ];
 
 /**
- * @ngdoc directive
- * @name ngMinlength
- * @restrict A
  *
  * @param {string} ngMinlength AngularJS expression that must evaluate to a `Number` or `String`
  *                                 parsable into a `Number`. Used as value for the `minlength`

package/src/loader.js

@@ -113,61 +113,45 @@ export class Angular {
       strictDi: false,
     };
 
-    this.doBootstrap = function () {
-      const jqLite = JQLite(element);
+    const jqLite = JQLite(element);
 
-      if (jqLite.injector()) {
-        throw ngMinErr("btstrpd", "App already bootstrapped");
-      }
-
-      if (Array.isArray(modules)) {
-        this.bootsrappedModules = modules;
-      }
-
-      this.bootsrappedModules.unshift([
-        "$provide",
-        ($provide) => {
-          $provide.value("$rootElement", jqLite);
-        },
-      ]);
-
-      this.bootsrappedModules.unshift("ng");
+    if (jqLite.injector()) {
+      throw ngMinErr("btstrpd", "App already bootstrapped");
+    }
 
-      const injector = createInjector(this.bootsrappedModules, config.strictDi);
-      injector.invoke([
-        "$rootScope",
-        "$rootElement",
-        "$compile",
-        "$injector",
-        /**
-         * @param {import('./core/scope/scope').Scope} scope
-         * @param {JQLite} el
-         * @param {*} compile
-         * @param {import("./core/di/internal-injector").InjectorService} $injector
-         */
-        function (scope, el, compile, $injector) {
-          scope.$apply(() => {
-            el.data("$injector", $injector);
-            compile(el)(scope);
-          });
-        },
-      ]);
-      return injector;
-    };
+    if (Array.isArray(modules)) {
+      this.bootsrappedModules = modules;
+    }
 
-    const NG_DEFER_BOOTSTRAP = /^NG_DEFER_BOOTSTRAP!/;
+    this.bootsrappedModules.unshift([
+      "$provide",
+      ($provide) => {
+        $provide.value("$rootElement", jqLite);
+      },
+    ]);
 
-    if (window && !NG_DEFER_BOOTSTRAP.test(window.name)) {
-      return this.doBootstrap();
-    }
+    this.bootsrappedModules.unshift("ng");
 
-    window.name = window.name.replace(NG_DEFER_BOOTSTRAP, "");
-    this.resumeBootstrap = function (extraModules) {
-      if (Array.isArray(extraModules)) {
-        extraModules.forEach((module) => modules.push(module));
-      }
-      return this.doBootstrap();
-    };
+    const injector = createInjector(this.bootsrappedModules, config.strictDi);
+    injector.invoke([
+      "$rootScope",
+      "$rootElement",
+      "$compile",
+      "$injector",
+      /**
+       * @param {import('./core/scope/scope').Scope} scope
+       * @param {JQLite} el
+       * @param {*} compile
+       * @param {import("./core/di/internal-injector").InjectorService} $injector
+       */
+      function (scope, el, compile, $injector) {
+        scope.$apply(() => {
+          el.data("$injector", $injector);
+          compile(el)(scope);
+        });
+      },
+    ]);
+    return injector;
   }
 
   /**

package/src/public.js

@@ -129,7 +129,6 @@ export const VERSION = "[VI]{version}[/VI]";
  * @returns {import('./types').Module} `ng`module
  */
 export function publishExternalAPI(angular) {
-  console.assert(angular !== undefined, `angular is %s`, angular);
   const ng = angular
     .module(
       "ng",

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

@@ -249,12 +249,6 @@ export let ngView = [
               $$animLeave: animLeave,
             };
             /**
-             * @ngdoc event
-             * @name ui.router.state.directive:ui-view#$viewContentLoading
-             * @eventOf ui.router.state.directive:ui-view
-             * @eventType emits on ui-view directive scope
-             * @description
-             *
              * Fired once the view **begins loading**, *before* the DOM is rendered.
              *
              * @param {Object} event Event object.
@@ -280,11 +274,6 @@ export let ngView = [
             currentEl = cloned;
             currentScope = newScope;
             /**
-             * @ngdoc event
-             * @name ui.router.state.directive:ui-view#$viewContentLoaded
-             * @eventOf ui.router.state.directive:ui-view
-             * @eventType emits on ui-view directive scope
-             * @description           *
              * Fired once the view is **loaded**, *after* the DOM is rendered.
              *
              * @param {Object} event Event object.

package/src/router/params/param-type.js

@@ -30,27 +30,22 @@ export class ParamType {
    * @returns a new ParamType object
    */
   constructor(def) {
-    /** @inheritdoc */
     this.pattern = /.*/;
-    /** @inheritdoc */
     this.inherit = true;
     Object.assign(this, def);
     this.name = undefined;
   }
   // consider these four methods to be "abstract methods" that should be overridden
-  /** @inheritdoc */
-  is(_val) {
-    return true;
+
+  is(val) {
+    return !!val;
   }
-  /** @inheritdoc */
   encode(val) {
     return val;
   }
-  /** @inheritdoc */
   decode(val) {
     return val;
   }
-  /** @inheritdoc */
   equals(a, b) {
     return a == b;
   }

package/src/router/params/param-types.js

@@ -1,11 +1,4 @@
-import {
-  fromJson,
-  toJson,
-  equals,
-  inherit,
-  map,
-  pick,
-} from "../../shared/common";
+import { equals, inherit, map, pick } from "../../shared/common";
 import { isNullOrUndefined } from "../../shared/predicates";
 import { isDefined } from "../../shared/utils";
 import { is } from "../../shared/hof";
@@ -141,8 +134,8 @@ function initDefaultTypes() {
       capture: /([0-9]{4})-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])/,
     }),
     json: makeDefaultType({
-      encode: toJson,
-      decode: fromJson,
+      encode: JSON.stringify,
+      decode: JSON.parse,
       is: is(Object),
       equals: equals,
       pattern: /[^/]*/,

package/src/router/resolve/resolvable.js

@@ -1,4 +1,4 @@
-import { isFunction, isObject } from "../../shared/utils";
+import { assert, isFunction, isObject } from "../../shared/utils";
 import { services } from "../common/coreservices";
 import { trace } from "../common/trace";
 import { stringify } from "../../shared/strings";
@@ -27,12 +27,7 @@ export class Resolvable {
     if (arg1 instanceof Resolvable) {
       Object.assign(this, arg1);
     } else if (isFunction(resolveFn)) {
-      if (isNullOrUndefined(arg1))
-        throw new Error("new Resolvable(): token argument is required");
-      if (!isFunction(resolveFn))
-        throw new Error(
-          "new Resolvable(): resolveFn argument must be a function",
-        );
+      assert(!isNullOrUndefined(arg1), "token argument is required");
       this.token = arg1;
       this.policy = policy;
       this.resolveFn = resolveFn;
@@ -46,14 +41,11 @@ export class Resolvable {
       (Object.prototype.hasOwnProperty.call(arg1, "resolveFn") ||
         Object.prototype.hasOwnProperty.call(arg1, "data"))
     ) {
-      const literal = arg1;
-      return new Resolvable(
-        literal.token,
-        literal.resolveFn,
-        literal.deps,
-        literal.policy,
-        literal.data,
-      );
+      this.token = arg1.token;
+      this.resolveFn = arg1.resolveFn;
+      this.deps = arg1.deps;
+      this.policy = arg1.policy;
+      this.data = arg1.data;
     }
   }
   getPolicy(state) {

package/src/router/transition/transition.js

@@ -13,7 +13,7 @@ import {
   flattenR,
   uniqR,
 } from "../../shared/common";
-import { isUndefined, isObject } from "../../shared/utils";
+import { isUndefined, isObject, assert } from "../../shared/utils";
 import { prop, propEq, val, is } from "../../shared/hof";
 import { TransitionHookPhase } from "./interface"; // has or is using
 import { TransitionHook } from "./transition-hook";
@@ -334,7 +334,7 @@ export class Transition {
     const targetNode = find(topath, (node) => {
       return node.state.name === stateName;
     });
-    console.assert(targetNode, `targetNode not found ${stateName}`);
+    assert(!!targetNode, `targetNode not found ${stateName}`);
 
     const resolveContext = new ResolveContext(topath);
     resolveContext.addResolvables([resolvable], targetNode.state);

package/src/router/url/url-matcher.js

@@ -14,8 +14,8 @@ import { isDefined, isString } from "../../shared/utils";
 import { Param, DefType } from "../params/param";
 import { joinNeighborsR, splitOnDelim } from "../../shared/strings";
 function quoteRegExp(str, param) {
-  let surroundPattern = ["", ""],
-    result = str.replace(/[\\\[\]\^$*+?.()|{}]/g, "\\$&");
+  let surroundPattern = ["", ""];
+  let result = str.replace(/[\\[\]^$*+?.()|{}]/g, "\\$&");
   if (!param) return result;
   switch (param.squash) {
     case false:
@@ -207,9 +207,9 @@ export class UrlMatcher {
     //    \\.                            - a backslash escape
     //    \{(?:[^{}\\]+|\\.)*\}          - a matched set of curly braces containing other atoms
     const placeholder =
-      /([:*])([\w\[\]]+)|\{([\w\[\]]+)(?:\:\s*((?:[^{}\\]+|\\.|\{(?:[^{}\\]+|\\.)*\})+))?\}/g;
+      /([:*])([\w[\]]+)|\{([\w[\]]+)(?::\s*((?:[^{}\\]+|\\.|\{(?:[^{}\\]+|\\.)*\})+))?\}/g;
     const searchPlaceholder =
-      /([:]?)([\w\[\].-]+)|\{([\w\[\].-]+)(?:\:\s*((?:[^{}\\]+|\\.|\{(?:[^{}\\]+|\\.)*\})+))?\}/g;
+      /([:]?)([\w[\].-]+)|\{([\w[\].-]+)(?::\s*((?:[^{}\\]+|\\.|\{(?:[^{}\\]+|\\.)*\})+))?\}/g;
     const patterns = [];
     let last = 0;
     let matchArray;

package/src/services/browser.js

@@ -164,9 +164,6 @@ export function Browser(taskTracker) {
   }
 
   /**
-   * @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:
@@ -224,9 +221,6 @@ export function Browser(taskTracker) {
   /// ///////////////////////////////////////////////////////////
 
   /**
-   * @name $browser#baseHref
-   *
-   * @description
    * Returns current <base href>
    * (always relative - without domain)
    *
@@ -238,13 +232,11 @@ export function Browser(taskTracker) {
   };
 
   /**
-   * @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 {number} 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