@plugjs/plug 0.0.14 → 0.0.16

package/dist/plugs/tsc/runner.mjs.map

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

package/dist/plugs/tsc.cjs

@@ -0,0 +1,7 @@
+"use strict";
+
+// plugs/tsc.ts
+var import_paths = require("../paths.cjs");
+var import_pipe = require("../pipe.cjs");
+(0, import_pipe.installForking)("tsc", (0, import_paths.requireResolve)(__filename, "./tsc/runner"));
+//# sourceMappingURL=tsc.cjs.map

package/dist/plugs/tsc.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/plugs/tsc.ts"],
+  "mappings": ";;;AAEA,mBAA+B;AAC/B,kBAA+B;AAAA,IAyC/B,4BAAe,WAAO,6BAAe,YAAW,cAAc,CAAC;",
+  "names": []
+}

package/dist/plugs/tsc.d.ts

@@ -0,0 +1,36 @@
+import type { CompilerOptions } from 'typescript';
+declare module '../pipe' {
+    interface Pipe {
+        /**
+         * Run the {@link https://www.typescriptlang.org/ TypeScript Compiler}
+         * over the input source files, using the default `tsconfig.json` file.
+         */
+        tsc(): Pipe;
+        /**
+         * Run the {@link https://www.typescriptlang.org/ TypeScript Compiler}
+         * over the input source files, specifying the `tsconfig.json` file.
+         *
+         * @param configFile The `tsconfig.json` file to use.
+         */
+        tsc(configFile: string): Pipe;
+        /**
+         * Run the {@link https://www.typescriptlang.org/ TypeScript Compiler}
+         * over the input source files, using the default `tsconfig.json` file
+         * and overriding some options
+         *
+         * @param options {@link CompilerOptions | Options} overriding what's
+         *                currently specified in the default `tsconfig.json`.
+         */
+        tsc(options: CompilerOptions): Pipe;
+        /**
+         * Run the {@link https://www.typescriptlang.org/ TypeScript Compiler}
+         * over the input source files, specifying the `tsconfig.json` file
+         * and overriding some options
+         *
+         * @param configFile The `tsconfig.json` file to use.
+         * @param options {@link CompilerOptions | Options} overriding what's
+         *                currently specified in the specified `tsconfig.json`.
+         */
+        tsc(configFile: string, options: CompilerOptions): Pipe;
+    }
+}

package/dist/plugs/tsc.mjs

@@ -0,0 +1,15 @@
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+
+// plugs/tsc.ts
+import { requireResolve } from "../paths.mjs";
+import { installForking } from "../pipe.mjs";
+var require_tsc = __commonJS({
+  "plugs/tsc.ts"() {
+    installForking("tsc", requireResolve(import.meta.url, "./tsc/runner"));
+  }
+});
+export default require_tsc();
+//# sourceMappingURL=tsc.mjs.map

package/dist/plugs/tsc.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/plugs/tsc.ts"],
+  "mappings": ";;;;;;AAEA,SAAS,sBAAsB;AAC/B,SAAS,sBAAsB;AAH/B;AAAA;AA4CA,mBAAe,OAAO,eAAe,iBAAW,cAAc,CAAC;AAAA;AAAA;",
+  "names": []
+}

package/dist/plugs.cjs

@@ -17,8 +17,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // plugs.ts
 var plugs_exports = {};
 module.exports = __toCommonJS(plugs_exports);
-var import_fork = require("./fork.cjs");
-var import_paths = require("./paths.cjs");
+__reExport(plugs_exports, require("./plugs/eslint.cjs"), module.exports);
+__reExport(plugs_exports, require("./plugs/mocha.cjs"), module.exports);
+__reExport(plugs_exports, require("./plugs/tsc.cjs"), module.exports);
 __reExport(plugs_exports, require("./plugs/copy.cjs"), module.exports);
 __reExport(plugs_exports, require("./plugs/coverage.cjs"), module.exports);
 __reExport(plugs_exports, require("./plugs/debug.cjs"), module.exports);
