@vltpkg/cli-sdk 0.0.0-3 → 0.0.0-30

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

@@ -1 +1 @@
-{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/config/merge.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,wDAAwD;AAExD,uBAAuB;AACvB,0DAA0D;AAC1D,uDAAuD;AACvD,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,IAAO,EACP,GAAM,EACH,EAAE,CACL,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;KACjB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;IACf,CAAC;IACD,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACpD,CAAC,CAAC,CACA,CAAC,CAAC,CAAC;oBACH,OAAO,CAAC,KAAK,QAAQ;oBACrB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBACR,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,CAC3B,CAAC,CAAC;oBACD,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;oBAClB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACT,CAAC;KACD,MAAM;AACL,iEAAiE;AACjE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAC3D,CACC,CAAA","sourcesContent":["/* eslint-disable @typescript-eslint/no-unsafe-assignment */\n/* eslint-disable @typescript-eslint/no-unsafe-return */\n\n// deep merge 2 objects\n// scalars are overwritten, objects are folded in together\n// if nothing to be added, then return the base object.\nexport const merge = <T extends Record<string, any>>(\n  base: T,\n  add: T,\n): T =>\n  Object.fromEntries(\n    Object.entries(base)\n      .map(([k, v]) => [\n        k,\n        add[k] === undefined ? v\n        : Array.isArray(v) && Array.isArray(add[k]) ?\n          [...new Set([...v, ...add[k]])]\n        : Array.isArray(v) || Array.isArray(add[k]) ? add[k]\n        : (\n          !!v &&\n          typeof v === 'object' &&\n          !!add[k] &&\n          typeof add[k] === 'object'\n        ) ?\n          merge(v, add[k])\n        : add[k],\n      ])\n      .concat(\n        // already merged together if existing, so just get new additions\n        Object.entries(add).filter(([k]) => base[k] === undefined),\n      ),\n  ) as T\n"]}
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/config/merge.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,IAAO,EACP,GAAM,EACH,EAAE,CACL,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;KACjB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAqB,EAAE,CAAC;IAClC,CAAC;IACD,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C;gBACE,GAAG,IAAI,GAAG,CAAC;oBACT,GAAI,CAAoB;oBACxB,GAAI,GAAG,CAAC,CAAC,CAAoB;iBAC9B,CAAC;aACH;YACH,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACpD,CAAC,CAAC,CACA,CAAC,CAAC,CAAC;oBACH,OAAO,CAAC,KAAK,QAAQ;oBACrB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBACR,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,CAC3B,CAAC,CAAC;oBACD,KAAK,CAAC,CAAoB,EAAE,GAAG,CAAC,CAAC,CAAoB,CAAC;oBACxD,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACT,CAAC;KACD,MAAM;AACL,iEAAiE;AACjE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAC3D,CACC,CAAA","sourcesContent":["type MergeableObject = Record<string, unknown>\ntype MergeableArray = unknown[]\n\n/*\n * deep merge 2 objects\n * scalars are overwritten, objects are folded in together\n * if nothing to be added, then return the base object.\n */\nexport const merge = <T extends MergeableObject>(\n  base: T,\n  add: T,\n): T =>\n  Object.fromEntries(\n    Object.entries(base)\n      .map(([k, v]): [string, unknown] => [\n        k,\n        add[k] === undefined ? v\n        : Array.isArray(v) && Array.isArray(add[k]) ?\n          [\n            ...new Set([\n              ...(v as MergeableArray),\n              ...(add[k] as MergeableArray),\n            ]),\n          ]\n        : Array.isArray(v) || Array.isArray(add[k]) ? add[k]\n        : (\n          !!v &&\n          typeof v === 'object' &&\n          !!add[k] &&\n          typeof add[k] === 'object'\n        ) ?\n          merge(v as MergeableObject, add[k] as MergeableObject)\n        : add[k],\n      ])\n      .concat(\n        // already merged together if existing, so just get new additions\n        Object.entries(add).filter(([k]) => base[k] === undefined),\n      ),\n  ) as T\n"]}

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

@@ -1,5 +1,5 @@
 import type { CommandUsage } from '../index.ts';
-export declare const commandUsage: ({ command, usage, description, subcommands, examples, options, }: {
+export type CommandUsageDefinition = {
     command: string;
     usage: string | string[];
     description: string;
@@ -14,5 +14,6 @@ export declare const commandUsage: ({ command, usage, description, subcommands,
         value?: string;
         description: string;
     }>;
-}) => ReturnType<CommandUsage>;
+};
+export declare const commandUsage: ({ command, usage, description, subcommands, examples, options, }: CommandUsageDefinition) => ReturnType<CommandUsage>;
 //# sourceMappingURL=usage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/config/usage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAU/C,eAAO,MAAM,YAAY,qEAOtB;IACD,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAClB,MAAM,EACN;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CACnD,CAAA;IACD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClE,KAAG,UAAU,CAAC,YAAY,CA+C1B,CAAA"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/config/usage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAU/C,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAClB,MAAM,EACN;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CACnD,CAAA;IACD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClE,CAAA;AAED,eAAO,MAAM,YAAY,qEAOtB,sBAAsB,KAAG,UAAU,CAAC,YAAY,CA+ClD,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/config/usage.ts"],"names":[],"mappings":"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","sourcesContent":["import { jack } from 'jackspeak'\nimport type { CommandUsage } from '../index.ts'\nimport { commandAliases } from './definition.ts'\n\nconst toArr = <T>(v: T | T[]): T[] => (Array.isArray(v) ? v : [v])\n\nconst code = (v: string) => [v, { pre: true }] as const\n\nconst join = (args: (string | undefined)[], joiner = ' ') =>\n  args.filter(Boolean).join(joiner)\n\nexport const commandUsage = ({\n  command,\n  usage,\n  description,\n  subcommands,\n  examples,\n  options,\n}: {\n  command: string\n  usage: string | string[]\n  description: string\n  subcommands?: Record<\n    string,\n    { usage?: string | string[]; description: string }\n  >\n  examples?: Record<string, { description: string }>\n  options?: Record<string, { value?: string; description: string }>\n}): ReturnType<CommandUsage> => {\n  const vlt = (s?: string) => join([`vlt`, command, s])\n\n  const joinUsage = (usages?: string | string[]) =>\n    toArr(usages).map(vlt).filter(Boolean).join('\\n')\n\n  const j = jack({ usage: joinUsage(usage) }).description(description)\n\n  const aliases = commandAliases.get(command)\n  if (aliases) {\n    j.heading('Aliases', 2).description(aliases.join(', '), {\n      pre: true,\n    })\n  }\n\n  if (subcommands) {\n    j.heading('Subcommands', 2)\n    for (const [k, v] of Object.entries(subcommands)) {\n      j.heading(k, 3)\n        .description(v.description)\n        .description(\n          ...code(joinUsage(toArr(v.usage).map(u => join([k, u])))),\n        )\n    }\n  }\n\n  if (examples) {\n    j.heading('Examples', 2)\n    for (const [k, v] of Object.entries(examples)) {\n      j.description(v.description).description(...code(vlt(k)))\n    }\n  }\n\n  if (options) {\n    j.heading('Options', 2)\n    for (const [k, v] of Object.entries(options)) {\n      j.heading(k, 3)\n        .description(v.description)\n        .description(\n          ...code(\n            join(['--', k, v.value ? '=' : undefined, v.value], ''),\n          ),\n        )\n    }\n  }\n\n  return j\n}\n"]}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/config/usage.ts"],"names":[],"mappings":"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","sourcesContent":["import { jack } from 'jackspeak'\nimport type { CommandUsage } from '../index.ts'\nimport { commandAliases } from './definition.ts'\n\nconst toArr = <T>(v: T | T[]): T[] => (Array.isArray(v) ? v : [v])\n\nconst code = (v: string) => [v, { pre: true }] as const\n\nconst join = (args: (string | undefined)[], joiner = ' ') =>\n  args.filter(Boolean).join(joiner)\n\nexport type CommandUsageDefinition = {\n  command: string\n  usage: string | string[]\n  description: string\n  subcommands?: Record<\n    string,\n    { usage?: string | string[]; description: string }\n  >\n  examples?: Record<string, { description: string }>\n  options?: Record<string, { value?: string; description: string }>\n}\n\nexport const commandUsage = ({\n  command,\n  usage,\n  description,\n  subcommands,\n  examples,\n  options,\n}: CommandUsageDefinition): ReturnType<CommandUsage> => {\n  const vlt = (s?: string) => join([`vlt`, command, s])\n\n  const joinUsage = (usages?: string | string[]) =>\n    toArr(usages).map(vlt).filter(Boolean).join('\\n')\n\n  const j = jack({ usage: joinUsage(usage) }).description(description)\n\n  const aliases = commandAliases.get(command)\n  if (aliases) {\n    j.heading('Aliases', 2).description(aliases.join(', '), {\n      pre: true,\n    })\n  }\n\n  if (subcommands) {\n    j.heading('Subcommands', 2)\n    for (const [k, v] of Object.entries(subcommands)) {\n      j.heading(k, 3)\n        .description(v.description)\n        .description(\n          ...code(joinUsage(toArr(v.usage).map(u => join([k, u])))),\n        )\n    }\n  }\n\n  if (examples) {\n    j.heading('Examples', 2)\n    for (const [k, v] of Object.entries(examples)) {\n      j.description(v.description).description(...code(vlt(k)))\n    }\n  }\n\n  if (options) {\n    j.heading('Options', 2)\n    for (const [k, v] of Object.entries(options)) {\n      j.heading(k, 3)\n        .description(v.description)\n        .description(\n          ...code(\n            join(['--', k, v.value ? '=' : undefined, v.value], ''),\n          ),\n        )\n    }\n  }\n\n  return j\n}\n"]}

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

@@ -1,34 +1,53 @@
 /**
- * Implementation shared between `vlt run`, `vlt run-exec`, and `vlt exec`
+ * impl for `vlt run`, `vlt run-exec`, `vlt exec-local`, `vlt exec`
+ * @module
  */
-import type { exec, execFG, ExecOptions, run, runExec, runExecFG, RunExecOptions, runFG, RunOptions, RunResult } from '@vltpkg/run';
-import { Monorepo } from '@vltpkg/workspaces';
-import type { Workspace } from '@vltpkg/workspaces';
+import type { NormalizedManifest } from '@vltpkg/types';
+import type { exec, execFG, ExecOptions, run, runExec, runExecFG, RunExecOptions, runFG, RunFGResult, RunOptions, RunResult } from '@vltpkg/run';
 import type { LoadedConfig } from './config/index.ts';
-import type { SpawnResultNoStdio } from '@vltpkg/promise-spawn';
 export type RunnerBG = typeof exec | typeof run | typeof runExec;
 export type RunnerFG = typeof execFG | typeof runExecFG | typeof runFG;
 export type RunnerOptions = ExecOptions & RunExecOptions & RunOptions;
-export type ExecResult = undefined | SpawnResultNoStdio | Record<string, RunResult>;
+export type MultiRunResult = Record<string, RunResult>;
+export type ScriptSet = Record<string, string>;
+export type MultiScriptSet = Record<string, ScriptSet>;
+export type ExecResult = RunFGResult | MultiRunResult | ScriptSet | MultiScriptSet;
+export declare const views: {
+    readonly human: (result: ExecResult) => void;
+    readonly json: (result: ExecResult) => ExecResult | undefined;
+};
+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;
+    env?: NodeJS.ProcessEnv;
     conf: LoadedConfig;
     projectRoot: string;
+    view: ViewValues;
+    validViewValues: Map<string, ViewValues>;
     constructor(conf: LoadedConfig, bg: B, fg: F);
+    hasArg0(): this is this & {
+        arg0: string;
+    };
     run(): Promise<ExecResult>;
-    printResult(ws: Workspace, result: RunResult): void;
-    setExitCode(result: RunResult): void;
+    printResult(path: string, result: RunResult): void;
     interactiveShell(): string;
     defaultArg0(): string | undefined;
+    getCwd(): string;
     fgArg(): RunnerOptions | undefined;
-    /** If this returns undefined, then nothing to do */
-    bgArg(ws: Workspace): RunnerOptions;
-    noArgsMulti(): void;
+    bgArg(this: this & {
+        arg0: string;
+    }, cwd: string): RunnerOptions;
+    noArgsSingle(): ScriptSet;
+    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;;GAEG;AAIH,OAAO,KAAK,EACV,IAAI,EACJ,MAAM,EACN,WAAW,EACX,GAAG,EACH,OAAO,EACP,SAAS,EACT,cAAc,EACd,KAAK,EACL,UAAU,EACV,SAAS,EACV,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,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,UAAU,GAClB,SAAS,GACT,kBAAkB,GAClB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAE7B,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,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;gBAEP,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAsBtC,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;IAmDhC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS;IAgB5C,WAAW,CAAC,MAAM,EAAE,SAAS;IAM7B,gBAAgB,IAAI,MAAM;IAU1B,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,KAAK,IAAI,aAAa,GAAG,SAAS;IAoBlC,oDAAoD;IACpD,KAAK,CAAC,EAAE,EAAE,SAAS,GAAG,aAAa;IAqBnC,WAAW;CAKZ"}
+{"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;AAQrD,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,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IAIvB,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;IA+HhC,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;IAgBhE,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

@@ -1,95 +1,217 @@
 /**
- * Implementation shared between `vlt run`, `vlt run-exec`, and `vlt exec`
+ * impl for `vlt run`, `vlt run-exec`, `vlt exec-local`, `vlt exec`
+ * @module
  */
-import { error, isErrorRoot } from '@vltpkg/error-cause';
+import { error } from '@vltpkg/error-cause';
+import { isErrorWithCause } from '@vltpkg/types';
+import { Query } from '@vltpkg/query';
+import { actual } from '@vltpkg/graph';
 import { isRunResult } from '@vltpkg/run';
 import { Monorepo } from '@vltpkg/workspaces';
 import { ansiToAnsi } from 'ansi-to-pre';
-import chalk from 'chalk';
-import { stdout, stderr } from "./output.js";
+import { stderr, stdout, styleTextStdout } from "./output.js";
+import assert from 'node:assert';
+import { resolve } from 'node:path';
+import { createHostContextsMap } from "./query-host-contexts.js";
+const isScriptSet = (o) => {
+    if (!o || typeof o !== 'object')
+        return false;
+    for (const v of Object.values(o)) {
+        if (typeof v !== 'string')
+            return false;
+    }
+    return true;
+};
+const isMultiScriptSet = (o) => {
+    for (const v of Object.values(o)) {
+        if (!isScriptSet(v))
+            return false;
+    }
+    return true;
+};
+const isSingleSuccess = (o) => o.signal === null && o.status === 0;
+const setExitCode = (result) => {
+    /* c8 ignore next */
+    process.exitCode ||= result.status ?? 1;
+};
+export const views = {
+    // run results for single or multiple will be printed along the way.
+    human: result => {
+        if (isScriptSet(result))
+            stdout('Scripts available:', result);
+        else if (isMultiScriptSet(result)) {
+            stdout('Scripts available:');
+            for (const [path, scripts] of Object.entries(result)) {
+                stdout(path, scripts);
+            }
+        }
+    },
+    json: result => isRunResult(result) && isSingleSuccess(result) ?
+        undefined
+        : result,
+};
 export class ExecCommand {
     bg;
     fg;
     arg0;
     args;
-    monorepo;
-    /** how many places are we doing things in? */
-    spaces;
+    env;
+    #monorepo;
+    #nodes;
+    #defaultIgnoreMissing = false;
     conf;
     projectRoot;
+    view;
+    validViewValues = new Map([
+        ['human', 'human'],
+        ['json', 'json'],
+        ['inspect', 'inspect'],
+        ['silent', 'silent'],
+    ]);
     constructor(conf, bg, fg) {
         this.conf = conf;
         this.bg = bg;
         this.fg = fg;
+        this.view = this.validViewValues.get(conf.values.view) ?? 'human';
         const { projectRoot, positionals: [arg0, ...args], } = conf;
         this.arg0 = arg0;
         this.args = args;
-        const paths = conf.get('workspace');
-        const groups = conf.get('workspace-group');
-        const recursive = conf.get('recursive');
-        this.monorepo =
-            paths?.length || groups?.length || recursive ?
-                Monorepo.load(projectRoot, { load: { paths, groups } })
-                : undefined;
-        this.spaces = this.monorepo?.size ?? 1;
         this.projectRoot = projectRoot;
     }
+    #targetCount() {
+        if (this.#nodes)
+            return this.#nodes.length;
+        return this.#monorepo?.size ?? 1;
+    }
+    hasArg0() {
+        return !!this.arg0;
+    }
     async run() {
-        if (this.spaces === 1) {
+        const { conf } = this;
+        const queryString = conf.get('scope');
+        const paths = conf.get('workspace');
+        const groups = conf.get('workspace-group');
+        const recursive = conf.get('recursive');
+        // scope takes precedence over workspaces or groups
+        if (queryString) {
+            this.#defaultIgnoreMissing = true;
+            const mainManifest = conf.options.packageJson.maybeRead(this.projectRoot);
+            let graph;
+            if (mainManifest) {
+                graph = actual.load({
+                    ...conf.options,
+                    mainManifest,
+                    monorepo: Monorepo.load(this.projectRoot),
+                    loadManifests: false,
+                });
+            }
+            const hostContexts = await createHostContextsMap(conf);
+            const query = new Query({
+                /* c8 ignore start */
+                nodes: graph ? new Set(graph.nodes.values()) : new Set(),
+                edges: graph?.edges ?? new Set(),
+                importers: graph?.importers ?? new Set(),
+                /* c8 ignore stop */
+                securityArchive: undefined,
+                hostContexts,
+            });
+            const { nodes } = await query.search(queryString, {
+                signal: new AbortController().signal,
+            });
+            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 if (paths?.length || groups?.length || recursive) {
+            this.#defaultIgnoreMissing = true;
+            this.#monorepo = Monorepo.load(this.projectRoot, {
+                load: { paths, groups },
+            });
+        }
+        if (this.#targetCount() === 1) {
             const arg = this.fgArg();
             if (!arg)
-                return;
+                return this.noArgsSingle();
             const result = await this.fg(arg);
-            stdout(result);
             if (isRunResult(result)) {
-                this.setExitCode(result);
+                setExitCode(result);
             }
             return result;
         }
-        const m = this.monorepo;
-        if (!m || 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() ?? [])],
+                });
+            }
         }
-        const arg0 = this.arg0;
-        if (!arg0) {
-            this.noArgsMulti();
-            return;
+        if (!this.hasArg0()) {
+            return this.noArgsMulti();
         }
         // run across workspaces
         let failed = false;
-        const resultMap = await m.run(async (ws) => {
-            if (!failed)
-                stderr(`${ws.path} ${arg0}`);
-            const result = await this.bg(this.bgArg(ws)).catch((er) => {
-                if (isErrorRoot(er) && isRunResult(er.cause)) {
-                    this.printResult(ws, er.cause);
+        const runInDir = async (cwd, label) => {
+            const result = await this.bg(this.bgArg(cwd)).catch((er) => {
+                if (isErrorWithCause(er) && isRunResult(er.cause)) {
+                    this.printResult(label, er.cause);
                 }
                 failed = true;
                 throw er;
             });
+            // If we are allowed to ignore missing commands, then command might be
+            // an emptry string. If so, we don't print anything and return null to
+            // be filtered out later.
+            if (!result.command)
+                return null;
             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);
+                if (result)
+                    resultMap.set(label, result);
+            }
+        }
+        else if (this.#monorepo) {
+            const wsResultMap = await this.#monorepo.run(ws => runInDir(ws.fullpath, ws.path));
+            for (const [ws, result] of wsResultMap) {
+                if (result)
+                    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(chalk.bgWhiteBright.black.bold(ws.path + ' failure'), {
+            stdout(styleTextStdout(['bgWhiteBright', 'black', 'bold'], path + ' failure'), {
                 status: result.status,
                 signal: result.signal,
             });
@@ -99,13 +221,9 @@ export class ExecCommand {
             if (result.stdout)
                 stdout(ansiToAnsi(result.stdout));
             /* c8 ignore stop */
-            this.setExitCode(result);
+            setExitCode(result);
         }
     }
-    setExitCode(result) {
-        /* c8 ignore next */
-        process.exitCode = process.exitCode || (result.status ?? 1);
-    }
     /* c8 ignore start - env specific */
     interactiveShell() {
         return (process.env.SHELL ??
@@ -113,47 +231,78 @@ export class ExecCommand {
             (process.platform === 'win32' ? 'cmd.exe' : '/bin/sh'));
     }
     /* c8 ignore stop */
-    // overridden by 'vlt run' to print options and return undefined
+    // overridden by 'vlt run' which returns undefined
     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();
-        if (!arg0) {
-            return undefined;
-        }
+        // return undefined so noArgsSingle will be called instead
+        if (typeof arg0 !== 'string')
+            return;
         return {
             cwd,
-            /* c8 ignore next - already guarded */
             arg0,
             args: this.args,
+            env: this.env,
             projectRoot: this.projectRoot,
-            packageJson: this.monorepo?.packageJson,
+            packageJson: this.conf.options.packageJson,
             'script-shell': this.arg0 ? this.conf.get('script-shell') : false,
         };
     }
-    /** If this returns undefined, then nothing to do */
-    bgArg(ws) {
-        /* c8 ignore start - already guarded */
-        if (!this.arg0)
-            throw error('Cannot spawn interactive shells in multiple workspaces');
-        /* c8 ignore stop */
+    bgArg(cwd) {
         return {
-            cwd: ws.fullpath,
+            cwd,
             acceptFail: !this.conf.get('bail'),
-            ignoreMissing: true,
+            ignoreMissing: this.conf.get('if-present') ?? this.#defaultIgnoreMissing,
             arg0: this.arg0,
             args: this.args,
+            env: this.env,
             projectRoot: this.projectRoot,
-            packageJson: this.monorepo?.packageJson,
+            packageJson: this.conf.options.packageJson,
             'script-shell': this.conf.get('script-shell'),
         };
     }
-    // overridden in `vlt run` to print available scripts
+    /* c8 ignore start - not used, only here to override */
+    noArgsSingle() {
+        throw error('Failed to determine interactive shell to spawn');
+    }
+    /* c8 ignore stop - not used, only here to override */
     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 * Implementation shared between `vlt run`, `vlt run-exec`, and `vlt exec`\n */\n\nimport { error, isErrorRoot } from '@vltpkg/error-cause'\nimport { isRunResult } from '@vltpkg/run'\nimport type {\n  exec,\n  execFG,\n  ExecOptions,\n  run,\n  runExec,\n  runExecFG,\n  RunExecOptions,\n  runFG,\n  RunOptions,\n  RunResult,\n} from '@vltpkg/run'\nimport { Monorepo } from '@vltpkg/workspaces'\nimport type { Workspace } from '@vltpkg/workspaces'\nimport { ansiToAnsi } from 'ansi-to-pre'\nimport chalk from 'chalk'\nimport type { LoadedConfig } from './config/index.ts'\nimport { stdout, stderr } from './output.ts'\nimport type { SpawnResultNoStdio } from '@vltpkg/promise-spawn'\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 ExecResult =\n  | undefined\n  | SpawnResultNoStdio\n  | Record<string, RunResult>\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\n  constructor(conf: LoadedConfig, bg: B, fg: F) {\n    this.conf = conf\n    this.bg = bg\n    this.fg = fg\n    const {\n      projectRoot,\n      positionals: [arg0, ...args],\n    } = conf\n    this.arg0 = arg0\n    this.args = args\n\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(projectRoot, { load: { paths, groups } })\n      : undefined\n    this.spaces = this.monorepo?.size ?? 1\n    this.projectRoot = projectRoot\n  }\n\n  async run(): Promise<ExecResult> {\n    if (this.spaces === 1) {\n      const arg = this.fgArg()\n      if (!arg) return\n      const result = await this.fg(arg)\n      stdout(result)\n      if (isRunResult(result)) {\n        this.setExitCode(result)\n      }\n      return result\n    }\n    const m = this.monorepo\n    if (!m || 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    const arg0 = this.arg0\n    if (!arg0) {\n      this.noArgsMulti()\n      return\n    }\n    // run across workspaces\n    let failed = false\n    const resultMap = await m.run(async ws => {\n      if (!failed) stderr(`${ws.path} ${arg0}`)\n      const result = await this.bg(this.bgArg(ws)).catch(\n        (er: unknown) => {\n          if (isErrorRoot(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    if (result.status === 0 && result.signal === null) {\n      stdout(ws.path, 'ok')\n    } else {\n      stdout(chalk.bgWhiteBright.black.bold(ws.path + ' failure'), {\n        status: result.status,\n        signal: result.signal,\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      this.setExitCode(result)\n    }\n  }\n\n  setExitCode(result: RunResult) {\n    /* c8 ignore next */\n    process.exitCode = process.exitCode || (result.status ?? 1)\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' to print options and return 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    if (!arg0) {\n      return undefined\n    }\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  /** If this returns undefined, then nothing to do */\n  bgArg(ws: Workspace): RunnerOptions {\n    /* c8 ignore start - already guarded */\n    if (!this.arg0)\n      throw error(\n        'Cannot spawn interactive shells in multiple workspaces',\n      )\n    /* c8 ignore stop */\n\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  // overridden in `vlt run` to print available scripts\n  noArgsMulti() {\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'\nimport { createHostContextsMap } from './query-host-contexts.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 ||= 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  env?: NodeJS.ProcessEnv\n  #monorepo?: Monorepo\n  #nodes?: string[]\n  #defaultIgnoreMissing = false\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    const paths = conf.get('workspace')\n    const groups = conf.get('workspace-group')\n    const recursive = conf.get('recursive')\n\n    // scope takes precedence over workspaces or groups\n    if (queryString) {\n      this.#defaultIgnoreMissing = true\n      const mainManifest = conf.options.packageJson.maybeRead(\n        this.projectRoot,\n      )\n      let graph\n      if (mainManifest) {\n        graph = actual.load({\n          ...conf.options,\n          mainManifest,\n          monorepo: Monorepo.load(this.projectRoot),\n          loadManifests: false,\n        })\n      }\n      const hostContexts = await createHostContextsMap(conf)\n      const query = new Query({\n        /* c8 ignore start */\n        nodes: graph ? new Set(graph.nodes.values()) : new Set(),\n        edges: graph?.edges ?? new Set(),\n        importers: graph?.importers ?? new Set(),\n        /* c8 ignore stop */\n        securityArchive: undefined,\n        hostContexts,\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 if (paths?.length || groups?.length || recursive) {\n      this.#defaultIgnoreMissing = true\n      this.#monorepo = Monorepo.load(this.projectRoot, {\n        load: { paths, groups },\n      })\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 we are allowed to ignore missing commands, then command might be\n      // an emptry string. If so, we don't print anything and return null to\n      // be filtered out later.\n      if (!result.command) return null\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        if (result) resultMap.set(label, result)\n      }\n    } else if (this.#monorepo) {\n      const wsResultMap = await this.#monorepo.run(ws =>\n        runInDir(ws.fullpath, ws.path),\n      )\n      for (const [ws, result] of wsResultMap) {\n        if (result) 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      arg0,\n      args: this.args,\n      env: this.env,\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:\n        this.conf.get('if-present') ?? this.#defaultIgnoreMissing,\n      arg0: this.arg0,\n      args: this.args,\n      env: this.env,\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/index.d.ts

@@ -1,17 +1,4 @@
-import type { Jack } from 'jackspeak';
-import type { LoadedConfig } from './config/index.ts';
-import type { Views } from './view.ts';
-export type CommandUsage = () => Jack;
-/**
- * A command function that may return a result of `T`.
- * If the result is `undefined`, no final output will be displayed by default.
- */
-export type CommandFn<T = unknown> = (conf: LoadedConfig) => Promise<T>;
-export type Command<T> = {
-    command: CommandFn<T>;
-    usage: CommandUsage;
-    views: Views<T>;
-};
+export type { Command, CommandFn, CommandUsage, } from './load-command.ts';
 declare const run: () => Promise<void>;
 export default run;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGrC,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,mBAAmB,CAAA;AAE/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAEtC,MAAM,MAAM,YAAY,GAAG,MAAM,IAAI,CAAA;AAErC;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,OAAO,IAAI,CACnC,IAAI,EAAE,YAAY,KACf,OAAO,CAAC,CAAC,CAAC,CAAA;AAEf,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IACvB,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACrB,KAAK,EAAE,YAAY,CAAA;IACnB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;CAChB,CAAA;AAwBD,QAAA,MAAM,GAAG,qBAsBR,CAAA;AAED,eAAe,GAAG,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAYA,YAAY,EACV,OAAO,EACP,SAAS,EACT,YAAY,GACb,MAAM,mBAAmB,CAAA;AAgD1B,QAAA,MAAM,GAAG,qBA2CR,CAAA;AAED,eAAe,GAAG,CAAA"}