@vltpkg/cli-sdk 0.0.0-19 → 0.0.0-20

package/dist/esm/commands/ci.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../../../src/commands/ci.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,eAAO,MAAM,KAAK,EAAE,YAWhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;;CAGe,CAAA;AAEjC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,KAAK,CASpC,CAAA"}
+{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../../../src/commands/ci.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,eAAO,MAAM,KAAK,EAAE,YAWhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;;CAGe,CAAA;AAEjC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,KAAK,CAUpC,CAAA"}

package/dist/esm/commands/ci.js

@@ -20,6 +20,7 @@ export const command = async (conf) => {
     const ciOptions = {
         ...conf.options,
         expectLockfile: true,
+        frozenLockfile: true,
         cleanInstall: true,
     };
     const { graph } = await install(ciOptions);

package/dist/esm/commands/ci.js.map

@@ -1 +1 @@
-{"version":3,"file":"ci.js","sourceRoot":"","sources":["../../../src/commands/ci.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,EAAE;IACT,WAAW,EAAE;;;kEAGiD;IAC9D,QAAQ,EAAE;QACR,EAAE,EAAE,EAAE,WAAW,EAAE,6BAA6B,EAAE;KACnD;CACF,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,eAAe;CACS,CAAA;AAEjC,MAAM,CAAC,MAAM,OAAO,GAAqB,KAAK,EAAC,IAAI,EAAC,EAAE;IACpD,MAAM,SAAS,GAAG;QAChB,GAAG,IAAI,CAAC,OAAO;QACf,cAAc,EAAE,IAAI;QACpB,YAAY,EAAE,IAAI;KACnB,CAAA;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAA;IAC1C,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import type { Graph } from '@vltpkg/graph'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { install } from '@vltpkg/graph'\nimport type { Views } from '../view.ts'\nimport { InstallReporter } from './install/reporter.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'ci',\n    usage: '',\n    description: `Clean install from lockfile. Deletes node_modules and installs \n                  dependencies exactly as specified in vlt-lock.json. This is \n                  similar to running 'vlt install --expect-lockfile' but performs \n                  a clean install by removing node_modules first.`,\n    examples: {\n      '': { description: 'Clean install from lockfile' },\n    },\n  })\n\nexport const views = {\n  json: g => g.toJSON(),\n  human: InstallReporter,\n} as const satisfies Views<Graph>\n\nexport const command: CommandFn<Graph> = async conf => {\n  const ciOptions = {\n    ...conf.options,\n    expectLockfile: true,\n    cleanInstall: true,\n  }\n\n  const { graph } = await install(ciOptions)\n  return graph\n}\n"]}
+{"version":3,"file":"ci.js","sourceRoot":"","sources":["../../../src/commands/ci.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,EAAE;IACT,WAAW,EAAE;;;kEAGiD;IAC9D,QAAQ,EAAE;QACR,EAAE,EAAE,EAAE,WAAW,EAAE,6BAA6B,EAAE;KACnD;CACF,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,eAAe;CACS,CAAA;AAEjC,MAAM,CAAC,MAAM,OAAO,GAAqB,KAAK,EAAC,IAAI,EAAC,EAAE;IACpD,MAAM,SAAS,GAAG;QAChB,GAAG,IAAI,CAAC,OAAO;QACf,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,IAAI;QACpB,YAAY,EAAE,IAAI;KACnB,CAAA;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAA;IAC1C,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import type { Graph } from '@vltpkg/graph'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { install } from '@vltpkg/graph'\nimport type { Views } from '../view.ts'\nimport { InstallReporter } from './install/reporter.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'ci',\n    usage: '',\n    description: `Clean install from lockfile. Deletes node_modules and installs \n                  dependencies exactly as specified in vlt-lock.json. This is \n                  similar to running 'vlt install --expect-lockfile' but performs \n                  a clean install by removing node_modules first.`,\n    examples: {\n      '': { description: 'Clean install from lockfile' },\n    },\n  })\n\nexport const views = {\n  json: g => g.toJSON(),\n  human: InstallReporter,\n} as const satisfies Views<Graph>\n\nexport const command: CommandFn<Graph> = async conf => {\n  const ciOptions = {\n    ...conf.options,\n    expectLockfile: true,\n    frozenLockfile: true,\n    cleanInstall: true,\n  }\n\n  const { graph } = await install(ciOptions)\n  return graph\n}\n"]}

package/dist/esm/commands/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/run.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EAGX,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,eAAO,MAAM,KAAK,EAAE,YAQhB,CAAA;AA8BJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CACR,CAAA"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EAGX,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,eAAO,MAAM,KAAK,EAAE,YAQhB,CAAA;AA2BJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CACR,CAAA"}

package/dist/esm/commands/run.js

@@ -19,18 +19,17 @@ class RunCommand extends ExecCommand {
     defaultArg0() { }
     noArgsSingle() {
         // called when there's no arg0, with a single workspace or root
-        const ws = this.monorepo?.values().next().value;
-        const cwd = ws?.fullpath ?? this.projectRoot;
+        const cwd = this.getCwd();
         const { scripts = {} } = this.conf.options.packageJson.read(cwd);
         return scripts;
     }
     noArgsMulti() {
-        const scriptSet = {};
-        for (const [ws, scripts] of this.monorepo.runSync(({ manifest: { scripts } }) => scripts)) {
-            if (scripts)
-                scriptSet[ws.path] = scripts;
+        const scripts = {};
+        for (const { label, manifest } of this.getTargets()) {
+            if (manifest.scripts)
+                scripts[label] = manifest.scripts;
         }
-        return scriptSet;
+        return scripts;
     }
 }
 export const command = async (conf) => await new RunCommand(conf).run();

package/dist/esm/commands/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAMjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGhD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE;;;sCAGqB;CACnC,CAAC,CAAA;AAEJ,MAAM,UAAW,SAAQ,WAAqC;IAC5D,YAAY,IAAkB;QAC5B,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;IACzB,CAAC;IAED,4DAA4D;IAC5D,wDAAwD;IACxD,WAAW,KAAe,CAAC;IAE3B,YAAY;QACV,+DAA+D;QAC/D,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;QAC/C,MAAM,GAAG,GAAG,EAAE,EAAE,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAA;QAC5C,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,WAAW;QACT,MAAM,SAAS,GAAmB,EAAE,CAAA;QACpC,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAC/C,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,CACvC,EAAE,CAAC;YACF,IAAI,OAAO;gBAAE,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,OAAO,CAAA;QAC3C,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE,CACzD,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA","sourcesContent":["import { run, runFG } from '@vltpkg/run'\nimport type { Monorepo } from '@vltpkg/workspaces'\nimport type { LoadedConfig } from '../config/index.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type {\n  ExecResult,\n  MultiScriptSet,\n  ScriptSet,\n} from '../exec-command.ts'\nimport { ExecCommand } from '../exec-command.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\n\nexport { views } from '../exec-command.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'run',\n    usage: '<script> [args ...]',\n    description: `Run a script defined in 'package.json', passing along any extra\n                  arguments. Note that vlt config values must be specified *before*\n                  the script name, because everything after that is handed off to\n                  the script process.`,\n  })\n\nclass RunCommand extends ExecCommand<typeof run, typeof runFG> {\n  constructor(conf: LoadedConfig) {\n    super(conf, run, runFG)\n  }\n\n  // do not provide the interactive shell arg, just do nothing\n  // so that it falls back up to the noArgsSingle() method\n  defaultArg0(): undefined {}\n\n  noArgsSingle(): ScriptSet {\n    // called when there's no arg0, with a single workspace or root\n    const ws = this.monorepo?.values().next().value\n    const cwd = ws?.fullpath ?? this.projectRoot\n    const { scripts = {} } = this.conf.options.packageJson.read(cwd)\n    return scripts\n  }\n\n  noArgsMulti(this: this & { monorepo: Monorepo }): MultiScriptSet {\n    const scriptSet: MultiScriptSet = {}\n    for (const [ws, scripts] of this.monorepo.runSync(\n      ({ manifest: { scripts } }) => scripts,\n    )) {\n      if (scripts) scriptSet[ws.path] = scripts\n    }\n    return scriptSet\n  }\n}\n\nexport const command: CommandFn<ExecResult> = async conf =>\n  await new RunCommand(conf).run()\n"]}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAMjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGhD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE;;;sCAGqB;CACnC,CAAC,CAAA;AAEJ,MAAM,UAAW,SAAQ,WAAqC;IAC5D,YAAY,IAAkB;QAC5B,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;IACzB,CAAC;IAED,4DAA4D;IAC5D,wDAAwD;IACxD,WAAW,KAAe,CAAC;IAE3B,YAAY;QACV,+DAA+D;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;QACzB,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,WAAW;QACT,MAAM,OAAO,GAAmB,EAAE,CAAA;QAClC,KAAK,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YACpD,IAAI,QAAQ,CAAC,OAAO;gBAAE,OAAO,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAA;QACzD,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE,CACzD,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA","sourcesContent":["import { run, runFG } from '@vltpkg/run'\nimport type { LoadedConfig } from '../config/index.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type {\n  ExecResult,\n  MultiScriptSet,\n  ScriptSet,\n} from '../exec-command.ts'\nimport { ExecCommand } from '../exec-command.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\n\nexport { views } from '../exec-command.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'run',\n    usage: '<script> [args ...]',\n    description: `Run a script defined in 'package.json', passing along any extra\n                  arguments. Note that vlt config values must be specified *before*\n                  the script name, because everything after that is handed off to\n                  the script process.`,\n  })\n\nclass RunCommand extends ExecCommand<typeof run, typeof runFG> {\n  constructor(conf: LoadedConfig) {\n    super(conf, run, runFG)\n  }\n\n  // do not provide the interactive shell arg, just do nothing\n  // so that it falls back up to the noArgsSingle() method\n  defaultArg0(): undefined {}\n\n  noArgsSingle(): ScriptSet {\n    // called when there's no arg0, with a single workspace or root\n    const cwd = this.getCwd()\n    const { scripts = {} } = this.conf.options.packageJson.read(cwd)\n    return scripts\n  }\n\n  noArgsMulti(): MultiScriptSet {\n    const scripts: MultiScriptSet = {}\n    for (const { label, manifest } of this.getTargets()) {\n      if (manifest.scripts) scripts[label] = manifest.scripts\n    }\n    return scripts\n  }\n}\n\nexport const command: CommandFn<ExecResult> = async conf =>\n  await new RunCommand(conf).run()\n"]}

package/dist/esm/commands/update.d.ts

@@ -0,0 +1,10 @@
+import type { Graph } from '@vltpkg/graph';
+import type { CommandFn, CommandUsage } from '../index.ts';
+import { InstallReporter } from './install/reporter.ts';
+export declare const usage: CommandUsage;
+export declare const views: {
+    readonly json: (g: Graph) => import("@vltpkg/graph").LockfileData;
+    readonly human: typeof InstallReporter;
+};
+export declare const command: CommandFn<Graph>;
+//# sourceMappingURL=update.d.ts.map

package/dist/esm/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGvD,eAAO,MAAM,KAAK,EAAE,YAMhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;;CAGe,CAAA;AAEjC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,KAAK,CAUpC,CAAA"}

package/dist/esm/commands/update.js

@@ -0,0 +1,25 @@
+import { update } from '@vltpkg/graph';
+import { error } from '@vltpkg/error-cause';
+import { commandUsage } from "../config/usage.js";
+import { InstallReporter } from "./install/reporter.js";
+export const usage = () => commandUsage({
+    command: 'update',
+    usage: '',
+    description: `Update dependencies to their latest in-range versions.
+                  Discards the lockfile and resolves dependencies from scratch.`,
+});
+export const views = {
+    json: g => g.toJSON(),
+    human: InstallReporter,
+};
+export const command = async (conf) => {
+    // Throw error if any arguments are provided
+    if (conf.positionals.length > 0) {
+        throw error('Arguments are not yet supported for vlt update', {
+            code: 'EUSAGE',
+        });
+    }
+    const { graph } = await update(conf.options);
+    return graph;
+};
+//# sourceMappingURL=update.js.map

package/dist/esm/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,EAAE;IACT,WAAW,EAAE;gFAC+D;CAC7E,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,eAAe;CACS,CAAA;AAEjC,MAAM,CAAC,MAAM,OAAO,GAAqB,KAAK,EAAC,IAAI,EAAC,EAAE;IACpD,4CAA4C;IAC5C,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,KAAK,CAAC,gDAAgD,EAAE;YAC5D,IAAI,EAAE,QAAQ;SACf,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC5C,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import { update } from '@vltpkg/graph'\nimport { error } from '@vltpkg/error-cause'\nimport type { Graph } from '@vltpkg/graph'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { InstallReporter } from './install/reporter.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'update',\n    usage: '',\n    description: `Update dependencies to their latest in-range versions.\n                  Discards the lockfile and resolves dependencies from scratch.`,\n  })\n\nexport const views = {\n  json: g => g.toJSON(),\n  human: InstallReporter,\n} as const satisfies Views<Graph>\n\nexport const command: CommandFn<Graph> = async conf => {\n  // Throw error if any arguments are provided\n  if (conf.positionals.length > 0) {\n    throw error('Arguments are not yet supported for vlt update', {\n      code: 'EUSAGE',\n    })\n  }\n\n  const { graph } = await update(conf.options)\n  return graph\n}\n"]}

package/dist/esm/config/definition.d.ts

@@ -38,6 +38,7 @@ export declare const commands: {
     readonly run: "run";
     readonly token: "token";
     readonly uninstall: "uninstall";
+    readonly update: "update";
     readonly 'exec-cache': "exec-cache";
     readonly version: "version";
     readonly whoami: "whoami";

package/dist/esm/config/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/config/definition.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAA0C,CAAA;AAElE,eAAO,MAAM,aAAa,cAKjB,CAAA;AA8CT;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGX,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,cAAc,uBAW1B,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAA;AAEtC,eAAO,MAAM,UAAU,OACjB,MAAM,KACT,QAAQ,CAAC,MAAM,QAAQ,CAAC,GAAG,SACkC,CAAA;AAKhE;;GAEG;AACH,eAAO,MAAM,YAAY,iGAMf,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvD,eAAO,MAAM,aAAa,MAAO,MAAM,KAAG,CAAC,IAAI,WACN,CAAA;AAwCzC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA2OH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA8MP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DvB,CAAA;AAEJ,eAAO,MAAM,mBAAmB,gBAS/B,CAAA;AAED,eAAO,MAAM,aAAa,gBAC2C,CAAA"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/config/definition.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAOd,CAAA;AAEV,eAAO,MAAM,aAAa,cAKjB,CAAA;AA+CT;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGX,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,cAAc,uBAW1B,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAA;AAEtC,eAAO,MAAM,UAAU,OACjB,MAAM,KACT,QAAQ,CAAC,MAAM,QAAQ,CAAC,GAAG,SACkC,CAAA;AAKhE;;GAEG;AACH,eAAO,MAAM,YAAY,iGAMf,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvD,eAAO,MAAM,aAAa,MAAO,MAAM,KAAG,CAAC,IAAI,WACN,CAAA;AAwCzC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA2OH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA8MP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DvB,CAAA;AAEJ,eAAO,MAAM,mBAAmB,gBAS/B,CAAA;AAED,eAAO,MAAM,aAAa,gBAC2C,CAAA"}

package/dist/esm/config/definition.js

@@ -1,7 +1,14 @@
 import { error } from '@vltpkg/error-cause';
 import { XDG } from '@vltpkg/xdg';
 import { jack } from 'jackspeak';