@@ -26,7 +27,4 @@ __reExport(plugs_exports, require("./plugs/esbuild.cjs"), module.exports);
 __reExport(plugs_exports, require("./plugs/exec.cjs"), module.exports);
 __reExport(plugs_exports, require("./plugs/filter.cjs"), module.exports);
 __reExport(plugs_exports, require("./plugs/rmf.cjs"), module.exports);
-(0, import_fork.installForking)("eslint", (0, import_paths.requireResolve)(__filename, "./plugs/eslint/runner"));
-(0, import_fork.installForking)("mocha", (0, import_paths.requireResolve)(__filename, "./plugs/mocha/runner"));
-(0, import_fork.installForking)("tsc", (0, import_paths.requireResolve)(__filename, "./plugs/tsc/runner"));
 //# sourceMappingURL=plugs.cjs.map

package/dist/plugs.cjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/plugs.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAIA,kBAA+B;AAC/B,mBAA+B;AAsB/B,0BAAc,6BA3Bd;AA4BA,0BAAc,iCA5Bd;AA6BA,0BAAc,8BA7Bd;AA8BA,0BAAc,gCA9Bd;AA+BA,0BAAc,6BA/Bd;AAgCA,0BAAc,+BAhCd;AAiCA,0BAAc,4BAjCd;AAAA,IAmBA,4BAAe,cAAU,6BAAe,YAAW,uBAAuB,CAAC;AAAA,IAC3E,4BAAe,aAAS,6BAAe,YAAW,sBAAsB,CAAC;AAAA,IACzE,4BAAe,WAAO,6BAAe,YAAW,oBAAoB,CAAC;",
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAIA,0BAAc,+BAJd;AAKA,0BAAc,8BALd;AAMA,0BAAc,4BANd;AAYA,0BAAc,6BAZd;AAaA,0BAAc,iCAbd;AAcA,0BAAc,8BAdd;AAeA,0BAAc,gCAfd;AAgBA,0BAAc,6BAhBd;AAiBA,0BAAc,+BAjBd;AAkBA,0BAAc,4BAlBd;",
   "names": []
 }

package/dist/plugs.d.ts

@@ -1,17 +1,10 @@
-import type ESLint from './plugs/eslint/runner.js';
-import type Mocha from './plugs/mocha/runner.js';
-import type Tsc from './plugs/tsc/runner.js';
-declare module './pipe.js' {
-    interface Pipe {
-        eslint: PipeExtension<typeof ESLint>;
-        mocha: PipeExtension<typeof Mocha>;
-        tsc: PipeExtension<typeof Tsc>;
-    }
-}
-export * from './plugs/copy.js';
-export * from './plugs/coverage.js';
-export * from './plugs/debug.js';
-export * from './plugs/esbuild.js';
-export * from './plugs/exec.js';
-export * from './plugs/filter.js';
-export * from './plugs/rmf.js';
+export * from './plugs/eslint';
+export * from './plugs/mocha';
+export * from './plugs/tsc';
+export * from './plugs/copy';
+export * from './plugs/coverage';
+export * from './plugs/debug';
+export * from './plugs/esbuild';
+export * from './plugs/exec';
+export * from './plugs/filter';
+export * from './plugs/rmf';

package/dist/plugs.mjs

@@ -1,6 +1,7 @@
 // plugs.ts
-import { installForking } from "./fork.mjs";
-import { requireResolve } from "./paths.mjs";
+export * from "./plugs/eslint.mjs";
+export * from "./plugs/mocha.mjs";
+export * from "./plugs/tsc.mjs";
 export * from "./plugs/copy.mjs";
 export * from "./plugs/coverage.mjs";
 export * from "./plugs/debug.mjs";
@@ -8,7 +9,4 @@ export * from "./plugs/esbuild.mjs";
 export * from "./plugs/exec.mjs";
 export * from "./plugs/filter.mjs";
 export * from "./plugs/rmf.mjs";
-installForking("eslint", requireResolve(import.meta.url, "./plugs/eslint/runner"));
-installForking("mocha", requireResolve(import.meta.url, "./plugs/mocha/runner"));
-installForking("tsc", requireResolve(import.meta.url, "./plugs/tsc/runner"));
 //# sourceMappingURL=plugs.mjs.map

