@vltpkg/cli-sdk 0.0.0-10

package/dist/esm/commands/exec-cache.js

@@ -0,0 +1,125 @@
+import { error } from '@vltpkg/error-cause';
+import { RollbackRemove } from '@vltpkg/rollback-remove';
+import * as vlx from '@vltpkg/vlx';
+import { basename } from 'node:path';
+import { commandUsage } from "../config/usage.js";
+import { stdout } from "../output.js";
+import { ViewClass } from "../view.js";
+let view;
+export class ExecCacheView extends ViewClass {
+    constructor(options, conf) {
+        super(options, conf);
+        view = this;
+    }
+    stdout(...args) {
+        stdout(...args);
+    }
+}
+export const views = {
+    human: ExecCacheView,
+};
+const usageDef = {
+    command: 'exec-cache',
+    usage: '<command> [flags]',
+    description: 'Work with vlt exec-cache folders',
+    subcommands: {
+        ls: {
+            usage: '',
+            description: `Show previously installed packages used for \`vlt exec\`.
+                    Key provided can be either the package name, or the full
+                    key.`,
+        },
+        delete: {
+            usage: '[<key>...]',
+            description: `Delete previously installed packages used for
+                    \`vlt exec\`. If no keys are provided, then all entries
+                    will be deleted.`,
+        },
+        info: {
+            usage: '<key>',
+            description: `Show extended information about a given \`vlt exec\`
+                    installation.`,
+        },
+        install: {
+            usage: '<spec>...',
+            description: `Install the specified package(s) in the \`vlt exec\`
+                    central cache location. Metadata info about each
+                    installation will be printed.`,
+        },
+    },
+    examples: {
+        ls: {
+            description: `Show all the keys for the installations in the \`vlt exec\`
+                    cache.`,
+        },
+        'delete typescript': {
+            description: `Delete all versions of typescript installed for vlt exec`,
+        },
+        'info typescript-695bf962': {
+            description: `Show extended info about a specific version of typescript`,
+        },
+    },
+};
+export const usage = () => commandUsage(usageDef);
+export const command = async (conf) => {
+    const [sub, ...args] = conf.positionals;
+    switch (sub) {
+        case 'ls':
+            return ls(conf, args, view);
+        case 'info':
+            return info(conf, args, view);
+        case 'install':
+            return install(conf, args, view);
+        case 'delete':
+            return deleteEntries(conf, args, view);
+        default: {
+            throw error('Unrecognized exec-cache command', {
+                code: 'EUSAGE',
+                found: sub,
+                validOptions: Object.keys(usageDef.subcommands),
+            });
+        }
+    }
+};
+const install = async (conf, keys, view) => {
+    if (!keys.length) {
+        throw error('Must supply a package spec to install', {
+            code: 'EUSAGE',
+        });
+    }
+    return Promise.all(keys.map(async (key) => {
+        const info = await vlx.install(key, conf.options);
+        view?.stdout(info);
+        return info.path;
+    }));
+};
+const ls = async (_conf, args, view) => {
+    const results = [];
+    for await (const path of vlx.list()) {
+        const key = basename(path);
+        if (args.length && !args.some(a => key.includes(a)))
+            continue;
+        results.push(key);
+        view?.stdout(key);
+    }
+    return results;
+};
+const info = async (conf, keys, view) => {
+    const results = [];
+    for await (const key of keys.length ? keys : vlx.list()) {
+        const info = vlx.info(key, conf.options);
+        results.push(info);
+        view?.stdout(info);
+    }
+    return results;
+};
+const deleteEntries = async (conf, keys, view) => {
+    const remover = new RollbackRemove();
+    const removed = (await vlx.delete(keys, remover, conf.options)).map(path => {
+        view?.stdout(`- ${basename(path)}`);
+        return path;
+    });
+    remover.confirm();
+    return removed;
+};
+//# sourceMappingURL=exec-cache.js.map

