@plugjs/plug 0.0.14 → 0.0.15

package/dist/log.cjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/log.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA2B;AAC3B,oBAA+B;AAC/B,qBAA6B;AAE7B,wBAAc,6BAJd;AAKA,wBAAc,6BALd;AAMA,wBAAc,6BANd;AAOA,wBAAc,8BAPd;AAQA,wBAAc,6BARd;AAAA,IAeA,6BAAa;AAUN,IAAM,OAAoB,MAAmB;AAElD,QAAM,SAAS,MAAQ;AA3BzB;AA2B6B,+CAAW,MAAX,mBAAc,YAAO,yBAAU;AAAA;AAG1D,QAAM,UAAe;AAAA,IACnB,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,IAEA,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,IAEA,QAAQ,MAA4B;AAClC,aAAO,EAAE,KAAK,GAAG,IAAI;AACrB,aAAO;AAAA,IACT;AAAA,IAEA,UAAU,MAA4B;AACpC,aAAO,EAAE,OAAO,GAAG,IAAI;AACvB,aAAO;AAAA,IACT;AAAA,IAEA,QAAQ,MAA4B;AAClC,aAAO,EAAE,KAAK,GAAG,IAAI;AACrB,aAAO;AAAA,IACT;AAAA,IAEA,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAMA,OAAM,IAAI,SAAgC,KAAK,QAAQ,OAAO,GAAG,IAAI;AAG3E,SAAO,OAAO,OAAOA,MAAK,OAAO;AACnC,GAAG;",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA+B;AAC/B,oBAA+B;AAC/B,qBAA6B;AAE7B,wBAAc,6BAJd;AAKA,wBAAc,6BALd;AAMA,wBAAc,6BANd;AAOA,wBAAc,8BAPd;AAQA,wBAAc,6BARd;AAAA,IAeA,6BAAa;AAUN,IAAM,OAAoB,MAAmB;AAElD,QAAM,SAAS,MAAQ;AA3BzB;AA2B6B,mDAAe,MAAf,mBAAkB,YAAO,yBAAU;AAAA;AAG9D,QAAM,UAAe;AAAA,IACnB,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,IAEA,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,IAEA,QAAQ,MAA4B;AAClC,aAAO,EAAE,KAAK,GAAG,IAAI;AACrB,aAAO;AAAA,IACT;AAAA,IAEA,UAAU,MAA4B;AACpC,aAAO,EAAE,OAAO,GAAG,IAAI;AACvB,aAAO;AAAA,IACT;AAAA,IAEA,QAAQ,MAA4B;AAClC,aAAO,EAAE,KAAK,GAAG,IAAI;AACrB,aAAO;AAAA,IACT;AAAA,IAEA,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAMA,OAAM,IAAI,SAAgC,KAAK,QAAQ,OAAO,GAAG,IAAI;AAG3E,SAAO,OAAO,OAAOA,MAAK,OAAO;AACnC,GAAG;",
   "names": ["log"]
 }

package/dist/log.d.ts

@@ -1,9 +1,9 @@
-import { Log } from './log/logger.js';
-export * from './log/colors.js';
-export * from './log/levels.js';
-export * from './log/logger.js';
-export * from './log/options.js';
-export * from './log/report.js';
+import { Log } from './log/logger';
+export * from './log/colors';
+export * from './log/levels';
+export * from './log/logger';
+export * from './log/options';
+export * from './log/report';
 /** The generic, shared `log` function type. */
 export declare type LogFunction = ((...args: [any, ...any]) => void) & Log;
 /** Our logging function (defaulting to the `NOTICE` level) */

package/dist/log.mjs

@@ -1,5 +1,5 @@
 // log.ts
-import { currentRun } from "./async.mjs";
+import { currentContext } from "./async.mjs";
 import { getLogger } from "./log/logger.mjs";
 import { setupSpinner } from "./log/spinner.mjs";
 export * from "./log/colors.mjs";