package/dist/plugs.mjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/plugs.ts"],
-  "mappings": ";AAIA,SAAS,sBAAsB;AAC/B,SAAS,sBAAsB;AAsB/B,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAdd,eAAe,UAAU,eAAe,iBAAW,uBAAuB,CAAC;AAC3E,eAAe,SAAS,eAAe,iBAAW,sBAAsB,CAAC;AACzE,eAAe,OAAO,eAAe,iBAAW,oBAAoB,CAAC;",
+  "mappings": ";AAIA,cAAc;AACd,cAAc;AACd,cAAc;AAMd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/dist/types.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/types.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+import type { Files } from './files';
+import type { AbsolutePath } from './paths';
+import type { Pipe } from './pipe';
+/**
+ * A type describing the ultimate result of a {@link Plug}, {@link Pipe} or
+ * {@link Task}, that is either a {@link Files} instance or `undefined`.
+ */
+export declare type Result = Files | undefined;
+/**
+ * The {@link State} interface defines a component tracking the current
+ * _state_ of a build, caching the result of {@link Task}s, and tracking their
+ * invocation stack to avoid infinite loops.
+ */
+export interface State {
+    /** The cache of the result of {@link Task}s execution */
+    readonly cache: Map<Task, Promise<Result>>;
+    /** The current {@link Task} invocation stack (to avoid infinite loops) */
+    readonly stack: Task[];
+    /** All {@link Tasks} available in this {@link State} */
+    readonly tasks: Tasks;
+    /** All _properties_ available in this {@link State} */
+    readonly props: Props;
+}
+/**
+ * The {@link Task} interface normalizes a task definition, associating it with
+ * its build file, its sibling {@link Task}s and available _properties_.
+ */
+export interface Task<T extends Result = Result> {
+    /** All _properties_ siblings to this {@link Task} */
+    readonly props: Props;
+    /** All {@link Tasks} sibling to this {@link Task} */
+    readonly tasks: Tasks;
+    /** The absolute file name where this {@link Task} was defined */
+    readonly buildFile: AbsolutePath;
+    /** Invoke a task from (possibly) a different {@link Context} */
+    call(state: State, taskName: string): Promise<T>;
+}
+/**
+ * The {@link TaskResult} type identifies _what_ can be returned by a
+ * {@link TaskDef | _task definition_}.
+ */
+export declare type TaskResult = Pipe | Files | void | undefined;
+/** The {@link TaskDef} type identifies the _definition_ of a task. */
+export declare type TaskDef<R extends TaskResult = TaskResult> = () => R | Promise<R>;
+/** A type identifying all _properties_ of a {@link Context}. */
+export declare type Props<D extends BuildDef = BuildDef> = {
+    readonly [k in string & keyof D as D[k] extends string ? k : never]: string;
+};
+/** A type identifying all _tasks_ in a {@link Context} */
+export declare type Tasks<D extends BuildDef = BuildDef> = {
+    readonly [k in string & keyof D as D[k] extends TaskDef | Task ? k : never]: D[k] extends TaskDef<infer R> ? R extends void | undefined ? Task<undefined> : R extends Pipe | Files ? Task<Files> : never : D[k] extends Task ? D[k] : never;
+};
+/**
+ * The {@link BuildDef} interface describes the _definition_ of a {@link Build},
+ * all its properties and tasks.
+ */
+export interface BuildDef {
+    [k: string]: string | TaskDef | Task;
+}
+/**
+ * The type that will be used for `this` when invoking
+ * {@link TaskDef | task definitions }.
+ */
+export declare type ThisBuild<D extends BuildDef> = {
+    readonly [k in keyof D]: k extends string ? D[k] extends TaskDef<infer R> ? R extends Promise<undefined> | void | undefined ? () => Promise<undefined> : R extends Pipe | Files ? () => Pipe & Promise<Files> : never : D[k] extends Task<infer R> ? R extends undefined ? () => Promise<undefined> : R extends Files ? () => Pipe & Promise<Files> : never : D[k] extends string ? string : never : never;
+};
+/**
+ * The {@link Build} type represents the collection of {@link Task}s
+ * and _properties_ compiled from a {@link BuildDef | build definition}.
+ */
+export declare type Build<D extends BuildDef = BuildDef> = Tasks<D> & Props<D>;

package/dist/types.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": [],
+  "mappings": "",
+  "names": []
+}