package/dist/esm/commands/exec-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-cache.js","sourceRoot":"","sources":["../../../src/commands/exec-cache.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { RollbackRemove } from '@vltpkg/rollback-remove'\nimport type { VlxInfo } from '@vltpkg/vlx'\nimport * as vlx from '@vltpkg/vlx'\nimport { basename } from 'node:path'\nimport type { LoadedConfig } from '../config/index.ts'\nimport type { CommandUsageDefinition } from '../config/usage.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { stdout } from '../output.ts'\nimport type { ViewOptions, Views } from '../view.ts'\nimport { ViewClass } from '../view.ts'\n\nexport type ExecCacheSubcommands =\n  keyof (typeof usageDef)['subcommands']\n\nlet view: ExecCacheView\nexport class ExecCacheView extends ViewClass {\n  constructor(options: ViewOptions, conf: LoadedConfig) {\n    super(options, conf)\n    view = this\n  }\n  stdout(...args: unknown[]) {\n    stdout(...args)\n  }\n}\n\nexport const views: Views<void | string[] | VlxInfo[]> = {\n  human: ExecCacheView,\n}\n\nconst usageDef = {\n  command: 'exec-cache',\n  usage: '<command> [flags]',\n  description: 'Work with vlt exec-cache folders',\n\n  subcommands: {\n    ls: {\n      usage: '',\n      description: `Show previously installed packages used for \\`vlt exec\\`.\n                    Key provided can be either the package name, or the full\n                    key.`,\n    },\n\n    delete: {\n      usage: '[<key>...]',\n      description: `Delete previously installed packages used for\n                    \\`vlt exec\\`. If no keys are provided, then all entries\n                    will be deleted.`,\n    },\n\n    info: {\n      usage: '<key>',\n      description: `Show extended information about a given \\`vlt exec\\`\n                    installation.`,\n    },\n\n    install: {\n      usage: '<spec>...',\n      description: `Install the specified package(s) in the \\`vlt exec\\`\n                    central cache location. Metadata info about each\n                    installation will be printed.`,\n    },\n  },\n\n  examples: {\n    ls: {\n      description: `Show all the keys for the installations in the \\`vlt exec\\`\n                    cache.`,\n    },\n    'delete typescript': {\n      description: `Delete all versions of typescript installed for vlt exec`,\n    },\n    'info typescript-695bf962': {\n      description: `Show extended info about a specific version of typescript`,\n    },\n  },\n} as const satisfies CommandUsageDefinition\n\nexport const usage: CommandUsage = () => commandUsage(usageDef)\n\nexport const command: CommandFn<\n  string[] | VlxInfo[]\n> = async conf => {\n  const [sub, ...args] = conf.positionals\n  switch (sub) {\n    case 'ls':\n      return ls(conf, args, view)\n\n    case 'info':\n      return info(conf, args, view)\n\n    case 'install':\n      return install(conf, args, view)\n\n    case 'delete':\n      return deleteEntries(conf, args, view)\n\n    default: {\n      throw error('Unrecognized exec-cache command', {\n        code: 'EUSAGE',\n        found: sub,\n        validOptions: Object.keys(usageDef.subcommands),\n      })\n    }\n  }\n}\n\nconst install = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: ExecCacheView,\n): Promise<string[]> => {\n  if (!keys.length) {\n    throw error('Must supply a package spec to install', {\n      code: 'EUSAGE',\n    })\n  }\n  return Promise.all(\n    keys.map(async key => {\n      const info = await vlx.install(key, conf.options)\n      view?.stdout(info)\n      return info.path\n    }),\n  )\n}\n\nconst ls = async (\n  _conf: LoadedConfig,\n  args: string[],\n  view?: ExecCacheView,\n): Promise<string[]> => {\n  const results: string[] = []\n  for await (const path of vlx.list()) {\n    const key = basename(path)\n    if (args.length && !args.some(a => key.includes(a))) continue\n    results.push(key)\n    view?.stdout(key)\n  }\n  return results\n}\n\nconst info = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: ExecCacheView,\n): Promise<VlxInfo[]> => {\n  const results: VlxInfo[] = []\n  for await (const key of keys.length ? keys : vlx.list()) {\n    const info = vlx.info(key, conf.options)\n    results.push(info)\n    view?.stdout(info)\n  }\n  return results\n}\n\nconst deleteEntries = async (\n  conf: LoadedConfig,\n  keys: string[],\n  view?: ExecCacheView,\n): Promise<string[]> => {\n  const remover = new RollbackRemove()\n  const removed = (await vlx.delete(keys, remover, conf.options)).map(\n    path => {\n      view?.stdout(`- ${basename(path)}`)\n      return path\n    },\n  )\n  remover.confirm()\n  return removed\n}\n"]}

package/dist/esm/commands/exec-local.d.ts

@@ -0,0 +1,6 @@
+import type { ExecResult } from '../exec-command.ts';
+import type { CommandFn, CommandUsage } from '../index.ts';
+export { views } from '../exec-command.ts';
+export declare const usage: CommandUsage;
+export declare const command: CommandFn<ExecResult>;
+//# sourceMappingURL=exec-local.d.ts.map

