@angular-wave/angular.ts 0.0.64 → 0.0.66

package/src/directive/ref/href.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../../loader";
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { dealoc } from "../../shared/jqlite/jqlite";
 import { isDefined } from "../../shared/utils";
 

package/src/directive/ref/ref.spec.js

@@ -1,4 +1,4 @@
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { Angular } from "../../loader";
 
 describe("ngRef", () => {

package/src/directive/repeat/repeat.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../../loader";
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { dealoc, JQLite } from "../../shared/jqlite/jqlite";
 import { forEach, valueFn } from "../../shared/utils";
 

package/src/directive/script/script.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../../loader";
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { dealoc, JQLite } from "../../shared/jqlite/jqlite";
 
 describe("scriptDirective", () => {

package/src/directive/select/select.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../../loader";
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { dealoc, JQLite } from "../../shared/jqlite/jqlite";
 import { forEach, hashKey, equals, isNumberNaN } from "../../shared/utils";
 import { browserTrigger } from "../../shared/test-utils";

package/src/directive/show-hide/show-hide.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../../loader";
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { dealoc, JQLite } from "../../shared/jqlite/jqlite";
 
 describe("ngShow / ngHide", () => {

package/src/directive/style/style.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../../loader";
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { dealoc, JQLite } from "../../shared/jqlite/jqlite";
 
 describe("ng-style", () => {

package/src/directive/switch/switch.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../../loader";
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { dealoc, JQLite } from "../../shared/jqlite/jqlite";
 
 describe("ngSwitch", () => {

package/src/directive/validators/validators.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../../loader";
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { dealoc } from "../../shared/jqlite/jqlite";
 
 describe("validators", () => {

package/src/exts/aria/aria.spec.js

@@ -1,4 +1,4 @@
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { Angular } from "../../loader";
 import { dealoc, JQLite } from "../../shared/jqlite/jqlite";
 

package/src/exts/messages/messages.spec.js

@@ -1,4 +1,4 @@
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { countWatchers } from "../../core/scope/scope";
 import { Angular } from "../../loader";
 import { isString } from "../../shared/utils";

package/src/filters/filter.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../loader";
-import { createInjector } from "../injector";
+import { createInjector } from "../core/di/injector";
 import { isString, includes } from "../shared/utils";
 import { JQLite } from "../shared/jqlite/jqlite";
 

package/src/filters/filters.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../loader";
-import { createInjector } from "../injector";
+import { createInjector } from "../core/di/injector";
 import { toJson } from "../shared/utils";
 
 describe("filters", () => {

package/src/filters/limit-to.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../loader";
-import { createInjector } from "../injector";
+import { createInjector } from "../di/injector";
 import { JQLite } from "../shared/jqlite/jqlite";
 
 describe("Filter: limitTo", () => {

package/src/filters/order-by.spec.js

@@ -1,5 +1,5 @@
 import { Angular } from "../loader";
-import { createInjector } from "../injector";
+import { createInjector } from "../di/injector";
 
 describe("Filter: orderBy", () => {
   let orderBy;

package/src/loader.js

@@ -7,16 +7,16 @@ import {
   errorHandlingConfig,
 } from "./shared/utils";
 import { JQLite } from "./shared/jqlite/jqlite";
-import { createInjector } from "./injector";
+import { createInjector } from "./core/di/injector";
+import { NgModule } from "./core/di/ng-module";
 import { CACHE } from "./core/cache/cache";
 import { publishExternalAPI } from "./public";
-import { NgModule } from "./core/ng-module";
 import { VERSION } from "./public";
 
 const ngMinErr = minErr("ng");
 const $injectorMinErr = minErr("$injector");
 
-/** @type {Object.<string, import('./types').Module>} */
+/** @type {Object.<string, NgModule>} */
 const modules = {};
 
 /**
@@ -144,7 +144,7 @@ export class Angular {
          * @param {*} scope
          * @param {JQLite} el
          * @param {*} compile
-         * @param {*} $injector
+         * @param {import("./core/di/internal-injector").InjectorService} $injector
          */
         function (scope, el, compile, $injector) {
           scope.$apply(() => {
@@ -264,10 +264,10 @@ export class Angular {
    * {@link ng.directive:ngApp ngApp} or
    * {@link angular.bootstrap} to simplify this process for you.
    *
-   * @param {!string} name The name of the module to create or retrieve.
-   * @param {!Array.<string>=} requires If specified then new module is being created. If
+   * @param {string} name The name of the module to create or retrieve.
+   * @param {Array.<string>} [requires] If specified then new module is being created. If
    *        unspecified then the module is being retrieved for further configuration.
-   * @param {Function=} configFn Optional configuration function for the module. Same as
+   * @param {Function} [configFn] Optional configuration function for the module. Same as
    *        {@link import('./types').Module#config Module#config()}.
    * @returns {NgModule} A newly registered module.
    */

package/src/loader.spec.js

@@ -1,27 +1,12 @@
 import { Angular } from "./loader";
-import { createInjector } from "./injector";
+import { createInjector } from "./core/di/injector";
 
 describe("module loader", () => {
   var angular;
   beforeEach(() => {
-    delete window.angular;
     angular = window.angular = new Angular();
   });
 
-  it("should set up namespace", () => {
-    expect(angular).toBeDefined();
-    expect(angular.module).toBeDefined();
-  });
-
-  it("should not override existing namespace", () => {
-    const { angular } = window;
-    const { module } = angular;
-
-    window.angular = new Angular();
-    expect(angular).toBe(angular);
-    expect(angular.module).toBe(module);
-  });
-
   it("allows registering a module", () => {
     const myModule = angular.module("myModule", []);
     expect(myModule).toBeDefined();
@@ -81,7 +66,7 @@ describe("module loader", () => {
     ).toBe(myModule);
 
     expect(myModule.requires).toEqual(["other"]);
-    expect(myModule._invokeQueue).toEqual([
+    expect(myModule.invokeQueue).toEqual([
       ["$provide", "constant", jasmine.objectContaining(["abc", 123])],
       ["$provide", "provider", jasmine.objectContaining(["sk", "sv"])],
       ["$provide", "factory", jasmine.objectContaining(["fk", "fv"])],
@@ -96,12 +81,12 @@ describe("module loader", () => {
         jasmine.objectContaining(["ctrl", "ccc"]),
       ],
     ]);
-    expect(myModule._configBlocks).toEqual([
+    expect(myModule.configBlocks).toEqual([
       ["$injector", "invoke", jasmine.objectContaining(["config"])],
       ["$provide", "decorator", jasmine.objectContaining(["dk", "dv"])],
       ["$injector", "invoke", jasmine.objectContaining(["init2"])],
     ]);
-    expect(myModule._runBlocks).toEqual(["runBlock"]);
+    expect(myModule.runBlocks).toEqual(["runBlock"]);
   });
 
   it("should not throw error when `module.decorator` is declared before provider that it decorates", () => {

package/src/public.spec.js

@@ -1,4 +1,4 @@
-import { createInjector } from "./injector";
+import { createInjector } from "./core/di/injector";
 import { Angular } from "./loader";
 
 describe("public", () => {

package/src/router/services.js

@@ -10,8 +10,16 @@
 import { services } from "./common/coreservices";
 import { unnestR } from "../shared/common";
 import { trace } from "./common/trace";
+import { annotate } from "../core/di/injector";
 
 runBlock.$inject = ["$injector", "$q", "$stateRegistry", "$urlService"];
+/**
+ *
+ * @param {import("../core/di/internal-injector").InjectorService} $injector
+ * @param {*} $q
+ * @param {*} $stateRegistry
+ * @param {*} $urlService
+ */
 export function runBlock($injector, $q, $stateRegistry, $urlService) {
   services.$injector = $injector;
   services.$q = $q;
@@ -32,10 +40,7 @@ export function runBlock($injector, $q, $stateRegistry, $urlService) {
     .filter((x) => x.deps === "deferred")
     .forEach(
       (resolvable) =>
-        (resolvable.deps = $injector.annotate(
-          resolvable.resolveFn,
-          $injector.strictDi,
-        )),
+        (resolvable.deps = annotate(resolvable.resolveFn, $injector.strictDi)),
     );
   // Start listening for url changes
   $urlService.listen();

package/src/router/state/state-builder.js

@@ -11,6 +11,7 @@ import { stringify } from "../../shared/strings";
 import { is, pattern, pipe, prop, val } from "../../shared/hof";
 import { Resolvable } from "../resolve/resolvable";
 import { services } from "../common/coreservices";
+import { annotate } from "../../core/di/injector";
 const parseUrl = (url) => {
   if (!isString(url)) return false;
   const root = url.charAt(0) === "^";
@@ -145,14 +146,14 @@ export function resolvablesBuilder(state) {
       policy: resolvePolicies[token],
     }));
   /** fetch DI annotations from a function or ng1-style array */
-  const annotate = (fn) => {
+  const annotateFn = (fn) => {
     const $injector = services.$injector;
     // ng1 doesn't have an $injector until runtime.
     // If the $injector doesn't exist, use "deferred" literal as a
     // marker indicating they should be annotated when runtime starts
     return (
       fn["$inject"] ||
-      ($injector && $injector.annotate(fn, $injector.strictDi)) ||
+      ($injector && annotate(fn, $injector.strictDi)) ||
       "deferred"
     );
   };
@@ -207,7 +208,7 @@ export function resolvablesBuilder(state) {
   const tuple2Resolvable = pattern([
         [pipe(prop('val'), isString), (tuple) => new Resolvable(tuple.token, ((x) => x), [tuple.val], tuple.policy)],
         [pipe(prop('val'), Array.isArray), (tuple) => new Resolvable(tuple.token, tail(tuple.val), tuple.val.slice(0, -1), tuple.policy)],
-        [pipe(prop('val'), isFunction), (tuple) => new Resolvable(tuple.token, tuple.val, annotate(tuple.val), tuple.policy)],
+        [pipe(prop('val'), isFunction), (tuple) => new Resolvable(tuple.token, tuple.val, annotateFn(tuple.val), tuple.policy)],
     ]);
   // prettier-ignore
   const item2Resolvable = pattern([

package/src/router/state/state-registry.js

@@ -50,6 +50,11 @@ export class StateRegistry {
 
   $get = [
     "$injector",
+    /**
+     *
+     * @param {import("../../core/di/internal-injector").InjectorService} $injector
+     * @returns
+     */
     ($injector) => {
       this.$injector = $injector;
       this.builder.$injector = $injector;

package/src/router/state/views.js

@@ -5,6 +5,7 @@ import { services } from "../common/coreservices";
 import { trace } from "../common/trace";
 import { ResolveContext } from "../resolve/resolve-context";
 import { Resolvable } from "../resolve/resolvable";
+import { annotate } from "../../core/di/injector";
 
 export function getNg1ViewConfigFactory() {
   let templateFactory = null;
@@ -141,7 +142,7 @@ export class Ng1ViewConfig {
   getController(context) {
     const provider = this.viewDecl.controllerProvider;
     if (!isInjectable(provider)) return this.viewDecl.controller;
-    const deps = services.$injector.annotate(provider);
+    const deps = annotate(provider);
     const providerFn = Array.isArray(provider) ? tail(provider) : provider;
     const resolvable = new Resolvable("", providerFn, deps);
     return resolvable.get(context);

package/src/router/template-factory.js

@@ -3,6 +3,7 @@ import { services } from "./common/coreservices";
 import { tail, unnestR } from "../shared/common";
 import { Resolvable } from "./resolve/resolvable";
 import { kebobString } from "../shared/strings";
+import { annotate } from "../core/di/injector";
 
 /**
  * @typedef BindingTuple
@@ -30,7 +31,7 @@ export class TemplateFactory {
      * @param {angular.ITemplateCacheService} $templateCache
      * @param {angular.ITemplateRequestService} $templateRequest
      * @param {angular.IQService} $q
-     * @param {angular.auto.IInjectorService} $injector
+     * @param {import("../core/di/internal-injector").InjectorService} $injector
      * @returns
      */
     ($http, $templateCache, $templateRequest, $q, $injector) => {
@@ -146,7 +147,7 @@ export class TemplateFactory {
    * for that string.
    */
   fromProvider(provider, params, context) {
-    const deps = this.$injector.annotate(provider);
+    const deps = annotate(provider);
     const providerFn = Array.isArray(provider) ? tail(provider) : provider;
     const resolvable = new Resolvable("", providerFn, deps);
     return resolvable.get(context);
@@ -159,7 +160,7 @@ export class TemplateFactory {
    * @return {string} The template html as a string: "<component-name input1='::$resolve.foo'></component-name>".
    */
   fromComponentProvider(provider, params, context) {
-    const deps = this.$injector.annotate(provider);
+    const deps = annotate(provider);
     const providerFn = Array.isArray(provider) ? tail(provider) : provider;
     const resolvable = new Resolvable("", providerFn, deps);
     return resolvable.get(context);
@@ -207,7 +208,7 @@ export class TemplateFactory {
       if (type === "&") {
         const res = context.getResolvable(resolveName);
         const fn = res && res.data;
-        const args = (fn && this.$injector.annotate(fn)) || [];
+        const args = (fn && annotate(fn)) || [];
         // account for array style injection, i.e., ['foo', function(foo) {}]
         const arrayIdxStr = Array.isArray(fn) ? `[${fn.length - 1}]` : "";
         return `${attrName}='$resolve.${resolveName}${arrayIdxStr}(${args.join(",")})'`;

package/src/services/http/http.js

@@ -499,6 +499,18 @@ export function $HttpProvider() {
     "$q",
     "$injector",
     "$sce",
+    /**
+     *
+     * @param {*} $browser
+     * @param {*} $httpBackend
+     * @param {*} $$cookieReader
+     * @param {*} $cacheFactory
+     * @param {*} $rootScope
+     * @param {*} $q
+     * @param {import("../../core/di/internal-injector").InjectorService} $injector
+     * @param {*} $sce
+     * @returns
+     */
     function (
       $browser,
       $httpBackend,

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

@@ -1,4 +1,4 @@
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { isObject } from "../../shared/utils";
 import { Angular } from "../../loader";
 

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

@@ -1,4 +1,4 @@
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { Angular } from "../../loader";
 
 describe("$templateRequest", () => {

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

@@ -1,4 +1,4 @@
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { Angular } from "../../loader";
 import { createHttpBackend } from "./http-backend";
 import sinon from "sinon";

package/src/shared/jqlite/jqlite.js

@@ -744,11 +744,9 @@ JQLite.prototype.triggerHandler = function (event, extraParameters) {
     if (isUndefined(value)) {
       value = fn(this[i], event, extraParameters);
       if (isDefined(value)) {
-        // @ts-ignore
         value = JQLite(value);
       }
     } else {
-      // @ts-ignore
       addNodes(value, fn(this[i], event, extraParameters));
     }
   }

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

@@ -7,7 +7,7 @@ import {
   removeElementData,
 } from "./jqlite";
 import { Angular } from "../../loader";
-import { createInjector } from "../../injector";
+import { createInjector } from "../../core/di/injector";
 import { equals, forEach } from "../../shared/utils";
 import { browserTrigger } from "../../shared/test-utils";
 import { CACHE, EXPANDO } from "../../core/cache/cache";

package/src/shared/utils.js

@@ -1070,7 +1070,16 @@ export function shallowCopy(src, dst) {
 }
 
 /**
- * throw error if the argument is falsy.
+ * Throw error if the argument is false
+ * @param {boolean} argument
+ * @param {string} errorMsg
+ */
+export function assert(argument, errorMsg = "Assertion failed") {
+  if (!argument) throw new Error(errorMsg);
+}
+
+/**
+ * Throw error if the argument is falsy.
  */
 export function assertArg(arg, name, reason) {
   if (!arg) {

package/src/src.html

@@ -12,7 +12,6 @@
     <script src="/jasmine/jasmine-5.1.2/boot1.js"></script>
     <script type="module" src="/src/angular.spec.js"></script>
     <script type="module" src="/src/binding.spec.js"></script>
-    <script type="module" src="/src/injector.spec.js"></script>
     <script type="module" src="/src/loader.spec.js"></script>
     <script type="module" src="/src/public.spec.js"></script>
   </head>

package/src/types.js

@@ -10,6 +10,15 @@
  * @template T
  */
 
+/**
+ *
+ * @typedef {Object} Annotated
+ * @property {Array<String>} $inject
+ *  *
+ * @typedef {Function & Annotated & Array<any>} AnnotatedFunction
+ *
+ */
+
 /**
  * @typedef {Object} ComponentOptions
  * @description Component definition object (a simplified directive definition object)
@@ -444,15 +453,4 @@
  * @property {function(any, any): IPromise<any>} [index] - Async validator function for each index.
  */
 
-/**
- * @typedef {Object} InjectorService
- * @property {function(Function, boolean=): string[]} annotate - Annotate a function or an array of inline annotations.
- * @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.
- */
-
 export {};

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

@@ -1,7 +1,7 @@
 export function $$AnimateJsProvider($animateProvider: any): void;
 export class $$AnimateJsProvider {
     constructor($animateProvider: any);
-    $get: (string | (($injector: any, $$AnimateRunner: any) => (element: any, event: any, classes: any, options: any, ...args: any[]) => {
+    $get: (string | (($injector: import("../core/di/internal-injector").InjectorService, $$AnimateRunner: any) => (element: any, event: any, classes: any, options: any, ...args: any[]) => {
         $$willAnimate: boolean;
         end(): any;
         start(): any;

package/types/animations/animation.d.ts

@@ -1,5 +1,5 @@
 export function $$AnimationProvider(): void;
 export class $$AnimationProvider {
     drivers: any[];
-    $get: (string | (($rootScope: any, $injector: any, $$AnimateRunner: any, $$rAFScheduler: import("./raf-scheduler").RafScheduler, $$animateCache: any) => (element: any, event: any, options: any) => any))[];
+    $get: (string | (($rootScope: any, $injector: import("../core/di/internal-injector").InjectorService, $$AnimateRunner: any, $$rAFScheduler: import("./raf-scheduler").RafScheduler, $$animateCache: any) => (element: any, event: any, options: any) => any))[];
 }

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

@@ -161,7 +161,7 @@ export class $CompileProvider {
      * @returns {object} `this` for chaining
      */
     addPropertySecurityContext: (elementName: string, propertyName: string, ctx: string) => object;
-    $get: (string | (($injector: any, $interpolate: any, $exceptionHandler: any, $templateRequest: any, $parse: any, $controller: any, $rootScope: any, $sce: any, $animate: any) => ($compileNodes: string | NodeList, transcludeFn: any, maxPriority: any, ignoreDirective: any, previousCompileContext: any) => (scope: any, cloneConnectFn: any, options: any) => string | NodeList | JQLite))[];
+    $get: (string | (($injector: import("../../core/di/internal-injector").InjectorService, $interpolate: any, $exceptionHandler: any, $templateRequest: any, $parse: any, $controller: any, $rootScope: any, $sce: any, $animate: any) => ($compileNodes: string | NodeList, transcludeFn: any, maxPriority: any, ignoreDirective: any, previousCompileContext: any) => (scope: any, cloneConnectFn: any, options: any) => string | NodeList | JQLite))[];
 }
 export namespace $CompileProvider {
     let $inject: string[];

package/types/core/controller/controller.d.ts

@@ -28,5 +28,5 @@ export class $ControllerProvider {
      *    annotations in the array notation).
      */
     register: (name: string | any, constructor: Function | any[]) => void;
-    $get: (string | (($injector: any) => (expression: Function | string, locals: any, later: any, ident: any) => any))[];
+    $get: (string | (($injector: import("../../core/di/internal-injector").InjectorService) => (expression: Function | string, locals: any, later: any, ident: any) => any))[];
 }

package/types/core/di/injector.d.ts

@@ -0,0 +1,18 @@
+/**
+ *
+ * @param {Array<String|Function>} modulesToLoad
+ * @param {boolean} [strictDi]
+ * @returns {InjectorService}
+ */
+export function createInjector(modulesToLoad: Array<string | Function>, strictDi?: boolean): InjectorService;
+/**
+ *
+ * @param {any} fn
+ * @param {boolean} [strictDi]
+ * @param {String} [name]
+ * @returns {Array<string>}
+ */
+export function annotate(fn: any, strictDi?: boolean, name?: string): Array<string>;
+/** @type {String[]} Used only for error reporting of circular dependencies*/
+export const path: string[];
+import { InjectorService } from "./internal-injector";

package/types/core/di/internal-injector.d.ts

@@ -0,0 +1,36 @@
+export class ProviderInjector {
+    /**
+     *
+     * @param {Object} cache
+     * @param {boolean} strictDi
+     */
+    constructor(cache: any, strictDi: boolean);
+    cache: any;
+    strictDi: boolean;
+    path: any[];
+    providerCache: any;
+    modules: any;
+    factory(caller: any): void;
+    /**
+     *
+     * @param {String} serviceName
+     * @returns {any}
+     */
+    get(serviceName: string): any;
+    injectionArgs(fn: any, locals: any, serviceName: any): any[];
+    invoke(fn: any, self: any, locals: any, serviceName: any): any;
+    instantiate(Type: any, locals: any, serviceName: any): any;
+    /**
+     *
+     * @param {String} name
+     * @returns {boolean}
+     */
+    has(name: string): boolean;
+}
+export class InjectorService extends ProviderInjector {
+    constructor(cache: any, strictDi: any, providerInjector: any);
+    strictDi: any;
+    providerInjector: any;
+    factory(serviceName: any, caller: any): any;
+    loadNewModules(): void;
+}

package/types/core/{ng-module.d.ts → di/ng-module.d.ts}

@@ -1,3 +1,19 @@
+export const PROVIDE_LITERAL: "$provide";
+export const INJECTOR_LITERAL: "$injector";
+export const COMPILE_LITERAL: "$compileProvider";
+export const ANIMATION_LITERAL: "$animateProvider";
+export const FILTER_LITERAL: "$filterProvider";
+export const CONTROLLER_LITERAL: "$controllerProvider";
+/**
+ * Modules are collections of application configuration information for components:
+ * controllers, directives, filters, etc. They provide recipes for the injector
+ * to do the actual instantiation. A module itself has no behaviour but only state.
+ * A such, it acts as a data structure between the Angular instance and the injector service.
+ *
+ * Since this is an internal structure that is exposed only via the Angular instance,
+ * it contains no validation of the items it receives. It is up to the instantiator on
+ * modules to do the actual validation.
+ */
 export class NgModule {
     /**
      *
@@ -16,17 +32,18 @@ export class NgModule {
      * loaded.
      */
     requires: string[];
-    configFn: Function;
-    /** @type {!Array.<Array.<*>>} */
-    _invokeQueue: Array<Array<any>>;
-    /** @type {!Array.<any>} */
-    _configBlocks: Array<any>;
+    /**
+     * Holds a collection of tasks, required to instantiate an angular component
+     * @type {!Array<Array<*>>}
+     */
+    invokeQueue: Array<Array<any>>;
+    /** @type {!Array<Array<*>>} */
+    configBlocks: Array<Array<any>>;
     /** @type {!Array.<Function>} */
-    _runBlocks: Array<Function>;
+    runBlocks: Array<Function>;
     /** @type {Object} */
     infoState: any;
     /**
-     *
      * @param {Object} value
      * @returns
      */
@@ -43,7 +60,12 @@ export class NgModule {
      * @returns {NgModule}
      */
     constant(name: string, object: any): NgModule;
-    config(configFn: any): this;
+    /**
+     *
+     * @param {Function} configFn
+     * @returns {NgModule}
+     */
+    config(configFn: Function): NgModule;
     run(block: any): this;
     component(name: any, options: any): this;
     factory(name: any, providerFunction: any): this;