package/dist/utils/caller.cjs

@@ -26,6 +26,7 @@ module.exports = __toCommonJS(caller_exports);
 var import_node_fs = require("node:fs");
 var import_node_url = require("node:url");
 var import_assert = require("../assert.cjs");
+var import_log = require("../log.cjs");
 var import_paths = require("../paths.cjs");
 function findCaller(of) {
   const oldPrepareStackTrace = Error.prepareStackTrace;
@@ -34,20 +35,16 @@ function findCaller(of) {
       const nullableFileOrUrl = stackTraces[0].getFileName();
       if (!nullableFileOrUrl)
         return;
-      const nullableLine = stackTraces[0].getColumnNumber();
-      const nullableColumn = stackTraces[0].getColumnNumber();
-      const line = typeof nullableLine === "number" ? nullableLine : void 0;
-      const column = typeof nullableColumn === "number" ? nullableColumn : void 0;
-      const file = nullableFileOrUrl.startsWith("file:/") ? (0, import_node_url.fileURLToPath)(nullableFileOrUrl) : nullableFileOrUrl;
-      (0, import_paths.assertAbsolutePath)(file);
-      return { file, line, column };
+      const file2 = nullableFileOrUrl.startsWith("file:/") ? (0, import_node_url.fileURLToPath)(nullableFileOrUrl) : nullableFileOrUrl;
+      (0, import_paths.assertAbsolutePath)(file2);
+      return file2;
     };
     const record = {};
     Error.captureStackTrace(record, of);
-    const location = record.stack;
-    (0, import_assert.assert)(location, "Unable to determine build file name");
-    (0, import_assert.assert)((0, import_node_fs.statSync)(location.file).isFile(), `Build file "${location.file}" not found`);
-    return location;
+    const file = record.stack;
+    (0, import_assert.assert)(file, "Unable to determine build file name");
+    (0, import_assert.assert)((0, import_node_fs.statSync)(file).isFile(), `Build file ${(0, import_log.$p)(file)} not found`);
+    return file;
   } finally {
     Error.prepareStackTrace = oldPrepareStackTrace;
   }

package/dist/utils/caller.cjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/utils/caller.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAyB;AACzB,sBAA8B;AAC9B,oBAAuB;AACvB,mBAAiD;AAQ1C,SAAS,WAAW,IAAuC;AAChE,QAAM,uBAAuB,MAAM;AAEnC,MAAI;AACF,UAAM,oBAAoB,CAAC,GAAG,gBAAsC;AAClE,YAAM,oBAAoB,YAAY,GAAG,YAAY;AACrD,UAAI,CAAE;AAAmB;AAEzB,YAAM,eAAe,YAAY,GAAG,gBAAgB;AACpD,YAAM,iBAAiB,YAAY,GAAG,gBAAgB;AAEtD,YAAM,OAAO,OAAO,iBAAiB,WAAW,eAAe;AAC/D,YAAM,SAAS,OAAO,mBAAmB,WAAW,iBAAiB;AAErE,YAAM,OACJ,kBAAkB,WAAW,QAAQ,QACnC,+BAAc,iBAAiB,IAC/B;AAEJ,2CAAmB,IAAI;AACvB,aAAO,EAAE,MAAM,MAAM,OAAO;AAAA,IAC9B;AAEA,UAAM,SAA+B,CAAC;AACtC,UAAM,kBAAkB,QAAQ,EAAE;AAClC,UAAM,WAAW,OAAO;AAExB,8BAAO,UAAU,qCAAqC;AACtD,kCAAO,yBAAS,SAAS,IAAI,EAAE,OAAO,GAAG,eAAe,SAAS,iBAAiB;AAClF,WAAO;AAAA,EACT,UAAE;AACA,UAAM,oBAAoB;AAAA,EAC5B;AACF;",
-  "names": []
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAyB;AACzB,sBAA8B;AAC9B,oBAAuB;AACvB,iBAAmB;AACnB,mBAAiD;AAE1C,SAAS,WAAW,IAA2C;AACpE,QAAM,uBAAuB,MAAM;AAEnC,MAAI;AACF,UAAM,oBAAoB,CAAC,GAAG,gBAA0C;AACtE,YAAM,oBAAoB,YAAY,GAAG,YAAY;AACrD,UAAI,CAAE;AAAmB;AAEzB,YAAMA,QACJ,kBAAkB,WAAW,QAAQ,QACnC,+BAAc,iBAAiB,IAC/B;AAEJ,2CAAmBA,KAAI;AACvB,aAAOA;AAAA,IACT;AAEA,UAAM,SAAmC,CAAC;AAC1C,UAAM,kBAAkB,QAAQ,EAAE;AAClC,UAAM,OAAO,OAAO;AAEpB,8BAAO,MAAM,qCAAqC;AAClD,kCAAO,yBAAS,IAAI,EAAE,OAAO,GAAG,kBAAc,eAAG,IAAI,aAAa;AAClE,WAAO;AAAA,EACT,UAAE;AACA,UAAM,oBAAoB;AAAA,EAC5B;AACF;",
+  "names": ["file"]
 }