package/dist/esm/commands/exec-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-local.d.ts","sourceRoot":"","sources":["../../../src/commands/exec-local.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,eAAO,MAAM,KAAK,EAAE,YAehB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CAGzC,CAAA"}

package/dist/esm/commands/exec-local.js

@@ -0,0 +1,24 @@
+import { exec, execFG } from '@vltpkg/run';
+import { commandUsage } from "../config/usage.js";
+import { ExecCommand } from "../exec-command.js";
+export { views } from "../exec-command.js";
+export const usage = () => commandUsage({
+    command: 'exec-local',
+    usage: '[command]',
+    description: `Run an arbitrary command, with the local installed packages
+                  first in the PATH. Ie, this will run your locally installed
+                  package bins.
+
+                  If no command is provided, then a shell is spawned in the
+                  current working directory, with the locally installed package
+                  bins first in the PATH.
+
+                  Note that any vlt configs must be specified *before* the
+                  command, as the remainder of the command line options are
+                  provided to the exec process.`,
+});
+export const command = async (conf) => {
+    delete conf.options['script-shell'];
+    return await new ExecCommand(conf, exec, execFG).run();
+};
+//# sourceMappingURL=exec-local.js.map

package/dist/esm/commands/exec-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-local.js","sourceRoot":"","sources":["../../../src/commands/exec-local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,YAAY;IACrB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE;;;;;;;;;;gDAU+B;CAC7C,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE;IACzD,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IACnC,OAAO,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAA;AACxD,CAAC,CAAA","sourcesContent":["import { exec, execFG } from '@vltpkg/run'\nimport { commandUsage } from '../config/usage.ts'\nimport type { ExecResult } from '../exec-command.ts'\nimport { ExecCommand } from '../exec-command.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nexport { views } from '../exec-command.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'exec-local',\n    usage: '[command]',\n    description: `Run an arbitrary command, with the local installed packages\n                  first in the PATH. Ie, this will run your locally installed\n                  package bins.\n\n                  If no command is provided, then a shell is spawned in the\n                  current working directory, with the locally installed package\n                  bins first in the PATH.\n\n                  Note that any vlt configs must be specified *before* the\n                  command, as the remainder of the command line options are\n                  provided to the exec process.`,\n  })\n\nexport const command: CommandFn<ExecResult> = async conf => {\n  delete conf.options['script-shell']\n  return await new ExecCommand(conf, exec, execFG).run()\n}\n"]}

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

@@ -0,0 +1,9 @@
+import type { PromptFn } from '@vltpkg/vlx';
+import type { ExecResult } from '../exec-command.ts';
+import type { CommandFn, CommandUsage } from '../index.ts';
+export { views } from '../exec-command.ts';
+export declare const usage: CommandUsage;
+export declare const prettyPath: (path: string) => string;
+export declare const promptFn: PromptFn;
+export declare const command: CommandFn<ExecResult>;
+//# sourceMappingURL=exec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/commands/exec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAK3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,eAAO,MAAM,KAAK,EAAE,YAoDhB,CAAA;AAGJ,eAAO,MAAM,UAAU,SAAU,MAAM,WAC2B,CAAA;AAElE,eAAO,MAAM,QAAQ,EAAE,QAyBtB,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CAUzC,CAAA"}

package/dist/esm/commands/exec.js