@@ -11,7 +11,7 @@ setupSpinner();
 var log = (() => {
   const logger = () => {
     var _a;
-    return ((_a = currentRun()) == null ? void 0 : _a.log) || getLogger();
+    return ((_a = currentContext()) == null ? void 0 : _a.log) || getLogger();
   };
   const wrapper = {
     trace(...args) {

package/dist/log.mjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/log.ts"],
-  "mappings": ";AAAA,SAAS,kBAAkB;AAC3B,SAAS,iBAAsB;AAC/B,SAAS,oBAAoB;AAE7B,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAOd,aAAa;AAUN,IAAM,OAAoB,MAAmB;AAElD,QAAM,SAAS,MAAQ;AA3BzB;AA2B6B,6BAAW,MAAX,mBAAc,QAAO,UAAU;AAAA;AAG1D,QAAM,UAAe;AAAA,IACnB,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,IAEA,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,IAEA,QAAQ,MAA4B;AAClC,aAAO,EAAE,KAAK,GAAG,IAAI;AACrB,aAAO;AAAA,IACT;AAAA,IAEA,UAAU,MAA4B;AACpC,aAAO,EAAE,OAAO,GAAG,IAAI;AACvB,aAAO;AAAA,IACT;AAAA,IAEA,QAAQ,MAA4B;AAClC,aAAO,EAAE,KAAK,GAAG,IAAI;AACrB,aAAO;AAAA,IACT;AAAA,IAEA,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAMA,OAAM,IAAI,SAAgC,KAAK,QAAQ,OAAO,GAAG,IAAI;AAG3E,SAAO,OAAO,OAAOA,MAAK,OAAO;AACnC,GAAG;",
+  "mappings": ";AAAA,SAAS,sBAAsB;AAC/B,SAAS,iBAAsB;AAC/B,SAAS,oBAAoB;AAE7B,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAOd,aAAa;AAUN,IAAM,OAAoB,MAAmB;AAElD,QAAM,SAAS,MAAQ;AA3BzB;AA2B6B,iCAAe,MAAf,mBAAkB,QAAO,UAAU;AAAA;AAG9D,QAAM,UAAe;AAAA,IACnB,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,IAEA,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,IAEA,QAAQ,MAA4B;AAClC,aAAO,EAAE,KAAK,GAAG,IAAI;AACrB,aAAO;AAAA,IACT;AAAA,IAEA,UAAU,MAA4B;AACpC,aAAO,EAAE,OAAO,GAAG,IAAI;AACvB,aAAO;AAAA,IACT;AAAA,IAEA,QAAQ,MAA4B;AAClC,aAAO,EAAE,KAAK,GAAG,IAAI;AACrB,aAAO;AAAA,IACT;AAAA,IAEA,SAAS,MAA4B;AACnC,aAAO,EAAE,MAAM,GAAG,IAAI;AACtB,aAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAMA,OAAM,IAAI,SAAgC,KAAK,QAAQ,OAAO,GAAG,IAAI;AAG3E,SAAO,OAAO,OAAOA,MAAK,OAAO;AACnC,GAAG;",
   "names": ["log"]
 }

package/dist/pipe.cjs

@@ -20,52 +20,59 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // pipe.ts
 var pipe_exports = {};
 __export(pipe_exports, {
+  Context: () => Context,
   Pipe: () => Pipe,
-  PipeImpl: () => PipeImpl,
-  install: () => install
+  install: () => install,
+  installForking: () => installForking
 });
 module.exports = __toCommonJS(pipe_exports);
-var import_assert = require("./assert.cjs");
-var Pipe = class {
-};
-var PipeImpl = class extends Pipe {
-  #promise;
-  #run;
-  constructor(start, run) {
-    super();
-    this.#promise = Promise.resolve(start);
-    this.#run = run;
-  }
-  plug(arg) {
-    const plug = typeof arg === "function" ? { pipe: arg } : arg;
-    const promise = this.#promise.then((files) => {
-      (0, import_assert.assert)(files, "Pipe can not be further extended");
-      return plug.pipe(files, this.#run);
-    });
-    return new PipeImpl(promise, this.#run);
-  }
-  then(onfulfilled, onrejected) {
-    return this.#promise.then(onfulfilled, onrejected);
-  }
-  catch(onrejected) {
-    return this.#promise.catch(onrejected);
+var import_log = require("./log.cjs");
+var import_paths = require("./paths.cjs");
+var import_fork = require("./fork.cjs");
+var import_path = require("path");
+var Context = class {
+  constructor(buildFile, taskName) {
+    this.buildFile = buildFile;
+    this.taskName = taskName;
+    this.buildDir = (0, import_paths.getAbsoluteParent)(buildFile);
+    this.log = (0, import_log.getLogger)(taskName);
   }
-  finally(onfinally) {
-    return this.#promise.finally(onfinally);
+  buildDir;
+  log;
+  resolve(path, ...paths) {
+    if (path && path.startsWith("@")) {
+      const components = path.substring(1).split(import_path.sep).filter((s) => !!s);
+      return (0, import_paths.resolveAbsolutePath)(this.buildDir, ...components, ...paths);
+    }
+    if (!path)
+      return (0, import_paths.getCurrentWorkingDirectory)();
+    return (0, import_paths.resolveAbsolutePath)((0, import_paths.getCurrentWorkingDirectory)(), path, ...paths);
   }
-  [Symbol.toStringTag] = "Pipe";
+};
+var PipeProto = class {
+};
+var Pipe = class extends PipeProto {
 };
 function install(name, ctor) {
-  function create(...args) {
+  function plug(...args) {
     return this.plug(new ctor(...args));
   }
-  Object.defineProperty(create, "name", { value: name });
-  Object.defineProperty(Pipe.prototype, name, { value: create });
+  Object.defineProperty(plug, "name", { value: name });
+  Object.defineProperty(PipeProto.prototype, name, { value: plug });
+}
+function installForking(plugName, scriptFile) {
+  const ctor = class extends import_fork.ForkingPlug {
+    constructor(...args) {
+      super(scriptFile, args);
+    }
+  };
+  install(plugName, ctor);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  Context,
   Pipe,
-  PipeImpl,
-  install
+  install,
+  installForking
 });
 //# sourceMappingURL=pipe.cjs.map

package/dist/pipe.cjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/pipe.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAuB;AA4BhB,IAAe,OAAf,MAAoC;AAG3C;AAIO,IAAM,WAAN,cAAoD,KAA2B;AAAA,EAC3E;AAAA,EACA;AAAA,EAET,YAAY,OAAuB,KAAU;AAC3C,UAAM;AACN,SAAK,WAAW,QAAQ,QAAQ,KAAK;AACrC,SAAK,OAAO;AAAA,EACd;AAAA,EAEA,KAAkC,KAAmD;AACnF,UAAM,OAAO,OAAO,QAAQ,aAAa,EAAE,MAAM,IAAI,IAAI;AACzD,UAAM,UAAU,KAAK,SAAS,KAAK,CAAC,UAAU;AAC5C,gCAAO,OAAO,kCAAkC;AAChD,aAAO,KAAK,KAAK,OAAO,KAAK,IAAI;AAAA,IACnC,CAAC;AACD,WAAO,IAAI,SAAS,SAAS,KAAK,IAAI;AAAA,EACxC;AAAA,EAEA,KACI,aACA,YACgB;AAClB,WAAO,KAAK,SAAS,KAAK,aAAa,UAAU;AAAA,EACnD;AAAA,EAEA,MACI,YACe;AACjB,WAAO,KAAK,SAAS,MAAM,UAAU;AAAA,EACvC;AAAA,EAEA,QACI,WACU;AACZ,WAAO,KAAK,SAAS,QAAQ,SAAS;AAAA,EACxC;AAAA,EAEA,CAAC,OAAO,eAAe;AACzB;AA+IO,SAAS,QAAmC,MAAgB,MAAe;AAGhF,WAAS,UAAsB,MAA8C;AAE3E,WAAO,KAAK,KAAK,IAAI,KAAK,GAAG,IAAI,CAAQ;AAAA,EAC3C;AAGA,SAAO,eAAe,QAAQ,QAAQ,EAAE,OAAO,KAAK,CAAC;AAGrD,SAAO,eAAe,KAAK,WAAW,MAAM,EAAE,OAAO,OAAO,CAAC;AAC/D;",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,iBAAkC;AAClC,mBAAiG;AAEjG,kBAA4B;AAC5B,kBAAoB;AA+Bb,IAAM,UAAN,MAAc;AAAA,EAMnB,YAEoB,WAEA,UAClB;AAHkB;AAEA;AAElB,SAAK,eAAW,gCAAkB,SAAS;AAC3C,SAAK,UAAM,sBAAU,QAAQ;AAAA,EAC/B;AAAA,EAZgB;AAAA,EAEA;AAAA,EAYhB,QAAQ,SAAiB,OAA+B;AAEtD,QAAI,QAAQ,KAAK,WAAW,GAAG,GAAG;AAEhC,YAAM,aAAa,KAAK,UAAU,CAAC,EAAE,MAAM,eAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACjE,iBAAO,kCAAoB,KAAK,UAAU,GAAG,YAAY,GAAG,KAAK;AAAA,IACnE;AAGA,QAAI,CAAE;AAAM,iBAAO,yCAA2B;AAG9C,eAAO,sCAAoB,yCAA2B,GAAG,MAAM,GAAG,KAAK;AAAA,EACzE;AACF;AAUA,IAAe,YAAf,MAAyB;AAEzB;AAMO,IAAe,OAAf,cAA4B,UAAU;AAO7C;AAyGO,SAAS,QAGd,MAAY,MAAkB;AAE9B,WAAS,QAAyB,MAAuD;AAEvF,WAAO,KAAK,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC;AAAA,EACpC;AAGA,SAAO,eAAe,MAAM,QAAQ,EAAE,OAAO,KAAK,CAAC;AAGnD,SAAO,eAAe,UAAU,WAAW,MAAM,EAAE,OAAO,KAAK,CAAC;AAClE;AAmBO,SAAS,eACZ,UACA,YACI;AAEN,QAAM,OAAO,cAAc,wBAAY;AAAA,IACrC,eAAe,MAAa;AAC1B,YAAM,YAAY,IAAI;AAAA,IACxB;AAAA,EACF;AAGA,UAAQ,UAAU,IAAI;AACxB;",
   "names": []
 }

package/dist/pipe.d.ts

@@ -1,128 +1,138 @@
-import { Files } from './files.js';
-import { Run } from './run.js';
+import type { Files } from './files';
+import { Logger } from './log';
+import { AbsolutePath } from './paths';
+/** A convenience type indicating what can be returned by a {@link Plug}. */
+export declare type PlugResult = Files | undefined | void;
 /**
- * The {@link Plug} interface describes an extension mechanism for our build.
+ * The {@link Plug} interface describes _build plugin_.
+ *
+ * A {@link Plug} receives a {@link Files} instance in its input (for example
+ * a list of _source `.ts` files_) and optionally produces a possibly different
+ * list (for example the _compiled `.js` files_).
  */
-export interface Plug<T extends Files | undefined> {
-    pipe(files: Files, run: Run): T | Promise<T>;
+export interface Plug<T extends PlugResult> {
+    pipe(files: Files, context: Context): T | Promise<T>;
 }
+/** A type identifying a {@link Plug} as a `function` */
+export declare type PlugFunction<T extends PlugResult> = Plug<T>['pipe'];
 /**
- * A type identifying a {@link Plug} as a `function`
+ * The {@link Context} class defines the context in which a {@link Plug}
+ * is invoked.
  */
-export declare type PlugFunction<T extends Files | undefined> = Plug<T>['pipe'];
+export declare class Context {
+    /** The absolute file name where the task was defined. */
+    readonly buildFile: AbsolutePath;
+    /** The _name_ of the task associated with this {@link Context}. */
+    readonly taskName: string;
+    /** The directory of the file where the task was defined (convenience). */
+    readonly buildDir: AbsolutePath;
+    /** The {@link Logger} associated with this instance. */
+    readonly log: Logger;
+    constructor(
+    /** The absolute file name where the task was defined. */
+    buildFile: AbsolutePath, 
+    /** The _name_ of the task associated with this {@link Context}. */
+    taskName: string);
+    resolve(path: string, ...paths: string[]): AbsolutePath;
+}
 /**
- * A {@link Pipe} represents a sequence of operations performed by
- * a series of {@link Plug | Plugs}.
+ * A class that will be extended by {@link Pipe} where {@link install} will
+ * add prototype properties from installed {@link Plug}s
  */
-export interface Pipe {
+declare abstract class PipeProto {
+    abstract plug(plug: Plug<PlugResult>): Pipe | Promise<undefined>;
 }
 /**
- * The {@link Pipe} abstract class exposes the prototype upon which all
- * extension plugs will be installed on.
+ * The {@link Pipe} abstract defines processing pipeline where multiple
+ * {@link Plug}s can transform lists of {@link Files}.
  */
-export declare abstract class Pipe implements Pipe {
-    abstract plug(plug: Plug<Files> | PlugFunction<Files>): Pipe & Promise<Files>;
-    abstract plug(plug: Plug<undefined> | PlugFunction<undefined>): Promise<undefined>;
-}
-/** Implementation of our {@link Pipe}. */
-export declare class PipeImpl<T extends Files | undefined> extends Pipe implements Promise<T> {
-    #private;
-    constructor(start: T | Promise<T>, run: Run);
-    plug<T extends Files | undefined>(arg: Plug<T> | PlugFunction<T>): Pipe & Promise<T>;
-    then<T1 = T, T2 = never>(onfulfilled?: ((value: T) => T1 | PromiseLike<T1>) | null | undefined, onrejected?: ((reason: any) => T2 | PromiseLike<T2>) | null | undefined): Promise<T1 | T2>;
-    catch<T0 = never>(onrejected?: ((reason: any) => T0 | PromiseLike<T0>) | null | undefined): Promise<T0 | T>;
-    finally(onfinally?: (() => void) | null | undefined): Promise<T>;
-    [Symbol.toStringTag]: string;
+export declare abstract class Pipe extends PipeProto {
+    abstract plug(plug: Plug<Files>): Pipe;
+    abstract plug(plug: PlugFunction<Files>): Pipe;
+    abstract plug(plug: Plug<void | undefined>): Promise<undefined>;
+    abstract plug(plug: PlugFunction<void | undefined>): Promise<undefined>;
+    abstract run(): Promise<Files>;
 }
 /** The names which can be installed as direct plugs. */
-export declare type PlugName = string & Exclude<keyof Pipe, 'plug' | keyof Promise<Files>>;
-/** A convenience type identifying a {@link Plug} constructor. */
-export declare type PlugConstructor = new (...args: any) => Plug<Files | undefined>;
-/** Convert the resulting type of a {@link Plug} for use in a {@link Pipe} */
-declare type PlugReturnForPipe<T> = T extends Plug<infer R> ? R extends Files ? Promise<Files> & Pipe : R extends undefined ? Promise<undefined> : never : never;
-/**
- * Map constructors into an array of all known overloads.
- *
- * This is a _royal_ pain in the ass, as we need to distinguish between
- * all possible number of overloads of a constructor... Limit to 5 of them!
- *
- * Also, the empty constructor (when specified in the overloads) will simply
- * match the first case (most overloads) and generate functions somewhat like
- *
- * (...args: unknown[]) => never
- * (...args: unknown[]) => never
- * (...args: unknown[]) => never
- * () => PlugReturnForPipe<R3>
- * (arg: Options) => PlugReturnForPipe<R4>
- *
- * Somehow inferring the result to `Function` or the right type and ANDing all
- * those together here doesn't work, so we create this array and we'll AND
- * all its members in the PipeExtension<...> type.
- */
-declare type PlugConstructorOverloads<T extends PlugConstructor> = T extends {
-    new (...args: infer A0): infer R0;
-    new (...args: infer A1): infer R1;
-    new (...args: infer A2): infer R2;
-    new (...args: infer A3): infer R3;
-    new (...args: infer A4): infer R4;
-} ? [
-    R0 extends Plug<Files | undefined> ? ((...args: A0) => PlugReturnForPipe<R0>) : Function,
-    R1 extends Plug<Files | undefined> ? ((...args: A1) => PlugReturnForPipe<R1>) : Function,
-    R2 extends Plug<Files | undefined> ? ((...args: A2) => PlugReturnForPipe<R2>) : Function,
-    R3 extends Plug<Files | undefined> ? ((...args: A3) => PlugReturnForPipe<R3>) : Function,
-    R4 extends Plug<Files | undefined> ? ((...args: A4) => PlugReturnForPipe<R4>) : Function
-] : T extends {
-    new (...args: infer A0): infer R0;
-    new (...args: infer A1): infer R1;
-    new (...args: infer A2): infer R2;
-    new (...args: infer A3): infer R3;
-} ? [
-    R0 extends Plug<Files | undefined> ? (...args: A0) => PlugReturnForPipe<R0> : Function,
-    R1 extends Plug<Files | undefined> ? (...args: A1) => PlugReturnForPipe<R1> : Function,
-    R2 extends Plug<Files | undefined> ? (...args: A2) => PlugReturnForPipe<R2> : Function,
-    R3 extends Plug<Files | undefined> ? (...args: A3) => PlugReturnForPipe<R3> : Function
-] : T extends {
-    new (...args: infer A0): infer R0;
-    new (...args: infer A1): infer R1;
-    new (...args: infer A2): infer R2;
-} ? [
-    R0 extends Plug<Files | undefined> ? (...args: A0) => PlugReturnForPipe<R0> : Function,
-    R1 extends Plug<Files | undefined> ? (...args: A1) => PlugReturnForPipe<R1> : Function,
-    R2 extends Plug<Files | undefined> ? (...args: A2) => PlugReturnForPipe<R2> : Function
-] : T extends {
-    new (...args: infer A0): infer R0;
-    new (...args: infer A1): infer R1;
-} ? [
-    R0 extends Plug<Files | undefined> ? (...args: A0) => PlugReturnForPipe<R0> : Function,
-    R1 extends Plug<Files | undefined> ? (...args: A1) => PlugReturnForPipe<R1> : Function
-] : T extends {
-    new (...args: infer A0): infer R0;
-} ? [
-    R0 extends Plug<Files | undefined> ? (...args: A0) => PlugReturnForPipe<R0> : Function
-] : never;
+export declare type PlugName = string & Exclude<keyof Pipe, 'plug' | 'run'>;
+/** The parameters of the plug extension with the given name */
+export declare type PipeParameters<Name extends PlugName> = PipeOverloads<Name>['args'];
+/** Extract arguments and return types from function overloads. */
+declare type PipeOverloads<Name extends PlugName> = Pipe[Name] extends {
+    (...args: infer A0): infer R0;
+    (...args: infer A1): infer R1;
+    (...args: infer A2): infer R2;
+    (...args: infer A3): infer R3;
+    (...args: infer A4): infer R4;
+} ? (R0 extends (Pipe | Promise<undefined>) ? {
+    args: A0;
+    ret: R0;
+} : never) | (R1 extends (Pipe | Promise<undefined>) ? {
+    args: A1;
+    ret: R1;
+} : never) | (R2 extends (Pipe | Promise<undefined>) ? {
+    args: A2;
+    ret: R2;
+} : never) | (R3 extends (Pipe | Promise<undefined>) ? {
+    args: A3;
+    ret: R3;
+} : never) | (R4 extends (Pipe | Promise<undefined>) ? {
+    args: A4;
+    ret: R4;
+} : never) : Pipe[Name] extends {
+    (...args: infer A0): infer R0;
+    (...args: infer A1): infer R1;
+    (...args: infer A2): infer R2;
+    (...args: infer A3): infer R3;
+} ? (R0 extends (Pipe | Promise<undefined>) ? {
+    args: A0;
+    ret: R0;
+} : never) | (R1 extends (Pipe | Promise<undefined>) ? {
+    args: A1;
+    ret: R1;
+} : never) | (R2 extends (Pipe | Promise<undefined>) ? {
+    args: A2;
+    ret: R2;
+} : never) | (R3 extends (Pipe | Promise<undefined>) ? {
+    args: A3;
+    ret: R3;
+} : never) : Pipe[Name] extends {
+    (...args: infer A0): infer R0;
+    (...args: infer A1): infer R1;
+    (...args: infer A2): infer R2;
+} ? (R0 extends (Pipe | Promise<undefined>) ? {
+    args: A0;
+    ret: R0;
+} : never) | (R1 extends (Pipe | Promise<undefined>) ? {
+    args: A1;
+    ret: R1;
+} : never) | (R2 extends (Pipe | Promise<undefined>) ? {
+    args: A2;
+    ret: R2;
+} : never) : Pipe[Name] extends {
+    (...args: infer A0): infer R0;
+    (...args: infer A1): infer R1;
+} ? (R0 extends (Pipe | Promise<undefined>) ? {
+    args: A0;
+    ret: R0;
+} : never) | (R1 extends (Pipe | Promise<undefined>) ? {
+    args: A1;
+    ret: R1;
+} : never) : Pipe[Name] extends {
+    (...args: infer A0): infer R0;
+} ? (R0 extends (Pipe | Promise<undefined>) ? {
+    args: A0;
+    ret: R0;
+} : never) : never;
+/** The parameters of the plug extension with the given name */
+declare type PipeResult<Name extends PlugName> = PipeOverloads<Name>['ret'];
 /**
- * A convenience type to easily annotate installed {@link Plug Plugs}.
- *
- * See also {@link install}.
- *
- * ```
- * export class Write implements Plug {
- *   // ... the plug implementation lives here
- * }
- *
- * install('write', Write)
- *
- * declare module '../pipe' {
- *   export interface Pipe {
- *     write: PipeExtension<typeof Write>
- *   }
- * }
- * ```
+ * A type defining the correct constructor for a {@link Plug}, inferring
+ * argument types and instance type from the definitions in {@link Pipe}.
  */
-export declare type PipeExtension<T extends PlugConstructor, A = PlugConstructorOverloads<T>> = A extends readonly [infer First, ...infer Rest] ? First & PipeExtension<T, Rest> : A extends readonly [infer Only] ? Only : Function;
+declare type PlugConstructor<Name extends PlugName> = PipeResult<Name> extends Pipe ? new (...args: PipeParameters<Name>) => Plug<Files> : PipeResult<Name> extends Promise<undefined> ? new (...args: PipeParameters<Name>) => Plug<void | undefined> : PipeResult<Name> extends (Pipe | Promise<undefined>) ? new (...args: PipeParameters<Name>) => Plug<Files | void | undefined> : never;
 /**
- * Install a {@link Plug} into our {@link Pipe} prototype, and return a static
- * creator function for the {@link Plug} itself.
+ * Install a {@link Plug} into our {@link Pipe} prototype.
  *
  * This allows our shorthand syntax for well-defined plugs such as:
  *
@@ -135,18 +145,38 @@ export declare type PipeExtension<T extends PlugConstructor, A = PlugConstructor
  * Use this alongside interface merging like:
  *
  * ```
- * export class Write implements Plug {
- *   // ... the plug implementation lives here
- * }
- *
- * install('write', Write)
- *
- * declare module '../pipe' {
+ * declare module '@plugjs/plug/pipe' {
  *   export interface Pipe {
- *     write: PipeExtension<typeof Write>
+ *     write(): Pipe
  *   }
  * }
+ *
+ * install('write', class Write implements Plug {
+ *   constructorg(...args: PipeParams<'write'>) {
+ *     // here `args` is automatically inferred by whatever was declared above
+ *   }
+ *
+ *   // ... the plug implementation lives here
+ * })
  * ```
  */
-export declare function install<C extends PlugConstructor>(name: PlugName, ctor: C): void;
+export declare function install<Name extends PlugName, Ctor extends PlugConstructor<Name>>(name: Name, ctor: Ctor): void;
+/**
+ * Install a _forking_ {@link Plug} in the {@link Pipe}, in other words
+ * execute the plug in a separate process.
+ *
+ * As a contract, if the _last non-null_ parameter of the constructor is an
+ * object and contains the key `coverageDir`, the process will be forked with
+ * the approptiately resolved `NODE_V8_COVERAGE` environment variable.
+ *
+ * Also, forking plugs require some special attention:
+ *
+ * * plug functions are not supported, only classes implementing the
+ *   {@link Plug} interface can be used with this.
+ *
+ * * the class itself _MUST_ be exported as the _default_ export for the
+ *   `scriptFile` specified below. This is to simplify interoperability between
+ *   CommonJS and ESM modules as we use dynamic `import(...)` statements.
+ */
+export declare function installForking<Name extends PlugName>(plugName: Name, scriptFile: AbsolutePath): void;
 export {};

package/dist/pipe.mjs

@@ -1,44 +1,50 @@
 // pipe.ts
-import { assert } from "./assert.mjs";
-var Pipe = class {
-};
-var PipeImpl = class extends Pipe {
-  #promise;
-  #run;
-  constructor(start, run) {
-    super();
-    this.#promise = Promise.resolve(start);
-    this.#run = run;
-  }
-  plug(arg) {
-    const plug = typeof arg === "function" ? { pipe: arg } : arg;
-    const promise = this.#promise.then((files) => {
-      assert(files, "Pipe can not be further extended");
-      return plug.pipe(files, this.#run);
-    });
-    return new PipeImpl(promise, this.#run);
-  }
-  then(onfulfilled, onrejected) {
-    return this.#promise.then(onfulfilled, onrejected);
-  }
-  catch(onrejected) {
-    return this.#promise.catch(onrejected);
+import { getLogger } from "./log.mjs";
+import { getAbsoluteParent, getCurrentWorkingDirectory, resolveAbsolutePath } from "./paths.mjs";
+import { ForkingPlug } from "./fork.mjs";
+import { sep } from "path";
+var Context = class {
+  constructor(buildFile, taskName) {
+    this.buildFile = buildFile;
+    this.taskName = taskName;
+    this.buildDir = getAbsoluteParent(buildFile);
+    this.log = getLogger(taskName);
   }
-  finally(onfinally) {
-    return this.#promise.finally(onfinally);
+  buildDir;
+  log;
+  resolve(path, ...paths) {
+    if (path && path.startsWith("@")) {
+      const components = path.substring(1).split(sep).filter((s) => !!s);
+      return resolveAbsolutePath(this.buildDir, ...components, ...paths);
+    }
+    if (!path)
+      return getCurrentWorkingDirectory();
+    return resolveAbsolutePath(getCurrentWorkingDirectory(), path, ...paths);
   }
-  [Symbol.toStringTag] = "Pipe";
+};
+var PipeProto = class {
+};
+var Pipe = class extends PipeProto {
 };
 function install(name, ctor) {
-  function create(...args) {
+  function plug(...args) {
     return this.plug(new ctor(...args));
   }
-  Object.defineProperty(create, "name", { value: name });
-  Object.defineProperty(Pipe.prototype, name, { value: create });
+  Object.defineProperty(plug, "name", { value: name });
+  Object.defineProperty(PipeProto.prototype, name, { value: plug });
+}
+function installForking(plugName, scriptFile) {
+  const ctor = class extends ForkingPlug {
+    constructor(...args) {
+      super(scriptFile, args);
+    }
+  };
+  install(plugName, ctor);
 }
 export {
+  Context,
   Pipe,
-  PipeImpl,
-  install
+  install,
+  installForking
 };
 //# sourceMappingURL=pipe.mjs.map

package/dist/pipe.mjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/pipe.ts"],
-  "mappings": ";AAAA,SAAS,cAAc;AA4BhB,IAAe,OAAf,MAAoC;AAG3C;AAIO,IAAM,WAAN,cAAoD,KAA2B;AAAA,EAC3E;AAAA,EACA;AAAA,EAET,YAAY,OAAuB,KAAU;AAC3C,UAAM;AACN,SAAK,WAAW,QAAQ,QAAQ,KAAK;AACrC,SAAK,OAAO;AAAA,EACd;AAAA,EAEA,KAAkC,KAAmD;AACnF,UAAM,OAAO,OAAO,QAAQ,aAAa,EAAE,MAAM,IAAI,IAAI;AACzD,UAAM,UAAU,KAAK,SAAS,KAAK,CAAC,UAAU;AAC5C,aAAO,OAAO,kCAAkC;AAChD,aAAO,KAAK,KAAK,OAAO,KAAK,IAAI;AAAA,IACnC,CAAC;AACD,WAAO,IAAI,SAAS,SAAS,KAAK,IAAI;AAAA,EACxC;AAAA,EAEA,KACI,aACA,YACgB;AAClB,WAAO,KAAK,SAAS,KAAK,aAAa,UAAU;AAAA,EACnD;AAAA,EAEA,MACI,YACe;AACjB,WAAO,KAAK,SAAS,MAAM,UAAU;AAAA,EACvC;AAAA,EAEA,QACI,WACU;AACZ,WAAO,KAAK,SAAS,QAAQ,SAAS;AAAA,EACxC;AAAA,EAEA,CAAC,OAAO,eAAe;AACzB;AA+IO,SAAS,QAAmC,MAAgB,MAAe;AAGhF,WAAS,UAAsB,MAA8C;AAE3E,WAAO,KAAK,KAAK,IAAI,KAAK,GAAG,IAAI,CAAQ;AAAA,EAC3C;AAGA,SAAO,eAAe,QAAQ,QAAQ,EAAE,OAAO,KAAK,CAAC;AAGrD,SAAO,eAAe,KAAK,WAAW,MAAM,EAAE,OAAO,OAAO,CAAC;AAC/D;",
+  "mappings": ";AACA,SAAS,iBAAyB;AAClC,SAAuB,mBAAmB,4BAA4B,2BAA2B;AAEjG,SAAS,mBAAmB;AAC5B,SAAS,WAAW;AA+Bb,IAAM,UAAN,MAAc;AAAA,EAMnB,YAEoB,WAEA,UAClB;AAHkB;AAEA;AAElB,SAAK,WAAW,kBAAkB,SAAS;AAC3C,SAAK,MAAM,UAAU,QAAQ;AAAA,EAC/B;AAAA,EAZgB;AAAA,EAEA;AAAA,EAYhB,QAAQ,SAAiB,OAA+B;AAEtD,QAAI,QAAQ,KAAK,WAAW,GAAG,GAAG;AAEhC,YAAM,aAAa,KAAK,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACjE,aAAO,oBAAoB,KAAK,UAAU,GAAG,YAAY,GAAG,KAAK;AAAA,IACnE;AAGA,QAAI,CAAE;AAAM,aAAO,2BAA2B;AAG9C,WAAO,oBAAoB,2BAA2B,GAAG,MAAM,GAAG,KAAK;AAAA,EACzE;AACF;AAUA,IAAe,YAAf,MAAyB;AAEzB;AAMO,IAAe,OAAf,cAA4B,UAAU;AAO7C;AAyGO,SAAS,QAGd,MAAY,MAAkB;AAE9B,WAAS,QAAyB,MAAuD;AAEvF,WAAO,KAAK,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC;AAAA,EACpC;AAGA,SAAO,eAAe,MAAM,QAAQ,EAAE,OAAO,KAAK,CAAC;AAGnD,SAAO,eAAe,UAAU,WAAW,MAAM,EAAE,OAAO,KAAK,CAAC;AAClE;AAmBO,SAAS,eACZ,UACA,YACI;AAEN,QAAM,OAAO,cAAc,YAAY;AAAA,IACrC,eAAe,MAAa;AAC1B,YAAM,YAAY,IAAI;AAAA,IACxB;AAAA,EACF;AAGA,UAAQ,UAAU,IAAI;AACxB;",
   "names": []
 }