@plugjs/plug 0.3.5 → 0.4.1

package/dist/build.mjs

@@ -1,141 +1,188 @@
 // build.ts
 import { assert } from "./asserts.mjs";
 import { runAsync } from "./async.mjs";
-import { $ms, $p, $t, getLogger, logOptions } from "./logging.mjs";
+import { $gry, $ms, $p, $t, getLogger, logOptions } from "./logging.mjs";
 import { Context, ContextPromises, PipeImpl } from "./pipe.mjs";
 import { findCaller } from "./utils/caller.mjs";
-var taskMarker = Symbol.for("plugjs:isTask");
-function isTask(something) {
-  return something[taskMarker] === true;
+import { getSingleton } from "./utils/singleton.mjs";
+import { buildMarker } from "./types.mjs";
+var taskCallMarker = Symbol.for("plugjs:plug:types:TaskCall");
+function isTaskCall(something) {
+  return something[taskCallMarker] === taskCallMarker;
 }
-function makeTask(buildFile, tasks, props, _def, _name) {
-  async function invoke(state, taskName) {
-    assert(!state.stack.includes(task), `Recursion detected calling ${$t(taskName)}`);
-    const cached = state.cache.get(task);
+function merge(a, b) {
+  return Object.assign(/* @__PURE__ */ Object.create(null), a, b);
+}
+function makeState(state) {
+  const {
+    cache = /* @__PURE__ */ new Map(),
+    fails = /* @__PURE__ */ new Set(),
+    stack = [],
+    tasks = {},
+    props = {}
+  } = state;
+  return { cache, fails, stack, tasks, props };
+}
+var lastIdKey = Symbol.for("plugjs:plug:singleton:taskId");
+var taskId = getSingleton(lastIdKey, () => ({ id: 0 }));
+var TaskImpl = class {
+  constructor(name, buildFile, _def, _tasks, _props) {
+    this.name = name;
+    this.buildFile = buildFile;
+    this._def = _def;
+    this.tasks = _tasks;
+    this.props = _props;
+  }
+  before = [];
+  after = [];
+  id = ++taskId.id;
+  props;
+  tasks;
+  async invoke(state, taskName) {
+    assert(!state.stack.includes(this), `Recursion detected calling ${$t(taskName)}`);
+    const cached = state.cache.get(this);
     if (cached)
       return cached;
-    const props2 = Object.assign({}, task.props, state.props);
-    const tasks2 = Object.assign({}, task.tasks, state.tasks);
-    const stack = [...state.stack, task];
-    const cache = state.cache;
-    state = { stack, cache, tasks: tasks2, props: props2 };
-    const context = new Context(task.buildFile, taskName);
+    state = makeState({
+      props: merge(this.props, state.props),
+      tasks: merge(this.tasks, state.tasks),
+      stack: [...state.stack, this],
+      cache: state.cache,
+      fails: state.fails
+    });
+    const context = new Context(this.buildFile, taskName);
     const build2 = new Proxy({}, {
-      get(_, name) {
-        if (name in tasks2) {
+      get: (_, name) => {
+        if (name in state.tasks) {
           return () => {
-            const promise2 = tasks2[name].invoke(state, name);
+            const promise2 = state.tasks[name].invoke(state, name);
             return new PipeImpl(context, promise2);
           };
-        } else if (name in props2) {
-          return props2[name];
+        } else if (name in state.props) {
+          return state.props[name];
         }
       }
     });
-    for (const before of task.before)
+    for (const before of this.before)
       await before.invoke(state, before.name);
     context.log.info("Running...");
     const now = Date.now();
     const promise = runAsync(context, taskName, async () => {
-      return await _def.call(build2) || void 0;
+      return await this._def.call(build2) || void 0;
     }).then(async (result) => {
       const level = taskName.startsWith("_") ? "info" : "notice";
       context.log[level](`Success ${$ms(Date.now() - now)}`);
       return result;
     }).catch((error) => {
+      state.fails.add(this);
       throw context.log.fail(`Failure ${$ms(Date.now() - now)}`, error);
     }).finally(async () => {
       await ContextPromises.wait(context);
     }).then(async (result) => {
-      for (const after of task.after)
+      for (const after of this.after)
         await after.invoke(state, after.name);
       return result;
     });
-    cache.set(task, promise);
+    state.cache.set(this, promise);
     return promise;
   }
-  const task = Object.assign((overrideProps = {}) => {
-    const state = {
-      cache: /* @__PURE__ */ new Map(),
-      stack: [],
-      props: Object.assign({}, props, overrideProps),
-      tasks
-    };
-    return invoke(state, _name);
-  }, { buildFile, tasks, props, invoke, before: [], after: [] });
-  Object.defineProperty(task, taskMarker, { value: true });
-  Object.defineProperty(task, "name", { value: _name });
-  return task;
-}
-var buildMarker = Symbol.for("plugjs:isBuild");
+};
 function build(def) {
   const buildFile = findCaller(build);
   const tasks = {};
   const props = {};
   for (const [key, val] of Object.entries(def)) {
     let len = 0;
-    if (isTask(val)) {
-      tasks[key] = val;
+    if (isTaskCall(val)) {
+      tasks[key] = val.task;
       len = key.length;
     } else if (typeof val === "string") {
       props[key] = val;
     } else if (typeof val === "function") {
-      tasks[key] = makeTask(buildFile, tasks, props, val, key);
+      tasks[key] = new TaskImpl(key, buildFile, val, tasks, props);
       len = key.length;
     }
     if (len > logOptions.taskLength)
       logOptions.taskLength = len;
   }
-  const invoke = async function invoke2(taskNames, overrideProps = {}) {
+  const start = async function start2(callback, overrideProps = {}) {
+    const state = makeState({ tasks, props: merge(props, overrideProps) });
     const logger = getLogger();
-    const state = {
-      cache: /* @__PURE__ */ new Map(),
-      stack: [],
-      props: Object.assign({}, props, overrideProps),
-      tasks
-    };
     logger.notice("Starting...");
     const now = Date.now();
     try {
+      const result = await callback(state);
+      logger.notice(`Build successful ${$ms(Date.now() - now)}`);
+      return result;
+    } catch (error) {
+      if (state.fails.size) {
+        logger.error("");
+        logger.error(state.fails.size, state.fails.size === 1 ? "task" : "tasks", "failed:");
+        state.fails.forEach((task) => logger.error($gry("*"), $t(task.name)));
+        logger.error("");
+      }
+      throw logger.fail(`Build failed ${$ms(Date.now() - now)}`, error);
+    }
+  };
+  const invoke = async function invoke2(taskNames, overrideProps = {}) {
+    await start(async (state) => {
       for (const name of taskNames) {
         const task = tasks[name];
         assert(task, `Task ${$t(name)} not found in build ${$p(buildFile)}`);
         await task.invoke(state, name);
       }
-      logger.notice(`Build successful ${$ms(Date.now() - now)}`);
-    } catch (error) {
-      throw logger.fail(`Build failed ${$ms(Date.now() - now)}`, error);
-    }
+    }, overrideProps);
   };
-  const compiled = Object.assign({}, props, tasks);
+  const callables = {};
+  for (const [name, task] of Object.entries(tasks)) {
+    const callable = async (overrideProps) => start(async (state) => task.invoke(state, name), overrideProps);
+    callables[name] = Object.defineProperties(callable, {
+      [taskCallMarker]: { value: taskCallMarker },
+      "task": { value: task },
+      "name": { value: name }
+    });
+  }
+  const compiled = merge(props, callables);
   Object.defineProperty(compiled, buildMarker, { value: invoke });
   return compiled;
 }
+function isBuild(build2) {
+  return build2 && typeof build2[buildMarker] === "function";
+}
+function invokeTasks(build2, tasks, props) {
+  if (isBuild(build2)) {
+    return build2[buildMarker](tasks, props);
+  } else {
+    throw new TypeError("Invalid build instance");
+  }
+}
 function hookBefore(build2, taskName, hooks) {
-  const task = build2[taskName];
-  assert(isTask(task), `Task "${$t(taskName)}" not found in build`);
+  const taskCall = build2[taskName];
+  assert(isTaskCall(taskCall), `Task "${$t(taskName)}" not found in build`);
   for (const hook of hooks) {
     const beforeHook = build2[hook];
-    assert(isTask(beforeHook), `Task "${$t(hook)}" to hook before "${$t(taskName)}" not found in build`);
-    if (task.before.includes(beforeHook))
+    assert(isTaskCall(beforeHook), `Task "${$t(hook)}" to hook before "${$t(taskName)}" not found in build`);
+    if (taskCall.task.before.includes(beforeHook.task))
       continue;
-    task.before.push(beforeHook);
+    taskCall.task.before.push(beforeHook.task);
   }
 }
 function hookAfter(build2, taskName, hooks) {
-  const task = build2[taskName];
-  assert(isTask(task), `Task "${$t(taskName)}" not found in build`);
+  const taskCall = build2[taskName];
+  assert(isTaskCall(taskCall), `Task "${$t(taskName)}" not found in build`);
   for (const hook of hooks) {
     const afterHook = build2[hook];
-    assert(isTask(afterHook), `Task "${$t(hook)}" to hook after "${$t(taskName)}" not found in build`);
-    if (task.after.includes(afterHook))
+    assert(isTaskCall(afterHook), `Task "${$t(hook)}" to hook after "${$t(taskName)}" not found in build`);
+    if (taskCall.task.after.includes(afterHook.task))
       continue;
-    task.after.push(afterHook);
+    taskCall.task.after.push(afterHook.task);
   }
 }
 export {
   build,
   hookAfter,
-  hookBefore
+  hookBefore,
+  invokeTasks,
+  isBuild
 };
 //# sourceMappingURL=build.mjs.map

package/dist/build.mjs.map

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

package/dist/cli.d.mts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import type { AbsolutePath } from './paths';
+interface CommandLineOptions {
+    buildFile: AbsolutePath;
+    watchDirs: string[];
+    tasks: string[];
+    props: Record<string, string>;
+    listOnly: boolean;
+}
+/** Parse `perocess.argv` and return our normalised command line options */
+export declare function parseCommandLine(args: string[]): CommandLineOptions;
+export {};

package/dist/cli.mjs

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+
+// cli.mts
+import _fs from "node:fs";
+import { main, yargsParser } from "@plugjs/tsrun";
+import { BuildFailure } from "./asserts.mjs";
+import { invokeTasks, isBuild } from "./build.mjs";
+import { $blu, $gry, $p, $red, $t, $und, $wht } from "./logging/colors.mjs";
+import { getCurrentWorkingDirectory, resolveDirectory, resolveFile, resolveAbsolutePath } from "./paths.mjs";
+var $bnd = (s) => $blu($und(s));
+var $gnd = (s) => $gry($und(s));
+var $wnd = (s) => $wht($und(s));
+var version = true ? "0.4.1" : "0.0.0-dev";
+function help() {
+  console.log(`${$bnd("Usage:")}
+
+  ${$wht("plugjs")} ${$gry("[")}--options${$gry("] [... ")}prop=val${$gry(" ...] [... ")}task${$gry(" ...]")}
+
+  ${$bnd("Options:")}
+
+      ${$wht(`-f --file ${$gnd("file")}`)}  Specify the build file to use (default ${$wnd("./build.ts")})
+      ${$wht(`-w --watch ${$gnd("dir")}`)}  Watch for changes on the specified directory and run
+      ${$wht("-v --verbose")}    Increase logging verbosity
+      ${$wht("-q --quiet")}      Decrease logging verbosity
+      ${$wht("-c --colors")}     Force colorful output (use ${$wnd("--no-colors")} to force plain text)
+      ${$wht("-l --list")}       Only list the tasks defined by the build, nothing more!
+      ${$wht("-h --help")}       Help! You're reading it now!
+      ${$wht("   --version")}    Version! This one: ${version}!
+
+  ${$bnd("Properties:")}
+
+      Any argument in the format ${$wnd("key=value")} will be interpeted as a property to
+      be injected in the build process (e.g. ${$wnd("mode=production")}).
+
+  ${$bnd("Tasks:")}
+
+      Any other argument will be treated as a task name. If no task names are
+      specified, the ${$t("default")} task will be executed.
+
+  ${$bnd("Watch Mode:")}
+
+      The ${$wnd("--watch")} option can be specified multiple times, and each single
+      directory specified will be watched for changes. Note that Plug's own
+      watch mode is incredibly basic, for more complex scenarios use something
+      more advanced like nodemon ${$gry("(")}${$gnd("https://www.npmjs.com/package/nodemon")}${$gry(")")}.
+
+  ${$bnd("TypeScript module format:")}
+
+      Normally our TypeScript loader will transpile ${$wnd(".ts")} files to the type
+      specified in ${$wnd("package.json")}, either ${$wnd("commonjs")} (the default) or ${$wnd("module")}.
+
+      To force a specific module format use one of the following flags:
+
+      ${$wht("--force-esm")}    Force transpilation of ${$wnd(".ts")} files to EcmaScript modules
+      ${$wht("--force-cjs")}    Force transpilation of ${$wnd(".ts")} files to CommonJS modules
+    `);
+}
+function parseCommandLine(args) {
+  const parsed = yargsParser(args, {
+    configuration: {
+      "camel-case-expansion": false,
+      "strip-aliased": true,
+      "strip-dashed": true
+    },
+    alias: {
+      "verbose": ["v"],
+      "quiet": ["q"],
+      "colors": ["c"],
+      "file": ["f"],
+      "list": ["l"],
+      "watch": ["w"],
+      "help": ["h"]
+    },
+    string: ["file", "watch"],
+    boolean: ["help", "colors", "list", "force-esm", "force-cjs", "version"],
+    count: ["verbose", "quiet"]
+  });
+  const tasks = [];
+  const props = {};
+  const watchDirs = [];
+  let verbosity = 0;
+  let colors = void 0;
+  let file = void 0;
+  let listOnly = false;
+  for (const [key, value] of Object.entries(parsed)) {
+    switch (key) {
+      case "_":
+        value.forEach((current) => {
+          const [key2, val] = current.split(/=(.*)/, 2);
+          if (key2 && val)
+            props[key2] = val;
+          else
+            tasks.push(current);
+        });
+        break;
+      case "verbose":
+        verbosity = verbosity + value;
+        break;
+      case "quiet":
+        verbosity = verbosity - value;
+        break;
+      case "file":
+        file = value;
+        break;
+      case "watch":
+        if (Array.isArray(value))
+          watchDirs.push(...value);
+        else if (value)
+          watchDirs.push(value);
+        break;
+      case "colors":
+        colors = !!value;
+        break;
+      case "list":
+        listOnly = !!value;
+        break;
+      case "help":
+        help();
+        process.exit(0);
+        break;
+      case "version":
+        console.log(`PlugJS ${$gry("ver.")} ${$wnd(version)}`);
+        process.exit(0);
+        break;
+      default:
+        console.log(`Unsupported option ${$wnd(key)} (try ${$wnd("--help")})`);
+        process.exit(1);
+    }
+  }
+  if (colors !== void 0)
+    process.env.LOG_COLORS = `${colors}`;
+  if (verbosity) {
+    const levels = ["TRACE", "DEBUG", "INFO", "NOTICE", "WARN", "ERROR", "OFF"];
+    let level = levels.indexOf("NOTICE") - verbosity;
+    if (level >= levels.length)
+      level = levels.length - 1;
+    else if (level < 0)
+      level = 0;
+    process.env.LOG_LEVEL = levels[level];
+  }
+  const cwd = getCurrentWorkingDirectory();
+  const exts = ["ts", "mts", "mjs", "js", "mjs", "cjs"];
+  let buildFile = void 0;
+  if (file) {
+    const absolute = resolveFile(cwd, file);
+    if (!absolute) {
+      console.log(`Specified build file "${file}" was not found`);
+      process.exit(1);
+    } else {
+      buildFile = absolute;
+    }
+  } else {
+    for (const ext of exts) {
+      const absolute = resolveFile(cwd, `build.${ext}`);
+      if (!absolute)
+        continue;
+      buildFile = absolute;
+      break;
+    }
+  }
+  if (!buildFile) {
+    console.log(`${$red("Unable to find build file")} ${$wht(`./build.[${exts.join("|")}]`)}`);
+    process.exit(1);
+  }
+  watchDirs.forEach((watchDir) => {
+    const absolute = resolveDirectory(cwd, watchDir);
+    if (!absolute) {
+      const path = resolveAbsolutePath(cwd, watchDir);
+      console.log(`Specified watch directory "${$p(path)}" was not found`);
+      process.exit(1);
+    } else {
+      watchDir = absolute;
+    }
+  });
+  return { buildFile, watchDirs, tasks, props, listOnly };
+}
+main(import.meta.url, async (args) => {
+  const {
+    buildFile,
+    watchDirs,
+    tasks,
+    props,
+    listOnly
+  } = parseCommandLine(args);
+  if (tasks.length === 0)
+    tasks.push("default");
+  let maybeBuild = await import(buildFile);
+  while (maybeBuild) {
+    if (isBuild(maybeBuild))
+      break;
+    maybeBuild = maybeBuild.default;
+  }
+  if (!isBuild(maybeBuild)) {
+    console.log($red("Build file did not export a proper build"));
+    console.log();
+    console.log('- If using CommonJS export your build as "module.exports"');
+    console.log(`  e.g.: ${$wht("module.exports = build({ ... })")}`);
+    console.log();
+    console.log('- If using ESM modules export your build as "default"');
+    console.log(`  e.g.: ${$wht("export default build({ ... })")}`);
+    console.log();
+    process.exit(1);
+  }
+  const build = maybeBuild;
+  if (listOnly) {
+    const taskNames = [];
+    const propNames = [];
+    for (const [key, value] of Object.entries(build)) {
+      (typeof value === "string" ? propNames : taskNames).push(key);
+    }
+    console.log(`
+${$gry("Outline of")} ${$p(buildFile)}`);
+    console.log("\nKnown tasks:\n");
+    for (const taskName of taskNames.sort()) {
+      console.log(` ${$gry("\u25A0")} ${$t(taskName)}`);
+    }
+    console.log("\nKnown properties:\n");
+    for (const propName of propNames.sort()) {
+      const value = build[propName] ? ` ${$gry("(default")} ${$und(build[propName])}${$gry(")")}` : "";
+      console.log(` ${$gry("\u25A1")} ${$blu(propName)}${value}`);
+    }
+    console.log();
+    return;
+  }
+  if (watchDirs.length) {
+    return new Promise((_, reject) => {
+      let timeout = void 0;
+      const runme = () => {
+        invokeTasks(build, tasks, props).then(() => {
+          console.log(`
+${$gry("Watching for files change...")}
+`);
+        }, (error) => {
+          if (error instanceof BuildFailure) {
+            console.log(`
+${$gry("Watching for files change...")}
+`);
+          } else {
+            watchers.forEach((watcher) => watcher.close());
+            reject(error);
+          }
+        }).finally(() => {
+          timeout = void 0;
+        });
+      };
+      const watchers = watchDirs.map((watchDir) => {
+        return _fs.watch(watchDir, { recursive: true }, () => {
+          if (!timeout)
+            timeout = setTimeout(runme, 250);
+        });
+      });
+      runme();
+    });
+  }
+  try {
+    await invokeTasks(build, tasks, props);
+  } catch (error) {
+    if (!(error instanceof BuildFailure))
+      console.log(error);
+    process.exitCode = 1;
+  }
+});
+export {
+  parseCommandLine
+};
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

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

package/dist/files.cjs

@@ -23,6 +23,7 @@ __export(files_exports, {
   Files: () => Files
 });
 module.exports = __toCommonJS(files_exports);
+var import_node_util = require("node:util");
 var import_asserts = require("./asserts.cjs");
 var import_fs = require("./fs.cjs");
 var import_paths = require("./paths.cjs");
@@ -34,10 +35,9 @@ var Files = class {
    * relative to the specified {@link Run}'s directory.
    */
   constructor(directory) {
-    this._directory = directory;
+    this._directory = directory || (0, import_paths.getCurrentWorkingDirectory)();
     this._files = [];
-    const inspect = Symbol.for("nodejs.util.inspect.custom");
-    Object.defineProperty(this, inspect, { value: () => ({
+    Object.defineProperty(this, import_node_util.inspect.custom, { value: () => ({
       directory: this._directory,
       files: [...this._files]
     }) });
@@ -66,6 +66,8 @@ var Files = class {
       yield [file, (0, import_paths.resolveAbsolutePath)(this._directory, file)];
   }
   static builder(arg) {
+    if (!arg)
+      arg = (0, import_paths.getCurrentWorkingDirectory)();
     const directory = typeof arg === "string" ? arg : arg.directory;
     const set = typeof arg === "string" ? /* @__PURE__ */ new Set() : new Set(arg._files);
     const instance = new Files(directory);

package/dist/files.cjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/files.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAuB;AACvB,gBAAiC;AACjC,mBAAgF;AA8BzE,IAAM,QAAN,MAAY;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMjB,YAAY,WAAyB;AACnC,SAAK,aAAa;AAClB,SAAK,SAAS,CAAC;AAGf,UAAM,UAAU,OAAO,IAAI,4BAA4B;AACvD,WAAO,eAAe,MAAM,SAAS,EAAE,OAAO,OAAO;AAAA,MACnD,WAAW,KAAK;AAAA,MAChB,OAAO,CAAE,GAAG,KAAK,MAAO;AAAA,IAC1B,GAAG,CAAC;AAAA,EACN;AAAA;AAAA,EAGA,IAAI,YAA0B;AAC5B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,SAAiB;AACnB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA;AAAA,EAGA,EAAG,OAAO,QAAQ,IAAuB;AACvC,eAAW,QAAQ,KAAK;AAAQ,YAAM;AAAA,EACxC;AAAA;AAAA,EAGA,CAAE,gBAAyC;AACzC,eAAW,QAAQ;AAAM,gBAAM,kCAAoB,KAAK,YAAY,IAAI;AAAA,EAC1E;AAAA;AAAA,EAGA,CAAE,eAAwE;AACxE,eAAW,QAAQ;AAAM,YAAM,CAAE,UAAM,kCAAoB,KAAK,YAAY,IAAI,CAAE;AAAA,EACpF;AAAA,EAKA,OAAO,QAAQ,KAAyC;AACtD,UAAM,YAAY,OAAO,QAAQ,WAAW,MAAM,IAAI;AACtD,UAAM,MAAM,OAAO,QAAQ,WAAW,oBAAI,IAAY,IAAI,IAAI,IAAI,IAAI,MAAM;AAE5E,UAAM,WAAW,IAAI,MAAM,SAAS;AACpC,QAAI,QAAQ;AAEZ,WAAO;AAAA,MACL,WAAW,SAAS;AAAA,MAEpB,OAAO,OAA+B;AACpC,mCAAO,CAAE,OAAO,sCAAsC;AAEtD,mBAAW,QAAQ,OAAO;AACxB,gBAAM,eAAW,sCAAwB,SAAS,WAAW,IAAI;AACjE,cAAI,IAAI,QAAQ;AAAA,QAClB;AAEA,eAAO;AAAA,MACT;AAAA,MAEA,SAAS,MAA6B;AACpC,mCAAO,CAAE,OAAO,sCAAsC;AAEtD,mBAAW,SAAS,MAAM;AACxB,qBAAW,QAAQ,MAAM,cAAc,GAAG;AACxC,iBAAK,IAAI,IAAI;AAAA,UACf;AAAA,QACF;AAEA,eAAO;AAAA,MACT;AAAA,MAEA,MAAM,MAAM,MAAc,SAAqD;AAC7E,cAAM,eAAW,sCAAwB,SAAS,WAAW,IAAI;AACjE,cAAM,eAAW,kCAAoB,SAAS,WAAW,QAAQ;AACjE,cAAMA,iBAAY,gCAAkB,QAAQ;AAE5C,kBAAM,iBAAMA,YAAW,EAAE,WAAW,KAAK,CAAC;AAC1C,kBAAM,qBAAU,UAAU,OAAO;AACjC,aAAK,IAAI,QAAQ;AAEjB,eAAO;AAAA,MACT;AAAA,MAEA,QAAe;AACb,mCAAO,CAAE,OAAO,sCAAsC;AAEtD,gBAAQ;AACR,iBAAS,OAAO,KAAK,GAAG,GAAG;AAC3B,iBAAS,OAAO,KAAK;AACrB,eAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AACF;",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAAwB;AAExB,qBAAuB;AACvB,gBAAiC;AACjC,mBAKO;AA8BA,IAAM,QAAN,MAAY;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMjB,YAAY,WAA0B;AACpC,SAAK,aAAa,iBAAa,yCAA2B;AAC1D,SAAK,SAAS,CAAC;AAGf,WAAO,eAAe,MAAM,yBAAQ,QAAQ,EAAE,OAAO,OAAO;AAAA,MAC1D,WAAW,KAAK;AAAA,MAChB,OAAO,CAAE,GAAG,KAAK,MAAO;AAAA,IAC1B,GAAG,CAAC;AAAA,EACN;AAAA;AAAA,EAGA,IAAI,YAA0B;AAC5B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,SAAiB;AACnB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA;AAAA,EAGA,EAAG,OAAO,QAAQ,IAAuB;AACvC,eAAW,QAAQ,KAAK;AAAQ,YAAM;AAAA,EACxC;AAAA;AAAA,EAGA,CAAE,gBAAyC;AACzC,eAAW,QAAQ;AAAM,gBAAM,kCAAoB,KAAK,YAAY,IAAI;AAAA,EAC1E;AAAA;AAAA,EAGA,CAAE,eAAwE;AACxE,eAAW,QAAQ;AAAM,YAAM,CAAE,UAAM,kCAAoB,KAAK,YAAY,IAAI,CAAE;AAAA,EACpF;AAAA,EAMA,OAAO,QAAQ,KAA0C;AACvD,QAAI,CAAE;AAAK,gBAAM,yCAA2B;AAC5C,UAAM,YAAY,OAAO,QAAQ,WAAW,MAAM,IAAI;AACtD,UAAM,MAAM,OAAO,QAAQ,WAAW,oBAAI,IAAY,IAAI,IAAI,IAAI,IAAI,MAAM;AAE5E,UAAM,WAAW,IAAI,MAAM,SAAS;AACpC,QAAI,QAAQ;AAEZ,WAAO;AAAA,MACL,WAAW,SAAS;AAAA,MAEpB,OAAO,OAA+B;AACpC,mCAAO,CAAE,OAAO,sCAAsC;AAEtD,mBAAW,QAAQ,OAAO;AACxB,gBAAM,eAAW,sCAAwB,SAAS,WAAW,IAAI;AACjE,cAAI,IAAI,QAAQ;AAAA,QAClB;AAEA,eAAO;AAAA,MACT;AAAA,MAEA,SAAS,MAA6B;AACpC,mCAAO,CAAE,OAAO,sCAAsC;AAEtD,mBAAW,SAAS,MAAM;AACxB,qBAAW,QAAQ,MAAM,cAAc,GAAG;AACxC,iBAAK,IAAI,IAAI;AAAA,UACf;AAAA,QACF;AAEA,eAAO;AAAA,MACT;AAAA,MAEA,MAAM,MAAM,MAAc,SAAqD;AAC7E,cAAM,eAAW,sCAAwB,SAAS,WAAW,IAAI;AACjE,cAAM,eAAW,kCAAoB,SAAS,WAAW,QAAQ;AACjE,cAAMA,iBAAY,gCAAkB,QAAQ;AAE5C,kBAAM,iBAAMA,YAAW,EAAE,WAAW,KAAK,CAAC;AAC1C,kBAAM,qBAAU,UAAU,OAAO;AACjC,aAAK,IAAI,QAAQ;AAEjB,eAAO;AAAA,MACT;AAAA,MAEA,QAAe;AACb,mCAAO,CAAE,OAAO,sCAAsC;AAEtD,gBAAQ;AACR,iBAAS,OAAO,KAAK,GAAG,GAAG;AAC3B,iBAAS,OAAO,KAAK;AACrB,eAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AACF;",
   "names": ["directory"]
 }

package/dist/files.d.ts

@@ -27,7 +27,7 @@ export declare class Files {
      * Create a new {@link Files} instance rooted in the specified `directory`
      * relative to the specified {@link Run}'s directory.
      */
-    constructor(directory: AbsolutePath);
+    constructor(directory?: AbsolutePath);
     /** Return the _directory_ where this {@link Files} is rooted */
     get directory(): AbsolutePath;
     /** Return the number of files tracked by this instance. */
@@ -39,6 +39,7 @@ export declare class Files {
     /** Return an iterator over all _relative_ to _absolute_ mappings */
     pathMappings(): Generator<[relative: string, absolute: AbsolutePath]>;
     /** Create a new {@link FilesBuilder} creating {@link Files} instances. */
+    static builder(): FilesBuilder;
     static builder(files: Files): FilesBuilder;
     static builder(directory: AbsolutePath): FilesBuilder;
 }