@@ -0,0 +1,78 @@
+import { exec, execFG } from '@vltpkg/run';
+import * as vlx from '@vltpkg/vlx';
+import { homedir } from 'node:os';
+import { createInterface } from 'node:readline/promises';
+import { commandUsage } from "../config/usage.js";
+import { ExecCommand } from "../exec-command.js";
+import { styleTextStdout } from "../output.js";
+export { views } from "../exec-command.js";
+export const usage = () => commandUsage({
+    command: 'exec',
+    usage: '[--package=<pkg>] [command...]',
+    description: `Run a command defined by a package, installing it
+                  if necessary.
+
+                  If the package specifier is provided explicitly via the
+                  \`--package\` config, then that is what will be used. If
+                  a satisfying instance of the named package exists in the
+                  local \`node_mnodules\` folder, then that will be used.
+
+                  If \`--package\` is not set, then vlt will attempt to infer
+                  the package to be installed if necessary, in the following
+                  manner:
+
+                  - If the first argument is an executable found in the
+                    \`node_modules/.bin\` folder (ie, provided by an
+                    installed direct dependency), then that will be used.
+                    The search stops, and nothing will be installed.
+                  - Otherwise, vlt attempts to resolve the first argument
+                    as if it was a \`--package\` option, and then swap it
+                    out with the "default" executable provided by that
+                    package.
+
+                  The "default" executable provided by a package is:
+
+                  - If the package provides a single executable string in the
+                    \`bin\` field, then that is the executable to use.
+                  - Otherwise, if there is a \`bin\` with the same name
+                    as the package (or just the portion after the \`/\` in
+                    the case of scoped packages), then that will be used.
+
+                  If the appropriate excutable cannot be determined, then
+                  an error will be raised.
+
+                  At no point will \`vlt exec\` change the locally installed
+                  dependencies. Any installs it performs is done in vlt's XDG
+                  data directory.
+    `,
+    examples: {
+        '--package typescript@5 tsc': {
+            description: 'Run tsc provided by typescript version 5',
+        },
+        'eslint src/file.js': {
+            description: 'Run the default bin provided by eslint',
+        },
+        'eslint@9.24 src/file.js': {
+            description: 'Run the default bin provided by eslint version 9.24',
+        },
+    },
+});
+const HOME = homedir();
+export const prettyPath = (path) => path.startsWith(HOME) ? `~${path.substring(HOME.length)}` : path;
+export const promptFn = async (pkgSpec, path, resolution) => {
+    const response = await createInterface(process.stdin, process.stdout).question(`About to install: ${styleTextStdout(['bgWhiteBright', 'black', 'bold'], String(pkgSpec))}
+from: ${styleTextStdout(['bgWhiteBright', 'black', 'bold'], resolution)}
+into: ${styleTextStdout(['bgWhiteBright', 'black', 'bold'], prettyPath(path))}
+Is this ok? (y) `);
+    process.stdin.pause();
+    return response;
+};
+export const command = async (conf) => {
+    const arg0 = await vlx.resolve(conf.positionals, conf.options, promptFn);
+    if (arg0)
+        conf.positionals[0] = arg0;
+    // now we have arg0! let's gooooo!!
+    delete conf.options['script-shell'];
+    return await new ExecCommand(conf, exec, execFG).run();
+};
+//# sourceMappingURL=exec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/commands/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,KAAK,GAAG,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,gCAAgC;IACvC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmCZ;IACD,QAAQ,EAAE;QACR,4BAA4B,EAAE;YAC5B,WAAW,EAAE,0CAA0C;SACxD;QACD,oBAAoB,EAAE;YACpB,WAAW,EAAE,wCAAwC;SACtD;QACD,yBAAyB,EAAE;YACzB,WAAW,EACT,qDAAqD;SACxD;KACF;CACF,CAAC,CAAA;AAEJ,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;AACtB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAElE,MAAM,CAAC,MAAM,QAAQ,GAAa,KAAK,EACrC,OAAO,EACP,IAAI,EACJ,UAAU,EACV,EAAE;IACF,MAAM,QAAQ,GAAG,MAAM,eAAe,CACpC,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,MAAM,CACf,CAAC,QAAQ,CACR,qBAAqB,eAAe,CAClC,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,MAAM,CAAC,OAAO,CAAC,CAChB;QACG,eAAe,CACjB,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,UAAU,CACX;QACG,eAAe,CACjB,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,UAAU,CAAC,IAAI,CAAC,CACjB;iBACY,CACd,CAAA;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACrB,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE;IACzD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAC5B,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,OAAO,EACZ,QAAQ,CACT,CAAA;IACD,IAAI,IAAI;QAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACpC,mCAAmC;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IACnC,OAAO,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAA;AACxD,CAAC,CAAA","sourcesContent":["import { exec, execFG } from '@vltpkg/run'\nimport type { PromptFn } from '@vltpkg/vlx'\nimport * as vlx from '@vltpkg/vlx'\nimport { homedir } from 'node:os'\nimport { createInterface } from 'node:readline/promises'\nimport { commandUsage } from '../config/usage.ts'\nimport type { ExecResult } from '../exec-command.ts'\nimport { ExecCommand } from '../exec-command.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { styleTextStdout } from '../output.ts'\nexport { views } from '../exec-command.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'exec',\n    usage: '[--package=<pkg>] [command...]',\n    description: `Run a command defined by a package, installing it\n                  if necessary.\n\n                  If the package specifier is provided explicitly via the\n                  \\`--package\\` config, then that is what will be used. If\n                  a satisfying instance of the named package exists in the\n                  local \\`node_mnodules\\` folder, then that will be used.\n\n                  If \\`--package\\` is not set, then vlt will attempt to infer\n                  the package to be installed if necessary, in the following\n                  manner:\n\n                  - If the first argument is an executable found in the\n                    \\`node_modules/.bin\\` folder (ie, provided by an\n                    installed direct dependency), then that will be used.\n                    The search stops, and nothing will be installed.\n                  - Otherwise, vlt attempts to resolve the first argument\n                    as if it was a \\`--package\\` option, and then swap it\n                    out with the \"default\" executable provided by that\n                    package.\n\n                  The \"default\" executable provided by a package is:\n\n                  - If the package provides a single executable string in the\n                    \\`bin\\` field, then that is the executable to use.\n                  - Otherwise, if there is a \\`bin\\` with the same name\n                    as the package (or just the portion after the \\`/\\` in\n                    the case of scoped packages), then that will be used.\n\n                  If the appropriate excutable cannot be determined, then\n                  an error will be raised.\n\n                  At no point will \\`vlt exec\\` change the locally installed\n                  dependencies. Any installs it performs is done in vlt's XDG\n                  data directory.\n    `,\n    examples: {\n      '--package typescript@5 tsc': {\n        description: 'Run tsc provided by typescript version 5',\n      },\n      'eslint src/file.js': {\n        description: 'Run the default bin provided by eslint',\n      },\n      'eslint@9.24 src/file.js': {\n        description:\n          'Run the default bin provided by eslint version 9.24',\n      },\n    },\n  })\n\nconst HOME = homedir()\nexport const prettyPath = (path: string) =>\n  path.startsWith(HOME) ? `~${path.substring(HOME.length)}` : path\n\nexport const promptFn: PromptFn = async (\n  pkgSpec,\n  path,\n  resolution,\n) => {\n  const response = await createInterface(\n    process.stdin,\n    process.stdout,\n  ).question(\n    `About to install: ${styleTextStdout(\n      ['bgWhiteBright', 'black', 'bold'],\n      String(pkgSpec),\n    )}\nfrom: ${styleTextStdout(\n      ['bgWhiteBright', 'black', 'bold'],\n      resolution,\n    )}\ninto: ${styleTextStdout(\n      ['bgWhiteBright', 'black', 'bold'],\n      prettyPath(path),\n    )}\nIs this ok? (y) `,\n  )\n  process.stdin.pause()\n  return response\n}\n\nexport const command: CommandFn<ExecResult> = async conf => {\n  const arg0 = await vlx.resolve(\n    conf.positionals,\n    conf.options,\n    promptFn,\n  )\n  if (arg0) conf.positionals[0] = arg0\n  // now we have arg0! let's gooooo!!\n  delete conf.options['script-shell']\n  return await new ExecCommand(conf, exec, execFG).run()\n}\n"]}

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

