@angular-wave/angular.ts 0.0.62 → 0.0.64

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

@@ -1,6 +1,5 @@
 import { dealoc } from "../shared/jqlite/jqlite";
 import { Angular } from "../loader";
-import { publishExternalAPI } from "../public";
 import { wait } from "../shared/test-utils";
 
 describe("ngView", () => {
@@ -10,7 +9,6 @@ describe("ngView", () => {
     beforeEach(() => {
       dealoc(document.getElementById("dummy"));
       window.angular = new Angular();
-      publishExternalAPI();
       window.angular.module("defaultModule", ["ng.router"]);
       let $injector = window.angular.bootstrap(
         document.getElementById("dummy"),
@@ -48,7 +46,6 @@ describe("ngView", () => {
     beforeEach(() => {
       dealoc(document.getElementById("dummy"));
       window.angular = new Angular();
-      publishExternalAPI();
       let module = window.angular.module("defaultModule", ["ng.router"]);
       module.config(($provide, $ngViewScrollProvider) => {
         $provide.decorator("$anchorScroll", function ($delegate) {

package/src/services/http/http.spec.js

@@ -1,6 +1,6 @@
 import { createInjector } from "../../injector";
 import { isObject } from "../../shared/utils";
-import { publishExternalAPI } from "../../public";
+import { Angular } from "../../loader";
 
 export function getLastAjaxRequest() {
   let ajaxEntries = performance
@@ -13,7 +13,7 @@ describe("$http", function () {
   let $http, $injector, $httpBackend, requests, response, $rootScope, $q;
 
   beforeEach(function () {
-    publishExternalAPI();
+    window.angular = new Angular();
     requests = [];
     $injector = createInjector(["ng"]);
     $http = $injector.get("$http");

package/src/services/http/template-request.spec.js

@@ -1,11 +1,11 @@
 import { createInjector } from "../../injector";
-import { publishExternalAPI } from "../../public";
+import { Angular } from "../../loader";
 
 describe("$templateRequest", () => {
-  let module, $rootScope, $templateRequest, $templateCache, $sce;
+  let module, $rootScope, $templateRequest, $templateCache, $sce, angular;
 
   beforeEach(() => {
-    publishExternalAPI();
+    angular = window.angular = new Angular();
     module = angular.module("test", ["ng"]);
     let injector = createInjector(["test"]);
     $rootScope = injector.get("$rootScope");

package/src/services/http-backend/http-backend.spec.js

@@ -1,5 +1,5 @@
 import { createInjector } from "../../injector";
-import { publishExternalAPI } from "../../public";
+import { Angular } from "../../loader";
 import { createHttpBackend } from "./http-backend";
 import sinon from "sinon";
 
@@ -9,6 +9,7 @@ describe("$httpBackend", () => {
   let xhr;
   let callback;
   let requests;
+  let angular;
 
   beforeEach(() => {
     xhr = sinon.useFakeXMLHttpRequest();
@@ -16,7 +17,7 @@ describe("$httpBackend", () => {
     xhr.onCreate = function (req) {
       requests.push(req);
     };
-    publishExternalAPI();
+    angular = window.angular = new Angular();
     let $injector = createInjector(["ng"]);
     $browser = $injector.get("$browser");
     xhr = sinon.useFakeXMLHttpRequest();

package/src/shared/jqlite/jqlite.js

@@ -16,11 +16,6 @@ import {
 import { CACHE, EXPANDO } from "../../core/cache/cache";
 
 /**
- * @name angular.element
- * @module ng
- * @kind function
- *
- * @description
  * Wraps a raw DOM element or HTML string as a [jQuery](http://jquery.com) element. Regardless of the presence of jQuery, `angular.element`
  * delegates to AngularJS's built-in subset of jQuery, called "jQuery lite" or **jqLite**.
  *
@@ -80,12 +75,6 @@ import { CACHE, EXPANDO } from "../../core/cache/cache";
  *   Requires {@link guide/production#disabling-debug-data Debug Data} to be enabled.
  * - `inheritedData()` - same as `data()`, but walks up the DOM until a value is found or the top
  *   parent element is reached.
- *
- * @knownIssue You cannot spy on `angular.element` if you are using Jasmine version 1.x. See
- * https://github.com/angular/angular.js/issues/14251 for more information.
- *
- * @param {string|Element} element HTML string or Element to be wrapped into jQuery.
- * @returns {JQLite} jQuery object.
  */
 
 /** @type {number} */
@@ -135,7 +124,7 @@ const BOOLEAN_ELEMENTS = {};
  * JQLite both a function and an array-like data structure for manipulation of DOM, linking elements to expando cache,
  * and execution of chain functions.
  *
- * @param {string|Element|Comment|Document|Window|JQLite|ArrayLike<Element>|(() => void)} element
+ * @param {string|Node|JQLite|ArrayLike<Element>|(() => void)} element
  * @returns {JQLite}
  */
 export function JQLite(element) {
@@ -553,15 +542,7 @@ JQLite.prototype.replaceWith = function (arg1) {
     });
   };
   for (let i = 0; i < this.length; i++) {
-    if (isUndefined(value)) {
-      value = fn(this[i], arg1);
-      if (isDefined(value)) {
-        // any function which returns a value needs to be wrapped
-        value = JQLite(value);
-      }
-    } else {
-      addNodes(value, fn(this[i], arg1));
-    }
+    addNodes(value, fn(this[i], arg1));
   }
   return isDefined(value) ? value : this;
 };
@@ -893,6 +874,7 @@ function elementAcceptsData(node) {
  * @returns {DocumentFragment}
  */
 export function buildFragment(html) {
+  /** @type {HTMLDivElement} */
   let tmp;
   let tag;
   let wrap;
@@ -905,6 +887,7 @@ export function buildFragment(html) {
     nodes.push(document.createTextNode(html));
   } else {
     // Convert html into DOM nodes
+
     tmp = tempFragment.appendChild(document.createElement("div"));
     tag = (TAG_NAME_REGEXP.exec(html) || ["", ""])[1].toLowerCase();
 
@@ -914,13 +897,13 @@ export function buildFragment(html) {
     i = wrap.length;
     while (--i > -1) {
       tmp.appendChild(window.document.createElement(wrap[i]));
-      tmp = tmp.firstChild;
+      tmp = /** @type {HTMLDivElement} */ (tmp.firstChild);
     }
     tmp.innerHTML = html;
 
     nodes = concat(nodes, tmp.childNodes);
 
-    tmp = tempFragment.firstChild;
+    tmp = /** @type {HTMLDivElement} */ (tempFragment.firstChild);
     tmp.textContent = "";
   }
 
@@ -1021,7 +1004,7 @@ export function getOrSetCacheData(element, key, value) {
 /**
  * Adds nodes or elements to the root array-like object.
  *
- * @param {Array} root - The array-like object to which elements will be added.
+ * @param {JQLite} root - The array-like object to which elements will be added.
  * @param {(Node|Array|NodeList|Object)} elements - The elements to add to the root. This can be a single DOM node, an array-like object (such as an Array or NodeList), or any other object.
  */
 function addNodes(root, elements) {
@@ -1054,7 +1037,7 @@ function getController(element, name) {
 
 /**
  *
- * @param {Element} element
+ * @param {Node} element
  * @param {string|string[]} name
  * @param {any} [value]
  * @returns
@@ -1064,13 +1047,20 @@ function getInheritedData(element, name, value) {
   // this makes $(document).scope() possible
   if (element.nodeType === Node.DOCUMENT_NODE) {
     // TODO Fix types
-    element = element.documentElement;
+    element = /** @type {Document} */ (element).documentElement;
   }
   const names = Array.isArray(name) ? name : [name];
 
   while (element) {
     for (let i = 0, ii = names.length; i < ii; i++) {
-      if (isDefined((value = getOrSetCacheData(element, names[i]))))
+      if (
+        isDefined(
+          (value = getOrSetCacheData(
+            /** @type {Element} */ (element),
+            names[i],
+          )),
+        )
+      )
         return value;
     }
 
@@ -1079,7 +1069,8 @@ function getInheritedData(element, name, value) {
     // to lookup parent controllers.
     element =
       element.parentNode ||
-      (element.nodeType === Node.DOCUMENT_FRAGMENT_NODE && element.host);
+      (element.nodeType === Node.DOCUMENT_FRAGMENT_NODE &&
+        /** @type {ShadowRoot} */ (element).host);
   }
 }
 
@@ -1193,7 +1184,7 @@ function specialMouseHandlerWrapper(target, event, handler) {
 export function startingTag(elementStr) {
   const clone = JQLite(elementStr)[0].cloneNode(true);
   const element = JQLite(clone).empty();
-  var elemHtml = JQLite("<div></div>").append(element).html();
+  var elemHtml = JQLite("<div></div>").append(element[0]).html();
   try {
     return element[0].nodeType === Node.TEXT_NODE
       ? lowercase(elemHtml)

package/src/shared/jqlite/jqlite.md

@@ -0,0 +1,62 @@
+/\*\*
+
+- Wraps a raw DOM element or HTML string as a [jQuery](http://jquery.com) element. Regardless of the presence of jQuery, `angular.element`
+- delegates to AngularJS's built-in subset of jQuery, called "jQuery lite" or **jqLite**.
+-
+- JQLite is a tiny, API-compatible subset of jQuery that allows
+- AngularJS to manipulate the DOM in a cross-browser compatible way. JQLite implements only the most
+- commonly needed functionality with the goal of having a very small footprint.
+-
+- <div class="alert alert-info">**Note:** All element references in AngularJS are always wrapped with
+- JQLite (such as the element argument in a directive's compile / link function). They are never raw DOM references.</div>
+-
+- <div class="alert alert-warning">**Note:** Keep in mind that this function will not find elements
+- by tag name / CSS selector. For lookups by tag name, try instead `angular.element(document).find(...)`
+- or `$document.find()`, or use the standard DOM APIs, e.g. `document.querySelectorAll()`.</div>
+-
+- ## AngularJS's JQLite
+- JQLite provides only the following jQuery methods:
+-
+- - [`after()`](http://api.jquery.com/after/)
+- - [`append()`](http://api.jquery.com/append/) - Contrary to jQuery, this doesn't clone elements
+- so will not work correctly when invoked on a JQLite object containing more than one DOM node
+- - [`attr()`](http://api.jquery.com/attr/) - Does not support functions as parameters
+- - [`children()`](http://api.jquery.com/children/) - Does not support selectors
+- - [`data()`](http://api.jquery.com/data/)
+- - [`empty()`](http://api.jquery.com/empty/)
+- - [`eq()`](http://api.jquery.com/eq/)
+- - [`html()`](http://api.jquery.com/html/)
+- - [`on()`](http://api.jquery.com/on/) - Does not support namespaces, selectors or eventData
+- - [`off()`](http://api.jquery.com/off/) - Does not support namespaces, selectors or event object as parameter
+- - [`parent()`](http://api.jquery.com/parent/) - Does not support selectors
+- - [`prepend()`](http://api.jquery.com/prepend/)
+- - [`remove()`](http://api.jquery.com/remove/)
+- - [`removeData()`](http://api.jquery.com/removeData/)
+- - [`replaceWith()`](http://api.jquery.com/replaceWith/)
+- - [`text()`](http://api.jquery.com/text/)
+- - [`val()`](http://api.jquery.com/val/)
+-
+- ## jQuery/jqLite Extras
+- AngularJS also provides the following additional methods and events to both jQuery and JQLite:
+-
+- ### Events
+- - `$destroy` - AngularJS intercepts all JQLite/jQuery's DOM destruction apis and fires this event
+- on all DOM nodes being removed. This can be used to clean up any 3rd party bindings to the DOM
+- element before it is removed.
+-
+- ### Methods
+- - `controller(name)` - retrieves the controller of the current element or its parent. By default
+- retrieves controller associated with the `ngController` directive. If `name` is provided as
+- camelCase directive name, then the controller for this directive will be retrieved (e.g.
+- `'ngModel'`).
+- - `injector()` - retrieves the injector of the current element or its parent.
+- - `scope()` - retrieves the {@link ng.$rootScope.Scope scope} of the current
+- element or its parent. Requires {@link guide/production#disabling-debug-data Debug Data} to
+- be enabled.
+- - `isolateScope()` - retrieves an isolate {@link ng.$rootScope.Scope scope} if one is attached directly to the
+- current element. This getter should be used only on elements that contain a directive which starts a new isolate
+- scope. Calling `scope()` on this element always returns the original non-isolate scope.
+- Requires {@link guide/production#disabling-debug-data Debug Data} to be enabled.
+- - `inheritedData()` - same as `data()`, but walks up the DOM until a value is found or the top
+- parent element is reached.
+  \*/

package/src/shared/jqlite/jqlite.spec.js

@@ -6,9 +6,8 @@ import {
   getOrSetCacheData,
   removeElementData,
 } from "./jqlite";
-import { angularInit } from "../../loader";
+import { Angular } from "../../loader";
 import { createInjector } from "../../injector";
-import { publishExternalAPI } from "../../public";
 import { equals, forEach } from "../../shared/utils";
 import { browserTrigger } from "../../shared/test-utils";
 import { CACHE, EXPANDO } from "../../core/cache/cache";
@@ -27,7 +26,7 @@ describe("jqLite", () => {
   });
 
   beforeEach(() => {
-    publishExternalAPI();
+    window.angular = new Angular();
     injector = createInjector(["ng"]);
     scope = injector.get("$rootScope");
     jasmine.addMatchers({
@@ -363,7 +362,7 @@ describe("jqLite", () => {
     it("should retrieve injector attached to the current element or its parent", () => {
       const template = JQLite("<div><span></span></div>");
       const span = template.children().eq(0);
-      const injector = angularInit(template[0]);
+      const injector = window.angular.init(template[0]);
 
       expect(span.injector()).toBe(injector);
       dealoc(template);

package/src/shared/min-err.spec.js

@@ -1,5 +1,4 @@
-import { minErr, isDefined, toDebugString } from "./utils";
-import { errorHandlingConfig } from "../loader";
+import { minErr, isDefined, toDebugString, errorHandlingConfig } from "./utils";
 
 describe("errors", () => {
   afterEach(() => {});

package/src/shared/test-utils.js

@@ -1,7 +1,7 @@
 import { JQLite } from "./jqlite/jqlite";
 
 /**
- * @param {HTMLElement} element
+ * @param {HTMLElement|JQLite} element
  * @param {string} event
  */
 export function browserTrigger(element, event) {

package/src/shared/utils.js

@@ -1101,7 +1101,41 @@ export function assertArgFn(arg, name, acceptArrayAnnotation) {
   return arg;
 }
 
-export const minErrConfig = {};
+/**
+ * @typedef {Object} ErrorHandlingConfig
+ * Error configuration object. May only contain the options that need to be updated.
+ * @property {number=} objectMaxDepth - The max depth for stringifying objects. Setting to a
+ *   non-positive or non-numeric value removes the max depth limit. Default: 5.
+ * @property {boolean=} urlErrorParamsEnabled - Specifies whether the generated error URL will
+ *   contain the parameters of the thrown error. Default: true. When used without argument, it returns the current value.
+ */
+
+/** @type {ErrorHandlingConfig} */
+const minErrConfig = {
+  objectMaxDepth: 5,
+  urlErrorParamsEnabled: true,
+};
+
+/**
+ * @param {ErrorHandlingConfig} [config]
+ * @returns {ErrorHandlingConfig}
+ */
+export function errorHandlingConfig(config) {
+  if (isObject(config)) {
+    if (isDefined(config.objectMaxDepth)) {
+      minErrConfig.objectMaxDepth = isValidObjectMaxDepth(config.objectMaxDepth)
+        ? config.objectMaxDepth
+        : NaN;
+    }
+    if (
+      isDefined(config.urlErrorParamsEnabled) &&
+      isBoolean(config.urlErrorParamsEnabled)
+    ) {
+      minErrConfig.urlErrorParamsEnabled = config.urlErrorParamsEnabled;
+    }
+  }
+  return minErrConfig;
+}
 
 /**
  * This object provides a utility for producing rich Error messages within
@@ -1158,7 +1192,7 @@ export function minErr(module) {
 
     message += `\n${url}${module ? `${module}/` : ""}${code}`;
 
-    if (minErrConfig.urlErrorParamsEnabled) {
+    if (errorHandlingConfig().urlErrorParamsEnabled) {
       for (
         i = 0, paramPrefix = "?";
         i < templateArgs.length;

package/src/types.js

@@ -1,7 +1,6 @@
 /**
  * @typedef {Object} BootstrapConfig
  * @description Configuration option for AngularTS bootstrap process.
- * @property {boolean} debugInfoEnabled - Indicates whether debug information should be enabled. Setting this to `false` can improve performance but will disable some debugging features.
  * @property {boolean} [strictDi] - Disable automatic function annotation for the application. This is meant to assist in finding bugs which break minified code. Defaults to `false`.
  */
 
@@ -451,9 +450,9 @@
  * @property {function(string, string=): any} get - Get a service by name.
  * @property {function(Function, any?): any} instantiate - Instantiate a type constructor with optional locals.
  * @property {function(Injectable<Function | ((...args: any[]) => any)>, any=, any=): any} invoke - Invoke a function with optional context and locals.
- * @property {function(Array<Module | string | Injectable<(...args: any[]) => void>>): void} loadNewModules - Add and load new modules to the injector.
- * @property {Object.<string, Module>} modules - A map of all the modules loaded into the injector.
- * @property {boolean} strictDi - Indicates if strict dependency injection is enforced.
+ * @property {function(Array<Module | string | Injectable<(...args: any[]) => void>>): void} [loadNewModules] - Add and load new modules to the injector.
+ * @property {Object.<string, Module>} [modules] - A map of all the modules loaded into the injector.
+ * @property {boolean} [strictDi] - Indicates if strict dependency injection is enforced.
  */
 
 export {};

package/types/animations/animate-css-driver.d.ts

@@ -4,8 +4,9 @@ export class $$AnimateCssDriverProvider {
     /**
      * @returns {Function}
      */
-    $get: (string | (($animateCss: any, $$AnimateRunner: typeof import("../core/animate/animate-runner").AnimateRunner, $rootElement: any) => (animationDetails: any) => any))[];
+    $get: (string | (($animateCss: any, $$AnimateRunner: typeof import("../core/animate/animate-runner").AnimateRunner, $rootElement: JQLite) => (animationDetails: any) => any))[];
 }
 export namespace $$AnimateCssDriverProvider {
     let $inject: string[];
 }
+import { JQLite } from "../shared/jqlite/jqlite";

package/types/animations/animate-queue.d.ts

@@ -6,7 +6,7 @@ export class $$AnimateQueueProvider {
         cancel: any[];
         join: any[];
     };
-    $get: (string | (($rootScope: any, $rootElement: any, $$animation: any, $$AnimateRunner: any, $templateRequest: any) => {
+    $get: (string | (($rootScope: any, $rootElement: JQLite, $$animation: any, $$AnimateRunner: any, $templateRequest: any) => {
         on(event: any, container: any, callback: any): void;
         off(event: any, container: any, callback: any, ...args: any[]): void;
         pin(element: any, parentElement: any): void;
@@ -17,3 +17,4 @@ export class $$AnimateQueueProvider {
 export namespace $$AnimateQueueProvider {
     let $inject: string[];
 }
+import { JQLite } from "../shared/jqlite/jqlite";

package/types/animations/module.d.ts

@@ -1 +1 @@
-export function initAnimateModule(): void;
+export function initAnimateModule(angular: any): void;

package/types/core/compile/compile.d.ts

@@ -147,7 +147,6 @@ export class $CompileProvider {
      *    chaining otherwise.
      */
     imgSrcSanitizationTrustedUrlList: (regexp?: RegExp | undefined) => RegExp | ng.ICompileProvider;
-    debugInfoEnabled: (enabled: any) => boolean | this;
     strictComponentBindingsEnabled: (enabled: any) => boolean | this;
     /**
      * @ngdoc method

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

@@ -204,6 +204,7 @@ export class $LocationProvider {
      * @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))[];
+    $get: (string | (($rootScope: any, $browser: any, $rootElement: JQLite) => LocationHtml5Url | LocationHashbangUrl))[];
 }
 export const PATH_MATCH: RegExp;
+import { JQLite } from "../../shared/jqlite/jqlite";

package/types/core/ng-module.d.ts

@@ -0,0 +1,57 @@
+export class NgModule {
+    /**
+     *
+     * @param {String} name - Name of the module
+     * @param {Array<String>} requires - List of modules which the injector will load before the current module
+     * @param {Function} [configFn]
+     */
+    constructor(name: string, requires: Array<string>, configFn?: Function);
+    /**
+     * @type {string}
+     * Name of the module.
+     */
+    name: string;
+    /**
+     * Holds the list of modules which the injector will load before the current module is
+     * loaded.
+     */
+    requires: string[];
+    configFn: Function;
+    /** @type {!Array.<Array.<*>>} */
+    _invokeQueue: Array<Array<any>>;
+    /** @type {!Array.<any>} */
+    _configBlocks: Array<any>;
+    /** @type {!Array.<Function>} */
+    _runBlocks: Array<Function>;
+    /** @type {Object} */
+    infoState: any;
+    /**
+     *
+     * @param {Object} value
+     * @returns
+     */
+    info(value: any): any;
+    /**
+     * @param {String} name
+     * @param {any} object
+     * @returns {NgModule}
+     */
+    value(name: string, object: any): NgModule;
+    /**
+     * @param {String} name
+     * @param {any} object
+     * @returns {NgModule}
+     */
+    constant(name: string, object: any): NgModule;
+    config(configFn: any): this;
+    run(block: any): this;
+    component(name: any, options: any): this;
+    factory(name: any, providerFunction: any): this;
+    service(name: any, serviceFunction: any): this;
+    provider(name: any, providerType: any): this;
+    decorator(name: any, decorFn: any): this;
+    directive(name: any, directiveFactory: any): this;
+    animation(name: any, animationFactory: any): this;
+    filter(name: any, filterFn: any): this;
+    controller(name: any, ctlFn: any): this;
+}

package/types/exts/aria/aria.d.ts

@@ -1 +1 @@
-export function initAriaModule(): void;
+export function initAriaModule(angular: any): void;

package/types/exts/messages/messages.d.ts

@@ -1 +1 @@
-export function initMessageModule(): void;
+export function initMessageModule(angular: any): void;

package/types/index.d.ts

@@ -1,5 +1,2 @@
-/**
- * @type {Angular}
- */
 export const angular: Angular;
 import { Angular } from "./loader";

package/types/injector.d.ts

@@ -1,10 +1,10 @@
-export function createInjector(modulesToLoad: any, strictDi: any): {
-    invoke: (fn: any, self: any, locals: any, serviceName: any) => any;
-    instantiate: (Type: any, locals: any, serviceName: any) => any;
-    get: (serviceName: any, caller: any) => any;
-    annotate: typeof annotate;
-    has: (name: any) => any;
-};
+/**
+ *
+ * @param {*} modulesToLoad
+ * @param {*} strictDi
+ * @returns {import("./types").InjectorService}
+ */
+export function createInjector(modulesToLoad: any, strictDi: any): import("./types").InjectorService;
 export namespace createInjector {
     export { annotate as $$annotate };
 }