-export const defaultView = process.stdout.isTTY ? 'human' : 'json';
+export const defaultView = 
+// If stdout is a TTY, use human output
+process.stdout.isTTY ? 'human'
+    // If its not a TTY but is a CI environment, use human output
+    // TODO: make a better view option for CI environments
+    : process.env.CI ? 'human'
+        // Otherwise, use json output
+        : 'json';
 export const defaultEditor = () => process.env.EDITOR ||
     process.env.VISUAL ||
     (process.platform === 'win32' ?
@@ -29,6 +36,7 @@ const canonicalCommands = {
     run: 'run',
     token: 'token',
     uninstall: 'uninstall',
+    update: 'update',
     'exec-cache': 'exec-cache',
     version: 'version',
     whoami: 'whoami',

package/dist/esm/config/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/config/definition.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { XDG } from '@vltpkg/xdg'\nimport { jack } from 'jackspeak'\n\nexport const defaultView = process.stdout.isTTY ? 'human' : 'json'\n\nexport const defaultEditor = () =>\n  process.env.EDITOR ||\n  process.env.VISUAL ||\n  (process.platform === 'win32' ?\n    `${process.env.SYSTEMROOT}\\\\notepad.exe`\n  : 'vi')\n\nconst canonicalCommands = {\n  cache: 'cache',\n  ci: 'ci',\n  config: 'config',\n  exec: 'exec',\n  'exec-local': 'exec-local',\n  gui: 'gui',\n  help: 'help',\n  init: 'init',\n  install: 'install',\n  login: 'login',\n  logout: 'logout',\n  list: 'list',\n  ls: 'ls',\n  pack: 'pack',\n  pkg: 'pkg',\n  publish: 'publish',\n  query: 'query',\n  'run-exec': 'run-exec',\n  run: 'run',\n  token: 'token',\n  uninstall: 'uninstall',\n  'exec-cache': 'exec-cache',\n  version: 'version',\n  whoami: 'whoami',\n} as const\n\nconst aliases = {\n  i: 'install',\n  add: 'install',\n  rm: 'uninstall',\n  u: 'uninstall',\n  r: 'run',\n  'run-script': 'run',\n  rx: 'run-exec',\n  x: 'exec',\n  xl: 'exec-local',\n  h: 'help',\n  '?': 'help',\n  conf: 'config',\n  ls: 'list',\n  xc: 'exec-cache',\n} as const\n\n/**\n * Command aliases mapped to their canonical names\n */\nexport const commands = {\n  ...canonicalCommands,\n  ...aliases,\n} as const\n\n/**\n * Canonical command names mapped to an array of its aliases\n */\nexport const commandAliases = Object.entries(aliases).reduce(\n  (acc, [alias, canonical]) => {\n    const commandAliases = acc.get(canonical)\n    if (commandAliases) {\n      commandAliases.push(alias)\n    } else {\n      acc.set(canonical, [alias])\n    }\n    return acc\n  },\n  new Map<string, string[]>(),\n)\n\nexport type Commands = typeof commands\n\nexport const getCommand = (\n  s?: string,\n): Commands[keyof Commands] | undefined =>\n  s && s in commands ? commands[s as keyof Commands] : undefined\n\nconst xdg = new XDG('vlt')\nconst cacheDir = xdg.cache()\n\n/**\n * Fields that are parsed as a set of key=value pairs\n */\nexport const recordFields = [\n  'git-hosts',\n  'registries',\n  'git-host-archives',\n  'scope-registries',\n  'jsr-registries',\n] as const\n\nexport type RecordField = (typeof recordFields)[number]\n\nexport const isRecordField = (s: string): s is RecordField =>\n  recordFields.includes(s as RecordField)\n\nconst stopParsingCommands: Commands[keyof Commands][] = [\n  'run',\n  'run-exec',\n  'exec-local',\n  'exec',\n]\n\nlet stopParsing: boolean | undefined = undefined\n\nconst j = jack({\n  envPrefix: 'VLT',\n  allowPositionals: true,\n  usage: `vlt [<options>] [<cmd> [<args> ...]]`,\n  stopAtPositionalTest: arg => {\n    if (stopParsing) return true\n    const a = arg as keyof Commands\n    // we stop parsing AFTER the thing, so you can do\n    // vlt run --vlt --configs scriptName --args --for --script\n    // or\n    // vlt exec --vlt --configs command --args --for --command\n    if (stopParsingCommands.includes(commands[a])) {\n      stopParsing = true\n    }\n    return false\n  },\n})\n  .heading('vlt')\n  .description(\n    `More documentation available at <https://docs.vlt.sh>`,\n  )\n  .heading('Subcommands')\n\nj.description(Object.keys(canonicalCommands).join(', '), {\n  pre: true,\n}).description(\n  'Run `vlt <cmd> --help` for more information about a specific command',\n)\n\nexport const definition = j\n  /**\n   * Definition of all configuration values used by vlt.\n   */\n  .heading('Configuration')\n  .description(\n    `If a \\`vlt.json\\` file is present in the root of the current project,\n     then that will be used as a source of configuration information.\n\n     Next, the \\`vlt.json\\` file in the XDG specified config directory\n     will be checked, and loaded for any fields not set in the local project.\n\n     Object type values will be merged together. Set a field to \\`null\\` in\n     the JSON configuration to explicitly remove it.\n\n     Command-specific fields may be set in a nested \\`command\\` object that\n     overrides any options defined at the top level.\n    `,\n  )\n\n  .flag({\n    color: {\n      short: 'c',\n      description: 'Use colors (Default for TTY)',\n    },\n    'no-color': {\n      short: 'C',\n      description: 'Do not use colors (Default for non-TTY)',\n    },\n  })\n\n  .opt({\n    registry: {\n      hint: 'url',\n      default: 'https://registry.npmjs.org/',\n      description: `Sets the registry for fetching packages, when no registry\n                    is explicitly set on a specifier.\n\n                    For example, \\`express@latest\\` will be resolved by looking\n                    up the metadata from this registry.\n\n                    Note that alias specifiers starting with \\`npm:\\` will\n                    still map to \\`https://registry.npmjs.org/\\` if this is\n                    changed, unless the a new mapping is created via the\n                    \\`--registries\\` option.\n      `,\n    },\n  })\n\n  .optList({\n    registries: {\n      hint: 'name=url',\n      description: `Specify named registry hosts by their prefix. To set the\n                    default registry used for non-namespaced specifiers,\n                    use the \\`--registry\\` option.\n\n                    Prefixes can be used as a package alias. For example:\n\n                    \\`\\`\\`\n                    vlt --registries loc=http://reg.local install foo@loc:foo@1.x\n                    \\`\\`\\`\n\n                    By default, the public npm registry is registered to the\n                    \\`npm:\\` prefix. It is not recommended to change this\n                    mapping in most cases.\n                    `,\n    },\n\n    'scope-registries': {\n      hint: '@scope=url',\n      description: `Map package name scopes to registry URLs.\n\n                    For example,\n                    \\`--scope-registries @acme=https://registry.acme/\\`\n                    would tell vlt to fetch any packages named\n                    \\`@acme/...\\` from the \\`https://registry.acme/\\`\n                    registry.\n\n                    Note: this way of specifying registries is more ambiguous,\n                    compared with using the \\`--registries\\` field and explicit\n                    prefixes, because instead of failing when the configuration\n                    is absent, it will instead attempt to fetch from the\n                    default registry.\n\n                    By comparison, using\n                    \\`--registries acme=https://registry.acme/\\` and then\n                    specifying dependencies such as \\`\"foo\": \"acme:foo@1.x\"\\`\n                    means that regardless of the name, the package will be\n                    fetched from the explicitly named registry, or fail if\n                    no registry is defined with that name.\n\n                    However, custom registry aliases are not supported by other\n                    package managers.`,\n    },\n\n    'jsr-registries': {\n      hint: 'name=url',\n      description: `Map alias names to JSR.io registry urls.\n\n                    For example,\n                    \\`--jsr-registries acme=https://jsr.acme.io/\\` would\n                    tell vlt to fetch any packages with the \\`acme:\\` registry\n                    prefix from the \\`https://jsr.acme.io/\\` registry, using\n                    the \"npm Compatibility\" translation. So for example,\n                    the package \\`acme:@foo/bar\\` would fetch the\n                    \\`@jsr/foo__bar\\` package from the \\`jsr.acme.io\\`\n                    registry.\n\n                    By default the \\`jsr\\` alias is always mapped to\n                    \\`https://npm.jsr.io/\\`, so existing \\`jsr:\\` packages will\n                    be fetched from the public \\`jsr\\` registry appropriately.\n                   `,\n    },\n\n    'git-hosts': {\n      hint: `name=template`,\n      short: 'G',\n      description: `Map a shorthand name to a git remote URL template.\n\n                    The \\`template\\` may contain placeholders, which will be\n                    swapped with the relevant values.\n\n                    \\`$1\\`, \\`$2\\`, etc. are replaced with the appropriate\n                    n-th path portion. For example, \\`github:user/project\\`\n                    would replace the \\`$1\\` in the template with \\`user\\`,\n                    and \\`$2\\` with \\`project\\`.`,\n    },\n\n    'git-host-archives': {\n      hint: `name=template`,\n      short: 'A',\n      description: `Similar to the \\`--git-host <name>=<template>\\` option,\n                    this option can define a template string that will be\n                    expanded to provide the URL to download a pre-built\n                    tarball of the git repository.\n\n                    In addition to the n-th path portion expansions performed\n                    by \\`--git-host\\`, this field will also expand the\n                    string \\`$committish\\` in the template, replacing it with\n                    the resolved git committish value to be fetched.`,\n    },\n  })\n\n  .opt({\n    cache: {\n      hint: 'path',\n      description: `\n        Location of the vlt on-disk cache. Defaults to the platform-specific\n        directory recommended by the XDG specification.\n      `,\n      default: cacheDir,\n    },\n    tag: {\n      description: `Default \\`dist-tag\\` to install or publish`,\n      default: 'latest',\n    },\n    before: {\n      hint: 'date',\n      description: `Do not install any packages published after this date`,\n    },\n    os: {\n      description: `The operating system to use as the selector when choosing\n                    packages based on their \\`os\\` value.`,\n      default: process.platform,\n    },\n    arch: {\n      description: `CPU architecture to use as the selector when choosing\n                    packages based on their \\`cpu\\` value.`,\n      default: process.arch,\n    },\n    'node-version': {\n      hint: 'version',\n      description: `Node version to use when choosing packages based on\n                    their \\`engines.node\\` value.`,\n      default: process.version,\n    },\n  })\n\n  .flag({\n    'git-shallow': {\n      description: `Set to force \\`--depth=1\\` on all git clone actions.\n                    When set explicitly to false with --no-git-shallow,\n                    then \\`--depth=1\\` will not be used.\n\n                    When not set explicitly, \\`--depth=1\\` will be used for\n                    git hosts known to support this behavior.`,\n    },\n  })\n  .num({\n    'fetch-retries': {\n      hint: 'n',\n      description: `Number of retries to perform when encountering network\n                    errors or likely-transient errors from git hosts.`,\n      default: 3,\n    },\n    'fetch-retry-factor': {\n      hint: 'n',\n      description: `The exponential backoff factor to use when retrying\n                    requests due to network issues.`,\n      default: 2,\n    },\n    'fetch-retry-mintimeout': {\n      hint: 'n',\n      description: `Number of milliseconds before starting first retry`,\n      default: 0,\n    },\n    'fetch-retry-maxtimeout': {\n      hint: 'n',\n      description: `Maximum number of milliseconds between two retries`,\n      default: 30_000,\n    },\n    'stale-while-revalidate-factor': {\n      hint: 'n',\n      default: 60,\n      description: `If the server does not serve a \\`stale-while-revalidate\\`\n                    value in the \\`cache-control\\` header, then this multiplier\n                    is applied to the \\`max-age\\` or \\`s-maxage\\` values.\n\n                    By default, this is \\`60\\`, so for example a response that\n                    is cacheable for 5 minutes will allow a stale response\n                    while revalidating for up to 5 hours.\n\n                    If the server *does* provide a \\`stale-while-revalidate\\`\n                    value, then that is always used.\n\n                    Set to 0 to prevent any \\`stale-while-revalidate\\` behavior\n                    unless explicitly allowed by the server's \\`cache-control\\`\n                    header.\n      `,\n    },\n  })\n\n  .opt({\n    identity: {\n      short: 'i',\n      validate: (v: unknown) =>\n        typeof v === 'string' && /^[a-z0-9]*$/.test(v),\n      hint: 'name',\n      default: '',\n      description: `Provide a string to define an identity for storing auth\n                    information when logging into registries.\n\n                    Authentication tokens will be stored in the XDG data\n                    directory, in \\`vlt/auth/$\\{identity}/keychain.json\\`.\n\n                    If no identity is provided, then the default \\`''\\` will\n                    be used, storing the file at \\`vlt/auth/keychain.json\\`.\n\n                    May only contain lowercase alphanumeric characters.\n                    `,\n    },\n  })\n\n  .optList({\n    workspace: {\n      hint: 'ws',\n      short: 'w',\n      description: `Set to limit the spaces being worked on when working on\n                    workspaces.\n\n                    Can be paths or glob patterns matching paths.\n\n                    Specifying workspaces by package.json name is not\n                    supported.`,\n    },\n    'workspace-group': {\n      short: 'g',\n      description: `Specify named workspace group names to load and operate on\n                    when doing recursive operations on workspaces.`,\n    },\n  })\n\n  .opt({\n    scope: {\n      short: 's',\n      description:\n        'Set to filter the scope of an operation using a DSS Query.',\n    },\n    target: {\n      short: 't',\n      description:\n        'Set to select packages using a DSS Query selector.',\n    },\n  })\n\n  .flag({\n    recursive: {\n      short: 'r',\n      description: `Run an operation across multiple workspaces.\n\n                    No effect when used in non-monorepo projects.\n\n                    Implied by setting --workspace or --workspace-group. If\n                    not set, then the action is run on the project root.`,\n    },\n\n    bail: {\n      short: 'b',\n      description: `When running scripts across multiple workspaces, stop\n                    on the first failure.`,\n      default: true,\n    },\n\n    'no-bail': {\n      short: 'B',\n      description: `When running scripts across multiple workspaces, continue\n                    on failure, running the script for all workspaces.`,\n    },\n  })\n\n  .opt({\n    config: {\n      hint: 'user | project',\n      description: `Specify whether to operate on user-level or project-level\n                    configuration files when running \\`vlt config\\` commands.`,\n      validOptions: ['user', 'project'] as const,\n      default: 'project',\n    },\n\n    editor: {\n      hint: 'program',\n      description: `The blocking editor to use for \\`vlt config edit\\` and\n                    any other cases where a file should be opened for\n                    editing.\n\n                    Defaults to the \\`EDITOR\\` or \\`VISUAL\\` env if set, or\n                    \\`notepad.exe\\` on Windows, or \\`vi\\` elsewhere.`,\n      default: defaultEditor(),\n    },\n\n    'script-shell': {\n      hint: 'program',\n      description: `The shell to use when executing \\`package.json#scripts\\`.\n\n                    For \\`vlt exec\\` and \\`vlt exec-local\\`, this is never set,\n                    meaning that command arguments are run exactly as provided.\n\n                    For \\`vlt run\\` (and other things that run lifecycle\n                    scripts in \\`package.json#scripts\\`), the entire command\n                    with all arguments is provided as a single string, meaning\n                    that some value must be provided for shell interpretation,\n                    and so for these contexts, the \\`script-shell\\` value will\n                    default to \\`/bin/sh\\` on POSIX systems or \\`cmd.exe\\` on\n                    Windows.\n      `,\n    },\n\n    'fallback-command': {\n      hint: 'command',\n      description: `The command to run when the first argument doesn't\n                    match any known commands.\n\n                    For pnpm-style behavior, set this to 'run-exec'. e.g:\n                    \\`\\`\\`\n                    vlt config set fallback-command=run-exec\n                    \\`\\`\\``,\n      default: 'help',\n      validOptions: Object.keys(canonicalCommands),\n    },\n  })\n\n  .opt({\n    package: {\n      hint: 'p',\n      description: `When running \\`vlt exec\\`, this allows you to explicitly\n                    set the package to search for bins. If not provided, then\n                    vlt will interpret the first argument as the package, and\n                    attempt to run the default executable.`,\n    },\n  })\n\n  .opt({\n    view: {\n      hint: 'output',\n      default: defaultView,\n      description: `Configures the output format for commands.\n\n                    Defaults to \\`human\\` if stdout is a TTY, or \\`json\\`\n                    if it is not.\n\n                    - human: Maximally ergonomic output reporting for human\n                      consumption.\n                    - json: Parseable JSON output for machines.\n                    - inspect: Output results with \\`util.inspect\\`.\n                    - gui: Start a local web server and opens a browser to\n                      explore the results. (Only relevant for certain\n                      commands.)\n                    - mermaid: Output mermaid diagramming syntax. (Only\n                      relevant for certain commands.)\n                    - silent: Suppress all output to stdout.\n\n                    If the requested view format is not supported for the\n                    current command, or if no option is provided, then it\n                    will fall back to the default.\n      `,\n      validOptions: [\n        'human',\n        'json',\n        'mermaid',\n        'gui',\n        'inspect',\n        'silent',\n      ] as const,\n    },\n  })\n\n  .optList({\n    'dashboard-root': {\n      hint: 'path',\n      description: `The root directory to use for the dashboard GUI.\n                    If not set, the user home directory is used.`,\n    },\n  })\n\n  .flag({\n    'save-dev': {\n      short: 'D',\n      description: `Save installed packages to a package.json file as\n                    devDependencies`,\n    },\n    'save-optional': {\n      short: 'O',\n      description: `Save installed packages to a package.json file as\n                    optionalDependencies`,\n    },\n    'save-peer': {\n      description: `Save installed packages to a package.json file as\n                    peerDependencies`,\n    },\n    'save-prod': {\n      short: 'P',\n      description: `Save installed packages into dependencies specifically.\n                    This is useful if a package already exists in\n                    devDependencies or optionalDependencies, but you want to\n                    move it to be a non-optional production dependency.`,\n    },\n  })\n\n  .opt({\n    'expect-results': {\n      hint: 'value',\n      validate: (v: unknown) =>\n        typeof v === 'string' && /^([<>]=?)?[0-9]+$/.test(v),\n      description: `When running \\`vlt query\\`, this option allows you to\n                    set a expected number of resulting items.\n\n                    Accepted values are numbers and strings.\n\n                    Strings starting with \\`>\\`, \\`<\\`, \\`>=\\` or \\`<=\\`\n                    followed by a number can be used to check if the result\n                    is greater than or less than a specific number.`,\n    },\n  })\n\n  .flag({\n    'dry-run': {\n      description: 'Run command without making any changes',\n    },\n    'expect-lockfile': {\n      description:\n        'Fail if lockfile is missing or out of date. Used by ci command to enforce lockfile integrity.',\n    },\n    'frozen-lockfile': {\n      description:\n        'Fail if lockfile is missing or out of sync with package.json. Prevents any lockfile modifications.',\n    },\n  })\n  .opt({\n    access: {\n      description: 'Set the access level of the package',\n      validOptions: ['public', 'restricted'] as const,\n      default: 'public',\n    },\n  })\n  .opt({\n    otp: {\n      description: `Provide an OTP to use when publishing a package.`,\n    },\n    'publish-directory': {\n      hint: 'path',\n      description: `Directory to use for pack and publish operations instead of the current directory.\n                    Similar to pnpm's publishConfig.directory feature.\n                    The directory must exist and nothing will be copied to it.`,\n    },\n  })\n\n  .flag({\n    yes: {\n      short: 'y',\n      description: `Automatically accept any confirmation prompts`,\n    },\n    version: {\n      short: 'v',\n      description: 'Print the version',\n    },\n    help: {\n      short: 'h',\n      description: 'Print helpful information',\n    },\n  })\n\nexport const getSortedCliOptions = () => {\n  const defs = definition.toJSON()\n  return getSortedKeys().map((k: keyof typeof defs) => {\n    const def = defs[k]\n    /* c8 ignore next */\n    if (!def) throw error('invalid key found', { found: k })\n    if (def.type === 'boolean') return `--${k}`\n    return `--${k}=<${def.hint ?? k}>`\n  })\n}\n\nexport const getSortedKeys = () =>\n  Object.keys(definition.toJSON()).sort((a, b) => a.localeCompare(b))\n"]}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/config/definition.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { XDG } from '@vltpkg/xdg'\nimport { jack } from 'jackspeak'\n\nexport const defaultView =\n  // If stdout is a TTY, use human output\n  process.stdout.isTTY ? 'human'\n    // If its not a TTY but is a CI environment, use human output\n    // TODO: make a better view option for CI environments\n  : process.env.CI ? 'human'\n    // Otherwise, use json output\n  : 'json'\n\nexport const defaultEditor = () =>\n  process.env.EDITOR ||\n  process.env.VISUAL ||\n  (process.platform === 'win32' ?\n    `${process.env.SYSTEMROOT}\\\\notepad.exe`\n  : 'vi')\n\nconst canonicalCommands = {\n  cache: 'cache',\n  ci: 'ci',\n  config: 'config',\n  exec: 'exec',\n  'exec-local': 'exec-local',\n  gui: 'gui',\n  help: 'help',\n  init: 'init',\n  install: 'install',\n  login: 'login',\n  logout: 'logout',\n  list: 'list',\n  ls: 'ls',\n  pack: 'pack',\n  pkg: 'pkg',\n  publish: 'publish',\n  query: 'query',\n  'run-exec': 'run-exec',\n  run: 'run',\n  token: 'token',\n  uninstall: 'uninstall',\n  update: 'update',\n  'exec-cache': 'exec-cache',\n  version: 'version',\n  whoami: 'whoami',\n} as const\n\nconst aliases = {\n  i: 'install',\n  add: 'install',\n  rm: 'uninstall',\n  u: 'uninstall',\n  r: 'run',\n  'run-script': 'run',\n  rx: 'run-exec',\n  x: 'exec',\n  xl: 'exec-local',\n  h: 'help',\n  '?': 'help',\n  conf: 'config',\n  ls: 'list',\n  xc: 'exec-cache',\n} as const\n\n/**\n * Command aliases mapped to their canonical names\n */\nexport const commands = {\n  ...canonicalCommands,\n  ...aliases,\n} as const\n\n/**\n * Canonical command names mapped to an array of its aliases\n */\nexport const commandAliases = Object.entries(aliases).reduce(\n  (acc, [alias, canonical]) => {\n    const commandAliases = acc.get(canonical)\n    if (commandAliases) {\n      commandAliases.push(alias)\n    } else {\n      acc.set(canonical, [alias])\n    }\n    return acc\n  },\n  new Map<string, string[]>(),\n)\n\nexport type Commands = typeof commands\n\nexport const getCommand = (\n  s?: string,\n): Commands[keyof Commands] | undefined =>\n  s && s in commands ? commands[s as keyof Commands] : undefined\n\nconst xdg = new XDG('vlt')\nconst cacheDir = xdg.cache()\n\n/**\n * Fields that are parsed as a set of key=value pairs\n */\nexport const recordFields = [\n  'git-hosts',\n  'registries',\n  'git-host-archives',\n  'scope-registries',\n  'jsr-registries',\n] as const\n\nexport type RecordField = (typeof recordFields)[number]\n\nexport const isRecordField = (s: string): s is RecordField =>\n  recordFields.includes(s as RecordField)\n\nconst stopParsingCommands: Commands[keyof Commands][] = [\n  'run',\n  'run-exec',\n  'exec-local',\n  'exec',\n]\n\nlet stopParsing: boolean | undefined = undefined\n\nconst j = jack({\n  envPrefix: 'VLT',\n  allowPositionals: true,\n  usage: `vlt [<options>] [<cmd> [<args> ...]]`,\n  stopAtPositionalTest: arg => {\n    if (stopParsing) return true\n    const a = arg as keyof Commands\n    // we stop parsing AFTER the thing, so you can do\n    // vlt run --vlt --configs scriptName --args --for --script\n    // or\n    // vlt exec --vlt --configs command --args --for --command\n    if (stopParsingCommands.includes(commands[a])) {\n      stopParsing = true\n    }\n    return false\n  },\n})\n  .heading('vlt')\n  .description(\n    `More documentation available at <https://docs.vlt.sh>`,\n  )\n  .heading('Subcommands')\n\nj.description(Object.keys(canonicalCommands).join(', '), {\n  pre: true,\n}).description(\n  'Run `vlt <cmd> --help` for more information about a specific command',\n)\n\nexport const definition = j\n  /**\n   * Definition of all configuration values used by vlt.\n   */\n  .heading('Configuration')\n  .description(\n    `If a \\`vlt.json\\` file is present in the root of the current project,\n     then that will be used as a source of configuration information.\n\n     Next, the \\`vlt.json\\` file in the XDG specified config directory\n     will be checked, and loaded for any fields not set in the local project.\n\n     Object type values will be merged together. Set a field to \\`null\\` in\n     the JSON configuration to explicitly remove it.\n\n     Command-specific fields may be set in a nested \\`command\\` object that\n     overrides any options defined at the top level.\n    `,\n  )\n\n  .flag({\n    color: {\n      short: 'c',\n      description: 'Use colors (Default for TTY)',\n    },\n    'no-color': {\n      short: 'C',\n      description: 'Do not use colors (Default for non-TTY)',\n    },\n  })\n\n  .opt({\n    registry: {\n      hint: 'url',\n      default: 'https://registry.npmjs.org/',\n      description: `Sets the registry for fetching packages, when no registry\n                    is explicitly set on a specifier.\n\n                    For example, \\`express@latest\\` will be resolved by looking\n                    up the metadata from this registry.\n\n                    Note that alias specifiers starting with \\`npm:\\` will\n                    still map to \\`https://registry.npmjs.org/\\` if this is\n                    changed, unless the a new mapping is created via the\n                    \\`--registries\\` option.\n      `,\n    },\n  })\n\n  .optList({\n    registries: {\n      hint: 'name=url',\n      description: `Specify named registry hosts by their prefix. To set the\n                    default registry used for non-namespaced specifiers,\n                    use the \\`--registry\\` option.\n\n                    Prefixes can be used as a package alias. For example:\n\n                    \\`\\`\\`\n                    vlt --registries loc=http://reg.local install foo@loc:foo@1.x\n                    \\`\\`\\`\n\n                    By default, the public npm registry is registered to the\n                    \\`npm:\\` prefix. It is not recommended to change this\n                    mapping in most cases.\n                    `,\n    },\n\n    'scope-registries': {\n      hint: '@scope=url',\n      description: `Map package name scopes to registry URLs.\n\n                    For example,\n                    \\`--scope-registries @acme=https://registry.acme/\\`\n                    would tell vlt to fetch any packages named\n                    \\`@acme/...\\` from the \\`https://registry.acme/\\`\n                    registry.\n\n                    Note: this way of specifying registries is more ambiguous,\n                    compared with using the \\`--registries\\` field and explicit\n                    prefixes, because instead of failing when the configuration\n                    is absent, it will instead attempt to fetch from the\n                    default registry.\n\n                    By comparison, using\n                    \\`--registries acme=https://registry.acme/\\` and then\n                    specifying dependencies such as \\`\"foo\": \"acme:foo@1.x\"\\`\n                    means that regardless of the name, the package will be\n                    fetched from the explicitly named registry, or fail if\n                    no registry is defined with that name.\n\n                    However, custom registry aliases are not supported by other\n                    package managers.`,\n    },\n\n    'jsr-registries': {\n      hint: 'name=url',\n      description: `Map alias names to JSR.io registry urls.\n\n                    For example,\n                    \\`--jsr-registries acme=https://jsr.acme.io/\\` would\n                    tell vlt to fetch any packages with the \\`acme:\\` registry\n                    prefix from the \\`https://jsr.acme.io/\\` registry, using\n                    the \"npm Compatibility\" translation. So for example,\n                    the package \\`acme:@foo/bar\\` would fetch the\n                    \\`@jsr/foo__bar\\` package from the \\`jsr.acme.io\\`\n                    registry.\n\n                    By default the \\`jsr\\` alias is always mapped to\n                    \\`https://npm.jsr.io/\\`, so existing \\`jsr:\\` packages will\n                    be fetched from the public \\`jsr\\` registry appropriately.\n                   `,\n    },\n\n    'git-hosts': {\n      hint: `name=template`,\n      short: 'G',\n      description: `Map a shorthand name to a git remote URL template.\n\n                    The \\`template\\` may contain placeholders, which will be\n                    swapped with the relevant values.\n\n                    \\`$1\\`, \\`$2\\`, etc. are replaced with the appropriate\n                    n-th path portion. For example, \\`github:user/project\\`\n                    would replace the \\`$1\\` in the template with \\`user\\`,\n                    and \\`$2\\` with \\`project\\`.`,\n    },\n\n    'git-host-archives': {\n      hint: `name=template`,\n      short: 'A',\n      description: `Similar to the \\`--git-host <name>=<template>\\` option,\n                    this option can define a template string that will be\n                    expanded to provide the URL to download a pre-built\n                    tarball of the git repository.\n\n                    In addition to the n-th path portion expansions performed\n                    by \\`--git-host\\`, this field will also expand the\n                    string \\`$committish\\` in the template, replacing it with\n                    the resolved git committish value to be fetched.`,\n    },\n  })\n\n  .opt({\n    cache: {\n      hint: 'path',\n      description: `\n        Location of the vlt on-disk cache. Defaults to the platform-specific\n        directory recommended by the XDG specification.\n      `,\n      default: cacheDir,\n    },\n    tag: {\n      description: `Default \\`dist-tag\\` to install or publish`,\n      default: 'latest',\n    },\n    before: {\n      hint: 'date',\n      description: `Do not install any packages published after this date`,\n    },\n    os: {\n      description: `The operating system to use as the selector when choosing\n                    packages based on their \\`os\\` value.`,\n      default: process.platform,\n    },\n    arch: {\n      description: `CPU architecture to use as the selector when choosing\n                    packages based on their \\`cpu\\` value.`,\n      default: process.arch,\n    },\n    'node-version': {\n      hint: 'version',\n      description: `Node version to use when choosing packages based on\n                    their \\`engines.node\\` value.`,\n      default: process.version,\n    },\n  })\n\n  .flag({\n    'git-shallow': {\n      description: `Set to force \\`--depth=1\\` on all git clone actions.\n                    When set explicitly to false with --no-git-shallow,\n                    then \\`--depth=1\\` will not be used.\n\n                    When not set explicitly, \\`--depth=1\\` will be used for\n                    git hosts known to support this behavior.`,\n    },\n  })\n  .num({\n    'fetch-retries': {\n      hint: 'n',\n      description: `Number of retries to perform when encountering network\n                    errors or likely-transient errors from git hosts.`,\n      default: 3,\n    },\n    'fetch-retry-factor': {\n      hint: 'n',\n      description: `The exponential backoff factor to use when retrying\n                    requests due to network issues.`,\n      default: 2,\n    },\n    'fetch-retry-mintimeout': {\n      hint: 'n',\n      description: `Number of milliseconds before starting first retry`,\n      default: 0,\n    },\n    'fetch-retry-maxtimeout': {\n      hint: 'n',\n      description: `Maximum number of milliseconds between two retries`,\n      default: 30_000,\n    },\n    'stale-while-revalidate-factor': {\n      hint: 'n',\n      default: 60,\n      description: `If the server does not serve a \\`stale-while-revalidate\\`\n                    value in the \\`cache-control\\` header, then this multiplier\n                    is applied to the \\`max-age\\` or \\`s-maxage\\` values.\n\n                    By default, this is \\`60\\`, so for example a response that\n                    is cacheable for 5 minutes will allow a stale response\n                    while revalidating for up to 5 hours.\n\n                    If the server *does* provide a \\`stale-while-revalidate\\`\n                    value, then that is always used.\n\n                    Set to 0 to prevent any \\`stale-while-revalidate\\` behavior\n                    unless explicitly allowed by the server's \\`cache-control\\`\n                    header.\n      `,\n    },\n  })\n\n  .opt({\n    identity: {\n      short: 'i',\n      validate: (v: unknown) =>\n        typeof v === 'string' && /^[a-z0-9]*$/.test(v),\n      hint: 'name',\n      default: '',\n      description: `Provide a string to define an identity for storing auth\n                    information when logging into registries.\n\n                    Authentication tokens will be stored in the XDG data\n                    directory, in \\`vlt/auth/$\\{identity}/keychain.json\\`.\n\n                    If no identity is provided, then the default \\`''\\` will\n                    be used, storing the file at \\`vlt/auth/keychain.json\\`.\n\n                    May only contain lowercase alphanumeric characters.\n                    `,\n    },\n  })\n\n  .optList({\n    workspace: {\n      hint: 'ws',\n      short: 'w',\n      description: `Set to limit the spaces being worked on when working on\n                    workspaces.\n\n                    Can be paths or glob patterns matching paths.\n\n                    Specifying workspaces by package.json name is not\n                    supported.`,\n    },\n    'workspace-group': {\n      short: 'g',\n      description: `Specify named workspace group names to load and operate on\n                    when doing recursive operations on workspaces.`,\n    },\n  })\n\n  .opt({\n    scope: {\n      short: 's',\n      description:\n        'Set to filter the scope of an operation using a DSS Query.',\n    },\n    target: {\n      short: 't',\n      description:\n        'Set to select packages using a DSS Query selector.',\n    },\n  })\n\n  .flag({\n    recursive: {\n      short: 'r',\n      description: `Run an operation across multiple workspaces.\n\n                    No effect when used in non-monorepo projects.\n\n                    Implied by setting --workspace or --workspace-group. If\n                    not set, then the action is run on the project root.`,\n    },\n\n    bail: {\n      short: 'b',\n      description: `When running scripts across multiple workspaces, stop\n                    on the first failure.`,\n      default: true,\n    },\n\n    'no-bail': {\n      short: 'B',\n      description: `When running scripts across multiple workspaces, continue\n                    on failure, running the script for all workspaces.`,\n    },\n  })\n\n  .opt({\n    config: {\n      hint: 'user | project',\n      description: `Specify whether to operate on user-level or project-level\n                    configuration files when running \\`vlt config\\` commands.`,\n      validOptions: ['user', 'project'] as const,\n      default: 'project',\n    },\n\n    editor: {\n      hint: 'program',\n      description: `The blocking editor to use for \\`vlt config edit\\` and\n                    any other cases where a file should be opened for\n                    editing.\n\n                    Defaults to the \\`EDITOR\\` or \\`VISUAL\\` env if set, or\n                    \\`notepad.exe\\` on Windows, or \\`vi\\` elsewhere.`,\n      default: defaultEditor(),\n    },\n\n    'script-shell': {\n      hint: 'program',\n      description: `The shell to use when executing \\`package.json#scripts\\`.\n\n                    For \\`vlt exec\\` and \\`vlt exec-local\\`, this is never set,\n                    meaning that command arguments are run exactly as provided.\n\n                    For \\`vlt run\\` (and other things that run lifecycle\n                    scripts in \\`package.json#scripts\\`), the entire command\n                    with all arguments is provided as a single string, meaning\n                    that some value must be provided for shell interpretation,\n                    and so for these contexts, the \\`script-shell\\` value will\n                    default to \\`/bin/sh\\` on POSIX systems or \\`cmd.exe\\` on\n                    Windows.\n      `,\n    },\n\n    'fallback-command': {\n      hint: 'command',\n      description: `The command to run when the first argument doesn't\n                    match any known commands.\n\n                    For pnpm-style behavior, set this to 'run-exec'. e.g:\n                    \\`\\`\\`\n                    vlt config set fallback-command=run-exec\n                    \\`\\`\\``,\n      default: 'help',\n      validOptions: Object.keys(canonicalCommands),\n    },\n  })\n\n  .opt({\n    package: {\n      hint: 'p',\n      description: `When running \\`vlt exec\\`, this allows you to explicitly\n                    set the package to search for bins. If not provided, then\n                    vlt will interpret the first argument as the package, and\n                    attempt to run the default executable.`,\n    },\n  })\n\n  .opt({\n    view: {\n      hint: 'output',\n      default: defaultView,\n      description: `Configures the output format for commands.\n\n                    Defaults to \\`human\\` if stdout is a TTY, or \\`json\\`\n                    if it is not.\n\n                    - human: Maximally ergonomic output reporting for human\n                      consumption.\n                    - json: Parseable JSON output for machines.\n                    - inspect: Output results with \\`util.inspect\\`.\n                    - gui: Start a local web server and opens a browser to\n                      explore the results. (Only relevant for certain\n                      commands.)\n                    - mermaid: Output mermaid diagramming syntax. (Only\n                      relevant for certain commands.)\n                    - silent: Suppress all output to stdout.\n\n                    If the requested view format is not supported for the\n                    current command, or if no option is provided, then it\n                    will fall back to the default.\n      `,\n      validOptions: [\n        'human',\n        'json',\n        'mermaid',\n        'gui',\n        'inspect',\n        'silent',\n      ] as const,\n    },\n  })\n\n  .optList({\n    'dashboard-root': {\n      hint: 'path',\n      description: `The root directory to use for the dashboard GUI.\n                    If not set, the user home directory is used.`,\n    },\n  })\n\n  .flag({\n    'save-dev': {\n      short: 'D',\n      description: `Save installed packages to a package.json file as\n                    devDependencies`,\n    },\n    'save-optional': {\n      short: 'O',\n      description: `Save installed packages to a package.json file as\n                    optionalDependencies`,\n    },\n    'save-peer': {\n      description: `Save installed packages to a package.json file as\n                    peerDependencies`,\n    },\n    'save-prod': {\n      short: 'P',\n      description: `Save installed packages into dependencies specifically.\n                    This is useful if a package already exists in\n                    devDependencies or optionalDependencies, but you want to\n                    move it to be a non-optional production dependency.`,\n    },\n  })\n\n  .opt({\n    'expect-results': {\n      hint: 'value',\n      validate: (v: unknown) =>\n        typeof v === 'string' && /^([<>]=?)?[0-9]+$/.test(v),\n      description: `When running \\`vlt query\\`, this option allows you to\n                    set a expected number of resulting items.\n\n                    Accepted values are numbers and strings.\n\n                    Strings starting with \\`>\\`, \\`<\\`, \\`>=\\` or \\`<=\\`\n                    followed by a number can be used to check if the result\n                    is greater than or less than a specific number.`,\n    },\n  })\n\n  .flag({\n    'dry-run': {\n      description: 'Run command without making any changes',\n    },\n    'expect-lockfile': {\n      description:\n        'Fail if lockfile is missing or out of date. Used by ci command to enforce lockfile integrity.',\n    },\n    'frozen-lockfile': {\n      description:\n        'Fail if lockfile is missing or out of sync with package.json. Prevents any lockfile modifications.',\n    },\n  })\n  .opt({\n    access: {\n      description: 'Set the access level of the package',\n      validOptions: ['public', 'restricted'] as const,\n      default: 'public',\n    },\n  })\n  .opt({\n    otp: {\n      description: `Provide an OTP to use when publishing a package.`,\n    },\n    'publish-directory': {\n      hint: 'path',\n      description: `Directory to use for pack and publish operations instead of the current directory.\n                    Similar to pnpm's publishConfig.directory feature.\n                    The directory must exist and nothing will be copied to it.`,\n    },\n  })\n\n  .flag({\n    yes: {\n      short: 'y',\n      description: `Automatically accept any confirmation prompts`,\n    },\n    version: {\n      short: 'v',\n      description: 'Print the version',\n    },\n    help: {\n      short: 'h',\n      description: 'Print helpful information',\n    },\n  })\n\nexport const getSortedCliOptions = () => {\n  const defs = definition.toJSON()\n  return getSortedKeys().map((k: keyof typeof defs) => {\n    const def = defs[k]\n    /* c8 ignore next */\n    if (!def) throw error('invalid key found', { found: k })\n    if (def.type === 'boolean') return `--${k}`\n    return `--${k}=<${def.hint ?? k}>`\n  })\n}\n\nexport const getSortedKeys = () =>\n  Object.keys(definition.toJSON()).sort((a, b) => a.localeCompare(b))\n"]}

package/dist/esm/config/index.d.ts

@@ -190,6 +190,12 @@ export declare class Config {
      * the XDG config home.
      */
     loadConfigFile(): Promise<this>;
+    /**
+     * Force a complete reload of config files from disk.
+     * This clears all caches and re-reads config files.
+     * Useful for long-running processes that need to pick up config changes.
+     */
+    reloadFromDisk(): Promise<void>;
     /**
      * Load the configuration and return a Promise to a
      * {@link Config} object

package/dist/esm/config/index.d.ts.map

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

package/dist/esm/config/index.js

@@ -152,6 +152,11 @@ export class Config {
      * positional arguments to the vlt process
      */
     positionals;
+    /**
+     * Original arguments used for parsing (stored for reload purposes)
+     * @internal
+     */
+    #originalArgs;
     /**
      * The root of the project where a vlt.json, vlt.json,
      * package.json, or .git was found. Not necessarily the `process.cwd()`,
@@ -181,6 +186,8 @@ export class Config {
     parse(args = process.argv) {
         if (isParsed(this))
             return this;
+        // Store the original args for potential reload
+        this.#originalArgs = [...args];
         this.jack.loadEnvDefaults();
         const p = this.jack.parseRaw(args);
         const fallback = getCommand(p.values['fallback-command']);
@@ -248,7 +255,8 @@ export class Config {
      * Write the config values to the user or project config file.
      */
     async writeConfigFile(which, values) {
-        return save('config', pairsToRecords(values), which);
+        save('config', pairsToRecords(values), which);
+        await this.#reloadConfig();
     }
     /**
      * Fold in the provided fields with the existing properties
@@ -385,6 +393,39 @@ export class Config {
         await this.#maybeLoadConfigFile('project');
         return this;
     }
+    /**
+     * Clear cached config values to force re-reading from updated files.
+     * @internal
+     */
+    async #reloadConfig() {
+        // Clear the memoized options to force recalculation
+        this.#options = undefined;
+    }
+    /**
+     * Force a complete reload of config files from disk.
+     * This clears all caches and re-reads config files.
+     * Useful for long-running processes that need to pick up config changes.
+     */
+    async reloadFromDisk() {
+        // Clear the memoized options to force recalculation
+        this.#options = undefined;
+        // Clear the parsed state to force re-parsing
+        // This is crucial because parse() returns early if already parsed
+        this.values = undefined;
+        this.positionals = undefined;
+        this.command = undefined;
+        // Clear vlt-json caches for both user and project configs
+        // This ensures that the next time config files are read, they'll be re-read from disk
+        const { unload } = await import('@vltpkg/vlt-json');
+        unload('user');
+        unload('project');
+        // Force reload of config files by calling the load methods again
+        // This will re-read the files and re-apply them to the jack parser
+        await this.#maybeLoadConfigFile('user');
+        await this.#maybeLoadConfigFile('project');
+        // Re-parse to pick up the updated config values using the original arguments
+        this.parse(this.#originalArgs);
+    }
     /**
      * cache of the loaded config
      */

package/dist/esm/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EACL,QAAQ,EACR,UAAU,EACV,aAAa,EACb,YAAY,GAEb,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;AAKtE,4CAA4C;AAC5C,uDAAuD;AACvD,MAAM,WAAW,GAAG,CAClB,KAAQ,EACU,EAAE;IACpB,MAAM,MAAM,GAAiB,EAAE,CAAA;IAC/B,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC1B,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAA;aACzB,CAAC;YACJ,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YAC/B,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;QACnB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,CAAS,EAAE,CAAU,EAAiB,EAAE,CAClE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAChB,YAAY,CAAC,QAAQ,CAAC,CAAkC,CAAC,CAAA;AAQ3D,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,GAEqC,EACrB,EAAE;IAClB,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QAClC,CAAC;QACD,CAAC,KAAK,SAAS,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;YAC7C,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;gBAChC,CAAC;gBACD,cAAc,CAAC,CAAgC,CAAC;aACjD,CAAC,CACH;YACH,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;gBAC3C,CAAC,CAAC,CAAC;KACJ,CAAC,CAE0B,CAAA;AAChC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAgB,EAAe,EAAE;IAC9D,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;SAChB,MAAM,CACL,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CACN,CAAC,CACC,CAAC,KAAK,QAAQ;QACd,CAAC,KAAK,aAAa;QACnB,CAAC,KAAK,UAAU;QAChB,CAAC,KAAK,aAAa;QACnB,CAAC,KAAK,aAAa,CACpB,CACJ;SACA,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QACf,CAAC;QACD,CAAC,KAAK,SAAS,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;YAC7C,cAAc,CAAC,CAAgB,CAAC;YAClC,CAAC,CAAC,CACA,CAAC,CAAC;gBACF,OAAO,CAAC,KAAK,QAAQ;gBACrB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAChB,CAAC,aAAa,CAAC,CAAC,CAAC,CAClB,CAAC,CAAC;gBACD,CAAC;gBACH,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;KACjD,CAAC,CACL,CAAA;AACH,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAA;AAiEjD;;;;GAIG;AACH,MAAM,OAAO,MAAM;IACjB;;;OAGG;IACH,IAAI,CAAyB;IAE7B;;OAEG;IACH,MAAM,CAAoC;IAE1C;;OAEG;IACH,aAAa,GAET,EAAE,CAAA;IAEN;;OAEG;IACH,IAAI,OAAO;QACT,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAA;QACvC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAC/C,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAA;QACrC,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,CAAA;QACrD,MAAM,MAAM,GAAG;YACb,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM;YACN,WAAW;YACX,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE;gBAC7C,MAAM;gBACN,WAAW;gBACX,IAAI,EAAE;oBACJ,KAAK,EAAE,SAAS,CAAC,SAAS;oBAC1B,MAAM,EAAE,SAAS,CAAC,iBAAiB,CAAC;iBACrC;aACF,CAAC;YACF,OAAO,EAAE,IAAI,CACX,SAAS,EACT,wBAAwB,CACzB;YACD,QAAQ,EAAE,IAAI,CACZ,UAAU,EACV,CAAC,CAAC,EAAE,CACF,mBAAmB,CACjB,CAAC,EACD,oBAAoB,EACpB,wCAAwC,CACzC,CACJ;SACF,CAAA;QAED,MAAM,OAAO,GAAuC,MAAM,CAAC,MAAM,CAC/D,SAAS,EACT,MAAM,CACP,CAAA;QAED,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;YACrC,WAAW,EAAE,IAAI,iBAAiB,CAAC,OAAO,CAAC;YAC3C,CAAC,cAAc,CAAC;gBACd,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAC5B,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CACN,CAAC,KAAK,UAAU;oBAChB,CAAC,KAAK,QAAQ;oBACd,CAAC,KAAK,aAAa;oBACnB,CAAC,KAAK,aAAa,CACtB,CACF,CAAA;YACH,CAAC;SACF,CAAC,CAAA;QACF,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;QAC9C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;IAC3B,CAAC;IAED,kCAAkC;IAClC,QAAQ,CAAgB;IAExB;;OAEG;IACH,WAAW,CAAW;IAEtB;;;;;;;OAOG;IACH,WAAW,CAAQ;IAEnB;;OAEG;IACH,QAAQ,CAAU;IAElB;;;OAGG;IACH,OAAO,CAA2B;IAElC,YACE,OAAgC,UAAU,EAC1C,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;QAE3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAiB,OAAO,CAAC,IAAI;QACjC,IAAI,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QAE/B,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAA;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAElC,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAA;QACzD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;QAE3C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAA;QAC9C,MAAM,WAAW,GACf,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAA;QACpD,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAA;QACxD,CAAC;QAED,0DAA0D;QAC1D,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;QAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;QAErB,IAAI,IAAI,CAAC,OAAO;YAAE,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAA;;YAClC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAA;QAE5D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAEtB,kCAAkC;QAClC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM,KAAK,CAAC,wBAAwB,CAAC,CAAA;QAC1D,oBAAoB;QAEpB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,CAA0B;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAEX,CAAA;QACb,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAA;QACrB,IAAI,KAAK,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAA;QACzC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAgB,EAAE,IAAI,EAAE,EAAE;YACjD,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAC5B,IAAI,EAAE,KAAK,CAAC,CAAC;gBAAE,OAAO,EAAE,CAAA;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;YAClC,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;YACb,OAAO,EAAE,CAAA;QACX,CAAC,EAAE,EAAE,CAAC,CAAA;QACN,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QACvC,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;;;;OAKG;IACH,GAAG,CACD,CAAI;QAEJ,2DAA2D;QAC3D,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAEnB,KAAkB,EAClB,MAAmC;QAEnC,OAAO,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAA;IACtD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAEnB,KAAkB,EAClB,MAAmC;QAEnC,OAAO,IAAI,CAAC,eAAe,CACzB,KAAK,EACL,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAC9D,CAAA;IACH,CAAC;IAED,+DAA+D;IAC/D,kCAAkC;IAClC,UAAU,GAA8B,UAEtC,CAAU,EACV,IAAY;QAEZ,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEZ,eAAe,CACb,CAAU,EACV,IAAY;QAEZ,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,MAAM,KAAK,CAAC,iCAAiC,EAAE;gBAC7C,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,gBAAgB;aACzB,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC,CAAgB,CAAC,CAAA;QAC/D,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChD,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;gBACzB,IAAI,GAAG,EAAE,CAAC;oBACR,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAC7B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAK,EAAiB,EAC7C,IAAkB,CACnB,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACzC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,oBAAoB,CAAC,WAAwB;QACjD,OAAO,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;IACrD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAEpB,KAAkB,EAClB,MAAgB;QAEhB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAA;QACnD,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAA;QACvB,IAAI,YAAY,GAAG,KAAK,CAAA;QACxB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAG/B,CAAA;YACD,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACzB,MAAM,CAAC,GAAG,GAA8B,CAAA;YACxC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,IAAI,CAAC,KAAK,SAAS;gBAAE,SAAQ;YAC7B,IAAI,IAAI,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACvC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrB,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAC/B,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAChC,CAAA;oBACD,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;wBACb,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;4BAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAA;;4BAC7B,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;wBACnB,YAAY,GAAG,IAAI,CAAA;oBACrB,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;wBAC1B,OAAO,CAAC,CAAC,IAAI,CAAC,CAAA;wBACd,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;4BAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAA;wBAC/C,YAAY,GAAG,IAAI,CAAA;oBACrB,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,YAAY,GAAG,IAAI,CAAA;gBACnB,OAAO,IAAI,CAAC,CAAC,CAAC,CAAA;YAChB,CAAC;QACH,CAAC;QACD,IAAI,YAAY;YAAE,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QACzD,OAAO,YAAY,CAAA;IACrB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,cAAc,CAElB,KAAkB,EAClB,IAA4C;QAE5C,4BAA4B;QAC5B,yBAAyB;QACzB,YAAY;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QACxB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAClE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,SAAS,CACb,IAAI,EACJ,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAC/C,CAAA;QACH,CAAC;QACD,IAAI,KAAK,GAAG,KAAK,CAAA;QACjB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAA;YAChB,oDAAoD;YACpD,+BAA+B;YAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YACtC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,CAAA;YACnC,KAAK,GAAG,IAAI,CAAA;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,2DAA2D;gBAC3D,0DAA0D;gBAC1D,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;oBAC7B,MAAM,CAAC,KAAK,CAAC,CAAA;gBACf,CAAC;qBAAM,CAAC;oBACN,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;gBACjC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAA;QACvC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAA;QAC7D,MAAM,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAA;QAC1C,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAA0B;IAExC;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CACf,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,EAC3B,IAAI,GAAG,OAAO,CAAC,IAAI;IACnB;;;OAGG;IACH,MAAM,GAAG,KAAK;QAEd,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,OAAO,CAAA;QAChD,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,cAAc,EAAE,CAAA;QAClC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAA;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;CACF;AAED,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAqB,EAAE,CAChD,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,OAAO,CAAC,CAAA","sourcesContent":["/**\n * Module that handles all vlt configuration needs\n *\n * Project-level configs are set in a `vlt.json` file in the local project\n * if present. This will override the user-level configs in the appropriate\n * XDG config path.\n *\n * Command-specific configuration can be specified by putting options in a\n * field in the `command` object. For example:\n *\n * ```json\n * {\n *   \"registry\": \"https://registry.npmjs.org/\",\n *   \"command\": {\n *     \"publish\": {\n *       \"registry\": \"http://registry.internal\"\n *     }\n *   }\n * }\n * ```\n * @module\n */\n\nimport { error } from '@vltpkg/error-cause'\nimport { PackageInfoClient } from '@vltpkg/package-info'\nimport { PackageJson } from '@vltpkg/package-json'\nimport type { SpecOptions } from '@vltpkg/spec'\nimport {\n  assertRecordStringString,\n  assertRecordStringT,\n  isRecordStringString,\n} from '@vltpkg/types'\nimport type { Validator, WhichConfig } from '@vltpkg/vlt-json'\nimport { find, load, reload, save } from '@vltpkg/vlt-json'\nimport { Monorepo } from '@vltpkg/workspaces'\nimport type { Jack, OptionsResults, Unwrap } from 'jackspeak'\nimport { readFile, rm, writeFile } from 'node:fs/promises'\nimport { dirname } from 'node:path'\nimport { PathScurry } from 'path-scurry'\nimport type { Commands, RecordField } from './definition.ts'\nimport {\n  commands,\n  definition,\n  getCommand,\n  isRecordField,\n  recordFields,\n} from './definition.ts'\nimport { merge } from './merge.ts'\nexport {\n  commands,\n  definition,\n  isRecordField,\n  recordFields,\n  type Commands,\n}\n\nexport const kCustomInspect = Symbol.for('nodejs.util.inspect.custom')\n\nexport type RecordPairs = Record<string, unknown>\nexport type RecordString = Record<string, string>\n\n// turn a set of pairs into a Record object.\n// if a kv pair doesn't have a = character, set to `''`\nconst reducePairs = <T extends string[]>(\n  pairs: T,\n): RecordString | T => {\n  const record: RecordString = {}\n  for (const kv of pairs) {\n    const eq = kv.indexOf('=')\n    if (eq === -1) record[kv] = ''\n    else {\n      const key = kv.substring(0, eq)\n      const val = kv.substring(eq + 1)\n      record[key] = val\n    }\n  }\n  return record\n}\n\nconst isRecordFieldValue = (k: string, v: unknown): v is string[] =>\n  Array.isArray(v) &&\n  recordFields.includes(k as (typeof recordFields)[number])\n\nexport type PairsAsRecords = ConfigOptionsNoExtras & {\n  command?: {\n    [k in keyof Commands]?: ConfigOptionsNoExtras\n  }\n}\n\nexport const pairsToRecords = (\n  obj:\n    | NonNullable<ConfigFileData>\n    | OptionsResults<ConfigDefinitions>,\n): PairsAsRecords => {\n  return Object.fromEntries(\n    Object.entries(obj).map(([k, v]) => [\n      k,\n      k === 'command' && v && typeof v === 'object' ?\n        Object.fromEntries(\n          Object.entries(v).map(([k, v]) => [\n            k,\n            pairsToRecords(v as NonNullable<ConfigFileData>),\n          ]),\n        )\n      : isRecordFieldValue(k, v) ? reducePairs(v)\n      : v,\n    ]),\n    // hard cast because TS can't see through the entries/fromEntries\n  ) as unknown as PairsAsRecords\n}\n\nexport const recordsToPairs = (obj: RecordPairs): RecordPairs => {\n  return Object.fromEntries(\n    Object.entries(obj)\n      .filter(\n        ([k]) =>\n          !(\n            k === 'scurry' ||\n            k === 'packageJson' ||\n            k === 'monorepo' ||\n            k === 'projectRoot' ||\n            k === 'packageInfo'\n          ),\n      )\n      .map(([k, v]) => [\n        k,\n        k === 'command' && v && typeof v === 'object' ?\n          recordsToPairs(v as RecordPairs)\n        : (\n          !v ||\n          typeof v !== 'object' ||\n          Array.isArray(v) ||\n          !isRecordField(k)\n        ) ?\n          v\n        : Object.entries(v).map(([k, v]) => `${k}=${v}`),\n      ]),\n  )\n}\n\nconst kRecord = Symbol('parsed key=value record')\n\nexport type ConfigDataNoCommand = {\n  [k in keyof OptionsResults<ConfigDefinitions>]?: OptionsResults<ConfigDefinitions>[k]\n}\n\n/**\n * Config data can be any options, and also a 'command' field which\n * contains command names and override options for that command.\n */\nexport type ConfigData = ConfigDataNoCommand & {\n  command?: {\n    [k in keyof Commands]?: ConfigDataNoCommand\n  }\n}\n\nexport type ConfigFileDataNoCommand = {\n  [k in keyof ConfigDataNoCommand]: k extends (\n    OptListKeys<ConfigDataNoCommand>\n  ) ?\n    RecordString | string[]\n  : ConfigDataNoCommand[k]\n}\n\n/**\n * Config data as it appears in the config field of the vlt.json, with kv pair\n * lists stored as `Record<string, string>` and\n */\nexport type ConfigFileData = ConfigFileDataNoCommand & {\n  command?: {\n    [k in keyof Commands]?: ConfigFileDataNoCommand\n  }\n}\n\nexport type ConfigOptionsNoExtras = {\n  [k in keyof OptionsResults<ConfigDefinitions>]: k extends (\n    RecordField\n  ) ?\n    RecordString\n  : k extends 'command' ? never\n  : OptionsResults<ConfigDefinitions>[k]\n}\n\nexport type ConfigOptions = ConfigOptionsNoExtras &\n  Pick<SpecOptions, 'catalog' | 'catalogs'> & {\n    packageJson: PackageJson\n    scurry: PathScurry\n    projectRoot: string\n    monorepo?: Monorepo\n    packageInfo: PackageInfoClient\n  }\n\n/**\n * The base config definition set as a type\n */\nexport type ConfigDefinitions = Unwrap<typeof definition>\n\nexport type StringListKeys<O> = {\n  [k in keyof O]: O[k] extends string[] | undefined ? k : never\n}\nexport type OptListKeys<O> = Exclude<\n  StringListKeys<O>[keyof StringListKeys<O>],\n  undefined\n>\n\n/**\n * Class that handles configuration for vlt.\n *\n * Call {@link Config.load} to get one of these.\n */\nexport class Config {\n  /**\n   * The {@link https://npmjs.com/jackspeak | JackSpeak} object\n   * representing vlt's configuration\n   */\n  jack: Jack<ConfigDefinitions>\n\n  /**\n   * Parsed values in effect\n   */\n  values?: OptionsResults<ConfigDefinitions>\n\n  /**\n   * Command-specific config values\n   */\n  commandValues: {\n    [cmd in Commands[keyof Commands]]?: ConfigData\n  } = {}\n\n  /**\n   * A flattened object of the parsed configuration\n   */\n  get options(): ConfigOptions {\n    if (this.#options) return this.#options\n    const scurry = new PathScurry(this.projectRoot)\n    const packageJson = new PackageJson()\n    const asRecords = pairsToRecords(this.parse().values)\n    const extras = {\n      projectRoot: this.projectRoot,\n      scurry,\n      packageJson,\n      monorepo: Monorepo.maybeLoad(this.projectRoot, {\n        scurry,\n        packageJson,\n        load: {\n          paths: asRecords.workspace,\n          groups: asRecords['workspace-group'],\n        },\n      }),\n      catalog: load<Record<string, string>>(\n        'catalog',\n        assertRecordStringString,\n      ),\n      catalogs: load<Record<string, Record<string, string>>>(\n        'catalogs',\n        o =>\n          assertRecordStringT(\n            o,\n            isRecordStringString,\n            'Record<string, Record<string, string>>',\n          ),\n      ),\n    }\n\n    const options: Omit<ConfigOptions, 'packageInfo'> = Object.assign(\n      asRecords,\n      extras,\n    )\n\n    this.#options = Object.assign(options, {\n      packageInfo: new PackageInfoClient(options),\n      [kCustomInspect]() {\n        return Object.fromEntries(\n          Object.entries(options).filter(\n            ([k]) =>\n              k !== 'monorepo' &&\n              k !== 'scurry' &&\n              k !== 'packageJson' &&\n              k !== 'packageInfo',\n          ),\n        )\n      },\n    })\n    return this.#options\n  }\n\n  /**\n   * Reset the options value, optionally setting a new project root\n   * to recalculate the options.\n   */\n  resetOptions(projectRoot: string = process.cwd()) {\n    this.projectRoot = projectRoot\n    this.#options = undefined\n  }\n\n  // memoized options() getter value\n  #options?: ConfigOptions\n\n  /**\n   * positional arguments to the vlt process\n   */\n  positionals?: string[]\n\n  /**\n   * The root of the project where a vlt.json, vlt.json,\n   * package.json, or .git was found. Not necessarily the `process.cwd()`,\n   * though that is the default location.\n   *\n   * Never walks up as far as `$HOME`. So for example, if a project is in\n   * `~/projects/xyz`, then the highest dir it will check is `~/projects`\n   */\n  projectRoot: string\n\n  /**\n   * `Record<alias, canonical name>` to dereference command aliases.\n   */\n  commands: Commands\n\n  /**\n   * Which command name to use for overriding with command-specific values,\n   * determined from the argv when parse() is called.\n   */\n  command?: Commands[keyof Commands]\n\n  constructor(\n    jack: Jack<ConfigDefinitions> = definition,\n    projectRoot = process.cwd(),\n  ) {\n    this.projectRoot = projectRoot\n    this.commands = commands\n    this.jack = jack\n  }\n\n  /**\n   * Parse the arguments and set configuration and positionals accordingly.\n   */\n  parse(args: string[] = process.argv): this & ParsedConfig {\n    if (isParsed(this)) return this\n\n    this.jack.loadEnvDefaults()\n    const p = this.jack.parseRaw(args)\n\n    const fallback = getCommand(p.values['fallback-command'])\n    this.command = getCommand(p.positionals[0])\n\n    const cmdOrFallback = this.command ?? fallback\n    const cmdSpecific =\n      cmdOrFallback && this.commandValues[cmdOrFallback]\n    if (cmdSpecific) {\n      this.jack.setConfigValues(recordsToPairs(cmdSpecific))\n    }\n\n    // ok, applied cmd-specific defaults, do rest of the parse\n    this.jack.applyDefaults(p)\n    this.jack.writeEnv(p)\n\n    if (this.command) p.positionals.shift()\n    else this.command = getCommand(p.values['fallback-command'])\n\n    Object.assign(this, p)\n\n    /* c8 ignore start - unpossible */\n    if (!isParsed(this)) throw error('failed to parse config')\n    /* c8 ignore stop */\n\n    return this\n  }\n\n  /**\n   * Get a `key=value` list option value as an object.\n   *\n   * For example, a list option with a vlaue of `['key=value', 'xyz=as=df' ]`\n   * would be returned as `{key: 'value', xyz: 'as=df'}`\n   *\n   * Results are memoized, so subsequent calls for the same key will return the\n   * same object. If new strings are added to the list, then the memoized value\n   * is *not* updated, so only use once configurations have been fully loaded.\n   *\n   * If the config value is not set at all, an empty object is returned.\n   */\n  getRecord(k: OptListKeys<ConfigData>): RecordString {\n    const pairs = this.get(k) as\n      | (string[] & { [kRecord]?: RecordString })\n      | undefined\n    if (!pairs) return {}\n    if (pairs[kRecord]) return pairs[kRecord]\n    const kv = pairs.reduce((kv: RecordString, pair) => {\n      const eq = pair.indexOf('=')\n      if (eq === -1) return kv\n      const key = pair.substring(0, eq)\n      const val = pair.substring(eq + 1)\n      kv[key] = val\n      return kv\n    }, {})\n    Object.assign(pairs, { [kRecord]: kv })\n    return kv\n  }\n\n  /**\n   * Get a configuration value.\n   *\n   * Note: `key=value` pair configs are returned as a string array. To get them\n   * as an object, use {@link Config#getRecord}.\n   */\n  get<K extends keyof OptionsResults<ConfigDefinitions>>(\n    k: K,\n  ): OptionsResults<ConfigDefinitions>[K] {\n    /* c8 ignore next -- impossible but TS doesn't know that */\n    return (this.values ?? this.parse().values)[k]\n  }\n\n  /**\n   * Write the config values to the user or project config file.\n   */\n  async writeConfigFile(\n    this: LoadedConfig,\n    which: WhichConfig,\n    values: NonNullable<ConfigFileData>,\n  ) {\n    return save('config', pairsToRecords(values), which)\n  }\n\n  /**\n   * Fold in the provided fields with the existing properties\n   * in the config file.\n   */\n  async addConfigToFile(\n    this: LoadedConfig,\n    which: WhichConfig,\n    values: NonNullable<ConfigFileData>,\n  ) {\n    return this.writeConfigFile(\n      which,\n      merge((await this.#maybeLoadConfigFile(which)) ?? {}, values),\n    )\n  }\n\n  // called in this weird bound way so that it can be used by the\n  // vlt-json config loading module.\n  #validator: Validator<ConfigFileData> = function (\n    this: Config,\n    c: unknown,\n    file: string,\n  ) {\n    this.#validateConfig(c, file)\n  }.bind(this)\n\n  #validateConfig(\n    c: unknown,\n    file: string,\n  ): asserts c is ConfigFileData {\n    if (!c || typeof c !== 'object' || Array.isArray(c)) {\n      throw error('invalid config, expected object', {\n        path: file,\n        found: c,\n        wanted: 'ConfigFileData',\n      })\n    }\n\n    const { command, ...values } = recordsToPairs(c as RecordPairs)\n    if (command) {\n      for (const [c, opts] of Object.entries(command)) {\n        const cmd = getCommand(c)\n        if (cmd) {\n          this.commandValues[cmd] = merge<ConfigData>(\n            this.commandValues[cmd] ?? ({} as ConfigData),\n            opts as ConfigData,\n          )\n        }\n      }\n    }\n    this.jack.setConfigValues(values, file)\n  }\n\n  /**\n   * if the file exists, parse and load it. returns object if data was\n   * loaded, or undefined if not.\n   */\n  async #maybeLoadConfigFile(whichConfig: WhichConfig) {\n    return load('config', this.#validator, whichConfig)\n  }\n\n  /**\n   * Deletes the specified config fields from the named file\n   * Returns `true` if anything was changed.\n   */\n  async deleteConfigKeys(\n    this: LoadedConfig,\n    which: WhichConfig,\n    fields: string[],\n  ) {\n    const data = await this.#maybeLoadConfigFile(which)\n    if (!data) return false\n    let didSomething = false\n    for (const f of fields) {\n      const [key, ...sk] = f.split('.') as [\n        h: string,\n        ...rest: string[],\n      ]\n      const subs = sk.join('.')\n      const k = key as keyof ConfigDefinitions\n      const v = data[k]\n      if (v === undefined) continue\n      if (subs && v && typeof v === 'object') {\n        if (Array.isArray(v)) {\n          const i = v.findIndex(subvalue =>\n            subvalue.startsWith(`${subs}=`),\n          )\n          if (i !== -1) {\n            if (v.length === 1) delete data[k]\n            else v.splice(i, 1)\n            didSomething = true\n          }\n        } else {\n          if (v[subs] !== undefined) {\n            delete v[subs]\n            if (Object.keys(v).length === 0) delete data[k]\n            didSomething = true\n          }\n        }\n      } else {\n        didSomething = true\n        delete data[k]\n      }\n    }\n    if (didSomething) await this.writeConfigFile(which, data)\n    return didSomething\n  }\n\n  /**\n   * Edit the user or project configuration file.\n   *\n   * If the file isn't present, then it starts with `{}` so the user has\n   * something to work with.\n   *\n   * If the result is not valid, or no config settings are contained in the\n   * file after editing, then it's restored to what it was before, which might\n   * mean deleting the file.\n   */\n  async editConfigFile(\n    this: LoadedConfig,\n    which: WhichConfig,\n    edit: (file: string) => Promise<void> | void,\n  ) {\n    // load the file as a backup\n    // call the edit function\n    // reload it\n    const file = find(which)\n    const backup = await readFile(file, 'utf8').catch(() => undefined)\n    if (!backup) {\n      await writeFile(\n        file,\n        JSON.stringify({ config: {} }, null, 2) + '\\n',\n      )\n    }\n    let valid = false\n    try {\n      await edit(file)\n      // force it to reload the file and validate it again\n      // if this fails, we roll back.\n      const result = reload('config', which)\n      save('config', result ?? {}, which)\n      valid = true\n    } finally {\n      if (!valid) {\n        // TODO: maybe write the file to a re-edit backup location?\n        // then you could do `vlt config edit retry` or something.\n        if (backup) {\n          await writeFile(file, backup)\n          reload(which)\n        } else {\n          await rm(file, { force: true })\n        }\n      }\n    }\n  }\n\n  /**\n   * Find the local config file and load both it and the user-level config in\n   * the XDG config home.\n   */\n  async loadConfigFile(): Promise<this> {\n    await this.#maybeLoadConfigFile('user')\n    this.projectRoot = dirname(find('project', this.projectRoot))\n    await this.#maybeLoadConfigFile('project')\n    return this\n  }\n\n  /**\n   * cache of the loaded config\n   */\n  static #loaded: LoadedConfig | undefined\n\n  /**\n   * Load the configuration and return a Promise to a\n   * {@link Config} object\n   */\n  static async load(\n    projectRoot = process.cwd(),\n    argv = process.argv,\n    /**\n     * only used in tests, resets the memoization\n     * @internal\n     */\n    reload = false,\n  ): Promise<LoadedConfig> {\n    if (this.#loaded && !reload) return this.#loaded\n    const a = new Config(definition, projectRoot)\n    const b = await a.loadConfigFile()\n    this.#loaded = b.parse(argv) as LoadedConfig\n    return this.#loaded\n  }\n}\n\nconst isParsed = (c: Config): c is ParsedConfig =>\n  !!(c.values && c.positionals && c.command)\n\nexport type ParsedConfig = Config & {\n  command: NonNullable<Config['command']>\n  values: OptionsResults<ConfigDefinitions>\n  positionals: string[]\n}\n\n/**\n * A fully loaded {@link Config} object\n */\nexport type LoadedConfig = ParsedConfig\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Module that handles all vlt configuration needs\n *\n * Project-level configs are set in a `vlt.json` file in the local project\n * if present. This will override the user-level configs in the appropriate\n * XDG config path.\n *\n * Command-specific configuration can be specified by putting options in a\n * field in the `command` object. For example:\n *\n * ```json\n * {\n *   \"registry\": \"https://registry.npmjs.org/\",\n *   \"command\": {\n *     \"publish\": {\n *       \"registry\": \"http://registry.internal\"\n *     }\n *   }\n * }\n * ```\n * @module\n */\n\nimport { error } from '@vltpkg/error-cause'\nimport { PackageInfoClient } from '@vltpkg/package-info'\nimport { PackageJson } from '@vltpkg/package-json'\nimport type { SpecOptions } from '@vltpkg/spec'\nimport {\n  assertRecordStringString,\n  assertRecordStringT,\n  isRecordStringString,\n} from '@vltpkg/types'\nimport type { Validator, WhichConfig } from '@vltpkg/vlt-json'\nimport { find, load, reload, save } from '@vltpkg/vlt-json'\nimport { Monorepo } from '@vltpkg/workspaces'\nimport type { Jack, OptionsResults, Unwrap } from 'jackspeak'\nimport { readFile, rm, writeFile } from 'node:fs/promises'\nimport { dirname } from 'node:path'\nimport { PathScurry } from 'path-scurry'\nimport type { Commands, RecordField } from './definition.ts'\nimport {\n  commands,\n  definition,\n  getCommand,\n  isRecordField,\n  recordFields,\n} from './definition.ts'\nimport { merge } from './merge.ts'\nexport {\n  commands,\n  definition,\n  isRecordField,\n  recordFields,\n  type Commands,\n}\n\nexport const kCustomInspect = Symbol.for('nodejs.util.inspect.custom')\n\nexport type RecordPairs = Record<string, unknown>\nexport type RecordString = Record<string, string>\n\n// turn a set of pairs into a Record object.\n// if a kv pair doesn't have a = character, set to `''`\nconst reducePairs = <T extends string[]>(\n  pairs: T,\n): RecordString | T => {\n  const record: RecordString = {}\n  for (const kv of pairs) {\n    const eq = kv.indexOf('=')\n    if (eq === -1) record[kv] = ''\n    else {\n      const key = kv.substring(0, eq)\n      const val = kv.substring(eq + 1)\n      record[key] = val\n    }\n  }\n  return record\n}\n\nconst isRecordFieldValue = (k: string, v: unknown): v is string[] =>\n  Array.isArray(v) &&\n  recordFields.includes(k as (typeof recordFields)[number])\n\nexport type PairsAsRecords = ConfigOptionsNoExtras & {\n  command?: {\n    [k in keyof Commands]?: ConfigOptionsNoExtras\n  }\n}\n\nexport const pairsToRecords = (\n  obj:\n    | NonNullable<ConfigFileData>\n    | OptionsResults<ConfigDefinitions>,\n): PairsAsRecords => {\n  return Object.fromEntries(\n    Object.entries(obj).map(([k, v]) => [\n      k,\n      k === 'command' && v && typeof v === 'object' ?\n        Object.fromEntries(\n          Object.entries(v).map(([k, v]) => [\n            k,\n            pairsToRecords(v as NonNullable<ConfigFileData>),\n          ]),\n        )\n      : isRecordFieldValue(k, v) ? reducePairs(v)\n      : v,\n    ]),\n    // hard cast because TS can't see through the entries/fromEntries\n  ) as unknown as PairsAsRecords\n}\n\nexport const recordsToPairs = (obj: RecordPairs): RecordPairs => {\n  return Object.fromEntries(\n    Object.entries(obj)\n      .filter(\n        ([k]) =>\n          !(\n            k === 'scurry' ||\n            k === 'packageJson' ||\n            k === 'monorepo' ||\n            k === 'projectRoot' ||\n            k === 'packageInfo'\n          ),\n      )\n      .map(([k, v]) => [\n        k,\n        k === 'command' && v && typeof v === 'object' ?\n          recordsToPairs(v as RecordPairs)\n        : (\n          !v ||\n          typeof v !== 'object' ||\n          Array.isArray(v) ||\n          !isRecordField(k)\n        ) ?\n          v\n        : Object.entries(v).map(([k, v]) => `${k}=${v}`),\n      ]),\n  )\n}\n\nconst kRecord = Symbol('parsed key=value record')\n\nexport type ConfigDataNoCommand = {\n  [k in keyof OptionsResults<ConfigDefinitions>]?: OptionsResults<ConfigDefinitions>[k]\n}\n\n/**\n * Config data can be any options, and also a 'command' field which\n * contains command names and override options for that command.\n */\nexport type ConfigData = ConfigDataNoCommand & {\n  command?: {\n    [k in keyof Commands]?: ConfigDataNoCommand\n  }\n}\n\nexport type ConfigFileDataNoCommand = {\n  [k in keyof ConfigDataNoCommand]: k extends (\n    OptListKeys<ConfigDataNoCommand>\n  ) ?\n    RecordString | string[]\n  : ConfigDataNoCommand[k]\n}\n\n/**\n * Config data as it appears in the config field of the vlt.json, with kv pair\n * lists stored as `Record<string, string>` and\n */\nexport type ConfigFileData = ConfigFileDataNoCommand & {\n  command?: {\n    [k in keyof Commands]?: ConfigFileDataNoCommand\n  }\n}\n\nexport type ConfigOptionsNoExtras = {\n  [k in keyof OptionsResults<ConfigDefinitions>]: k extends (\n    RecordField\n  ) ?\n    RecordString\n  : k extends 'command' ? never\n  : OptionsResults<ConfigDefinitions>[k]\n}\n\nexport type ConfigOptions = ConfigOptionsNoExtras &\n  Pick<SpecOptions, 'catalog' | 'catalogs'> & {\n    packageJson: PackageJson\n    scurry: PathScurry\n    projectRoot: string\n    monorepo?: Monorepo\n    packageInfo: PackageInfoClient\n  }\n\n/**\n * The base config definition set as a type\n */\nexport type ConfigDefinitions = Unwrap<typeof definition>\n\nexport type StringListKeys<O> = {\n  [k in keyof O]: O[k] extends string[] | undefined ? k : never\n}\nexport type OptListKeys<O> = Exclude<\n  StringListKeys<O>[keyof StringListKeys<O>],\n  undefined\n>\n\n/**\n * Class that handles configuration for vlt.\n *\n * Call {@link Config.load} to get one of these.\n */\nexport class Config {\n  /**\n   * The {@link https://npmjs.com/jackspeak | JackSpeak} object\n   * representing vlt's configuration\n   */\n  jack: Jack<ConfigDefinitions>\n\n  /**\n   * Parsed values in effect\n   */\n  values?: OptionsResults<ConfigDefinitions>\n\n  /**\n   * Command-specific config values\n   */\n  commandValues: {\n    [cmd in Commands[keyof Commands]]?: ConfigData\n  } = {}\n\n  /**\n   * A flattened object of the parsed configuration\n   */\n  get options(): ConfigOptions {\n    if (this.#options) return this.#options\n    const scurry = new PathScurry(this.projectRoot)\n    const packageJson = new PackageJson()\n    const asRecords = pairsToRecords(this.parse().values)\n    const extras = {\n      projectRoot: this.projectRoot,\n      scurry,\n      packageJson,\n      monorepo: Monorepo.maybeLoad(this.projectRoot, {\n        scurry,\n        packageJson,\n        load: {\n          paths: asRecords.workspace,\n          groups: asRecords['workspace-group'],\n        },\n      }),\n      catalog: load<Record<string, string>>(\n        'catalog',\n        assertRecordStringString,\n      ),\n      catalogs: load<Record<string, Record<string, string>>>(\n        'catalogs',\n        o =>\n          assertRecordStringT(\n            o,\n            isRecordStringString,\n            'Record<string, Record<string, string>>',\n          ),\n      ),\n    }\n\n    const options: Omit<ConfigOptions, 'packageInfo'> = Object.assign(\n      asRecords,\n      extras,\n    )\n\n    this.#options = Object.assign(options, {\n      packageInfo: new PackageInfoClient(options),\n      [kCustomInspect]() {\n        return Object.fromEntries(\n          Object.entries(options).filter(\n            ([k]) =>\n              k !== 'monorepo' &&\n              k !== 'scurry' &&\n              k !== 'packageJson' &&\n              k !== 'packageInfo',\n          ),\n        )\n      },\n    })\n    return this.#options\n  }\n\n  /**\n   * Reset the options value, optionally setting a new project root\n   * to recalculate the options.\n   */\n  resetOptions(projectRoot: string = process.cwd()) {\n    this.projectRoot = projectRoot\n    this.#options = undefined\n  }\n\n  // memoized options() getter value\n  #options?: ConfigOptions\n\n  /**\n   * positional arguments to the vlt process\n   */\n  positionals?: string[]\n\n  /**\n   * Original arguments used for parsing (stored for reload purposes)\n   * @internal\n   */\n  #originalArgs?: string[]\n\n  /**\n   * The root of the project where a vlt.json, vlt.json,\n   * package.json, or .git was found. Not necessarily the `process.cwd()`,\n   * though that is the default location.\n   *\n   * Never walks up as far as `$HOME`. So for example, if a project is in\n   * `~/projects/xyz`, then the highest dir it will check is `~/projects`\n   */\n  projectRoot: string\n\n  /**\n   * `Record<alias, canonical name>` to dereference command aliases.\n   */\n  commands: Commands\n\n  /**\n   * Which command name to use for overriding with command-specific values,\n   * determined from the argv when parse() is called.\n   */\n  command?: Commands[keyof Commands]\n\n  constructor(\n    jack: Jack<ConfigDefinitions> = definition,\n    projectRoot = process.cwd(),\n  ) {\n    this.projectRoot = projectRoot\n    this.commands = commands\n    this.jack = jack\n  }\n\n  /**\n   * Parse the arguments and set configuration and positionals accordingly.\n   */\n  parse(args: string[] = process.argv): this & ParsedConfig {\n    if (isParsed(this)) return this\n\n    // Store the original args for potential reload\n    this.#originalArgs = [...args]\n\n    this.jack.loadEnvDefaults()\n    const p = this.jack.parseRaw(args)\n\n    const fallback = getCommand(p.values['fallback-command'])\n    this.command = getCommand(p.positionals[0])\n\n    const cmdOrFallback = this.command ?? fallback\n    const cmdSpecific =\n      cmdOrFallback && this.commandValues[cmdOrFallback]\n    if (cmdSpecific) {\n      this.jack.setConfigValues(recordsToPairs(cmdSpecific))\n    }\n\n    // ok, applied cmd-specific defaults, do rest of the parse\n    this.jack.applyDefaults(p)\n    this.jack.writeEnv(p)\n\n    if (this.command) p.positionals.shift()\n    else this.command = getCommand(p.values['fallback-command'])\n\n    Object.assign(this, p)\n\n    /* c8 ignore start - unpossible */\n    if (!isParsed(this)) throw error('failed to parse config')\n    /* c8 ignore stop */\n\n    return this\n  }\n\n  /**\n   * Get a `key=value` list option value as an object.\n   *\n   * For example, a list option with a vlaue of `['key=value', 'xyz=as=df' ]`\n   * would be returned as `{key: 'value', xyz: 'as=df'}`\n   *\n   * Results are memoized, so subsequent calls for the same key will return the\n   * same object. If new strings are added to the list, then the memoized value\n   * is *not* updated, so only use once configurations have been fully loaded.\n   *\n   * If the config value is not set at all, an empty object is returned.\n   */\n  getRecord(k: OptListKeys<ConfigData>): RecordString {\n    const pairs = this.get(k) as\n      | (string[] & { [kRecord]?: RecordString })\n      | undefined\n    if (!pairs) return {}\n    if (pairs[kRecord]) return pairs[kRecord]\n    const kv = pairs.reduce((kv: RecordString, pair) => {\n      const eq = pair.indexOf('=')\n      if (eq === -1) return kv\n      const key = pair.substring(0, eq)\n      const val = pair.substring(eq + 1)\n      kv[key] = val\n      return kv\n    }, {})\n    Object.assign(pairs, { [kRecord]: kv })\n    return kv\n  }\n\n  /**\n   * Get a configuration value.\n   *\n   * Note: `key=value` pair configs are returned as a string array. To get them\n   * as an object, use {@link Config#getRecord}.\n   */\n  get<K extends keyof OptionsResults<ConfigDefinitions>>(\n    k: K,\n  ): OptionsResults<ConfigDefinitions>[K] {\n    /* c8 ignore next -- impossible but TS doesn't know that */\n    return (this.values ?? this.parse().values)[k]\n  }\n\n  /**\n   * Write the config values to the user or project config file.\n   */\n  async writeConfigFile(\n    this: LoadedConfig,\n    which: WhichConfig,\n    values: NonNullable<ConfigFileData>,\n  ) {\n    save('config', pairsToRecords(values), which)\n    await this.#reloadConfig()\n  }\n\n  /**\n   * Fold in the provided fields with the existing properties\n   * in the config file.\n   */\n  async addConfigToFile(\n    this: LoadedConfig,\n    which: WhichConfig,\n    values: NonNullable<ConfigFileData>,\n  ) {\n    return this.writeConfigFile(\n      which,\n      merge((await this.#maybeLoadConfigFile(which)) ?? {}, values),\n    )\n  }\n\n  // called in this weird bound way so that it can be used by the\n  // vlt-json config loading module.\n  #validator: Validator<ConfigFileData> = function (\n    this: Config,\n    c: unknown,\n    file: string,\n  ) {\n    this.#validateConfig(c, file)\n  }.bind(this)\n\n  #validateConfig(\n    c: unknown,\n    file: string,\n  ): asserts c is ConfigFileData {\n    if (!c || typeof c !== 'object' || Array.isArray(c)) {\n      throw error('invalid config, expected object', {\n        path: file,\n        found: c,\n        wanted: 'ConfigFileData',\n      })\n    }\n\n    const { command, ...values } = recordsToPairs(c as RecordPairs)\n    if (command) {\n      for (const [c, opts] of Object.entries(command)) {\n        const cmd = getCommand(c)\n        if (cmd) {\n          this.commandValues[cmd] = merge<ConfigData>(\n            this.commandValues[cmd] ?? ({} as ConfigData),\n            opts as ConfigData,\n          )\n        }\n      }\n    }\n    this.jack.setConfigValues(values, file)\n  }\n\n  /**\n   * if the file exists, parse and load it. returns object if data was\n   * loaded, or undefined if not.\n   */\n  async #maybeLoadConfigFile(whichConfig: WhichConfig) {\n    return load('config', this.#validator, whichConfig)\n  }\n\n  /**\n   * Deletes the specified config fields from the named file\n   * Returns `true` if anything was changed.\n   */\n  async deleteConfigKeys(\n    this: LoadedConfig,\n    which: WhichConfig,\n    fields: string[],\n  ) {\n    const data = await this.#maybeLoadConfigFile(which)\n    if (!data) return false\n    let didSomething = false\n    for (const f of fields) {\n      const [key, ...sk] = f.split('.') as [\n        h: string,\n        ...rest: string[],\n      ]\n      const subs = sk.join('.')\n      const k = key as keyof ConfigDefinitions\n      const v = data[k]\n      if (v === undefined) continue\n      if (subs && v && typeof v === 'object') {\n        if (Array.isArray(v)) {\n          const i = v.findIndex(subvalue =>\n            subvalue.startsWith(`${subs}=`),\n          )\n          if (i !== -1) {\n            if (v.length === 1) delete data[k]\n            else v.splice(i, 1)\n            didSomething = true\n          }\n        } else {\n          if (v[subs] !== undefined) {\n            delete v[subs]\n            if (Object.keys(v).length === 0) delete data[k]\n            didSomething = true\n          }\n        }\n      } else {\n        didSomething = true\n        delete data[k]\n      }\n    }\n    if (didSomething) await this.writeConfigFile(which, data)\n    return didSomething\n  }\n\n  /**\n   * Edit the user or project configuration file.\n   *\n   * If the file isn't present, then it starts with `{}` so the user has\n   * something to work with.\n   *\n   * If the result is not valid, or no config settings are contained in the\n   * file after editing, then it's restored to what it was before, which might\n   * mean deleting the file.\n   */\n  async editConfigFile(\n    this: LoadedConfig,\n    which: WhichConfig,\n    edit: (file: string) => Promise<void> | void,\n  ) {\n    // load the file as a backup\n    // call the edit function\n    // reload it\n    const file = find(which)\n    const backup = await readFile(file, 'utf8').catch(() => undefined)\n    if (!backup) {\n      await writeFile(\n        file,\n        JSON.stringify({ config: {} }, null, 2) + '\\n',\n      )\n    }\n    let valid = false\n    try {\n      await edit(file)\n      // force it to reload the file and validate it again\n      // if this fails, we roll back.\n      const result = reload('config', which)\n      save('config', result ?? {}, which)\n      valid = true\n    } finally {\n      if (!valid) {\n        // TODO: maybe write the file to a re-edit backup location?\n        // then you could do `vlt config edit retry` or something.\n        if (backup) {\n          await writeFile(file, backup)\n          reload(which)\n        } else {\n          await rm(file, { force: true })\n        }\n      }\n    }\n  }\n\n  /**\n   * Find the local config file and load both it and the user-level config in\n   * the XDG config home.\n   */\n  async loadConfigFile(): Promise<this> {\n    await this.#maybeLoadConfigFile('user')\n    this.projectRoot = dirname(find('project', this.projectRoot))\n    await this.#maybeLoadConfigFile('project')\n    return this\n  }\n\n  /**\n   * Clear cached config values to force re-reading from updated files.\n   * @internal\n   */\n  async #reloadConfig() {\n    // Clear the memoized options to force recalculation\n    this.#options = undefined\n  }\n\n  /**\n   * Force a complete reload of config files from disk.\n   * This clears all caches and re-reads config files.\n   * Useful for long-running processes that need to pick up config changes.\n   */\n  async reloadFromDisk(): Promise<void> {\n    // Clear the memoized options to force recalculation\n    this.#options = undefined\n\n    // Clear the parsed state to force re-parsing\n    // This is crucial because parse() returns early if already parsed\n    this.values = undefined\n    this.positionals = undefined\n    this.command = undefined\n\n    // Clear vlt-json caches for both user and project configs\n    // This ensures that the next time config files are read, they'll be re-read from disk\n    const { unload } = await import('@vltpkg/vlt-json')\n    unload('user')\n    unload('project')\n\n    // Force reload of config files by calling the load methods again\n    // This will re-read the files and re-apply them to the jack parser\n    await this.#maybeLoadConfigFile('user')\n    await this.#maybeLoadConfigFile('project')\n\n    // Re-parse to pick up the updated config values using the original arguments\n    this.parse(this.#originalArgs)\n  }\n\n  /**\n   * cache of the loaded config\n   */\n  static #loaded: LoadedConfig | undefined\n\n  /**\n   * Load the configuration and return a Promise to a\n   * {@link Config} object\n   */\n  static async load(\n    projectRoot = process.cwd(),\n    argv = process.argv,\n    /**\n     * only used in tests, resets the memoization\n     * @internal\n     */\n    reload = false,\n  ): Promise<LoadedConfig> {\n    if (this.#loaded && !reload) return this.#loaded\n    const a = new Config(definition, projectRoot)\n    const b = await a.loadConfigFile()\n    this.#loaded = b.parse(argv) as LoadedConfig\n    return this.#loaded\n  }\n}\n\nconst isParsed = (c: Config): c is ParsedConfig =>\n  !!(c.values && c.positionals && c.command)\n\nexport type ParsedConfig = Config & {\n  command: NonNullable<Config['command']>\n  values: OptionsResults<ConfigDefinitions>\n  positionals: string[]\n}\n\n/**\n * A fully loaded {@link Config} object\n */\nexport type LoadedConfig = ParsedConfig\n"]}

package/dist/esm/exec-command.d.ts

@@ -2,9 +2,8 @@
  * impl for `vlt run`, `vlt run-exec`, `vlt exec-local`, `vlt exec`
  * @module
  */
+import type { NormalizedManifest } from '@vltpkg/types';
 import type { exec, execFG, ExecOptions, run, runExec, runExecFG, RunExecOptions, runFG, RunFGResult, RunOptions, RunResult } from '@vltpkg/run';
-import type { Workspace } from '@vltpkg/workspaces';
-import { Monorepo } from '@vltpkg/workspaces';
 import type { LoadedConfig } from './config/index.ts';
 export type RunnerBG = typeof exec | typeof run | typeof runExec;
 export type RunnerFG = typeof execFG | typeof runExecFG | typeof runFG;
@@ -19,36 +18,35 @@ export declare const views: {
 };
 type ViewValues = 'human' | 'json' | 'inspect' | 'silent';
 export declare class ExecCommand<B extends RunnerBG, F extends RunnerFG> {
+    #private;
     bg: B;
     fg: F;
     arg0?: string;
     args: string[];
-    monorepo?: Monorepo;
-    /** how many places are we doing things in? */
-    spaces?: number;
     conf: LoadedConfig;
     projectRoot: string;
     view: ViewValues;
     validViewValues: Map<string, ViewValues>;
     constructor(conf: LoadedConfig, bg: B, fg: F);
-    hasMonorepo(): this is this & {
-        monorepo: Monorepo;
-    };
     hasArg0(): this is this & {
         arg0: string;
     };
     run(): Promise<ExecResult>;
-    printResult(ws: Workspace, result: RunResult): void;
+    printResult(path: string, result: RunResult): void;
     interactiveShell(): string;
     defaultArg0(): string | undefined;
+    getCwd(): string;
     fgArg(): RunnerOptions | undefined;
     bgArg(this: this & {
         arg0: string;
-    }, ws: Workspace): RunnerOptions;
+    }, cwd: string): RunnerOptions;
     noArgsSingle(): ScriptSet;
-    noArgsMulti(this: this & {
-        monorepo: Monorepo;
-    }): MultiScriptSet;
+    noArgsMulti(): MultiScriptSet;
+    getTargets(): {
+        label: string;
+        cwd: string;
+        manifest: NormalizedManifest;
+    }[];
 }
 export {};
 //# sourceMappingURL=exec-command.d.ts.map

package/dist/esm/exec-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exec-command.d.ts","sourceRoot":"","sources":["../../src/exec-command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,IAAI,EACJ,MAAM,EACN,WAAW,EACX,GAAG,EACH,OAAO,EACP,SAAS,EACT,cAAc,EACd,KAAK,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACV,MAAM,aAAa,CAAA;AAIpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIrD,MAAM,MAAM,QAAQ,GAAG,OAAO,IAAI,GAAG,OAAO,GAAG,GAAG,OAAO,OAAO,CAAA;AAChE,MAAM,MAAM,QAAQ,GAAG,OAAO,MAAM,GAAG,OAAO,SAAS,GAAG,OAAO,KAAK,CAAA;AACtE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,CAAA;AACrE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AACtD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAC9C,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AACtD,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,cAAc,GACd,SAAS,GACT,cAAc,CAAA;AA6BlB,eAAO,MAAM,KAAK;;;CAeoB,CAAA;AAEtC,KAAK,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEzD,qBAAa,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ;IAC7D,EAAE,EAAE,CAAC,CAAA;IACL,EAAE,EAAE,CAAC,CAAA;IACL,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,UAAU,CAAA;IAChB,eAAe,0BAKb;gBAEU,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAc5C,WAAW,IAAI,IAAI,IAAI,IAAI,GAAG;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE;IAIpD,OAAO,IAAI,IAAI,IAAI,IAAI,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAIpC,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;IA8FhC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS;IA0B5C,gBAAgB,IAAI,MAAM;IAU1B,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,KAAK,IAAI,aAAa,GAAG,SAAS;IAoBlC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,EAAE,SAAS,GAAG,aAAa;IAclE,YAAY,IAAI,SAAS;IAKzB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAAG,cAAc;CAKjE"}
+{"version":3,"file":"exec-command.d.ts","sourceRoot":"","sources":["../../src/exec-command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EACV,IAAI,EACJ,MAAM,EACN,WAAW,EACX,GAAG,EACH,OAAO,EACP,SAAS,EACT,cAAc,EACd,KAAK,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACV,MAAM,aAAa,CAAA;AAMpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAOrD,MAAM,MAAM,QAAQ,GAAG,OAAO,IAAI,GAAG,OAAO,GAAG,GAAG,OAAO,OAAO,CAAA;AAChE,MAAM,MAAM,QAAQ,GAAG,OAAO,MAAM,GAAG,OAAO,SAAS,GAAG,OAAO,KAAK,CAAA;AACtE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,CAAA;AACrE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AACtD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAC9C,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AACtD,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,cAAc,GACd,SAAS,GACT,cAAc,CAAA;AA6BlB,eAAO,MAAM,KAAK;;;CAeoB,CAAA;AAEtC,KAAK,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEzD,qBAAa,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ;;IAC7D,EAAE,EAAE,CAAC,CAAA;IACL,EAAE,EAAE,CAAC,CAAA;IACL,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,EAAE,CAAA;IAGd,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,UAAU,CAAA;IAChB,eAAe,0BAKb;gBAEU,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAmB5C,OAAO,IAAI,IAAI,IAAI,IAAI,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAIpC,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;IAgHhC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS;IA0B3C,gBAAgB,IAAI,MAAM;IAU1B,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,MAAM,IAAI,MAAM;IAYhB,KAAK,IAAI,aAAa,GAAG,SAAS;IAmBlC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa;IAchE,YAAY,IAAI,SAAS;IAKzB,WAAW,IAAI,cAAc;IAM7B,UAAU,IAAI;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,EAAE,MAAM,CAAA;QACX,QAAQ,EAAE,kBAAkB,CAAA;KAC7B,EAAE;CAsBJ"}

package/dist/esm/exec-command.js

@@ -10,6 +10,8 @@ import { isRunResult } from '@vltpkg/run';
 import { Monorepo } from '@vltpkg/workspaces';
 import { ansiToAnsi } from 'ansi-to-pre';
 import { stderr, stdout, styleTextStdout } from "./output.js";
+import assert from 'node:assert';
+import { resolve } from 'node:path';
 const isScriptSet = (o) => {
     if (!o || typeof o !== 'object')
         return false;
@@ -38,8 +40,8 @@ export const views = {
             stdout('Scripts available:', result);
         else if (isMultiScriptSet(result)) {
             stdout('Scripts available:');
-            for (const [wsPath, scripts] of Object.entries(result)) {
-                stdout(wsPath, scripts);
+            for (const [path, scripts] of Object.entries(result)) {
+                stdout(path, scripts);
             }
         }
     },
@@ -52,9 +54,8 @@ export class ExecCommand {
     fg;
     arg0;
     args;
-    monorepo;
-    /** how many places are we doing things in? */
-    spaces;
+    #monorepo;
+    #nodes;
     conf;
     projectRoot;
     view;
@@ -74,8 +75,10 @@ export class ExecCommand {
         this.args = args;
         this.projectRoot = projectRoot;
     }
-    hasMonorepo() {
-        return !!this.monorepo;
+    #targetCount() {
+        if (this.#nodes)
+            return this.#nodes.length;
+        return this.#monorepo?.size ?? 1;
     }
     hasArg0() {
         return !!this.arg0;
@@ -99,33 +102,27 @@ export class ExecCommand {
             const { nodes } = await query.search(queryString, {
                 signal: new AbortController().signal,
             });
-            const importerPaths = nodes
-                .filter(n => n.importer)
-                .map(n => n.location)
-                .filter(v => v !== undefined);
-            this.monorepo =
-                importerPaths.length ?
-                    Monorepo.load(this.projectRoot, {
-                        load: {
-                            paths: importerPaths,
-                        },
-                    })
-                    : undefined;
-            this.spaces = this.monorepo?.size ?? 0;
+            this.#nodes = [];
+            for (const node of nodes) {
+                const { location } = node.toJSON();
+                assert(location, error(`node ${node.id} has no location`, {
+                    found: node,
+                }));
+                this.#nodes.push(location);
+            }
         }
         else {
             const paths = conf.get('workspace');
             const groups = conf.get('workspace-group');
             const recursive = conf.get('recursive');
-            this.monorepo =
+            this.#monorepo =
                 paths?.length || groups?.length || recursive ?
                     Monorepo.load(this.projectRoot, {
                         load: { paths, groups },
                     })
                     : undefined;
-            this.spaces = this.monorepo?.size ?? 1;
         }
-        if (this.spaces === 1) {
+        if (this.#targetCount() === 1) {
             const arg = this.fgArg();
             if (!arg)
                 return this.noArgsSingle();
@@ -135,48 +132,70 @@ export class ExecCommand {
             }
             return result;
         }
-        if (!this.hasMonorepo() || this.spaces === 0) {
-            throw error('no matching workspaces found', {
-                /* c8 ignore next - already guarded */
-                validOptions: [...(this.monorepo?.load().paths() ?? [])],
-            });
+        if (this.#targetCount() === 0) {
+            if (queryString) {
+                throw error('no matching nodes found for query', {
+                    found: queryString,
+                });
+            }
+            else {
+                throw error('no matching workspaces found', {
+                    /* c8 ignore next - already guarded */
+                    validOptions: [...(this.#monorepo?.load().paths() ?? [])],
+                });
+            }
         }
         if (!this.hasArg0()) {
             return this.noArgsMulti();
         }
         // run across workspaces
         let failed = false;
-        const resultMap = await this.monorepo.run(async (ws) => {
-            const result = await this.bg(this.bgArg(ws)).catch((er) => {
+        const runInDir = async (cwd, label) => {
+            const result = await this.bg(this.bgArg(cwd)).catch((er) => {
                 if (isErrorWithCause(er) && isRunResult(er.cause)) {
-                    this.printResult(ws, er.cause);
+                    this.printResult(label, er.cause);
                 }
                 failed = true;
                 throw er;
             });
             if (!failed)
-                this.printResult(ws, result);
+                this.printResult(label, result);
             return result;
-        });
+        };
+        const resultMap = new Map();
+        if (this.#nodes) {
+            for (const { label, cwd } of this.getTargets()) {
+                const result = await runInDir(cwd, label);
+                resultMap.set(label, result);
+            }
+        }
+        else if (this.#monorepo) {
+            const wsResultMap = await this.#monorepo.run(async (ws) => {
+                return runInDir(ws.fullpath, ws.path);
+            });
+            for (const [ws, result] of wsResultMap) {
+                resultMap.set(ws.path, result);
+            }
+        }
         const results = {};
-        for (const [ws, result] of resultMap) {
+        for (const [path, result] of resultMap) {
             if (result.status === 0 && result.signal === null) {
                 result.stdout = '';
                 result.stderr = '';
             }
-            results[ws.path] = result;
+            results[path] = result;
         }
         return results;
     }
-    printResult(ws, result) {
+    printResult(path, result) {
         // non-human results just get printed at the end
         if (this.view !== 'human')
             return;
         if (result.status === 0 && result.signal === null) {
-            stdout(ws.path, 'ok');
+            stdout(path, 'ok');
         }
         else {
-            stdout(styleTextStdout(['bgWhiteBright', 'black', 'bold'], ws.path + ' failure'), {
+            stdout(styleTextStdout(['bgWhiteBright', 'black', 'bold'], path + ' failure'), {
                 status: result.status,
                 signal: result.signal,
             });
@@ -200,9 +219,17 @@ export class ExecCommand {
     defaultArg0() {
         return this.interactiveShell();
     }
+    getCwd() {
+        if (this.#nodes) {
+            const [first] = this.#nodes;
+            assert(first, error('no nodes found'));
+            return resolve(this.projectRoot, first);
+        }
+        return (this.#monorepo?.values().next().value?.fullpath ??
+            this.projectRoot);
+    }
     fgArg() {
-        const ws = this.monorepo?.values().next().value;
-        const cwd = ws?.fullpath ?? this.projectRoot;
+        const cwd = this.getCwd();
         const arg0 = this.arg0 ?? this.defaultArg0();
         // return undefined so noArgsSingle will be called instead
         if (typeof arg0 !== 'string')
@@ -213,19 +240,19 @@ export class ExecCommand {
             arg0,
             args: this.args,
             projectRoot: this.projectRoot,
-            packageJson: this.monorepo?.packageJson,
+            packageJson: this.conf.options.packageJson,
             'script-shell': this.arg0 ? this.conf.get('script-shell') : false,
         };
     }
-    bgArg(ws) {
+    bgArg(cwd) {
         return {
-            cwd: ws.fullpath,
+            cwd,
             acceptFail: !this.conf.get('bail'),
             ignoreMissing: true,
             arg0: this.arg0,
             args: this.args,
             projectRoot: this.projectRoot,
-            packageJson: this.monorepo?.packageJson,
+            packageJson: this.conf.options.packageJson,
             'script-shell': this.conf.get('script-shell'),
         };
     }
@@ -237,5 +264,28 @@ export class ExecCommand {
     noArgsMulti() {
         throw error('Cannot spawn interactive shells in multiple workspaces');
     }
+    getTargets() {
+        const targets = [];
+        if (this.#nodes) {
+            for (const location of this.#nodes) {
+                const manifest = this.conf.options.packageJson.read(location);
+                const label = 
+                /* c8 ignore next */
+                location.startsWith('./') ? location.slice(2) : location;
+                const cwd = resolve(this.projectRoot, location);
+                targets.push({ label, cwd, manifest });
+            }
+        }
+        else if (this.#monorepo) {
+            this.#monorepo.runSync(ws => {
+                targets.push({
+                    label: ws.path,
+                    cwd: ws.fullpath,
+                    manifest: ws.manifest,
+                });
+            });
+        }
+        return targets;
+    }
 }
 //# sourceMappingURL=exec-command.js.map

package/dist/esm/exec-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"exec-command.js","sourceRoot":"","sources":["../../src/exec-command.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * impl for `vlt run`, `vlt run-exec`, `vlt exec-local`, `vlt exec`\n * @module\n */\n\nimport { error } from '@vltpkg/error-cause'\nimport { isErrorWithCause } from '@vltpkg/types'\nimport type {\n  exec,\n  execFG,\n  ExecOptions,\n  run,\n  runExec,\n  runExecFG,\n  RunExecOptions,\n  runFG,\n  RunFGResult,\n  RunOptions,\n  RunResult,\n} from '@vltpkg/run'\nimport { Query } from '@vltpkg/query'\nimport { actual } from '@vltpkg/graph'\nimport { isRunResult } from '@vltpkg/run'\nimport type { Workspace } from '@vltpkg/workspaces'\nimport { Monorepo } from '@vltpkg/workspaces'\nimport { ansiToAnsi } from 'ansi-to-pre'\nimport type { LoadedConfig } from './config/index.ts'\nimport { stderr, stdout, styleTextStdout } from './output.ts'\nimport type { Views } from './view.ts'\n\nexport type RunnerBG = typeof exec | typeof run | typeof runExec\nexport type RunnerFG = typeof execFG | typeof runExecFG | typeof runFG\nexport type RunnerOptions = ExecOptions & RunExecOptions & RunOptions\nexport type MultiRunResult = Record<string, RunResult>\nexport type ScriptSet = Record<string, string>\nexport type MultiScriptSet = Record<string, ScriptSet>\nexport type ExecResult =\n  | RunFGResult\n  | MultiRunResult\n  | ScriptSet\n  | MultiScriptSet\n\nconst isScriptSet = (o: unknown): o is ScriptSet => {\n  if (!o || typeof o !== 'object') return false\n  for (const v of Object.values(o)) {\n    if (typeof v !== 'string') return false\n  }\n  return true\n}\n\nconst isMultiScriptSet = (\n  o: ExecResult,\n): o is Record<string, ScriptSet> => {\n  for (const v of Object.values(o)) {\n    if (!isScriptSet(v)) return false\n  }\n  return true\n}\n\nconst isSingleSuccess = (\n  o: RunResult,\n): o is RunResult & { status: 0; signal: null } =>\n  o.signal === null && o.status === 0\n\nconst setExitCode = (result: RunResult) => {\n  /* c8 ignore next */\n  process.exitCode = process.exitCode || (result.status ?? 1)\n}\n\nexport const views = {\n  // run results for single or multiple will be printed along the way.\n  human: result => {\n    if (isScriptSet(result)) stdout('Scripts available:', result)\n    else if (isMultiScriptSet(result)) {\n      stdout('Scripts available:')\n      for (const [wsPath, scripts] of Object.entries(result)) {\n        stdout(wsPath, scripts)\n      }\n    }\n  },\n  json: result =>\n    isRunResult(result) && isSingleSuccess(result) ?\n      undefined\n    : result,\n} as const satisfies Views<ExecResult>\n\ntype ViewValues = 'human' | 'json' | 'inspect' | 'silent'\n\nexport class ExecCommand<B extends RunnerBG, F extends RunnerFG> {\n  bg: B\n  fg: F\n  arg0?: string\n  args: string[]\n  monorepo?: Monorepo\n  /** how many places are we doing things in? */\n  spaces?: number\n  conf: LoadedConfig\n  projectRoot: string\n  view: ViewValues\n  validViewValues = new Map<string, ViewValues>([\n    ['human', 'human'],\n    ['json', 'json'],\n    ['inspect', 'inspect'],\n    ['silent', 'silent'],\n  ])\n\n  constructor(conf: LoadedConfig, bg: B, fg: F) {\n    this.conf = conf\n    this.bg = bg\n    this.fg = fg\n    this.view = this.validViewValues.get(conf.values.view) ?? 'human'\n    const {\n      projectRoot,\n      positionals: [arg0, ...args],\n    } = conf\n    this.arg0 = arg0\n    this.args = args\n    this.projectRoot = projectRoot\n  }\n\n  hasMonorepo(): this is this & { monorepo: Monorepo } {\n    return !!this.monorepo\n  }\n\n  hasArg0(): this is this & { arg0: string } {\n    return !!this.arg0\n  }\n\n  async run(): Promise<ExecResult> {\n    const { conf } = this\n\n    const queryString = conf.get('scope')\n    // scope takes precedence over workspaces or groups\n    if (queryString) {\n      const graph = actual.load({\n        ...conf.options,\n        mainManifest: conf.options.packageJson.read(this.projectRoot),\n        monorepo: Monorepo.load(this.projectRoot),\n        loadManifests: false,\n      })\n      const query = new Query({\n        graph,\n        specOptions: conf.options,\n        securityArchive: undefined,\n      })\n      const { nodes } = await query.search(queryString, {\n        signal: new AbortController().signal,\n      })\n      const importerPaths = nodes\n        .filter(n => n.importer)\n        .map(n => n.location)\n        .filter(v => v !== undefined)\n      this.monorepo =\n        importerPaths.length ?\n          Monorepo.load(this.projectRoot, {\n            load: {\n              paths: importerPaths,\n            },\n          })\n        : undefined\n      this.spaces = this.monorepo?.size ?? 0\n    } else {\n      const paths = conf.get('workspace')\n      const groups = conf.get('workspace-group')\n      const recursive = conf.get('recursive')\n      this.monorepo =\n        paths?.length || groups?.length || recursive ?\n          Monorepo.load(this.projectRoot, {\n            load: { paths, groups },\n          })\n        : undefined\n      this.spaces = this.monorepo?.size ?? 1\n    }\n\n    if (this.spaces === 1) {\n      const arg = this.fgArg()\n      if (!arg) return this.noArgsSingle()\n      const result = await this.fg(arg)\n      if (isRunResult(result)) {\n        setExitCode(result)\n      }\n      return result\n    }\n\n    if (!this.hasMonorepo() || this.spaces === 0) {\n      throw error('no matching workspaces found', {\n        /* c8 ignore next - already guarded */\n        validOptions: [...(this.monorepo?.load().paths() ?? [])],\n      })\n    }\n\n    if (!this.hasArg0()) {\n      return this.noArgsMulti()\n    }\n\n    // run across workspaces\n    let failed = false\n    const resultMap = await this.monorepo.run(async ws => {\n      const result = await this.bg(this.bgArg(ws)).catch(\n        (er: unknown) => {\n          if (isErrorWithCause(er) && isRunResult(er.cause)) {\n            this.printResult(ws, er.cause)\n          }\n          failed = true\n          throw er\n        },\n      )\n      if (!failed) this.printResult(ws, result)\n      return result\n    })\n\n    const results: Record<string, RunResult> = {}\n    for (const [ws, result] of resultMap) {\n      if (result.status === 0 && result.signal === null) {\n        result.stdout = ''\n        result.stderr = ''\n      }\n      results[ws.path] = result\n    }\n    return results\n  }\n\n  printResult(ws: Workspace, result: RunResult) {\n    // non-human results just get printed at the end\n    if (this.view !== 'human') return\n\n    if (result.status === 0 && result.signal === null) {\n      stdout(ws.path, 'ok')\n    } else {\n      stdout(\n        styleTextStdout(\n          ['bgWhiteBright', 'black', 'bold'],\n          ws.path + ' failure',\n        ),\n        {\n          status: result.status,\n          signal: result.signal,\n        },\n      )\n      /* c8 ignore start */\n      if (result.stderr) stderr(ansiToAnsi(result.stderr))\n      if (result.stdout) stdout(ansiToAnsi(result.stdout))\n      /* c8 ignore stop */\n      setExitCode(result)\n    }\n  }\n\n  /* c8 ignore start - env specific */\n  interactiveShell(): string {\n    return (\n      process.env.SHELL ??\n      this.conf.get('script-shell') ??\n      (process.platform === 'win32' ? 'cmd.exe' : '/bin/sh')\n    )\n  }\n  /* c8 ignore stop */\n\n  // overridden by 'vlt run' which returns undefined\n  defaultArg0(): string | undefined {\n    return this.interactiveShell()\n  }\n\n  fgArg(): RunnerOptions | undefined {\n    const ws = this.monorepo?.values().next().value\n    const cwd = ws?.fullpath ?? this.projectRoot\n    const arg0 = this.arg0 ?? this.defaultArg0()\n\n    // return undefined so noArgsSingle will be called instead\n    if (typeof arg0 !== 'string') return\n\n    return {\n      cwd,\n      /* c8 ignore next - already guarded */\n      arg0,\n      args: this.args,\n      projectRoot: this.projectRoot,\n      packageJson: this.monorepo?.packageJson,\n      'script-shell':\n        this.arg0 ? this.conf.get('script-shell') : false,\n    }\n  }\n\n  bgArg(this: this & { arg0: string }, ws: Workspace): RunnerOptions {\n    return {\n      cwd: ws.fullpath,\n      acceptFail: !this.conf.get('bail'),\n      ignoreMissing: true,\n      arg0: this.arg0,\n      args: this.args,\n      projectRoot: this.projectRoot,\n      packageJson: this.monorepo?.packageJson,\n      'script-shell': this.conf.get('script-shell'),\n    }\n  }\n\n  /* c8 ignore start - not used, only here to override */\n  noArgsSingle(): ScriptSet {\n    throw error('Failed to determine interactive shell to spawn')\n  }\n  /* c8 ignore stop - not used, only here to override */\n\n  noArgsMulti(this: this & { monorepo: Monorepo }): MultiScriptSet {\n    throw error(\n      'Cannot spawn interactive shells in multiple workspaces',\n    )\n  }\n}\n"]}
+{"version":3,"file":"exec-command.js","sourceRoot":"","sources":["../../src/exec-command.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * impl for `vlt run`, `vlt run-exec`, `vlt exec-local`, `vlt exec`\n * @module\n */\n\nimport { error } from '@vltpkg/error-cause'\nimport { isErrorWithCause } from '@vltpkg/types'\nimport type { NormalizedManifest } from '@vltpkg/types'\nimport type {\n  exec,\n  execFG,\n  ExecOptions,\n  run,\n  runExec,\n  runExecFG,\n  RunExecOptions,\n  runFG,\n  RunFGResult,\n  RunOptions,\n  RunResult,\n} from '@vltpkg/run'\nimport { Query } from '@vltpkg/query'\nimport { actual } from '@vltpkg/graph'\nimport { isRunResult } from '@vltpkg/run'\nimport { Monorepo } from '@vltpkg/workspaces'\nimport { ansiToAnsi } from 'ansi-to-pre'\nimport type { LoadedConfig } from './config/index.ts'\nimport { stderr, stdout, styleTextStdout } from './output.ts'\nimport type { Views } from './view.ts'\nimport type { SpawnResultStdioStrings } from '@vltpkg/promise-spawn'\nimport assert from 'node:assert'\nimport { resolve } from 'node:path'\n\nexport type RunnerBG = typeof exec | typeof run | typeof runExec\nexport type RunnerFG = typeof execFG | typeof runExecFG | typeof runFG\nexport type RunnerOptions = ExecOptions & RunExecOptions & RunOptions\nexport type MultiRunResult = Record<string, RunResult>\nexport type ScriptSet = Record<string, string>\nexport type MultiScriptSet = Record<string, ScriptSet>\nexport type ExecResult =\n  | RunFGResult\n  | MultiRunResult\n  | ScriptSet\n  | MultiScriptSet\n\nconst isScriptSet = (o: unknown): o is ScriptSet => {\n  if (!o || typeof o !== 'object') return false\n  for (const v of Object.values(o)) {\n    if (typeof v !== 'string') return false\n  }\n  return true\n}\n\nconst isMultiScriptSet = (\n  o: ExecResult,\n): o is Record<string, ScriptSet> => {\n  for (const v of Object.values(o)) {\n    if (!isScriptSet(v)) return false\n  }\n  return true\n}\n\nconst isSingleSuccess = (\n  o: RunResult,\n): o is RunResult & { status: 0; signal: null } =>\n  o.signal === null && o.status === 0\n\nconst setExitCode = (result: RunResult) => {\n  /* c8 ignore next */\n  process.exitCode = process.exitCode || (result.status ?? 1)\n}\n\nexport const views = {\n  // run results for single or multiple will be printed along the way.\n  human: result => {\n    if (isScriptSet(result)) stdout('Scripts available:', result)\n    else if (isMultiScriptSet(result)) {\n      stdout('Scripts available:')\n      for (const [path, scripts] of Object.entries(result)) {\n        stdout(path, scripts)\n      }\n    }\n  },\n  json: result =>\n    isRunResult(result) && isSingleSuccess(result) ?\n      undefined\n    : result,\n} as const satisfies Views<ExecResult>\n\ntype ViewValues = 'human' | 'json' | 'inspect' | 'silent'\n\nexport class ExecCommand<B extends RunnerBG, F extends RunnerFG> {\n  bg: B\n  fg: F\n  arg0?: string\n  args: string[]\n  #monorepo?: Monorepo\n  #nodes?: string[]\n  conf: LoadedConfig\n  projectRoot: string\n  view: ViewValues\n  validViewValues = new Map<string, ViewValues>([\n    ['human', 'human'],\n    ['json', 'json'],\n    ['inspect', 'inspect'],\n    ['silent', 'silent'],\n  ])\n\n  constructor(conf: LoadedConfig, bg: B, fg: F) {\n    this.conf = conf\n    this.bg = bg\n    this.fg = fg\n    this.view = this.validViewValues.get(conf.values.view) ?? 'human'\n    const {\n      projectRoot,\n      positionals: [arg0, ...args],\n    } = conf\n    this.arg0 = arg0\n    this.args = args\n    this.projectRoot = projectRoot\n  }\n\n  #targetCount(): number {\n    if (this.#nodes) return this.#nodes.length\n    return this.#monorepo?.size ?? 1\n  }\n\n  hasArg0(): this is this & { arg0: string } {\n    return !!this.arg0\n  }\n\n  async run(): Promise<ExecResult> {\n    const { conf } = this\n\n    const queryString = conf.get('scope')\n    // scope takes precedence over workspaces or groups\n    if (queryString) {\n      const graph = actual.load({\n        ...conf.options,\n        mainManifest: conf.options.packageJson.read(this.projectRoot),\n        monorepo: Monorepo.load(this.projectRoot),\n        loadManifests: false,\n      })\n      const query = new Query({\n        graph,\n        specOptions: conf.options,\n        securityArchive: undefined,\n      })\n      const { nodes } = await query.search(queryString, {\n        signal: new AbortController().signal,\n      })\n      this.#nodes = []\n      for (const node of nodes) {\n        const { location } = node.toJSON()\n        assert(\n          location,\n          error(`node ${node.id} has no location`, {\n            found: node,\n          }),\n        )\n        this.#nodes.push(location)\n      }\n    } else {\n      const paths = conf.get('workspace')\n      const groups = conf.get('workspace-group')\n      const recursive = conf.get('recursive')\n      this.#monorepo =\n        paths?.length || groups?.length || recursive ?\n          Monorepo.load(this.projectRoot, {\n            load: { paths, groups },\n          })\n        : undefined\n    }\n\n    if (this.#targetCount() === 1) {\n      const arg = this.fgArg()\n      if (!arg) return this.noArgsSingle()\n      const result = await this.fg(arg)\n      if (isRunResult(result)) {\n        setExitCode(result)\n      }\n      return result\n    }\n\n    if (this.#targetCount() === 0) {\n      if (queryString) {\n        throw error('no matching nodes found for query', {\n          found: queryString,\n        })\n      } else {\n        throw error('no matching workspaces found', {\n          /* c8 ignore next - already guarded */\n          validOptions: [...(this.#monorepo?.load().paths() ?? [])],\n        })\n      }\n    }\n\n    if (!this.hasArg0()) {\n      return this.noArgsMulti()\n    }\n\n    // run across workspaces\n    let failed = false as boolean\n    const runInDir = async (cwd: string, label: string) => {\n      const result = await this.bg(this.bgArg(cwd)).catch(\n        (er: unknown) => {\n          if (isErrorWithCause(er) && isRunResult(er.cause)) {\n            this.printResult(label, er.cause)\n          }\n          failed = true\n          throw er\n        },\n      )\n      if (!failed) this.printResult(label, result)\n      return result\n    }\n\n    const resultMap = new Map<string, SpawnResultStdioStrings>()\n    if (this.#nodes) {\n      for (const { label, cwd } of this.getTargets()) {\n        const result = await runInDir(cwd, label)\n        resultMap.set(label, result)\n      }\n    } else if (this.#monorepo) {\n      const wsResultMap = await this.#monorepo.run(async ws => {\n        return runInDir(ws.fullpath, ws.path)\n      })\n      for (const [ws, result] of wsResultMap) {\n        resultMap.set(ws.path, result)\n      }\n    }\n\n    const results: Record<string, RunResult> = {}\n    for (const [path, result] of resultMap) {\n      if (result.status === 0 && result.signal === null) {\n        result.stdout = ''\n        result.stderr = ''\n      }\n      results[path] = result\n    }\n    return results\n  }\n\n  printResult(path: string, result: RunResult) {\n    // non-human results just get printed at the end\n    if (this.view !== 'human') return\n\n    if (result.status === 0 && result.signal === null) {\n      stdout(path, 'ok')\n    } else {\n      stdout(\n        styleTextStdout(\n          ['bgWhiteBright', 'black', 'bold'],\n          path + ' failure',\n        ),\n        {\n          status: result.status,\n          signal: result.signal,\n        },\n      )\n      /* c8 ignore start */\n      if (result.stderr) stderr(ansiToAnsi(result.stderr))\n      if (result.stdout) stdout(ansiToAnsi(result.stdout))\n      /* c8 ignore stop */\n      setExitCode(result)\n    }\n  }\n\n  /* c8 ignore start - env specific */\n  interactiveShell(): string {\n    return (\n      process.env.SHELL ??\n      this.conf.get('script-shell') ??\n      (process.platform === 'win32' ? 'cmd.exe' : '/bin/sh')\n    )\n  }\n  /* c8 ignore stop */\n\n  // overridden by 'vlt run' which returns undefined\n  defaultArg0(): string | undefined {\n    return this.interactiveShell()\n  }\n\n  getCwd(): string {\n    if (this.#nodes) {\n      const [first] = this.#nodes\n      assert(first, error('no nodes found'))\n      return resolve(this.projectRoot, first)\n    }\n    return (\n      this.#monorepo?.values().next().value?.fullpath ??\n      this.projectRoot\n    )\n  }\n\n  fgArg(): RunnerOptions | undefined {\n    const cwd = this.getCwd()\n    const arg0 = this.arg0 ?? this.defaultArg0()\n\n    // return undefined so noArgsSingle will be called instead\n    if (typeof arg0 !== 'string') return\n\n    return {\n      cwd,\n      /* c8 ignore next - already guarded */\n      arg0,\n      args: this.args,\n      projectRoot: this.projectRoot,\n      packageJson: this.conf.options.packageJson,\n      'script-shell':\n        this.arg0 ? this.conf.get('script-shell') : false,\n    }\n  }\n\n  bgArg(this: this & { arg0: string }, cwd: string): RunnerOptions {\n    return {\n      cwd,\n      acceptFail: !this.conf.get('bail'),\n      ignoreMissing: true,\n      arg0: this.arg0,\n      args: this.args,\n      projectRoot: this.projectRoot,\n      packageJson: this.conf.options.packageJson,\n      'script-shell': this.conf.get('script-shell'),\n    }\n  }\n\n  /* c8 ignore start - not used, only here to override */\n  noArgsSingle(): ScriptSet {\n    throw error('Failed to determine interactive shell to spawn')\n  }\n  /* c8 ignore stop - not used, only here to override */\n\n  noArgsMulti(): MultiScriptSet {\n    throw error(\n      'Cannot spawn interactive shells in multiple workspaces',\n    )\n  }\n\n  getTargets(): {\n    label: string\n    cwd: string\n    manifest: NormalizedManifest\n  }[] {\n    const targets = []\n    if (this.#nodes) {\n      for (const location of this.#nodes) {\n        const manifest = this.conf.options.packageJson.read(location)\n        const label =\n          /* c8 ignore next */\n          location.startsWith('./') ? location.slice(2) : location\n        const cwd = resolve(this.projectRoot, location)\n        targets.push({ label, cwd, manifest })\n      }\n    } else if (this.#monorepo) {\n      this.#monorepo.runSync(ws => {\n        targets.push({\n          label: ws.path,\n          cwd: ws.fullpath,\n          manifest: ws.manifest,\n        })\n      })\n    }\n    return targets\n  }\n}\n"]}

package/dist/esm/start-gui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-gui.d.ts","sourceRoot":"","sources":["../../src/start-gui.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,eAAO,MAAM,uBAAuB,YAAmB;IACrD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,UAAU,CAAA;CACnB,oBAYA,CAAA;AAaD,eAAO,MAAM,QAAQ,SACb,YAAY,kBACF,MAAM,gDAwBvB,CAAA"}
+{"version":3,"file":"start-gui.d.ts","sourceRoot":"","sources":["../../src/start-gui.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,eAAO,MAAM,uBAAuB,YAAmB;IACrD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,UAAU,CAAA;CACnB,oBAYA,CAAA;AAaD,eAAO,MAAM,QAAQ,SACb,YAAY,kBACF,MAAM,gDAyBvB,CAAA"}

package/dist/esm/start-gui.js

@@ -23,6 +23,7 @@ export const startGUI = async (conf, startingRoute) => {
     const server = createServer({
         ...conf.options,
         assetsDir: getAssetsDir(),
+        loadedConfig: conf,
     });
     server.on('needConfigUpdate', dir => {
         conf.resetOptions(dir);

package/dist/esm/start-gui.js.map

@@ -1 +1 @@
-{"version":3,"file":"start-gui.js","sourceRoot":"","sources":["../../src/start-gui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,QAAQ,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAKpC,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAAE,OAK7C,EAAE,EAAE;IACH,MAAM,EACJ,WAAW,GAAG,OAAO,EACrB,aAAa,EACb,WAAW,EACX,MAAM,GACP,GAAG,OAAO,CAAA;IACX,IAAI,aAAa;QAAE,OAAO,aAAa,CAAA;IACvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,eAAe,CAAC,CAAA;IAC9D,OAAO,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAC7C,YAAY,QAAQ,CAAC,6BAA6B,CAAC,WAAW,CAAC,WAAW;QAC5E,CAAC,CAAC,GAAG,CAAA;AACT,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,GAAG,EAAE;IACxB,qBAAqB;IACrB,IAAI,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;QAC9C,OAAO,OAAO,CACZ,MAAM,CAAC,IAAI,CAAC,OAAO,EACnB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAC1C,CAAA;IACH,CAAC;IACD,oBAAoB;AACtB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,IAAkB,EAClB,aAAsB,EACtB,EAAE;IACF,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,GAAG,IAAI,CAAC,OAAO;QACf,SAAS,EAAE,YAAY,EAAE;KAC1B,CAAC,CAAA;IACF,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,GAAG,CAAC,EAAE;QAClC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CACrB;QAAC,MAA6B,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;IACF,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAA;IAC5C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACpB,MAAM,CAAC,yBAAyB,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IACnD,KAAK,OAAO,CACV,MAAM,CAAC,OAAO,CACZ,MAAM,uBAAuB,CAAC;QAC5B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;QAC/B,aAAa;QACb,WAAW;QACX,MAAM;KACP,CAAC,CACH,CACF,CAAA;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA","sourcesContent":["import { resolve } from 'node:path'\nimport LZString from 'lz-string'\nimport { createServer } from '@vltpkg/server'\nimport { urlOpen } from '@vltpkg/url-open'\nimport { stdout } from './output.ts'\nimport type { PathScurry } from 'path-scurry'\nimport type { LoadedConfig } from './config/index.ts'\nimport type { VltServerListening } from '@vltpkg/server'\n\nexport const getDefaultStartingRoute = async (options: {\n  queryString?: string\n  startingRoute?: string\n  projectRoot: string\n  scurry: PathScurry\n}) => {\n  const {\n    queryString = ':root',\n    startingRoute,\n    projectRoot,\n    scurry,\n  } = options\n  if (startingRoute) return startingRoute\n  const stat = await scurry.lstat(`${projectRoot}/package.json`)\n  return stat?.isFile() && !stat.isSymbolicLink() ?\n      `/explore/${LZString.compressToEncodedURIComponent(queryString)}/overview`\n    : '/'\n}\n\nconst getAssetsDir = () => {\n  /* c8 ignore start */\n  if (process.env.__VLT_INTERNAL_GUI_ASSETS_DIR) {\n    return resolve(\n      import.meta.dirname,\n      process.env.__VLT_INTERNAL_GUI_ASSETS_DIR,\n    )\n  }\n  /* c8 ignore stop */\n}\n\nexport const startGUI = async (\n  conf: LoadedConfig,\n  startingRoute?: string,\n) => {\n  const server = createServer({\n    ...conf.options,\n    assetsDir: getAssetsDir(),\n  })\n  server.on('needConfigUpdate', dir => {\n    conf.resetOptions(dir)\n    ;(server as VltServerListening).updateOptions(conf.options)\n  })\n  const { projectRoot, scurry } = conf.options\n  await server.start()\n  stdout(`⚡️ vlt GUI running at ${server.address()}`)\n  void urlOpen(\n    server.address(\n      await getDefaultStartingRoute({\n        queryString: conf.values.target,\n        startingRoute,\n        projectRoot,\n        scurry,\n      }),\n    ),\n  )\n  return server\n}\n"]}
+{"version":3,"file":"start-gui.js","sourceRoot":"","sources":["../../src/start-gui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,QAAQ,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAKpC,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAAE,OAK7C,EAAE,EAAE;IACH,MAAM,EACJ,WAAW,GAAG,OAAO,EACrB,aAAa,EACb,WAAW,EACX,MAAM,GACP,GAAG,OAAO,CAAA;IACX,IAAI,aAAa;QAAE,OAAO,aAAa,CAAA;IACvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,eAAe,CAAC,CAAA;IAC9D,OAAO,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAC7C,YAAY,QAAQ,CAAC,6BAA6B,CAAC,WAAW,CAAC,WAAW;QAC5E,CAAC,CAAC,GAAG,CAAA;AACT,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,GAAG,EAAE;IACxB,qBAAqB;IACrB,IAAI,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;QAC9C,OAAO,OAAO,CACZ,MAAM,CAAC,IAAI,CAAC,OAAO,EACnB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAC1C,CAAA;IACH,CAAC;IACD,oBAAoB;AACtB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,IAAkB,EAClB,aAAsB,EACtB,EAAE;IACF,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,GAAG,IAAI,CAAC,OAAO;QACf,SAAS,EAAE,YAAY,EAAE;QACzB,YAAY,EAAE,IAAI;KACnB,CAAC,CAAA;IACF,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,GAAG,CAAC,EAAE;QAClC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CACrB;QAAC,MAA6B,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;IACF,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAA;IAC5C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACpB,MAAM,CAAC,yBAAyB,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IACnD,KAAK,OAAO,CACV,MAAM,CAAC,OAAO,CACZ,MAAM,uBAAuB,CAAC;QAC5B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;QAC/B,aAAa;QACb,WAAW;QACX,MAAM;KACP,CAAC,CACH,CACF,CAAA;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA","sourcesContent":["import { resolve } from 'node:path'\nimport LZString from 'lz-string'\nimport { createServer } from '@vltpkg/server'\nimport { urlOpen } from '@vltpkg/url-open'\nimport { stdout } from './output.ts'\nimport type { PathScurry } from 'path-scurry'\nimport type { LoadedConfig } from './config/index.ts'\nimport type { VltServerListening } from '@vltpkg/server'\n\nexport const getDefaultStartingRoute = async (options: {\n  queryString?: string\n  startingRoute?: string\n  projectRoot: string\n  scurry: PathScurry\n}) => {\n  const {\n    queryString = ':root',\n    startingRoute,\n    projectRoot,\n    scurry,\n  } = options\n  if (startingRoute) return startingRoute\n  const stat = await scurry.lstat(`${projectRoot}/package.json`)\n  return stat?.isFile() && !stat.isSymbolicLink() ?\n      `/explore/${LZString.compressToEncodedURIComponent(queryString)}/overview`\n    : '/'\n}\n\nconst getAssetsDir = () => {\n  /* c8 ignore start */\n  if (process.env.__VLT_INTERNAL_GUI_ASSETS_DIR) {\n    return resolve(\n      import.meta.dirname,\n      process.env.__VLT_INTERNAL_GUI_ASSETS_DIR,\n    )\n  }\n  /* c8 ignore stop */\n}\n\nexport const startGUI = async (\n  conf: LoadedConfig,\n  startingRoute?: string,\n) => {\n  const server = createServer({\n    ...conf.options,\n    assetsDir: getAssetsDir(),\n    loadedConfig: conf,\n  })\n  server.on('needConfigUpdate', dir => {\n    conf.resetOptions(dir)\n    ;(server as VltServerListening).updateOptions(conf.options)\n  })\n  const { projectRoot, scurry } = conf.options\n  await server.start()\n  stdout(`⚡️ vlt GUI running at ${server.address()}`)\n  void urlOpen(\n    server.address(\n      await getDefaultStartingRoute({\n        queryString: conf.values.target,\n        startingRoute,\n        projectRoot,\n        scurry,\n      }),\n    ),\n  )\n  return server\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vltpkg/cli-sdk",
   "description": "The source for the vlt CLI",
-  "version": "0.0.0-19",
+  "version": "0.0.0-20",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
@@ -37,29 +37,30 @@
     "ssri": "^12.0.0",
     "supports-color": "^10.0.0",
     "tar": "^7.4.3",
-    "@vltpkg/dot-prop": "0.0.0-19",
-    "@vltpkg/config": "0.0.0-19",
-    "@vltpkg/dep-id": "0.0.0-19",
-    "@vltpkg/git": "0.0.0-19",
-    "@vltpkg/error-cause": "0.0.0-19",
-    "@vltpkg/graph": "0.0.0-19",
-    "@vltpkg/init": "0.0.0-19",
-    "@vltpkg/output": "0.0.0-19",
-    "@vltpkg/package-info": "0.0.0-19",
-    "@vltpkg/package-json": "0.0.0-19",
-    "@vltpkg/query": "0.0.0-19",
-    "@vltpkg/registry-client": "0.0.0-19",
-    "@vltpkg/rollback-remove": "0.0.0-19",
-    "@vltpkg/run": "0.0.0-19",
-    "@vltpkg/server": "0.0.0-19",
-    "@vltpkg/security-archive": "0.0.0-19",
-    "@vltpkg/spec": "0.0.0-19",
-    "@vltpkg/types": "0.0.0-19",
-    "@vltpkg/vlx": "0.0.0-19",
-    "@vltpkg/url-open": "0.0.0-19",
-    "@vltpkg/vlt-json": "0.0.0-19",
-    "@vltpkg/workspaces": "0.0.0-19",
-    "@vltpkg/xdg": "0.0.0-19"
+    "@vltpkg/config": "0.0.0-20",
+    "@vltpkg/dep-id": "0.0.0-20",
+    "@vltpkg/dot-prop": "0.0.0-20",
+    "@vltpkg/error-cause": "0.0.0-20",
+    "@vltpkg/git": "0.0.0-20",
+    "@vltpkg/graph": "0.0.0-20",
+    "@vltpkg/init": "0.0.0-20",
+    "@vltpkg/output": "0.0.0-20",
+    "@vltpkg/package-info": "0.0.0-20",
+    "@vltpkg/package-json": "0.0.0-20",
+    "@vltpkg/promise-spawn": "0.0.0-20",
+    "@vltpkg/query": "0.0.0-20",
+    "@vltpkg/registry-client": "0.0.0-20",
+    "@vltpkg/run": "0.0.0-20",
+    "@vltpkg/server": "0.0.0-20",
+    "@vltpkg/rollback-remove": "0.0.0-20",
+    "@vltpkg/security-archive": "0.0.0-20",
+    "@vltpkg/types": "0.0.0-20",
+    "@vltpkg/url-open": "0.0.0-20",
+    "@vltpkg/vlt-json": "0.0.0-20",
+    "@vltpkg/vlx": "0.0.0-20",
+    "@vltpkg/spec": "0.0.0-20",
+    "@vltpkg/xdg": "0.0.0-20",
+    "@vltpkg/workspaces": "0.0.0-20"
   },
   "devDependencies": {
     "@eslint/js": "^9.28.0",