@@ -0,0 +1,6 @@
+import type { CommandFn, CommandUsage } from '../index.ts';
+import type { ViewFn } from '../view.ts';
+export declare const views: ViewFn<null>;
+export declare const usage: CommandUsage;
+export declare const command: CommandFn;
+//# sourceMappingURL=gui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gui.d.ts","sourceRoot":"","sources":["../../../src/commands/gui.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAGxC,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,IAAI,CAE9B,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,YAKhB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SAA4B,CAAA"}

package/dist/esm/commands/gui.js

@@ -0,0 +1,13 @@
+import { commandUsage } from "../config/usage.js";
+import { startGUI } from "../start-gui.js";
+// this command is only a view, it doesn't actually do anything at this time
+export const views = async (_, __, conf) => {
+    await startGUI(conf);
+};
+export const usage = () => commandUsage({
+    command: 'gui',
+    usage: '',
+    description: 'Launch a graphical user interface in a browser',
+});
+export const command = async () => null;
+//# sourceMappingURL=gui.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gui.js","sourceRoot":"","sources":["../../../src/commands/gui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAG1C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,KAAK,GAAiB,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;IACvD,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,gDAAgD;CAC9D,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,OAAO,GAAc,KAAK,IAAI,EAAE,CAAC,IAAI,CAAA","sourcesContent":["import { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { startGUI } from '../start-gui.ts'\nimport type { ViewFn } from '../view.ts'\n\n// this command is only a view, it doesn't actually do anything at this time\nexport const views: ViewFn<null> = async (_, __, conf) => {\n  await startGUI(conf)\n}\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'gui',\n    usage: '',\n    description: 'Launch a graphical user interface in a browser',\n  })\n\nexport const command: CommandFn = async () => null\n"]}

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

