@vltpkg/cli-sdk 0.0.0-9 → 1.0.0-rc.1

package/dist/esm/commands/docs.js

@@ -0,0 +1,154 @@
+import { error } from '@vltpkg/error-cause';
+import { PackageInfoClient } from '@vltpkg/package-info';
+import { Spec } from '@vltpkg/spec';
+import { urlOpen } from '@vltpkg/url-open';
+import { actual } from '@vltpkg/graph';
+import { Query } from '@vltpkg/query';
+import { SecurityArchive } from '@vltpkg/security-archive';
+import { createHostContextsMap } from "../query-host-contexts.js";
+import { commandUsage } from "../config/usage.js";
+import hostedGitInfo from 'hosted-git-info';
+const { fromUrl: hostedGitInfoFromUrl } = hostedGitInfo;
+export const usage = () => commandUsage({
+    command: 'docs',
+    usage: ['[<spec>]', '[--target=<query>]'],
+    description: `Open documentation for a package in a web browser.
+                  Reads repository information from package.json or fetches
+                  manifest data for the specified package.`,
+    options: {
+        target: {
+            value: '<query>',
+            description: 'Query selector to filter packages using DSS syntax.',
+        },
+    },
+    examples: {
+        '': {
+            description: 'Open docs for the current package (reads local package.json)',
+        },
+        'abbrev@2.0.0': {
+            description: 'Open docs for a specific package version',
+        },
+        '--target=":root > *"': {
+            description: 'List documentation URLs for all direct dependencies',
+        },
+    },
+});
+export const views = {
+    human: r => {
+        if (Array.isArray(r)) {
+            let msg = 'Multiple package docs found:\n';
+            msg += r.map(item => `• ${item.name}: ${item.url}`).join('\n');
+            return msg;
+        }
+        return '';
+    },
+    json: r => r,
+};
+const getUrlFromManifest = (manifest) => {
+    const { name, homepage, repository } = manifest;
+    if (!name) {
+        throw error('No package name found');
+    }
+    // Extract repository URL
+    let url;
+    if (homepage) {
+        url = homepage;
+    }
+    else if (repository) {
+        const repoUrl = typeof repository === 'string' ? repository
+            : typeof repository === 'object' && 'url' in repository ?
+                repository.url
+                : /* c8 ignore next */ undefined;
+        if (repoUrl) {
+            // Try to get hosted git info
+            const info = hostedGitInfoFromUrl(repoUrl.replace(/^git\+/, ''));
+            if (info?.docs && typeof info.docs === 'function') {
+                url = info.docs();
+            }
+        }
+    }
+    // Fallback to npmjs.com package page
+    if (!url) {
+        url = `https://www.npmjs.com/package/${name}`;
+    }
+    return url;
+};
+export const command = async (conf) => {
+    const { projectRoot, packageJson } = conf.options;
+    const targetOption = conf.get('target');
+    // Handle --target query
+    if (targetOption) {
+        const mainManifest = packageJson.maybeRead(projectRoot);
+        if (!mainManifest) {
+            throw error('No package.json found in project root', {
+                path: projectRoot,
+            });
+        }
+        const graph = actual.load({
+            ...conf.options,
+            mainManifest,
+            monorepo: conf.options.monorepo,
+            loadManifests: true,
+        });
+        const securityArchive = Query.hasSecuritySelectors(targetOption) ?
+            await SecurityArchive.start({
+                nodes: [...graph.nodes.values()],
+            })
+            : undefined;
+        const hostContexts = await createHostContextsMap(conf);
+        const query = new Query({
+            nodes: new Set(graph.nodes.values()),
+            edges: graph.edges,
+            importers: graph.importers,
+            securityArchive,
+            hostContexts,
+        });
+        const { nodes } = await query.search(targetOption, {
+            signal: new AbortController().signal,
+        });
+        const results = [];
+        for (const node of nodes) {
+            if (!node.manifest)
+                continue;
+            const url = getUrlFromManifest(node.manifest);
+            results.push({
+                url,
+                name: node.name /* c8 ignore next */ ?? '(unknown)',
+            });
+        }
+        if (results.length === 0) {
+            throw error('No packages found matching target query', {
+                found: targetOption,
+            });
+        }
+        // If single result, open it
+        if (results.length === 1) {
+            const result = results[0];
+            /* c8 ignore next 3 */
+            if (!result) {
+                throw error('Unexpected empty result');
+            }
+            await urlOpen(result.url);
+            return result;
+        }
+        // Multiple results, return the list
+        return results;
+    }
+    // read the package spec from a positional argument or local package.json
+    const specArg = conf.positionals[0];
+    const manifest = conf.positionals.length === 0 ? packageJson.read(projectRoot)
+        : specArg ?
+            await new PackageInfoClient(conf.options).manifest(Spec.parseArgs(specArg, conf.options))
+            : /* c8 ignore next */ packageJson.read(projectRoot);
+    const url = getUrlFromManifest(manifest);
+    const { name } = manifest;
+    /* c8 ignore start - getUrlFromManifest already validates name */
+    if (!name) {
+        throw error('No package name found');
+    }
+    /* c8 ignore stop */
+    // Open the URL
+    await urlOpen(url);
+    return { url, name };
+};
+//# sourceMappingURL=docs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/commands/docs.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { PackageInfoClient } from '@vltpkg/package-info'\nimport { Spec } from '@vltpkg/spec'\nimport { urlOpen } from '@vltpkg/url-open'\nimport { actual } from '@vltpkg/graph'\nimport { Query } from '@vltpkg/query'\nimport { SecurityArchive } from '@vltpkg/security-archive'\nimport { createHostContextsMap } from '../query-host-contexts.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { Views } from '../view.ts'\nimport type { Manifest, NormalizedManifest } from '@vltpkg/types'\nimport hostedGitInfo from 'hosted-git-info'\nconst { fromUrl: hostedGitInfoFromUrl } = hostedGitInfo as {\n  fromUrl: (url: string) => { docs?: () => string } | null\n}\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'docs',\n    usage: ['[<spec>]', '[--target=<query>]'],\n    description: `Open documentation for a package in a web browser.\n                  Reads repository information from package.json or fetches\n                  manifest data for the specified package.`,\n    options: {\n      target: {\n        value: '<query>',\n        description:\n          'Query selector to filter packages using DSS syntax.',\n      },\n    },\n    examples: {\n      '': {\n        description:\n          'Open docs for the current package (reads local package.json)',\n      },\n      'abbrev@2.0.0': {\n        description: 'Open docs for a specific package version',\n      },\n      '--target=\":root > *\"': {\n        description:\n          'List documentation URLs for all direct dependencies',\n      },\n    },\n  })\n\ntype CommandResultSingle = {\n  url: string\n  name: string\n}\n\ntype CommandResultMultiple = {\n  url: string\n  name: string\n}[]\n\nexport type CommandResult =\n  | CommandResultSingle\n  | CommandResultMultiple\n\nexport const views = {\n  human: r => {\n    if (Array.isArray(r)) {\n      let msg = 'Multiple package docs found:\\n'\n      msg += r.map(item => `• ${item.name}: ${item.url}`).join('\\n')\n      return msg\n    }\n    return ''\n  },\n  json: r => r,\n} as const satisfies Views<CommandResult>\n\nconst getUrlFromManifest = (\n  manifest: Manifest | NormalizedManifest,\n): string => {\n  const { name, homepage, repository } = manifest\n\n  if (!name) {\n    throw error('No package name found')\n  }\n\n  // Extract repository URL\n  let url: string | undefined\n\n  if (homepage) {\n    url = homepage\n  } else if (repository) {\n    const repoUrl =\n      typeof repository === 'string' ? repository\n      : typeof repository === 'object' && 'url' in repository ?\n        repository.url\n      : /* c8 ignore next */ undefined\n\n    if (repoUrl) {\n      // Try to get hosted git info\n\n      const info = hostedGitInfoFromUrl(repoUrl.replace(/^git\\+/, ''))\n\n      if (info?.docs && typeof info.docs === 'function') {\n        url = info.docs()\n      }\n    }\n  }\n\n  // Fallback to npmjs.com package page\n  if (!url) {\n    url = `https://www.npmjs.com/package/${name}`\n  }\n\n  return url\n}\n\nexport const command: CommandFn<CommandResult> = async conf => {\n  const { projectRoot, packageJson } = conf.options\n  const targetOption = conf.get('target')\n\n  // Handle --target query\n  if (targetOption) {\n    const mainManifest = packageJson.maybeRead(projectRoot)\n    if (!mainManifest) {\n      throw error('No package.json found in project root', {\n        path: projectRoot,\n      })\n    }\n\n    const graph = actual.load({\n      ...conf.options,\n      mainManifest,\n      monorepo: conf.options.monorepo,\n      loadManifests: true,\n    })\n\n    const securityArchive =\n      Query.hasSecuritySelectors(targetOption) ?\n        await SecurityArchive.start({\n          nodes: [...graph.nodes.values()],\n        })\n      : undefined\n\n    const hostContexts = await createHostContextsMap(conf)\n    const query = new Query({\n      nodes: new Set(graph.nodes.values()),\n      edges: graph.edges,\n      importers: graph.importers,\n      securityArchive,\n      hostContexts,\n    })\n\n    const { nodes } = await query.search(targetOption, {\n      signal: new AbortController().signal,\n    })\n\n    const results: CommandResultMultiple = []\n    for (const node of nodes) {\n      if (!node.manifest) continue\n      const url = getUrlFromManifest(node.manifest)\n      results.push({\n        url,\n        name: node.name /* c8 ignore next */ ?? '(unknown)',\n      })\n    }\n\n    if (results.length === 0) {\n      throw error('No packages found matching target query', {\n        found: targetOption,\n      })\n    }\n\n    // If single result, open it\n    if (results.length === 1) {\n      const result = results[0]\n      /* c8 ignore next 3 */\n      if (!result) {\n        throw error('Unexpected empty result')\n      }\n      await urlOpen(result.url)\n      return result\n    }\n\n    // Multiple results, return the list\n    return results\n  }\n\n  // read the package spec from a positional argument or local package.json\n  const specArg = conf.positionals[0]\n  const manifest =\n    conf.positionals.length === 0 ? packageJson.read(projectRoot)\n    : specArg ?\n      await new PackageInfoClient(conf.options).manifest(\n        Spec.parseArgs(specArg, conf.options),\n      )\n    : /* c8 ignore next */ packageJson.read(projectRoot)\n\n  const url = getUrlFromManifest(manifest)\n  const { name } = manifest\n  /* c8 ignore start - getUrlFromManifest already validates name */\n  if (!name) {\n    throw error('No package name found')\n  }\n  /* c8 ignore stop */\n  // Open the URL\n  await urlOpen(url)\n\n  return { url, name }\n}\n"]}

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

