chore: internally document methods

lib/injector.js

@@ -114,18 +114,38 @@ export default function Injector(modules, parent) {
     };
   }
 
-  function instantiate(Type) {
+  /**
+   * Instantiate the given type, injecting dependencies.
+   *
+   * @template T
+   *
+   * @param { Function | [...string[], Function ]} type
+   *
+   * @return T
+   */
+  function instantiate(type) {
     const {
       fn,
       dependencies
-    } = fnDef(Type);
+    } = fnDef(type);
 
     // instantiate var args constructor
     const Constructor = Function.prototype.bind.apply(fn, [ null ].concat(dependencies));
 
     return new Constructor();
   }
 
+  /**
+   * Invoke the given function, injecting dependencies. Return the result.
+   *
+   * @template T
+   *
+   * @param { Function | [...string[], Function ]} func
+   * @param { Object } [context]
+   * @param { Object } [locals]
+   *
+   * @return {T} invocation result
+   */
   function invoke(func, context, locals) {
     const {
       fn,