feat: unify signatures of with and bind (#78)

Author: rauno56

src/api/context.ts

@@ -79,11 +79,11 @@ export class ContextAPI {
   /**
    * Bind a context to a target function or event emitter
    *
-   * @param target function or event emitter to bind
    * @param context context to bind to the event emitter or function. Defaults to the currently active context
+   * @param target function or event emitter to bind
    */
-  public bind<T>(target: T, context: Context = this.active()): T {
-    return this._getContextManager().bind(target, context);
+  public bind<T>(context: Context, target: T): T {
+    return this._getContextManager().bind(context, target);
   }
 
   private _getContextManager(): ContextManager {

src/context/NoopContextManager.ts

@@ -31,7 +31,7 @@ export class NoopContextManager implements types.ContextManager {
     return fn.call(thisArg, ...args);
   }
 
-  bind<T>(target: T, _context?: types.Context): T {
+  bind<T>(_context: types.Context, target: T): T {
     return target;
   }
 

src/context/types.ts

@@ -62,10 +62,10 @@ export interface ContextManager {
 
   /**
    * Bind an object as the current context (or a specific one)
-   * @param target Any object to which a context need to be set
    * @param [context] Optionally specify the context which you want to assign
+   * @param target Any object to which a context need to be set
    */
-  bind<T>(target: T, context?: Context): T;
+  bind<T>(context: Context, target: T): T;
 
   /**
    * Enable context management

test/context/NoopContextManager.test.ts

@@ -119,13 +119,19 @@ describe('NoopContextManager', () => {
   describe('.bind()', () => {
     it('should return the same target (when enabled)', () => {
       const test = { a: 1 };
-      assert.deepStrictEqual(contextManager.bind(test), test);
+      assert.deepStrictEqual(
+        contextManager.bind(contextManager.active(), test),
+        test
+      );
     });
 
     it('should return the same target (when disabled)', () => {
       contextManager.disable();
       const test = { a: 1 };
-      assert.deepStrictEqual(contextManager.bind(test), test);
+      assert.deepStrictEqual(
+        contextManager.bind(contextManager.active(), test),
+        test
+      );
       contextManager.enable();
     });
   });