@@ -0,0 +1,49 @@
+import type { VlxInfo } from '@vltpkg/vlx';
+import type { LoadedConfig } from '../config/index.ts';
+import type { CommandFn, CommandUsage } from '../index.ts';
+import type { ViewOptions, Views } from '../view.ts';
+import { ViewClass } from '../view.ts';
+export type ExecCacheSubcommands = keyof (typeof usageDef)['subcommands'];
+export declare class ExecCacheView extends ViewClass {
+    constructor(options: ViewOptions, conf: LoadedConfig);
+    stdout(...args: unknown[]): void;
+}
+export declare const views: Views<void | string[] | VlxInfo[]>;
+declare const usageDef: {
+    readonly command: "exec-cache";
+    readonly usage: "<command> [flags]";
+    readonly description: "Work with vlt exec-cache folders";
+    readonly subcommands: {
+        readonly ls: {
+            readonly usage: "";
+            readonly description: "Show previously installed packages used for `vlt exec`.\n                    Key provided can be either the package name, or the full\n                    key.";
+        };
+        readonly delete: {
+            readonly usage: "[<key>...]";
+            readonly description: "Delete previously installed packages used for\n                    `vlt exec`. If no keys are provided, then all entries\n                    will be deleted.";
+        };
+        readonly info: {
+            readonly usage: "<key>";
+            readonly description: "Show extended information about a given `vlt exec`\n                    installation.";
+        };
+        readonly install: {
+            readonly usage: "<spec>...";
+            readonly description: "Install the specified package(s) in the `vlt exec`\n                    central cache location. Metadata info about each\n                    installation will be printed.";
+        };
+    };
+    readonly examples: {
+        readonly ls: {
+            readonly description: "Show all the keys for the installations in the `vlt exec`\n                    cache.";
+        };
+        readonly 'delete typescript': {
+            readonly description: "Delete all versions of typescript installed for vlt exec";
+        };
+        readonly 'info typescript-695bf962': {
+            readonly description: "Show extended info about a specific version of typescript";
+        };
+    };
+};
+export declare const usage: CommandUsage;
+export declare const command: CommandFn<string[] | VlxInfo[]>;
+export {};
+//# sourceMappingURL=exec-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exec-cache.d.ts","sourceRoot":"","sources":["../../../src/commands/exec-cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtC,MAAM,MAAM,oBAAoB,GAC9B,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAC,aAAa,CAAC,CAAA;AAGxC,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY;IAIpD,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;CAG1B;AAED,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,IAAI,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,CAEpD,CAAA;AAED,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8C6B,CAAA;AAE3C,eAAO,MAAM,KAAK,EAAE,YAA2C,CAAA;AAE/D,eAAO,MAAM,OAAO,EAAE,SAAS,CAC7B,MAAM,EAAE,GAAG,OAAO,EAAE,CAwBrB,CAAA"}

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

