@plugjs/build 0.1.0 → 0.2.1

package/dist/bootstrap.mjs

@@ -1,17 +1,23 @@
 #!/usr/bin/env node
 
 // bootstrap.mts
-import { build, find, invoke, log, resolve, fs, isFile } from "@plugjs/plug";
+import { build, find, fs, isFile, log, resolve } from "@plugjs/plug";
 import { $p } from "@plugjs/plug/logging";
 var tasks = build({
+  /** Copy all resources from the `resources/` directory into the target */
   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)}`);
   },
+  /** Setup dependencies and build script into target `package.json` */
   async bootstrap_package() {
     const buildPackage = resolve("@../package.json");
     log(`Reading ${$p(buildPackage)}`);
@@ -25,17 +31,25 @@ var tasks = build({
       Object.assign(targetJson, JSON.parse(targetData));
     }
     log(`Updating ${$p(targetPackage)}`);
-    if (!targetJson.scripts?.build) {
-      targetJson.scripts = Object.assign({}, targetJson.scripts, {
-        build: "plug"
-      });
-    }
-    targetJson.devDependencies = Object.assign({}, targetJson.devDependencies, {
+    targetJson.scripts = {
+      build: "plug",
+      coverage: "plug coverage",
+      dev: "plug coverage -w src -w test",
+      lint: "plug lint",
+      test: "plug test",
+      transpile: "plug transpile",
+      ...targetJson.scripts
+    };
+    const targetFiles = /* @__PURE__ */ new Set([...targetJson.files || [], "*.md", "dist/", "src/"]);
+    targetJson.files = [...targetFiles].sort();
+    targetJson.devDependencies = {
+      ...targetJson.devDependencies,
       [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() {
     log(`Boostrapping PlugJS Build from ${$p(resolve("@"))}`);
     await this.bootstrap_resources();
@@ -43,5 +57,5 @@ var tasks = build({
   }
 });
 var overwrite = process.argv[2] === "--overwrite" ? "overwrite" : "skip";
-invoke(tasks, "bootstrap", { overwrite }).catch(log.error);
+tasks.bootstrap({ overwrite }).catch(log.error);
 //# sourceMappingURL=bootstrap.mjs.map

package/dist/bootstrap.mjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/bootstrap.mts"],
-  "mappings": ";;;AACA,SAAS,OAAO,MAAM,QAAQ,KAAK,SAAS,IAAI,cAAc;AAC9D,SAAS,UAAU;AAEnB,IAAM,QAAQ,MAAM;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,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;AAEnC,QAAI,CAAE,WAAW,SAAS,OAAO;AAC/B,iBAAW,UAAU,OAAO,OAAO,CAAC,GAAG,WAAW,SAAS;AAAA,QACzD,OAAO;AAAA,MACT,CAAC;AAAA,IACH;AAEA,eAAW,kBAAkB,OAAO,OAAO,CAAC,GAAG,WAAW,iBAAiB;AAAA,MACzE,CAAC,UAAU,OAAO,IAAI,UAAU;AAAA,IAClC,CAAC;AAGD,QAAI,WAAW,GAAG,aAAa,GAAG;AAClC,UAAM,GAAG,UAAU,eAAe,KAAK,UAAU,YAAY,MAAM,CAAC,GAAG,OAAO;AAAA,EAChF;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,OAAO,gBAAgB,cAAc;AACpE,OAAO,OAAO,aAAa,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

@@ -0,0 +1,267 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.ts
+var src_exports = {};
+__export(src_exports, {
+  tasks: () => tasks
+});
+module.exports = __toCommonJS(src_exports);
+var import_cov8 = require("@plugjs/cov8");
+var import_eslint = require("@plugjs/eslint");
+var import_jasmine = require("@plugjs/jasmine");
+var import_plug = require("@plugjs/plug");
+var import_typescript = require("@plugjs/typescript");
+__reExport(src_exports, require("@plugjs/plug"), module.exports);
+var esbuildDefaults = {
+  platform: "node",
+  sourcemap: "linked",
+  sourcesContent: false,
+  plugins: [(0, import_plug.fixExtensions)()]
+};
+function tasks(options = {}) {
+  const {
+    sourceDir: _sourceDir = "src",
+    destDir: _destDir = "dist",
+    testDir: _testDir = "test",
+    coverageDir: _coverageDir = "coverage",
+    coverageDataDir: _coverageDataDir = ".coverage-data",
+    extraTypesDir: _extraTypesDir = "types",
+    packageJson: _packageJson = "package.json",
+    outputPackageJson: _outputPackageJson = _packageJson,
+    cjsExtension: _cjsExtension = ".cjs",
+    esmExtension: _esmExtension = ".mjs",
+    cjsTranspile: _cjsTranspile = true,
+    esmTranspile: _esmTranspile = true,
+    parallelize: _parallelize = false,
+    banners: _banners = !_parallelize,
+    testGlob: _testGlob = "**/*.test.([cm])?ts",
+    exportsGlob: _exportsGlob = "index.*",
+    coverage: _coverage = true,
+    minimumCoverage: _minimumCoverage = 100,
+    minimumFileCoverage: _minimumFileCoverage = 100,
+    optimalCoverage: _optimalCoverage = void 0,
+    optimalFileCoverage: _optimalFileCoverage = void 0,
+    esbuildOptions: _esbuildOptions = {}
+  } = options;
+  const banner = _banners ? emitBanner : (...args) => void 0;
+  const esbuildMergedOptions = Object.assign({}, esbuildDefaults, _esbuildOptions);
+  return (0, import_plug.build)({
+    /** The directory for the original sources (default: `src`) */
+    sourceDir: _sourceDir,
+    /** The destination directory of the transpiled sources (default: `dist`) */
+    destDir: _destDir,
+    /** The directory for the test files (default: `test`) */
+    testDir: _testDir,
+    /** The directory for the coverage report (default: `coverage`) */
+    coverageDir: _coverageDir,
+    /** The directory for the coverage data (default: `.coverage-data`) */
+    coverageDataDir: _coverageDataDir,
+    /** A directory containing extra types to use while transpiling (default: `types`) */
+    extraTypesDir: _extraTypesDir,
+    /** The source `package.json` file (default: `package.json`) */
+    packageJson: _packageJson,
+    /** The source `package.json` file (default: same as `packageJson` option) */
+    outputPackageJson: _outputPackageJson,
+    /** The extension used for CommonJS modules (default: `.cjs`) */
+    cjsExtension: _cjsExtension,
+    /** The extension used for EcmaScript modules (default: `.mjs`) */
+    esmExtension: _esmExtension,
+    /** A glob pattern matching all test files (default: `**∕*.test.([cm])?ts`) */
+    testGlob: _testGlob,
+    /** A glob pattern matching files to be exported (default: `index.*`) */
+    exportsGlob: _exportsGlob,
+    /* ====================================================================== *
+     * SOURCES STRUCTURE                                                      *
+     * ====================================================================== */
+    /** Find all CommonJS source files (`*.cts`) */
+    _find_sources_cts() {
+      return (0, import_plug.find)("**/*.(c)?ts", { directory: this.sourceDir, ignore: "**/*.d.ts" });
+    },
+    /** Find all EcmaScript Module source files (`*.mts`) */
+    _find_sources_mts() {
+      return (0, import_plug.find)("**/*.(m)?ts", { directory: this.sourceDir, ignore: "**/*.d.ts" });
+    },
+    /** Find all typescript source files (`*.ts`, `*.mts` and `*.cts`) */
+    _find_sources() {
+      return (0, import_plug.merge)([
+        _cjsTranspile ? this._find_sources_cts() : (0, import_plug.noop)(),
+        _esmTranspile ? this._find_sources_mts() : (0, import_plug.noop)()
+      ]);
+    },
+    /** Find all types definition files within sources */
+    _find_types() {
+      return (0, import_plug.find)("**/*.d.ts", { directory: this.sourceDir });
+    },
+    /** Find all types definition files within sources */
+    _find_extras() {
+      if (!(0, import_plug.isDirectory)(this.extraTypesDir))
+        return (0, import_plug.noop)();
+      return (0, import_plug.find)("**/*.d.ts", { directory: this.extraTypesDir });
+    },
+    /** Find all resource files (non-typescript files) within sources */
+    _find_resources() {
+      return (0, import_plug.find)("**/*", { directory: this.sourceDir, ignore: "**/*.([cm])?ts" });
+    },
+    /** Find all test source files */
+    _find_tests() {
+      return (0, import_plug.find)(this.testGlob, { directory: this.testDir, ignore: "**/*.d.ts" });
+    },
+    /* ====================================================================== *
+     * TRANSPILE                                                              *
+     * ====================================================================== */
+    /** Transpile to CJS */
+    transpile_cjs() {
+      return this._find_sources_cts().esbuild({
+        ...esbuildMergedOptions,
+        format: "cjs",
+        outdir: this.destDir,
+        outExtension: { ".js": this.cjsExtension }
+      });
+    },
+    /** Transpile to ESM */
+    transpile_esm() {
+      return this._find_sources_mts().esbuild({
+        ...esbuildMergedOptions,
+        format: "esm",
+        outdir: this.destDir,
+        outExtension: { ".js": this.esmExtension }
+      });
+    },
+    /** Generate all .d.ts files */
+    transpile_types() {
+      return (0, import_plug.merge)([
+        this._find_sources(),
+        this._find_types(),
+        this._find_extras()
+      ]).tsc("tsconfig.json", {
+        noEmit: false,
+        rootDir: this.sourceDir,
+        declaration: true,
+        emitDeclarationOnly: true,
+        outDir: this.destDir
+      });
+    },
+    /** Copy all resources coming alongside our sources */
+    transpile_resources() {
+      return (0, import_plug.merge)([
+        this._find_resources(),
+        this._find_types()
+      ]).copy(this.destDir);
+    },
+    /** Transpile all source code */
+    async transpile() {
+      banner("Transpiling source files");
+      if ((0, import_plug.isDirectory)(this.destDir))
+        await (0, import_plug.rmrf)(this.destDir);
+      return (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()
+      ]);
+    },
+    /* ====================================================================== *
+     * TEST, COVERAGE & LINTING                                               *
+     * ====================================================================== */
+    /** Run test and emit coverage data */
+    async test() {
+      banner("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 */
+    async coverage() {
+      let files;
+      try {
+        await this.test();
+      } finally {
+        banner("Preparing coverage report");
+        files = await this._find_sources().coverage(this.coverageDataDir, {
+          reportDir: this.coverageDir,
+          minimumCoverage: _minimumCoverage,
+          minimumFileCoverage: _minimumFileCoverage,
+          optimalCoverage: _optimalCoverage,
+          optimalFileCoverage: _optimalFileCoverage
+        });
+      }
+      return files;
+    },
+    /** Run test and emit coverage data */
+    async lint() {
+      banner("Linting sources");
+      await (0, import_plug.merge)([
+        this._find_sources(),
+        this._find_tests(),
+        this._find_types(),
+        this._find_extras()
+      ]).eslint();
+    },
+    /* ====================================================================== *
+     * PACKAGE.JSON EXPORTS                                                   *
+     * ====================================================================== */
+    /** Inject `exports` into the `package.json` file */
+    async exports() {
+      const files = await this.transpile();
+      banner('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,
+        packageJson: this.packageJson,
+        outputPackageJson: this.outputPackageJson
+      });
+    },
+    /* ====================================================================== *
+     * DEFAULT: DO EVERYTHING                                                 *
+     * ====================================================================== */
+    /* coverage ignore next */
+    /** Build everything */
+    async default() {
+      if (_parallelize) {
+        await Promise.all([
+          this.transpile(),
+          this.coverage(),
+          // implies "test"
+          this.lint()
+        ]);
+      } else {
+        await this.transpile();
+        await this.coverage();
+        await this.lint();
+      }
+      await this.exports();
+    }
+  });
+}
+function emitBanner(message) {
+  import_plug.log.notice([
+    "",
+    (0, import_plug.$gry)(`\u2554${"".padStart(60, "\u2550")}\u2557`),
+    `${(0, import_plug.$gry)("\u2551")} ${(0, import_plug.$wht)(message.padEnd(58, " "))} ${(0, import_plug.$gry)("\u2551")}`,
+    (0, import_plug.$gry)(`\u255A${"".padStart(60, "\u2550")}\u255D`),
+    ""
+  ].join("\n"));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  tasks
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

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

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+import '@plugjs/cov8';
+import '@plugjs/eslint';
+import '@plugjs/jasmine';
+import '@plugjs/typescript';
+import type { ESBuildOptions, Pipe } from '@plugjs/plug';
+export * from '@plugjs/plug';
+/** Options for creating our shared build file */
+export interface TasksOptions {
+    /** The directory for the original sources (default: `src`) */
+    sourceDir?: string;
+    /** The destination directory of the transpiled sources (default: `dist`) */
+    destDir?: string;
+    /** The directory for the test files (default: `test`) */
+    testDir?: string;
+    /** The directory for the coverage report (default: `coverage`) */
+    coverageDir?: string;
+    /** The directory for the coverage data (default: `.coverage-data`) */
+    coverageDataDir?: string;
+    /** A directory containing extra types to use while transpiling (default: `types`) */
+    extraTypesDir?: string;
+    /** The source `package.json` file (default: `package.json`) */
+    packageJson?: string;
+    /** The source `package.json` file (default: same as `packageJson` option) */
+    outputPackageJson?: string;
+    /** The extension used for CommonJS modules (default: `.cjs`) */
+    cjsExtension?: string;
+    /** The extension used for EcmaScript modules (default: `.mjs`) */
+    esmExtension?: string;
+    /** Enable CommonJS Modules transpilation or not (default: `true`) */
+    cjsTranspile?: boolean;
+    /** Enable EcmaScript Modules transpilation or not (default: `true`) */
+    esmTranspile?: boolean;
+    /** Enable or disable banners (default: `true` if `parallelize` is `false`) */
+    banners?: boolean;
+    /** Parallelize tasks (might make output confusing, default: `false`) */
+    parallelize?: boolean;
+    /** A glob pattern matching all test files (default: `**∕*.test.([cm])?ts`) */
+    testGlob?: string;
+    /** A glob pattern matching files to be exported (default: `index.*`) */
+    exportsGlob?: string;
+    /** Enable coverage when running tests (default: `true`) */
+    coverage?: boolean;
+    /** Minimum overall coverage percentage (default: `100`) */
+    minimumCoverage?: number;
+    /** Minimum per-file coverage percentage (default: `100`) */
+    minimumFileCoverage?: number;
+    /** Optimal overall coverage percentage (default: _none_) */
+    optimalCoverage?: number;
+    /** Optimal per-file coverage percentage (default: _none_) */
+    optimalFileCoverage?: number;
+    /**
+     * ESBuild compilation options
+     *
+     * Default:
+     *
+     * ```
+     * {
+     *   platform: 'node',
+     *   sourcemap: 'linked',
+     *   sourcesContent: false,
+     *   plugins: [ fixExtensions() ],
+     * }
+     * ```
+     */
+    esbuildOptions?: ESBuildOptions;
+}
+export declare function tasks(options?: TasksOptions): import("@plugjs/plug").Build<{
+    /** The directory for the original sources (default: `src`) */
+    sourceDir: string;
+    /** The destination directory of the transpiled sources (default: `dist`) */
+    destDir: string;
+    /** The directory for the test files (default: `test`) */
+    testDir: string;
+    /** The directory for the coverage report (default: `coverage`) */
+    coverageDir: string;
+    /** The directory for the coverage data (default: `.coverage-data`) */
+    coverageDataDir: string;
+    /** A directory containing extra types to use while transpiling (default: `types`) */
+    extraTypesDir: string;
+    /** The source `package.json` file (default: `package.json`) */
+    packageJson: string;
+    /** The source `package.json` file (default: same as `packageJson` option) */
+    outputPackageJson: string;
+    /** The extension used for CommonJS modules (default: `.cjs`) */
+    cjsExtension: string;
+    /** The extension used for EcmaScript modules (default: `.mjs`) */
+    esmExtension: string;
+    /** A glob pattern matching all test files (default: `**∕*.test.([cm])?ts`) */
+    testGlob: string;
+    /** A glob pattern matching files to be exported (default: `index.*`) */
+    exportsGlob: string;
+    /** Find all CommonJS source files (`*.cts`) */
+    _find_sources_cts(): Pipe;
+    /** Find all EcmaScript Module source files (`*.mts`) */
+    _find_sources_mts(): Pipe;
+    /** Find all typescript source files (`*.ts`, `*.mts` and `*.cts`) */
+    _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 resource files (non-typescript files) within sources */
+    _find_resources(): Pipe;
+    /** Find all test source files */
+    _find_tests(): Pipe;
+    /** Transpile to CJS */
+    transpile_cjs(): Pipe;
+    /** Transpile to ESM */
+    transpile_esm(): Pipe;
+    /** Generate all .d.ts files */
+    transpile_types(): Pipe;
+    /** Copy all resources coming alongside our sources */
+    transpile_resources(): Pipe;
+    /** Transpile all source code */
+    transpile(): Promise<Pipe>;
+    /** Run test and emit coverage data */
+    test(): Promise<void>;
+    /** Run tests (always) and generate a coverage report */
+    coverage(): Promise<Pipe>;
+    /** Run test and emit coverage data */
+    lint(): Promise<void>;
+    /** Inject `exports` into the `package.json` file */
+    exports(): Promise<Pipe>;
+    /** Build everything */
+    default(): Promise<void>;
+}>;