@@ -0,0 +1,4 @@
+import type { CommandFn, CommandUsage } from '../index.ts';
+export declare const usage: CommandUsage;
+export declare const command: CommandFn<string>;
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/commands/help.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,eAAO,MAAM,KAAK,EAAE,YAKhB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,MAAM,CAErC,CAAA"}

package/dist/esm/commands/help.js

@@ -0,0 +1,10 @@
+import { commandUsage } from "../config/usage.js";
+export const usage = () => commandUsage({
+    command: 'help',
+    usage: '',
+    description: 'Print the full help output for the CLI',
+});
+export const command = async (conf) => {
+    return conf.jack.usage();
+};
+//# sourceMappingURL=help.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGjD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,wCAAwC;CACtD,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,OAAO,GAAsB,KAAK,EAAC,IAAI,EAAC,EAAE;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;AAC1B,CAAC,CAAA","sourcesContent":["import { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'help',\n    usage: '',\n    description: 'Print the full help output for the CLI',\n  })\n\nexport const command: CommandFn<string> = async conf => {\n  return conf.jack.usage()\n}\n"]}

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

@@ -0,0 +1,8 @@
+import type { CommandFn, CommandUsage } from '../index.ts';
+import type { InitFileResults } from '@vltpkg/init';
+export declare const usage: CommandUsage;
+export declare const views: {
+    readonly human: (results: InitFileResults, _options: import("../view.ts").ViewOptions, _config: import("../config/index.ts").ParsedConfig) => string;
+};
+export declare const command: CommandFn<InitFileResults>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAGnD,eAAO,MAAM,KAAK,EAAE,YAKhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;CAeyB,CAAA;AAE3C,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,eAAe,CACX,CAAA"}

package/dist/esm/commands/init.js

@@ -0,0 +1,25 @@
+import { commandUsage } from "../config/usage.js";
+import { init } from '@vltpkg/init';
+export const usage = () => commandUsage({
+    command: 'init',
+    usage: '',
+    description: `Create a new package.json file in the current directory.`,
+});
+export const views = {
+    human: (results, _options, _config) => {
+        const output = [];
+        // TODO: colorize the JSON if config.options.color
+        for (const [type, { path, data }] of Object.entries(results)) {
+            output.push(`Wrote ${type} to ${path}:
+
+${JSON.stringify(data, null, 2)}
+`);
+        }
+        output.push(`Modify/add properties using \`vlt pkg\`. For example:
+
+  vlt pkg set "description=My new project"`);
+        return output.join('\n');
+    },
+};
+export const command = async () => await init({ cwd: process.cwd() });
+//# sourceMappingURL=init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAInC,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,0DAA0D;CACxE,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QACpC,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,kDAAkD;QAClD,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,IAAI;;EAExC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;CAC9B,CAAC,CAAA;QACE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;;2CAE2B,CAAC,CAAA;QACxC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;CACwC,CAAA;AAE3C,MAAM,CAAC,MAAM,OAAO,GAA+B,KAAK,IAAI,EAAE,CAC5D,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA","sourcesContent":["import { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { init } from '@vltpkg/init'\nimport type { InitFileResults } from '@vltpkg/init'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'init',\n    usage: '',\n    description: `Create a new package.json file in the current directory.`,\n  })\n\nexport const views = {\n  human: (results, _options, _config) => {\n    const output: string[] = []\n    // TODO: colorize the JSON if config.options.color\n    for (const [type, { path, data }] of Object.entries(results)) {\n      output.push(`Wrote ${type} to ${path}:\n\n${JSON.stringify(data, null, 2)}\n`)\n    }\n    output.push(`Modify/add properties using \\`vlt pkg\\`. For example:\n\n  vlt pkg set \"description=My new project\"`)\n    return output.join('\\n')\n  },\n} as const satisfies Views<InitFileResults>\n\nexport const command: CommandFn<InitFileResults> = async () =>\n  await init({ cwd: process.cwd() })\n"]}

package/dist/esm/commands/install/reporter.d.ts

