@plugjs/build 0.2.0 → 0.2.2

package/dist/bootstrap.mjs

@@ -8,7 +8,11 @@ var tasks = build({
   async bootstrap_resources() {
     const pipe = find("**/*", "**/.*", { directory: "@../resources" });
     const sources = await pipe;
-    const targets = await pipe.copy(".", { overwrite });
+    const targets = await pipe.copy(".", {
+      // it seems NPM has _some_ problems with some dotfiles (e.g. .gitignore)
+      rename: (relative) => relative.replaceAll(/(^|\/)__dot_/g, "$1."),
+      overwrite
+    });
     log("Bootstrapped", targets.length, "of", sources.length, "files:");
     for (const file of targets.absolutePaths())
       log(`    ${$p(file)}`);
@@ -43,7 +47,7 @@ var tasks = build({
       [buildJson.name]: `^${buildJson.version}`
     };
     log(`Writing ${$p(targetPackage)}`);
-    await fs.writeFile(targetPackage, JSON.stringify(targetJson, null, 2), "utf-8");
+    await fs.writeFile(targetPackage, JSON.stringify(targetJson, null, 2) + "\n", "utf-8");
   },
   /** Bootstrap the project */
   async bootstrap() {

package/dist/bootstrap.mjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/bootstrap.mts"],
-  "mappings": ";;;AAGA,SAAS,OAAO,MAAM,IAAI,QAAQ,KAAK,eAAe;AACtD,SAAS,UAAU;AAEnB,IAAM,QAAQ,MAAM;AAAA;AAAA,EAElB,MAAM,sBAAqC;AACzC,UAAM,OAAO,KAAK,QAAQ,SAAS,EAAE,WAAW,gBAAgB,CAAC;AACjE,UAAM,UAAU,MAAM;AACtB,UAAM,UAAU,MAAM,KAAK,KAAK,KAAK,EAAE,UAAU,CAAC;AAElD,QAAI,gBAAgB,QAAQ,QAAQ,MAAM,QAAQ,QAAQ,QAAQ;AAClE,eAAW,QAAQ,QAAQ,cAAc;AAAG,UAAI,OAAO,GAAG,IAAI,GAAG;AAAA,EACnE;AAAA;AAAA,EAGA,MAAM,oBAAmC;AAEvC,UAAM,eAAe,QAAQ,kBAAkB;AAC/C,QAAI,WAAW,GAAG,YAAY,GAAG;AACjC,UAAM,YAAY,MAAM,GAAG,SAAS,cAAc,OAAO;AACzD,UAAM,YAAY,KAAK,MAAM,SAAS;AAGtC,UAAM,aAAkC,CAAC;AACzC,UAAM,gBAAgB,QAAQ,gBAAgB;AAC9C,QAAI,OAAO,aAAa,GAAG;AACzB,UAAI,WAAW,GAAG,aAAa,GAAG;AAClC,YAAM,aAAa,MAAM,GAAG,SAAS,eAAe,OAAO;AAC3D,aAAO,OAAO,YAAY,KAAK,MAAM,UAAU,CAAC;AAAA,IAClD;AAGA,QAAI,YAAY,GAAG,aAAa,GAAG;AAGnC,eAAW,UAAU;AAAA,MACnB,OAAO;AAAA,MACP,UAAU;AAAA,MACV,KAAK;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN,WAAW;AAAA,MACX,GAAG,WAAW;AAAA,IAChB;AAGA,UAAM,cAAc,oBAAI,IAAI,CAAE,GAAI,WAAW,SAAS,CAAC,GAAI,QAAQ,SAAS,MAAO,CAAC;AACpF,eAAW,QAAQ,CAAE,GAAG,WAAY,EAAE,KAAK;AAG3C,eAAW,kBAAkB;AAAA,MAC3B,GAAG,WAAW;AAAA,MACd,CAAC,UAAU,IAAI,GAAG,IAAI,UAAU;AAAA,IAClC;AAGA,QAAI,WAAW,GAAG,aAAa,GAAG;AAClC,UAAM,GAAG,UAAU,eAAe,KAAK,UAAU,YAAY,MAAM,CAAC,GAAG,OAAO;AAAA,EAChF;AAAA;AAAA,EAGA,MAAM,YAA2B;AAC/B,QAAI,kCAAkC,GAAG,QAAQ,GAAG,CAAC,GAAG;AACxD,UAAM,KAAK,oBAAoB;AAC/B,UAAM,KAAK,kBAAkB;AAAA,EAC/B;AACF,CAAC;AAED,IAAM,YAAY,QAAQ,KAAK,CAAC,MAAM,gBAAgB,cAAc;AACpE,MAAM,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,IAAI,KAAK;",
+  "mappings": ";;;AAGA,SAAS,OAAO,MAAM,IAAI,QAAQ,KAAK,eAAe;AACtD,SAAS,UAAU;AAEnB,IAAM,QAAQ,MAAM;AAAA;AAAA,EAElB,MAAM,sBAAqC;AACzC,UAAM,OAAO,KAAK,QAAQ,SAAS,EAAE,WAAW,gBAAgB,CAAC;AACjE,UAAM,UAAU,MAAM;AACtB,UAAM,UAAU,MAAM,KAAK,KAAK,KAAK;AAAA;AAAA,MAEnC,QAAQ,CAAC,aAAa,SAAS,WAAW,iBAAiB,KAAK;AAAA,MAChE;AAAA,IACF,CAAC;AAED,QAAI,gBAAgB,QAAQ,QAAQ,MAAM,QAAQ,QAAQ,QAAQ;AAClE,eAAW,QAAQ,QAAQ,cAAc;AAAG,UAAI,OAAO,GAAG,IAAI,GAAG;AAAA,EACnE;AAAA;AAAA,EAGA,MAAM,oBAAmC;AAEvC,UAAM,eAAe,QAAQ,kBAAkB;AAC/C,QAAI,WAAW,GAAG,YAAY,GAAG;AACjC,UAAM,YAAY,MAAM,GAAG,SAAS,cAAc,OAAO;AACzD,UAAM,YAAY,KAAK,MAAM,SAAS;AAGtC,UAAM,aAAkC,CAAC;AACzC,UAAM,gBAAgB,QAAQ,gBAAgB;AAC9C,QAAI,OAAO,aAAa,GAAG;AACzB,UAAI,WAAW,GAAG,aAAa,GAAG;AAClC,YAAM,aAAa,MAAM,GAAG,SAAS,eAAe,OAAO;AAC3D,aAAO,OAAO,YAAY,KAAK,MAAM,UAAU,CAAC;AAAA,IAClD;AAGA,QAAI,YAAY,GAAG,aAAa,GAAG;AAGnC,eAAW,UAAU;AAAA,MACnB,OAAO;AAAA,MACP,UAAU;AAAA,MACV,KAAK;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,MACN,WAAW;AAAA,MACX,GAAG,WAAW;AAAA,IAChB;AAGA,UAAM,cAAc,oBAAI,IAAI,CAAE,GAAI,WAAW,SAAS,CAAC,GAAI,QAAQ,SAAS,MAAO,CAAC;AACpF,eAAW,QAAQ,CAAE,GAAG,WAAY,EAAE,KAAK;AAG3C,eAAW,kBAAkB;AAAA,MAC3B,GAAG,WAAW;AAAA,MACd,CAAC,UAAU,IAAI,GAAG,IAAI,UAAU;AAAA,IAClC;AAGA,QAAI,WAAW,GAAG,aAAa,GAAG;AAClC,UAAM,GAAG,UAAU,eAAe,KAAK,UAAU,YAAY,MAAM,CAAC,IAAI,MAAM,OAAO;AAAA,EACvF;AAAA;AAAA,EAGA,MAAM,YAA2B;AAC/B,QAAI,kCAAkC,GAAG,QAAQ,GAAG,CAAC,GAAG;AACxD,UAAM,KAAK,oBAAoB;AAC/B,UAAM,KAAK,kBAAkB;AAAA,EAC/B;AACF,CAAC;AAED,IAAM,YAAY,QAAQ,KAAK,CAAC,MAAM,gBAAgB,cAAc;AACpE,MAAM,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,IAAI,KAAK;",
   "names": []
 }

package/dist/index.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // index.ts
 var src_exports = {};
 __export(src_exports, {
+  banner: () => banner,
   tasks: () => tasks
 });
 module.exports = __toCommonJS(src_exports);
@@ -61,7 +62,7 @@ function tasks(options = {}) {
     optimalFileCoverage: _optimalFileCoverage = void 0,
     esbuildOptions: _esbuildOptions = {}
   } = options;
-  const banner = _banners ? emitBanner : (...args) => void 0;
+  const emitBanner = _banners ? banner : (...args) => void 0;
   const esbuildMergedOptions = Object.assign({}, esbuildDefaults, _esbuildOptions);
   return (0, import_plug.build)({
     /** The directory for the original sources (default: `src`) */
@@ -110,8 +111,8 @@ function tasks(options = {}) {
     _find_types() {
       return (0, import_plug.find)("**/*.d.ts", { directory: this.sourceDir });
     },
-    /** Find all types definition files within sources */
-    _find_extras() {
+    /** Find all extra types definition files from `extraTypesDir` */
+    _find_extra_types() {
       if (!(0, import_plug.isDirectory)(this.extraTypesDir))
         return (0, import_plug.noop)();
       return (0, import_plug.find)("**/*.d.ts", { directory: this.extraTypesDir });
@@ -124,6 +125,15 @@ function tasks(options = {}) {
     _find_tests() {
       return (0, import_plug.find)(this.testGlob, { directory: this.testDir, ignore: "**/*.d.ts" });
     },
+    /** Find all source files to lint */
+    _find_lint_sources() {
+      return (0, import_plug.merge)([
+        this._find_sources(),
+        this._find_tests(),
+        this._find_types(),
+        this._find_extra_types()
+      ]);
+    },
     /* ====================================================================== *
      * TRANSPILE                                                              *
      * ====================================================================== */
@@ -150,7 +160,7 @@ function tasks(options = {}) {
       return (0, import_plug.merge)([
         this._find_sources(),
         this._find_types(),
-        this._find_extras()
+        this._find_extra_types()
       ]).tsc("tsconfig.json", {
         noEmit: false,
         rootDir: this.sourceDir,
@@ -160,7 +170,7 @@ function tasks(options = {}) {
       });
     },
     /** Copy all resources coming alongside our sources */
-    transpile_resources() {
+    copy_resources() {
       return (0, import_plug.merge)([
         this._find_resources(),
         this._find_types()
@@ -168,34 +178,35 @@ function tasks(options = {}) {
     },
     /** Transpile all source code */
     async transpile() {
-      banner("Transpiling source files");
+      emitBanner("Transpiling source files");
       if ((0, import_plug.isDirectory)(this.destDir))
         await (0, import_plug.rmrf)(this.destDir);
-      return (0, import_plug.merge)([
+      const result = await (0, import_plug.merge)([
         _cjsTranspile ? this.transpile_cjs() : (0, import_plug.noop)(),
         _esmTranspile ? this.transpile_esm() : (0, import_plug.noop)(),
         this.transpile_types(),
-        this.transpile_resources()
+        this.copy_resources()
       ]);
+      return result;
     },
     /* ====================================================================== *
-     * TEST, COVERAGE & LINTING                                               *
+     * TEST & COVERAGE                                                        *
      * ====================================================================== */
-    /** Run test and emit coverage data */
+    /** Run tests */
     async test() {
-      banner("Running tests");
+      emitBanner("Running tests");
       if (_coverage && (0, import_plug.isDirectory)(this.coverageDataDir))
         await (0, import_plug.rmrf)(this.coverageDataDir);
       await this._find_tests().jasmine({ coverageDir: _coverage ? this.coverageDataDir : void 0 });
     },
-    /** Run tests (always) and generate a coverage report */
+    /** Ensure tests have run and generate a coverage report */
     async coverage() {
-      let files;
+      let coveragePipe;
       try {
         await this.test();
       } finally {
-        banner("Preparing coverage report");
-        files = await this._find_sources().coverage(this.coverageDataDir, {
+        emitBanner("Preparing coverage report");
+        coveragePipe = this._find_sources().coverage(this.coverageDataDir, {
           reportDir: this.coverageDir,
           minimumCoverage: _minimumCoverage,
           minimumFileCoverage: _minimumFileCoverage,
@@ -203,17 +214,15 @@ function tasks(options = {}) {
           optimalFileCoverage: _optimalFileCoverage
         });
       }
-      return files;
+      return coveragePipe;
     },
-    /** Run test and emit coverage data */
+    /* ====================================================================== *
+     * LINTING                                                                *
+     * ====================================================================== */
+    /** Lint all sources */
     async lint() {
-      banner("Linting sources");
-      await (0, import_plug.merge)([
-        this._find_sources(),
-        this._find_tests(),
-        this._find_types(),
-        this._find_extras()
-      ]).eslint();
+      emitBanner("Linting sources");
+      await this._find_lint_sources().eslint();
     },
     /* ====================================================================== *
      * PACKAGE.JSON EXPORTS                                                   *
@@ -221,7 +230,7 @@ function tasks(options = {}) {
     /** Inject `exports` into the `package.json` file */
     async exports() {
       const files = await this.transpile();
-      banner('Updating exports in "package.json"');
+      emitBanner('Updating exports in "package.json"');
       return (0, import_plug.merge)([files]).filter(this.exportsGlob, { directory: this.destDir, ignore: "**/*.map" }).exports({
         cjsExtension: this.cjsExtension,
         esmExtension: this.esmExtension,
@@ -230,11 +239,11 @@ function tasks(options = {}) {
       });
     },
     /* ====================================================================== *
-     * DEFAULT: DO EVERYTHING                                                 *
+     * ALL: DO EVERYTHING                                                     *
      * ====================================================================== */
     /* coverage ignore next */
-    /** Build everything */
-    async default() {
+    /** Build everything. */
+    async all() {
       if (_parallelize) {
         await Promise.all([
           this.transpile(),
@@ -247,11 +256,23 @@ function tasks(options = {}) {
         await this.coverage();
         await this.lint();
       }
-      await this.exports();
+    },
+    /* ====================================================================== *
+     * DEFAULT: DO EVERYTHING                                                 *
+     * ====================================================================== */
+    /* coverage ignore next */
+    /**
+     * Default task (simply invokes `this._all()`).
+     *
+     * Override this and invoke `this._all()` to inject tasks _before_ or
+     * _after_ the normal build execution.
+     */
+    async default() {
+      await this.all();
     }
   });
 }
-function emitBanner(message) {
+function banner(message) {
   import_plug.log.notice([
     "",
     (0, import_plug.$gry)(`\u2554${"".padStart(60, "\u2550")}\u2557`),
@@ -262,6 +283,7 @@ function emitBanner(message) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  banner,
   tasks
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/index.d.ts

@@ -97,12 +97,14 @@ export declare function tasks(options?: TasksOptions): import("@plugjs/plug").Bu
     _find_sources(): Pipe;
     /** Find all types definition files within sources */
     _find_types(): Pipe;
-    /** Find all types definition files within sources */
-    _find_extras(): Pipe;
+    /** Find all extra types definition files from `extraTypesDir` */
+    _find_extra_types(): Pipe;
     /** Find all resource files (non-typescript files) within sources */
     _find_resources(): Pipe;
     /** Find all test source files */
     _find_tests(): Pipe;
+    /** Find all source files to lint */
+    _find_lint_sources(): Pipe;
     /** Transpile to CJS */
     transpile_cjs(): Pipe;
     /** Transpile to ESM */
@@ -110,17 +112,25 @@ export declare function tasks(options?: TasksOptions): import("@plugjs/plug").Bu
     /** Generate all .d.ts files */
     transpile_types(): Pipe;
     /** Copy all resources coming alongside our sources */
-    transpile_resources(): Pipe;
+    copy_resources(): Pipe;
     /** Transpile all source code */
     transpile(): Promise<Pipe>;
-    /** Run test and emit coverage data */
+    /** Run tests */
     test(): Promise<void>;
-    /** Run tests (always) and generate a coverage report */
+    /** Ensure tests have run and generate a coverage report */
     coverage(): Promise<Pipe>;
-    /** Run test and emit coverage data */
+    /** Lint all sources */
     lint(): Promise<void>;
     /** Inject `exports` into the `package.json` file */
     exports(): Promise<Pipe>;
-    /** Build everything */
+    /** Build everything. */
+    all(): Promise<void>;
+    /**
+     * Default task (simply invokes `this._all()`).
+     *
+     * Override this and invoke `this._all()` to inject tasks _before_ or
+     * _after_ the normal build execution.
+     */
     default(): Promise<void>;
 }>;
+export declare function banner(message: string): void;

package/dist/index.mjs

@@ -47,7 +47,7 @@ function tasks(options = {}) {
     optimalFileCoverage: _optimalFileCoverage = void 0,
     esbuildOptions: _esbuildOptions = {}
   } = options;
-  const banner = _banners ? emitBanner : (...args) => void 0;
+  const emitBanner = _banners ? banner : (...args) => void 0;
   const esbuildMergedOptions = Object.assign({}, esbuildDefaults, _esbuildOptions);
   return build({
     /** The directory for the original sources (default: `src`) */
@@ -96,8 +96,8 @@ function tasks(options = {}) {
     _find_types() {
       return find("**/*.d.ts", { directory: this.sourceDir });
     },
-    /** Find all types definition files within sources */
-    _find_extras() {
+    /** Find all extra types definition files from `extraTypesDir` */
+    _find_extra_types() {
       if (!isDirectory(this.extraTypesDir))
         return noop();
       return find("**/*.d.ts", { directory: this.extraTypesDir });
@@ -110,6 +110,15 @@ function tasks(options = {}) {
     _find_tests() {
       return find(this.testGlob, { directory: this.testDir, ignore: "**/*.d.ts" });
     },
+    /** Find all source files to lint */
+    _find_lint_sources() {
+      return merge([
+        this._find_sources(),
+        this._find_tests(),
+        this._find_types(),
+        this._find_extra_types()
+      ]);
+    },
     /* ====================================================================== *
      * TRANSPILE                                                              *
      * ====================================================================== */
@@ -136,7 +145,7 @@ function tasks(options = {}) {
       return merge([
         this._find_sources(),
         this._find_types(),
-        this._find_extras()
+        this._find_extra_types()
       ]).tsc("tsconfig.json", {
         noEmit: false,
         rootDir: this.sourceDir,
@@ -146,7 +155,7 @@ function tasks(options = {}) {
       });
     },
     /** Copy all resources coming alongside our sources */
-    transpile_resources() {
+    copy_resources() {
       return merge([
         this._find_resources(),
         this._find_types()
@@ -154,34 +163,35 @@ function tasks(options = {}) {
     },
     /** Transpile all source code */
     async transpile() {
-      banner("Transpiling source files");
+      emitBanner("Transpiling source files");
       if (isDirectory(this.destDir))
         await rmrf(this.destDir);
-      return merge([
+      const result = await merge([
         _cjsTranspile ? this.transpile_cjs() : noop(),
         _esmTranspile ? this.transpile_esm() : noop(),
         this.transpile_types(),
-        this.transpile_resources()
+        this.copy_resources()
       ]);
+      return result;
     },
     /* ====================================================================== *
-     * TEST, COVERAGE & LINTING                                               *
+     * TEST & COVERAGE                                                        *
      * ====================================================================== */
-    /** Run test and emit coverage data */
+    /** Run tests */
     async test() {
-      banner("Running tests");
+      emitBanner("Running tests");
       if (_coverage && isDirectory(this.coverageDataDir))
         await rmrf(this.coverageDataDir);
       await this._find_tests().jasmine({ coverageDir: _coverage ? this.coverageDataDir : void 0 });
     },
-    /** Run tests (always) and generate a coverage report */
+    /** Ensure tests have run and generate a coverage report */
     async coverage() {
-      let files;
+      let coveragePipe;
       try {
         await this.test();
       } finally {
-        banner("Preparing coverage report");
-        files = await this._find_sources().coverage(this.coverageDataDir, {
+        emitBanner("Preparing coverage report");
+        coveragePipe = this._find_sources().coverage(this.coverageDataDir, {
           reportDir: this.coverageDir,
           minimumCoverage: _minimumCoverage,
           minimumFileCoverage: _minimumFileCoverage,
@@ -189,17 +199,15 @@ function tasks(options = {}) {
           optimalFileCoverage: _optimalFileCoverage
         });
       }
-      return files;
+      return coveragePipe;
     },
-    /** Run test and emit coverage data */
+    /* ====================================================================== *
+     * LINTING                                                                *
+     * ====================================================================== */
+    /** Lint all sources */
     async lint() {
-      banner("Linting sources");
-      await merge([
-        this._find_sources(),
-        this._find_tests(),
-        this._find_types(),
-        this._find_extras()
-      ]).eslint();
+      emitBanner("Linting sources");
+      await this._find_lint_sources().eslint();
     },
     /* ====================================================================== *
      * PACKAGE.JSON EXPORTS                                                   *
@@ -207,7 +215,7 @@ function tasks(options = {}) {
     /** Inject `exports` into the `package.json` file */
     async exports() {
       const files = await this.transpile();
-      banner('Updating exports in "package.json"');
+      emitBanner('Updating exports in "package.json"');
       return merge([files]).filter(this.exportsGlob, { directory: this.destDir, ignore: "**/*.map" }).exports({
         cjsExtension: this.cjsExtension,
         esmExtension: this.esmExtension,
@@ -216,11 +224,11 @@ function tasks(options = {}) {
       });
     },
     /* ====================================================================== *
-     * DEFAULT: DO EVERYTHING                                                 *
+     * ALL: DO EVERYTHING                                                     *
      * ====================================================================== */
     /* coverage ignore next */
-    /** Build everything */
-    async default() {
+    /** Build everything. */
+    async all() {
       if (_parallelize) {
         await Promise.all([
           this.transpile(),
@@ -233,11 +241,23 @@ function tasks(options = {}) {
         await this.coverage();
         await this.lint();
       }
-      await this.exports();
+    },
+    /* ====================================================================== *
+     * DEFAULT: DO EVERYTHING                                                 *
+     * ====================================================================== */
+    /* coverage ignore next */
+    /**
+     * Default task (simply invokes `this._all()`).
+     *
+     * Override this and invoke `this._all()` to inject tasks _before_ or
+     * _after_ the normal build execution.
+     */
+    async default() {
+      await this.all();
     }
   });
 }
-function emitBanner(message) {
+function banner(message) {
   log.notice([
     "",
     $gry(`\u2554${"".padStart(60, "\u2550")}\u2557`),
@@ -247,6 +267,7 @@ function emitBanner(message) {
   ].join("\n"));
 }
 export {
+  banner,
   tasks
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plugjs/build",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Simple shared build using PlugJS",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -29,12 +29,12 @@
     "transpile": "plug transpile"
   },
   "dependencies": {
-    "@plugjs/cov8": "^0.2.0",
-    "@plugjs/eslint": "^0.2.0",
+    "@plugjs/cov8": "^0.2.1",
+    "@plugjs/eslint": "^0.2.1",
     "@plugjs/eslint-plugin": "^0.1.2",
-    "@plugjs/jasmine": "^0.2.0",
-    "@plugjs/plug": "^0.2.0",
-    "@plugjs/typescript": "^0.2.0"
+    "@plugjs/jasmine": "^0.2.1",
+    "@plugjs/plug": "^0.2.1",
+    "@plugjs/typescript": "^0.2.1"
   },
   "files": [
     "*.md",

package/resources/__dot_vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "typescript.tsdk": "node_modules/typescript/lib"
+}

package/src/bootstrap.mts

@@ -9,7 +9,11 @@ const tasks = build({
   async bootstrap_resources(): Promise<void> {
     const pipe = find('**/*', '**/.*', { directory: '@../resources' })
     const sources = await pipe
-    const targets = await pipe.copy('.', { overwrite })
+    const targets = await pipe.copy('.', {
+      // it seems NPM has _some_ problems with some dotfiles (e.g. .gitignore)
+      rename: (relative) => relative.replaceAll(/(^|\/)__dot_/g, '$1.'),
+      overwrite,
+    })
 
     log('Bootstrapped', targets.length, 'of', sources.length, 'files:')
     for (const file of targets.absolutePaths()) log(`    ${$p(file)}`)
@@ -58,7 +62,7 @@ const tasks = build({
 
     // Overwrite taget package.json file
     log(`Writing ${$p(targetPackage)}`)
-    await fs.writeFile(targetPackage, JSON.stringify(targetJson, null, 2), 'utf-8')
+    await fs.writeFile(targetPackage, JSON.stringify(targetJson, null, 2) + '\n', 'utf-8')
   },
 
   /** Bootstrap the project */

package/src/index.ts

@@ -13,7 +13,7 @@ import {
 } from '@plugjs/plug'
 import '@plugjs/typescript'
 
-import type { ESBuildOptions, Files, Pipe } from '@plugjs/plug'
+import type { ESBuildOptions, Pipe } from '@plugjs/plug'
 
 export * from '@plugjs/plug'
 
@@ -89,7 +89,6 @@ export interface TasksOptions {
   /** Optimal per-file coverage percentage (default: _none_) */
   optimalFileCoverage?: number,
 
-
   /**
    * ESBuild compilation options
    *
@@ -139,7 +138,7 @@ export function tasks(options: TasksOptions = {}) {
   } = options
 
   // coverage ignore next
-  const banner = _banners ? emitBanner : (...args: any) => void args
+  const emitBanner = _banners ? banner : (...args: any) => void args
 
   // Merge esbuild defaults with specified options
   const esbuildMergedOptions = Object.assign({}, esbuildDefaults, _esbuildOptions)
@@ -197,13 +196,12 @@ export function tasks(options: TasksOptions = {}) {
       return find('**/*.d.ts', { directory: this.sourceDir })
     },
 
-    /** Find all types definition files within sources */
-    _find_extras(): Pipe {
+    /** Find all extra types definition files from `extraTypesDir` */
+    _find_extra_types(): Pipe {
       if (! isDirectory(this.extraTypesDir)) return noop()
       return find('**/*.d.ts', { directory: this.extraTypesDir })
     },
 
-
     /** Find all resource files (non-typescript files) within sources */
     _find_resources(): Pipe {
       return find('**/*', { directory: this.sourceDir, ignore: '**/*.([cm])?ts' })
@@ -214,6 +212,16 @@ export function tasks(options: TasksOptions = {}) {
       return find(this.testGlob, { directory: this.testDir, ignore: '**/*.d.ts' })
     },
 
+    /** Find all source files to lint */
+    _find_lint_sources(): Pipe {
+      return merge([
+        this._find_sources(),
+        this._find_tests(),
+        this._find_types(),
+        this._find_extra_types(),
+      ])
+    },
+
     /* ====================================================================== *
      * TRANSPILE                                                              *
      * ====================================================================== */
@@ -245,7 +253,7 @@ export function tasks(options: TasksOptions = {}) {
       return merge([
         this._find_sources(),
         this._find_types(),
-        this._find_extras(),
+        this._find_extra_types(),
       ]).tsc('tsconfig.json', {
         noEmit: false,
         rootDir: this.sourceDir,
@@ -256,7 +264,7 @@ export function tasks(options: TasksOptions = {}) {
     },
 
     /** Copy all resources coming alongside our sources */
-    transpile_resources(): Pipe {
+    copy_resources(): Pipe {
       return merge([
         this._find_resources(),
         this._find_types(),
@@ -265,25 +273,27 @@ export function tasks(options: TasksOptions = {}) {
 
     /** Transpile all source code */
     async transpile(): Promise<Pipe> {
-      banner('Transpiling source files')
+      emitBanner('Transpiling source files')
 
       if (isDirectory(this.destDir)) await rmrf(this.destDir)
 
-      return merge([
+      const result = await merge([
         _cjsTranspile ? this.transpile_cjs() : noop(),
         _esmTranspile ? this.transpile_esm() : noop(),
         this.transpile_types(),
-        this.transpile_resources(),
+        this.copy_resources(),
       ])
+
+      return result
     },
 
     /* ====================================================================== *
-     * TEST, COVERAGE & LINTING                                               *
+     * TEST & COVERAGE                                                        *
      * ====================================================================== */
 
-    /** Run test and emit coverage data */
+    /** Run tests */
     async test(): Promise<void> {
-      banner('Running tests')
+      emitBanner('Running tests')
 
       if (_coverage && isDirectory(this.coverageDataDir)) await rmrf(this.coverageDataDir)
 
@@ -292,16 +302,17 @@ export function tasks(options: TasksOptions = {}) {
           .jasmine({ coverageDir: _coverage ? this.coverageDataDir : undefined })
     },
 
-    /** Run tests (always) and generate a coverage report */
+    /** Ensure tests have run and generate a coverage report */
     async coverage(): Promise<Pipe> {
+      let coveragePipe: Pipe
+
       // Capture error from running tests, but always produce coverage
-      let files: Files
       try {
         await this.test()
       } finally {
-        banner('Preparing coverage report')
-        files = await this
-            ._find_sources()
+        emitBanner('Preparing coverage report')
+
+        coveragePipe = this._find_sources()
             .coverage(this.coverageDataDir, {
               reportDir: this.coverageDir,
               minimumCoverage: _minimumCoverage,
@@ -311,20 +322,19 @@ export function tasks(options: TasksOptions = {}) {
             })
       }
 
-      // No exceptions!
-      return files
+      // If the tests didn't throw, return the coverage
+      return coveragePipe
     },
 
-    /** Run test and emit coverage data */
+    /* ====================================================================== *
+     * LINTING                                                                *
+     * ====================================================================== */
+
+    /** Lint all sources */
     async lint(): Promise<void> {
-      banner('Linting sources')
+      emitBanner('Linting sources')
 
-      await merge([
-        this._find_sources(),
-        this._find_tests(),
-        this._find_types(),
-        this._find_extras(),
-      ]).eslint()
+      await this._find_lint_sources().eslint()
     },
 
     /* ====================================================================== *
@@ -335,7 +345,7 @@ export function tasks(options: TasksOptions = {}) {
     async exports(): Promise<Pipe> {
       const files = await this.transpile()
 
-      banner('Updating exports in "package.json"')
+      emitBanner('Updating exports in "package.json"')
 
       return merge([ files ])
           .filter(this.exportsGlob, { directory: this.destDir, ignore: '**/*.map' })
@@ -348,12 +358,12 @@ export function tasks(options: TasksOptions = {}) {
     },
 
     /* ====================================================================== *
-     * DEFAULT: DO EVERYTHING                                                 *
+     * ALL: DO EVERYTHING                                                     *
      * ====================================================================== */
 
     /* coverage ignore next */
-    /** Build everything */
-    async default(): Promise<void> {
+    /** Build everything. */
+    async all(): Promise<void> {
       if (_parallelize) {
         await Promise.all([
           this.transpile(),
@@ -365,14 +375,28 @@ export function tasks(options: TasksOptions = {}) {
         await this.coverage() // implies "test"
         await this.lint()
       }
-      await this.exports()
+    },
+
+    /* ====================================================================== *
+     * DEFAULT: DO EVERYTHING                                                 *
+     * ====================================================================== */
+
+    /* coverage ignore next */
+    /**
+     * Default task (simply invokes `this._all()`).
+     *
+     * Override this and invoke `this._all()` to inject tasks _before_ or
+     * _after_ the normal build execution.
+     */
+    async default(): Promise<void> {
+      await this.all()
     },
   })
 }
 
 /* coverage ignore next */
 /* Leave this at the _end_ of the file, unicode messes up sitemaps... */
-function emitBanner(message: string): void {
+export function banner(message: string): void {
   log.notice([
     '', $gry(`\u2554${''.padStart(60, '\u2550')}\u2557`),
     `${$gry('\u2551')} ${$wht(message.padEnd(58, ' '))} ${$gry('\u2551')}`,