package/dist/utils/caller.d.ts

@@ -1,7 +1,2 @@
-import { AbsolutePath } from '../paths.js';
-export interface Location {
-    file: AbsolutePath;
-    line?: number | undefined;
-    column?: number | undefined;
-}
-export declare function findCaller(of: (...args: any[]) => any): Location;
+import { AbsolutePath } from '../paths';
+export declare function findCaller(of: (...args: any[]) => any): AbsolutePath;

package/dist/utils/caller.mjs

@@ -2,6 +2,7 @@
 import { statSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { assert } from "../assert.mjs";
+import { $p } from "../log.mjs";
 import { assertAbsolutePath } from "../paths.mjs";
 function findCaller(of) {
   const oldPrepareStackTrace = Error.prepareStackTrace;
@@ -10,20 +11,16 @@ function findCaller(of) {
       const nullableFileOrUrl = stackTraces[0].getFileName();
       if (!nullableFileOrUrl)
         return;
-      const nullableLine = stackTraces[0].getColumnNumber();
-      const nullableColumn = stackTraces[0].getColumnNumber();
-      const line = typeof nullableLine === "number" ? nullableLine : void 0;
-      const column = typeof nullableColumn === "number" ? nullableColumn : void 0;
-      const file = nullableFileOrUrl.startsWith("file:/") ? fileURLToPath(nullableFileOrUrl) : nullableFileOrUrl;
-      assertAbsolutePath(file);
-      return { file, line, column };
+      const file2 = nullableFileOrUrl.startsWith("file:/") ? fileURLToPath(nullableFileOrUrl) : nullableFileOrUrl;
+      assertAbsolutePath(file2);
+      return file2;
     };
     const record = {};
     Error.captureStackTrace(record, of);
-    const location = record.stack;
-    assert(location, "Unable to determine build file name");
-    assert(statSync(location.file).isFile(), `Build file "${location.file}" not found`);
-    return location;
+    const file = record.stack;
+    assert(file, "Unable to determine build file name");
+    assert(statSync(file).isFile(), `Build file ${$p(file)} not found`);
+    return file;
   } finally {
     Error.prepareStackTrace = oldPrepareStackTrace;
   }

package/dist/utils/caller.mjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/utils/caller.ts"],
-  "mappings": ";AAAA,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAC9B,SAAS,cAAc;AACvB,SAAuB,0BAA0B;AAQ1C,SAAS,WAAW,IAAuC;AAChE,QAAM,uBAAuB,MAAM;AAEnC,MAAI;AACF,UAAM,oBAAoB,CAAC,GAAG,gBAAsC;AAClE,YAAM,oBAAoB,YAAY,GAAG,YAAY;AACrD,UAAI,CAAE;AAAmB;AAEzB,YAAM,eAAe,YAAY,GAAG,gBAAgB;AACpD,YAAM,iBAAiB,YAAY,GAAG,gBAAgB;AAEtD,YAAM,OAAO,OAAO,iBAAiB,WAAW,eAAe;AAC/D,YAAM,SAAS,OAAO,mBAAmB,WAAW,iBAAiB;AAErE,YAAM,OACJ,kBAAkB,WAAW,QAAQ,IACnC,cAAc,iBAAiB,IAC/B;AAEJ,yBAAmB,IAAI;AACvB,aAAO,EAAE,MAAM,MAAM,OAAO;AAAA,IAC9B;AAEA,UAAM,SAA+B,CAAC;AACtC,UAAM,kBAAkB,QAAQ,EAAE;AAClC,UAAM,WAAW,OAAO;AAExB,WAAO,UAAU,qCAAqC;AACtD,WAAO,SAAS,SAAS,IAAI,EAAE,OAAO,GAAG,eAAe,SAAS,iBAAiB;AAClF,WAAO;AAAA,EACT,UAAE;AACA,UAAM,oBAAoB;AAAA,EAC5B;AACF;",
-  "names": []
+  "mappings": ";AAAA,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAC9B,SAAS,cAAc;AACvB,SAAS,UAAU;AACnB,SAAuB,0BAA0B;AAE1C,SAAS,WAAW,IAA2C;AACpE,QAAM,uBAAuB,MAAM;AAEnC,MAAI;AACF,UAAM,oBAAoB,CAAC,GAAG,gBAA0C;AACtE,YAAM,oBAAoB,YAAY,GAAG,YAAY;AACrD,UAAI,CAAE;AAAmB;AAEzB,YAAMA,QACJ,kBAAkB,WAAW,QAAQ,IACnC,cAAc,iBAAiB,IAC/B;AAEJ,yBAAmBA,KAAI;AACvB,aAAOA;AAAA,IACT;AAEA,UAAM,SAAmC,CAAC;AAC1C,UAAM,kBAAkB,QAAQ,EAAE;AAClC,UAAM,OAAO,OAAO;AAEpB,WAAO,MAAM,qCAAqC;AAClD,WAAO,SAAS,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,aAAa;AAClE,WAAO;AAAA,EACT,UAAE;AACA,UAAM,oBAAoB;AAAA,EAC5B;AACF;",
+  "names": ["file"]
 }