@@ -0,0 +1,10 @@
+import { ViewClass } from '../../view.ts';
+export declare class InstallReporter extends ViewClass {
+    #private;
+    start(): void;
+    done(_result: unknown, { time }: {
+        time: number;
+    }): undefined;
+    error(err: unknown): void;
+}
+//# sourceMappingURL=reporter.d.ts.map

package/dist/esm/commands/install/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../../src/commands/install/reporter.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAiFzC,qBAAa,eAAgB,SAAQ,SAAS;;IAG5C,KAAK;IAIL,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAMjD,KAAK,CAAC,GAAG,EAAE,OAAO;CAGnB"}

package/dist/esm/commands/install/reporter.js

@@ -0,0 +1,67 @@
+import { emitter } from '@vltpkg/output';
+import { Box, render, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import { createElement as $, Fragment, useLayoutEffect, useState, } from 'react';
+import { stdout } from "../../output.js";
+import { ViewClass } from "../../view.js";
+import { asError } from '@vltpkg/error-cause';
+const GraphStep = ({ text, step }) => {
+    if (step.state === 'waiting') {
+        return $(Text, { color: 'gray' }, text);
+    }
+    if (step.state === 'in_progress') {
+        return $(Text, { color: 'yellow' }, text, $(Spinner, { type: 'dots' }));
+    }
+    return $(Text, { color: 'green' }, text, ' ✓');
+};
+const App = () => {
+    const [requests, setRequests] = useState(0);
+    const [steps, setSteps] = useState({
+        build: {
+            state: 'waiting',
+        },
+        actual: {
+            state: 'waiting',
+        },
+        reify: {
+            state: 'waiting',
+        },
+    });
+    useLayoutEffect(() => {
+        const update = () => setRequests(p => p + 1);
+        emitter.on('request', update);
+        return () => emitter.off('request', update);
+    }, []);
+    useLayoutEffect(() => {
+        const update = ({ step, state }) => {
+            setSteps(p => ({
+                ...p,
+                [step]: {
+                    ...p[step],
+                    state: state === 'start' ? 'in_progress' : 'completed',
+                },
+            }));
+        };
+        emitter.on('graphStep', update);
+        return () => emitter.off('graphStep', update);
+    }, []);
+    return $(Fragment, null, $(Box, null, ...['build', 'actual', 'reify'].map((step, idx, list) => {
+        const separator = idx === list.length - 1 ? '' : ' > ';
+        return $(Text, { key: step }, $(GraphStep, { text: step, step: steps[step] }), $(Text, { color: 'gray' }, separator));
+    })), requests > 0 ? $(Text, null, `${requests} requests`) : null);
+};
+export class InstallReporter extends ViewClass {
+    #instance = null;
+    start() {
+        this.#instance = render($(App));
+    }
+    done(_result, { time }) {
+        this.#instance?.unmount();
+        stdout(`Done in ${time}ms`);
+        return undefined;
+    }
+    error(err) {
+        this.#instance?.unmount(asError(err));
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/esm/commands/install/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../../../src/commands/install/reporter.ts"],"names":[],"mappings":"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","sourcesContent":["import { emitter } from '@vltpkg/output'\nimport type { Events } from '@vltpkg/output'\nimport { Box, render, Text } from 'ink'\nimport type { Instance } from 'ink'\nimport Spinner from 'ink-spinner'\nimport {\n  createElement as $,\n  Fragment,\n  useLayoutEffect,\n  useState,\n} from 'react'\nimport { stdout } from '../../output.ts'\nimport { ViewClass } from '../../view.ts'\nimport { asError } from '@vltpkg/error-cause'\n\ntype Step = {\n  state: 'waiting' | 'in_progress' | 'completed'\n}\n\nconst GraphStep = ({ text, step }: { text: string; step: Step }) => {\n  if (step.state === 'waiting') {\n    return $(Text, { color: 'gray' }, text)\n  }\n  if (step.state === 'in_progress') {\n    return $(\n      Text,\n      { color: 'yellow' },\n      text,\n      $(Spinner, { type: 'dots' }),\n    )\n  }\n  return $(Text, { color: 'green' }, text, ' ✓')\n}\n\nconst App = () => {\n  const [requests, setRequests] = useState(0)\n\n  const [steps, setSteps] = useState<\n    Record<Events['graphStep']['step'], Step>\n  >({\n    build: {\n      state: 'waiting',\n    },\n    actual: {\n      state: 'waiting',\n    },\n    reify: {\n      state: 'waiting',\n    },\n  })\n\n  useLayoutEffect(() => {\n    const update = () => setRequests(p => p + 1)\n    emitter.on('request', update)\n    return () => emitter.off('request', update)\n  }, [])\n\n  useLayoutEffect(() => {\n    const update = ({ step, state }: Events['graphStep']) => {\n      setSteps(p => ({\n        ...p,\n        [step]: {\n          ...p[step],\n          state: state === 'start' ? 'in_progress' : 'completed',\n        },\n      }))\n    }\n    emitter.on('graphStep', update)\n    return () => emitter.off('graphStep', update)\n  }, [])\n\n  return $(\n    Fragment,\n    null,\n    $(\n      Box,\n      null,\n      ...(['build', 'actual', 'reify'] as const).map(\n        (step, idx, list) => {\n          const separator = idx === list.length - 1 ? '' : ' > '\n          return $(\n            Text,\n            { key: step },\n            $(GraphStep, { text: step, step: steps[step] }),\n            $(Text, { color: 'gray' }, separator),\n          )\n        },\n      ),\n    ),\n    requests > 0 ? $(Text, null, `${requests} requests`) : null,\n  )\n}\n\nexport class InstallReporter extends ViewClass {\n  #instance: Instance | null = null\n\n  start() {\n    this.#instance = render($(App))\n  }\n\n  done(_result: unknown, { time }: { time: number }) {\n    this.#instance?.unmount()\n    stdout(`Done in ${time}ms`)\n    return undefined\n  }\n\n  error(err: unknown) {\n    this.#instance?.unmount(asError(err))\n  }\n}\n"]}

package/dist/esm/commands/install.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=install.d.ts.map

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

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

package/dist/esm/commands/install.js

@@ -0,0 +1,21 @@
+import { commandUsage } from "../config/usage.js";
+import { install } from '@vltpkg/graph';
+import { parseAddArgs } from "../parse-add-remove-args.js";
+import { InstallReporter } from "./install/reporter.js";
+export const usage = () => commandUsage({
+    command: 'install',
+    usage: '[packages ...]',
+    description: `Install the specified packages, updating package.json and
+                  vlt-lock.json appropriately.`,
+});
+export const views = {
+    json: g => g.toJSON(),
+    human: InstallReporter,
+};
+export const command = async (conf) => {
+    const monorepo = conf.options.monorepo;
+    const { add } = parseAddArgs(conf, monorepo);
+    const { graph } = await install(conf.options, add);
+    return graph;
+};
+//# sourceMappingURL=install.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/install.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE;+CAC8B;CAC5C,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,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IACtC,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC5C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAClD,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 { parseAddArgs } from '../parse-add-remove-args.ts'\nimport type { Views } from '../view.ts'\nimport { InstallReporter } from './install/reporter.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'install',\n    usage: '[packages ...]',\n    description: `Install the specified packages, updating package.json and\n                  vlt-lock.json appropriately.`,\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 monorepo = conf.options.monorepo\n  const { add } = parseAddArgs(conf, monorepo)\n  const { graph } = await install(conf.options, add)\n  return graph\n}\n"]}

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

@@ -0,0 +1,15 @@
+import type { HumanReadableOutputGraph, JSONOutputGraph, MermaidOutputGraph } from '@vltpkg/graph';
+import { humanReadableOutput, jsonOutput, mermaidOutput } from '@vltpkg/graph';
+import type { CommandFn, CommandUsage } from '../index.ts';
+export declare const usage: CommandUsage;
+export type ListResult = JSONOutputGraph & MermaidOutputGraph & HumanReadableOutputGraph & {
+    queryString: string;
+};
+export declare const views: {
+    readonly json: typeof jsonOutput;
+    readonly mermaid: typeof mermaidOutput;
+    readonly human: typeof humanReadableOutput;
+    readonly gui: ({ queryString }: ListResult, _: import("../view.ts").ViewOptions, conf: import("../config/index.ts").ParsedConfig) => Promise<void>;
+};
+export declare const command: CommandFn<ListResult>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAEnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAEL,mBAAmB,EACnB,UAAU,EACV,aAAa,EACd,MAAM,eAAe,CAAA;AAItB,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,eAAO,MAAM,KAAK,EAAE,YA4ChB,CAAA;AAEJ,MAAM,MAAM,UAAU,GAAG,eAAe,GACtC,kBAAkB,GAClB,wBAAwB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD,eAAO,MAAM,KAAK;;;;;CAUoB,CAAA;AAEtC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CAmEzC,CAAA"}