@@ -0,0 +1,146 @@
+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',
+        });
+    }
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    return Promise.all(keys.map(async (key) => {
+        const info = await vlx.install(key, {
+            ...conf.options,
+            query: undefined,
+            allowScripts,
+        });
+        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 allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    const results = [];
+    for await (const key of keys.length ? keys : vlx.list()) {
+        const info = vlx.info(key, {
+            ...conf.options,
+            query: undefined,
+            allowScripts,
+        });
+        results.push(info);
+        view?.stdout(info);
+    }
+    return results;
+};
+const deleteEntries = async (conf, keys, view) => {
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    const remover = new RollbackRemove();
+    const removed = (await vlx.delete(keys, remover, {
+        ...conf.options,
+        query: undefined,
+        allowScripts,
+    })).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":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAExD,OAAO,KAAK,GAAG,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGpC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAKtC,IAAI,IAAmB,CAAA;AACvB,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,YAAY,OAAoB,EAAE,IAAkB;QAClD,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACpB,IAAI,GAAG,IAAI,CAAA;IACb,CAAC;IACD,MAAM,CAAC,GAAG,IAAe;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAA;IACjB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,KAAK,GAAuC;IACvD,KAAK,EAAE,aAAa;CACrB,CAAA;AAED,MAAM,QAAQ,GAAG;IACf,OAAO,EAAE,YAAY;IACrB,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,kCAAkC;IAE/C,WAAW,EAAE;QACX,EAAE,EAAE;YACF,KAAK,EAAE,EAAE;YACT,WAAW,EAAE;;yBAEM;SACpB;QAED,MAAM,EAAE;YACN,KAAK,EAAE,YAAY;YACnB,WAAW,EAAE;;qCAEkB;SAChC;QAED,IAAI,EAAE;YACJ,KAAK,EAAE,OAAO;YACd,WAAW,EAAE;kCACe;SAC7B;QAED,OAAO,EAAE;YACP,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE;;kDAE+B;SAC7C;KACF;IAED,QAAQ,EAAE;QACR,EAAE,EAAE;YACF,WAAW,EAAE;2BACQ;SACtB;QACD,mBAAmB,EAAE;YACnB,WAAW,EAAE,0DAA0D;SACxE;QACD,0BAA0B,EAAE;YAC1B,WAAW,EAAE,2DAA2D;SACzE;KACF;CACwC,CAAA;AAE3C,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;AAE/D,MAAM,CAAC,MAAM,OAAO,GAEhB,KAAK,EAAC,IAAI,EAAC,EAAE;IACf,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAA;IACvC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,IAAI;YACP,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QAE7B,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QAE/B,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QAElC,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QAExC,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,KAAK,CAAC,iCAAiC,EAAE;gBAC7C,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;aAChD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,KAAK,EACnB,IAAkB,EAClB,IAAc,EACd,IAAoB,EACD,EAAE;IACrB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,KAAK,CAAC,uCAAuC,EAAE;YACnD,IAAI,EAAE,QAAQ;SACf,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,YAAY,GAChB,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC,CAAC,SAAS,CAAA;IACb,OAAO,OAAO,CAAC,GAAG,CAChB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAC,GAAG,EAAC,EAAE;QACnB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE;YAClC,GAAG,IAAI,CAAC,OAAO;YACf,KAAK,EAAE,SAAS;YAChB,YAAY;SACb,CAAC,CAAA;QACF,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAClB,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC,CAAC,CACH,CAAA;AACH,CAAC,CAAA;AAED,MAAM,EAAE,GAAG,KAAK,EACd,KAAmB,EACnB,IAAc,EACd,IAAoB,EACD,EAAE;IACrB,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC1B,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,SAAQ;QAC7D,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;IACnB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,IAAI,GAAG,KAAK,EAChB,IAAkB,EAClB,IAAc,EACd,IAAoB,EACA,EAAE;IACtB,MAAM,YAAY,GAChB,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,OAAO,GAAc,EAAE,CAAA;IAC7B,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE;YACzB,GAAG,IAAI,CAAC,OAAO;YACf,KAAK,EAAE,SAAS;YAChB,YAAY;SACb,CAAC,CAAA;QACF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,KAAK,EACzB,IAAkB,EAClB,IAAc,EACd,IAAoB,EACD,EAAE;IACrB,MAAM,YAAY,GAChB,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAA;IACpC,MAAM,OAAO,GAAG,CACd,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE;QAC9B,GAAG,IAAI,CAAC,OAAO;QACf,KAAK,EAAE,SAAS;QAChB,YAAY;KACb,CAAC,CACH,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACnC,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;IACF,OAAO,CAAC,OAAO,EAAE,CAAA;IACjB,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA","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  const allowScripts =\n    conf.get('allow-scripts') ?\n      String(conf.get('allow-scripts'))\n    : ':not(*)'\n  return Promise.all(\n    keys.map(async key => {\n      const info = await vlx.install(key, {\n        ...conf.options,\n        query: undefined,\n        allowScripts,\n      })\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 allowScripts =\n    conf.get('allow-scripts') ?\n      String(conf.get('allow-scripts'))\n    : ':not(*)'\n  const results: VlxInfo[] = []\n  for await (const key of keys.length ? keys : vlx.list()) {\n    const info = vlx.info(key, {\n      ...conf.options,\n      query: undefined,\n      allowScripts,\n    })\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 allowScripts =\n    conf.get('allow-scripts') ?\n      String(conf.get('allow-scripts'))\n    : ':not(*)'\n  const remover = new RollbackRemove()\n  const removed = (\n    await vlx.delete(keys, remover, {\n      ...conf.options,\n      query: undefined,\n      allowScripts,\n    })\n  ).map(path => {\n    view?.stdout(`- ${basename(path)}`)\n    return path\n  })\n  remover.confirm()\n  return removed\n}\n"]}

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

@@ -1,5 +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

@@ -1 +1 @@
-{"version":3,"file":"exec-local.d.ts","sourceRoot":"","sources":["../../../src/commands/exec-local.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,eAAO,MAAM,KAAK,EAAE,YAehB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CAEzC,CAAA"}
+{"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

@@ -1,6 +1,7 @@
 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]',
@@ -17,6 +18,7 @@ export const usage = () => commandUsage({
                   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

@@ -1 +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;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAIhD,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,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 { ExecCommand } from '../exec-command.ts'\nimport type { ExecResult } from '../exec-command.ts'\nimport type { CommandFn, CommandUsage } from '../index.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  return await new ExecCommand(conf, exec, execFG).run()\n}\n"]}
+{"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

@@ -1,4 +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 command: CommandFn<string>;
+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

@@ -1 +1 @@
-{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/commands/exec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,eAAO,MAAM,KAAK,EAAE,YAMhB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,MAAM,CAKrC,CAAA"}
+{"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,CAoBzC,CAAA"}

package/dist/esm/commands/exec.js

@@ -1,13 +1,87 @@
+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',
+    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) => {
-    return [
-        'TODO: exec-local, but install if not present',
-        ...conf.positionals,
-    ].join('\n');
+    /* c8 ignore start */
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    /* c8 ignore stop */
+    const arg0 = await vlx.resolve(conf.positionals, {
+        ...conf.options,
+        query: undefined,
+        allowScripts,
+    }, 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

@@ -1 +1 @@
-{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/commands/exec.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,gCAAgC;IACvC,WAAW,EACT,gEAAgE;CACnE,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,OAAO,GAAsB,KAAK,EAAC,IAAI,EAAC,EAAE;IACrD,OAAO;QACL,8CAA8C;QAC9C,GAAG,IAAI,CAAC,WAAW;KACpB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,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: 'exec',\n    usage: '[--package=<pkg>] [command...]',\n    description:\n      'Run a command defined by a package, installing it if necessary',\n  })\n\nexport const command: CommandFn<string> = async conf => {\n  return [\n    'TODO: exec-local, but install if not present',\n    ...conf.positionals,\n  ].join('\\n')\n}\n"]}
+{"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,qBAAqB;IACrB,MAAM,YAAY,GAChB,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC,CAAC,SAAS,CAAA;IACb,oBAAoB;IACpB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAC5B,IAAI,CAAC,WAAW,EAChB;QACE,GAAG,IAAI,CAAC,OAAO;QACf,KAAK,EAAE,SAAS;QAChB,YAAY;KACb,EACD,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  /* c8 ignore start */\n  const allowScripts =\n    conf.get('allow-scripts') ?\n      String(conf.get('allow-scripts'))\n    : ':not(*)'\n  /* c8 ignore stop */\n  const arg0 = await vlx.resolve(\n    conf.positionals,\n    {\n      ...conf.options,\n      query: undefined,\n      allowScripts,\n    },\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/help.d.ts

@@ -1,4 +1,4 @@
-import type { CommandFn, CommandUsage } from '../index.ts';
+import type { CommandFn, CommandUsage } from '../load-command.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

@@ -1 +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"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/commands/help.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAQjE,eAAO,MAAM,KAAK,EAAE,YAWhB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,MAAM,CA0BrC,CAAA"}

package/dist/esm/commands/help.js

@@ -1,10 +1,39 @@
+import { error } from '@vltpkg/error-cause';
 import { commandUsage } from "../config/usage.js";
+import { loadCommand } from "../load-command.js";
+import { getCommand } from "../config/definition.js";
+import { generateDefaultHelp, generateFullHelp, } from "../custom-help.js";
 export const usage = () => commandUsage({
     command: 'help',
-    usage: '',
-    description: 'Print the full help output for the CLI',
+    usage: '[<command>]',
+    description: 'Print the full help output for the CLI, or help for a specific command',
+    examples: {
+        '': { description: 'Show general CLI help' },
+        install: { description: 'Show help for the install command' },
+        run: { description: 'Show help for the run command' },
+    },
 });
 export const command = async (conf) => {
-    return conf.jack.usage();
+    // If no positional arguments, show general help
+    if (conf.positionals.length === 0) {
+        // Check for color support (prefer explicit config, fall back to TTY detection)
+        const colors = conf.values.color ?? process.stdout.isTTY;
+        // Use full custom help if --all flag is set
+        if (conf.values.all) {
+            return generateFullHelp(colors);
+        }
+        return generateDefaultHelp(colors);
+    }
+    // Get the command name from the first positional argument
+    const cmdName = conf.positionals[0];
+    const canonicalCmd = getCommand(cmdName);
+    if (!canonicalCmd) {
+        throw error(`Unknown command: ${cmdName}`, {
+            found: cmdName,
+            code: 'EUSAGE',
+        });
+    }
+    const command = await loadCommand(canonicalCmd);
+    return command.usage().usage();
 };
 //# sourceMappingURL=help.js.map