package/dist/utils/options.cjs

@@ -25,13 +25,11 @@ __export(options_exports, {
 module.exports = __toCommonJS(options_exports);
 function parseOptions(args, defaults) {
   const params = [];
-  const options = { ...defaults };
-  for (const arg of args) {
-    if (typeof arg === "string")
-      params.push(arg);
-    else
-      Object.assign(options, arg);
+  const clone = [...args];
+  while (typeof clone[0] === "string") {
+    params.push(clone.shift());
   }
+  const options = Object.assign({}, defaults, clone.pop());
   return { params, options };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/utils/options.cjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/utils/options.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAWO,SAAS,aAAgD,MAA6B,UAAyC;AACpI,QAAM,SAAmB,CAAC;AAC1B,QAAM,UAAe,EAAE,GAAG,SAAS;AAEnC,aAAW,OAAO,MAAM;AACtB,QAAI,OAAO,QAAQ;AAAU,aAAO,KAAK,GAAG;AAAA;AACvC,aAAO,OAAO,SAAS,GAAG;AAAA,EACjC;AAEA,SAAO,EAAE,QAAQ,QAAQ;AAC3B;",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAmCO,SAAS,aAId,MAAY,UAA4D;AACxE,QAAM,SAAmB,CAAC;AAC1B,QAAM,QAAe,CAAE,GAAG,IAAK;AAG/B,SAAO,OAAO,MAAM,OAAO,UAAU;AACnC,WAAO,KAAK,MAAM,MAAM,CAAC;AAAA,EAC3B;AAGA,QAAM,UAAU,OAAO,OAAO,CAAC,GAAG,UAAU,MAAM,IAAI,CAAC;AAGvD,SAAO,EAAE,QAAQ,QAAQ;AAC3B;",
   "names": []
 }

package/dist/utils/options.d.ts

@@ -1,15 +1,16 @@
-export declare type ParsedOptions<Options> = {
-    params: string[];
-    options: Options;
-};
-export declare type ParsedOptionalOptions<Options> = {
-    params: string[];
-    options?: Options | undefined;
-};
-export declare type ParseOptions<Options> = string[] | [...string[], Options] | [Options];
-/** Parse an array of at least one string, followed by an optional `Options` argument. */
-export declare function parseOptions<Options>(args: ParseOptions<Options>): ParsedOptionalOptions<Options>;
-/** Parse an array of at least one string, followed by an optional `Options` argument. */
-export declare function parseOptions<Options>(args: ParseOptions<Options>, defaults?: undefined): ParsedOptionalOptions<Options>;
-/** Parse an array of at least one string, followed by an optional `Options` argument, ensuring some defaults are present. */
-export declare function parseOptions<Options, Defaults extends Options>(args: ParseOptions<Options>, defaults: Defaults): ParsedOptions<Options & Defaults>;
+/** A type extacting string parameters from an arguments array */
+export declare type ParsedParams<Args extends readonly any[]> = Args extends readonly [infer First, ...infer Rest] ? First extends string ? [First, ...ParsedParams<Rest>] : [] : Args extends readonly [...infer First, infer Rest] ? Rest extends string ? [...ParsedParams<First>, Rest] : [...ParsedParams<First>] : Args extends readonly string[] ? [...Args] : [];
+/** A type extacting the (last) options type from an arguments array */
+export declare type ParsedOptions<Args extends readonly any[]> = Args extends readonly [...string[], infer Last] ? Last extends object ? Last : never : never;
+/** Parserable arguments: a number of strings, followed by optional options */
+export declare type ParseOptions<Options extends Record<any, any>> = readonly [...params: string[]] | readonly [...params: string[], options: Options];
+/** The return type from {@link ParseOptions} */
+export interface ParsedResult<Args extends readonly any[], Options, Defaults> {
+    params: ParsedParams<Args>;
+    options: Defaults extends null | undefined ? Options | undefined : Options & Defaults;
+}
+/**
+ * Parse an array of arguments (a number of strings optionally followed by an
+ * options object into parameters and options.
+ */
+export declare function parseOptions<Args extends ParseOptions<any>, Options extends ParsedOptions<Args> = ParsedOptions<Args>, Defaults extends ParsedOptions<Args> | null | undefined = undefined>(args: Args, defaults?: Defaults): ParsedResult<Args, Options, Defaults>;

package/dist/utils/options.mjs

@@ -1,13 +1,11 @@
 // utils/options.ts
 function parseOptions(args, defaults) {
   const params = [];
-  const options = { ...defaults };
-  for (const arg of args) {
-    if (typeof arg === "string")
-      params.push(arg);
-    else
-      Object.assign(options, arg);
+  const clone = [...args];
+  while (typeof clone[0] === "string") {
+    params.push(clone.shift());
   }
+  const options = Object.assign({}, defaults, clone.pop());
   return { params, options };
 }
 export {

package/dist/utils/options.mjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/utils/options.ts"],
-  "mappings": ";AAWO,SAAS,aAAgD,MAA6B,UAAyC;AACpI,QAAM,SAAmB,CAAC;AAC1B,QAAM,UAAe,EAAE,GAAG,SAAS;AAEnC,aAAW,OAAO,MAAM;AACtB,QAAI,OAAO,QAAQ;AAAU,aAAO,KAAK,GAAG;AAAA;AACvC,aAAO,OAAO,SAAS,GAAG;AAAA,EACjC;AAEA,SAAO,EAAE,QAAQ,QAAQ;AAC3B;",
+  "mappings": ";AAmCO,SAAS,aAId,MAAY,UAA4D;AACxE,QAAM,SAAmB,CAAC;AAC1B,QAAM,QAAe,CAAE,GAAG,IAAK;AAG/B,SAAO,OAAO,MAAM,OAAO,UAAU;AACnC,WAAO,KAAK,MAAM,MAAM,CAAC;AAAA,EAC3B;AAGA,QAAM,UAAU,OAAO,OAAO,CAAC,GAAG,UAAU,MAAM,IAAI,CAAC;AAGvD,SAAO,EAAE,QAAQ,QAAQ;AAC3B;",
   "names": []
 }

package/dist/utils/walk.d.ts

@@ -1,5 +1,5 @@
-import { AbsolutePath } from '../paths.js';
-import { MatchOptions } from './match.js';
+import { AbsolutePath } from '../paths';
+import { MatchOptions } from './match';
 /** Specific options for walking a directory */
 export interface WalkOptions extends MatchOptions {
     /**