@vltpkg/vlx 0.0.0-10

package/LICENSE

@@ -0,0 +1,15 @@
+Copyright (c) vlt technology, Inc.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+   Subject to the terms and conditions of this license, each copyright holder and contributor hereby grants to those receiving rights under this license a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except for failure to satisfy the conditions of this license) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer this software, where such license applies only to those patent claims, already acquired or hereafter acquired, licensable by such copyright holder or contributor that are necessarily infringed by:
+
+(a) their Contribution(s) (the licensed copyrights of copyright holders and non-copyrightable additions of contributors, in source or binary form) alone; or
+(b) combination of their Contribution(s) with the work of authorship to which such Contribution(s) was added by such copyright holder or contributor, if, at the time the Contribution is added, such addition causes such combination to be necessarily infringed. The patent license shall not apply to any other combinations which include the Contribution.
+Except as expressly stated above, no rights or licenses from any copyright holder or contributor is granted under this license, whether expressly, by implication, estoppel or otherwise.
+
+DISCLAIMER
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,78 @@
+# @vltpkg/vlx
+
+Executable management for `vlt exec`.
+
+**[Usage](#usage)**
+
+## Overview
+
+This is a tool that provides the global installs used by `vlt exec`
+(that is, when it's not a local installed dependency).
+
+## Usage
+
+```ts
+import * as vlx from '@vltpkg/vlx'
+
+// get the options and arguments in the normal ways
+const conf: LoadedConfig = blahblahblah()
+
+const { positionals, options } = conf
+
+// Provide a promptFn which is `()=>Promise<string>` if you want
+// to confirm before installing things. If it returns a string
+// that does not start with the letter 'y', then operation will
+// be aborted. If not provided, consent is assumed.
+const promptFn = async (pkgSpec: Spec, path: string) => {
+  const result = await createInterface(
+    process.stdin,
+    process.stdout,
+  ).question(`Installing ${pkgSpec} in ${path}, is this ok? (y)`)
+  process.stdin.pause()
+  return result
+}
+
+// figure out the correct executable, adding it to the user's
+// XDG.data directory if appropriate, based on the positional
+// args and the package option. Other options are used
+// appropriately for installation, resolution, etc.
+const arg0 = await vlx.resolve(positionals, options, promptFn)
+
+// now one of the following is true:
+// - arg0 refers to a locally installed package bin
+// - arg0 refers to a package bin in the XDG.data directory
+// - arg0 is undefined, and an interactive shell can be executed
+// - an error was thrown, because it couijld not be determined
+if (arg0 === undefined) {
+  doInteractiveShellOrWhatever()
+} else {
+  runTheCommandOrWhatever([arg0, ...positionals.slice(2)])
+}
+
+// some other stuff this can do:
+
+// explicitly add a package install to the XDG.data dir, if
+// not already present. Returns the key used to reference
+// the install for removal or inspection.
+const info = await vlx.install('somepkg@somespec', options)
+
+// remove an installed instance, if present
+// returns a list of paths that were removed
+const removed = await vlx.delete(['somepkg'], remover, options)
+const removed = await vlx.delete(['somepkg'], remover, options)
+
+// list the paths for all installs in the XDG.data directory
+const installPaths = await vlx.list()
+
+// get information about a given install, or undefined missing
+const {
+  // the manifest of the synthetic vlx project depending on that package
+  manifest,
+  // path to the synthetic vlx project
+  path,
+  // the resolved package dependency, if it came from the vlx cache
+  resolved,
+  // the inferred default binary, if one could be determined.
+  arg0,
+} = await vlx.info(path, options)
+```

package/dist/esm/add-to-path.d.ts

@@ -0,0 +1,2 @@
+export declare const addToPATH: (newPath: string) => void;
+//# sourceMappingURL=add-to-path.d.ts.map

package/dist/esm/add-to-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-to-path.d.ts","sourceRoot":"","sources":["../../src/add-to-path.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,YAAa,MAAM,SAUxC,CAAA"}

package/dist/esm/add-to-path.js

@@ -0,0 +1,9 @@
+import { delimiter } from 'node:path';
+export const addToPATH = (newPath) => {
+    process.env.PATH = [
+        ...new Set(`${newPath}${delimiter}${process.env.PATH ?? ''}`.split(delimiter)),
+    ]
+        .filter(p => !!p)
+        .join(delimiter);
+};
+//# sourceMappingURL=add-to-path.js.map

package/dist/esm/add-to-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-to-path.js","sourceRoot":"","sources":["../../src/add-to-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAE,EAAE;IAC3C,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG;QACjB,GAAG,IAAI,GAAG,CACR,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,KAAK,CACrD,SAAS,CACV,CACF;KACF;SACE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SAChB,IAAI,CAAC,SAAS,CAAC,CAAA;AACpB,CAAC,CAAA","sourcesContent":["import { delimiter } from 'node:path'\n\nexport const addToPATH = (newPath: string) => {\n  process.env.PATH = [\n    ...new Set(\n      `${newPath}${delimiter}${process.env.PATH ?? ''}`.split(\n        delimiter,\n      ),\n    ),\n  ]\n    .filter(p => !!p)\n    .join(delimiter)\n}\n"]}

package/dist/esm/delete.d.ts

@@ -0,0 +1,4 @@
+import type { RollbackRemove } from '@vltpkg/rollback-remove';
+import type { VlxOptions } from './index.ts';
+export declare const vlxDelete: (keys: string[], remover: RollbackRemove, options: VlxOptions) => Promise<string[]>;
+//# sourceMappingURL=delete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/delete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAY5C,eAAO,MAAM,SAAS,SACd,MAAM,EAAE,WACL,cAAc,WACd,UAAU,sBAqBpB,CAAA"}

package/dist/esm/delete.js

@@ -0,0 +1,35 @@
+import { basename } from 'node:path';
+import { vlxInfo } from "./info.js";
+import { vlxList } from "./list.js";
+const keyMatch = (keys, path) => {
+    if (!keys.length)
+        return true;
+    for (const k of keys) {
+        if (path.includes(k))
+            return true;
+    }
+    return false;
+};
+export const vlxDelete = async (keys, remover, options) => {
+    const removed = [];
+    const promises = [];
+    for await (const p of vlxList()) {
+        // if the request for info fails, delete it
+        const key = basename(p);
+        try {
+            vlxInfo(p, options);
+            if (keyMatch(keys, key)) {
+                promises.push(remover.rm(p));
+                removed.push(key);
+            }
+        }
+        catch {
+            // delete if no good
+            promises.push(remover.rm(p));
+            removed.push(key);
+        }
+    }
+    await Promise.all(promises);
+    return removed;
+};
+//# sourceMappingURL=delete.js.map

package/dist/esm/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,QAAQ,GAAG,CAAC,IAAc,EAAE,IAAY,EAAW,EAAE;IACzD,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAC7B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAA;IACnC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC5B,IAAc,EACd,OAAuB,EACvB,OAAmB,EACnB,EAAE;IACF,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,QAAQ,GAAoB,EAAE,CAAA;IACpC,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,EAAE,CAAC;QAChC,2CAA2C;QAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,CAAC;YACH,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;YACnB,IAAI,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;gBACxB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACnB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;YACpB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;YAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;IACD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC3B,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA","sourcesContent":["import type { RollbackRemove } from '@vltpkg/rollback-remove'\nimport { basename } from 'node:path'\nimport type { VlxOptions } from './index.ts'\nimport { vlxInfo } from './info.ts'\nimport { vlxList } from './list.ts'\n\nconst keyMatch = (keys: string[], path: string): boolean => {\n  if (!keys.length) return true\n  for (const k of keys) {\n    if (path.includes(k)) return true\n  }\n  return false\n}\n\nexport const vlxDelete = async (\n  keys: string[],\n  remover: RollbackRemove,\n  options: VlxOptions,\n) => {\n  const removed: string[] = []\n  const promises: Promise<void>[] = []\n  for await (const p of vlxList()) {\n    // if the request for info fails, delete it\n    const key = basename(p)\n    try {\n      vlxInfo(p, options)\n      if (keyMatch(keys, key)) {\n        promises.push(remover.rm(p))\n        removed.push(key)\n      }\n    } catch {\n      // delete if no good\n      promises.push(remover.rm(p))\n      removed.push(key)\n    }\n  }\n  await Promise.all(promises)\n  return removed\n}\n"]}

package/dist/esm/dir-exists.d.ts

@@ -0,0 +1,2 @@
+export declare const dirExists: (path: string) => Promise<boolean>;
+//# sourceMappingURL=dir-exists.d.ts.map

package/dist/esm/dir-exists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir-exists.d.ts","sourceRoot":"","sources":["../../src/dir-exists.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,SAAgB,MAAM,KAAG,OAAO,CAAC,OAAO,CAI3D,CAAA"}

package/dist/esm/dir-exists.js

@@ -0,0 +1,3 @@
+import { stat } from 'node:fs/promises';
+export const dirExists = async (path) => stat(path).then(st => st.isDirectory(), () => false);
+//# sourceMappingURL=dir-exists.js.map

package/dist/esm/dir-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir-exists.js","sourceRoot":"","sources":["../../src/dir-exists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAEvC,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE,CAChE,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CACb,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,EACtB,GAAG,EAAE,CAAC,KAAK,CACZ,CAAA","sourcesContent":["import { stat } from 'node:fs/promises'\n\nexport const dirExists = async (path: string): Promise<boolean> =>\n  stat(path).then(\n    st => st.isDirectory(),\n    () => false,\n  )\n"]}

package/dist/esm/do-prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Spec } from '@vltpkg/spec';
+import type { PromptFn } from './index.ts';
+export declare const doPrompt: (spec: Spec, dir: string, resolution: string, fn?: PromptFn) => Promise<boolean>;
+//# sourceMappingURL=do-prompt.d.ts.map

package/dist/esm/do-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-prompt.d.ts","sourceRoot":"","sources":["../../src/do-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,eAAO,MAAM,QAAQ,SACb,IAAI,OACL,MAAM,cACC,MAAM,OACb,QAAQ,KACZ,OAAO,CAAC,OAAO,CAMjB,CAAA"}

package/dist/esm/do-prompt.js

@@ -0,0 +1,9 @@
+export const doPrompt = async (spec, dir, resolution, fn) => {
+    if (!fn)
+        return true;
+    const result = (await fn(spec, dir, resolution))
+        .trim()
+        .toLowerCase();
+    return !result || result.startsWith('y');
+};
+//# sourceMappingURL=do-prompt.js.map

package/dist/esm/do-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-prompt.js","sourceRoot":"","sources":["../../src/do-prompt.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,IAAU,EACV,GAAW,EACX,UAAkB,EAClB,EAAa,EACK,EAAE;IACpB,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAA;IACpB,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;SAC7C,IAAI,EAAE;SACN,WAAW,EAAE,CAAA;IAChB,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;AAC1C,CAAC,CAAA","sourcesContent":["import type { Spec } from '@vltpkg/spec'\nimport type { PromptFn } from './index.ts'\n\nexport const doPrompt = async (\n  spec: Spec,\n  dir: string,\n  resolution: string,\n  fn?: PromptFn,\n): Promise<boolean> => {\n  if (!fn) return true\n  const result = (await fn(spec, dir, resolution))\n    .trim()\n    .toLowerCase()\n  return !result || result.startsWith('y')\n}\n"]}

package/dist/esm/find-executable.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Find the executable in a node_modules/.bin folder between the cwd
+ * and the projectRoot.
+ *
+ * Returns `[executable, target]` showing the package origin.
+ */
+export declare const findExecutable: (arg0: string, projectRoot: string) => Promise<string | undefined>;
+//# sourceMappingURL=find-executable.d.ts.map

package/dist/esm/find-executable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-executable.d.ts","sourceRoot":"","sources":["../../src/find-executable.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,SACnB,MAAM,eACC,MAAM,gCASpB,CAAA"}

package/dist/esm/find-executable.js

@@ -0,0 +1,19 @@
+import { findCmdShimIfExists } from '@vltpkg/cmd-shim';
+import { relative, resolve } from 'node:path';
+import { walkUp } from 'walk-up-path';
+/**
+ * Find the executable in a node_modules/.bin folder between the cwd
+ * and the projectRoot.
+ *
+ * Returns `[executable, target]` showing the package origin.
+ */
+export const findExecutable = async (arg0, projectRoot) => {
+    for (const path of walkUp(process.cwd())) {
+        const bin = await findCmdShimIfExists(resolve(path, 'node_modules/.bin', arg0));
+        if (bin)
+            return bin[0];
+        if (relative(path, projectRoot) === '')
+            break;
+    }
+};
+//# sourceMappingURL=find-executable.js.map

package/dist/esm/find-executable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-executable.js","sourceRoot":"","sources":["../../src/find-executable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,IAAY,EACZ,WAAmB,EACnB,EAAE;IACF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,mBAAmB,CACnC,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,IAAI,CAAC,CACzC,CAAA;QACD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAA;QACtB,IAAI,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE;YAAE,MAAK;IAC/C,CAAC;AACH,CAAC,CAAA","sourcesContent":["import { findCmdShimIfExists } from '@vltpkg/cmd-shim'\nimport { relative, resolve } from 'node:path'\nimport { walkUp } from 'walk-up-path'\n\n/**\n * Find the executable in a node_modules/.bin folder between the cwd\n * and the projectRoot.\n *\n * Returns `[executable, target]` showing the package origin.\n */\nexport const findExecutable = async (\n  arg0: string,\n  projectRoot: string,\n) => {\n  for (const path of walkUp(process.cwd())) {\n    const bin = await findCmdShimIfExists(\n      resolve(path, 'node_modules/.bin', arg0),\n    )\n    if (bin) return bin[0]\n    if (relative(path, projectRoot) === '') break\n  }\n}\n"]}

package/dist/esm/find-package.d.ts

@@ -0,0 +1,10 @@
+import type { PackageJson } from '@vltpkg/package-json';
+import type { VlxInfo } from './index.ts';
+/**
+ * Find the nearest package in a node_modules folder between the cwd
+ * and the projectRoot. This should only be used to look for local packages.
+ * Note that the `resolved` value in the VlxInfo object is a bit useless,
+ * as we didn't install anything and so don't need to do a full resolution.
+ */
+export declare const findPackage: (name: string, projectRoot: string, packageJson: PackageJson) => Promise<undefined | VlxInfo>;
+//# sourceMappingURL=find-package.d.ts.map

package/dist/esm/find-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-package.d.ts","sourceRoot":"","sources":["../../src/find-package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,YAAY,CAAA;AAWtD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,SAChB,MAAM,eACC,MAAM,eACN,WAAW,KACvB,OAAO,CAAC,SAAS,GAAG,OAAO,CAmB7B,CAAA"}

package/dist/esm/find-package.js

@@ -0,0 +1,41 @@
+import { relative, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { walkUp } from 'walk-up-path';
+import { inferDefaultExecutable } from "./infer-default-executable.js";
+const maybeManifest = (p, packageJson) => {
+    try {
+        return packageJson.read(p);
+    }
+    catch {
+        return {};
+    }
+};
+/**
+ * Find the nearest package in a node_modules folder between the cwd
+ * and the projectRoot. This should only be used to look for local packages.
+ * Note that the `resolved` value in the VlxInfo object is a bit useless,
+ * as we didn't install anything and so don't need to do a full resolution.
+ */
+export const findPackage = async (name, projectRoot, packageJson) => {
+    for (const path of walkUp(process.cwd())) {
+        const p = resolve(path, 'node_modules', name);
+        const manifest = maybeManifest(path, packageJson);
+        try {
+            const m = packageJson.read(p, { reload: true });
+            const bin = inferDefaultExecutable(m);
+            const { vlx = {} } = manifest;
+            return {
+                path,
+                name,
+                version: m.version,
+                resolved: String(pathToFileURL(p)),
+                arg0: bin?.[0],
+                ...vlx,
+            };
+        }
+        catch { }
+        if (relative(path, projectRoot) === '')
+            break;
+    }
+};
+//# sourceMappingURL=find-package.js.map

package/dist/esm/find-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-package.js","sourceRoot":"","sources":["../../src/find-package.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAEtE,MAAM,aAAa,GAAG,CAAC,CAAS,EAAE,WAAwB,EAAE,EAAE;IAC5D,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,IAAY,EACZ,WAAmB,EACnB,WAAwB,EACM,EAAE;IAChC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAA;QAC7C,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;QACjD,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;YAC/C,MAAM,GAAG,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAA;YACrC,MAAM,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,QAAuB,CAAA;YAC5C,OAAO;gBACL,IAAI;gBACJ,IAAI;gBACJ,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;gBAClC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;gBACd,GAAG,GAAG;aACP,CAAA;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,IAAI,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE;YAAE,MAAK;IAC/C,CAAC;AACH,CAAC,CAAA","sourcesContent":["import type { PackageJson } from '@vltpkg/package-json'\nimport { relative, resolve } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport { walkUp } from 'walk-up-path'\nimport type { VlxInfo, VlxManifest } from './index.ts'\nimport { inferDefaultExecutable } from './infer-default-executable.ts'\n\nconst maybeManifest = (p: string, packageJson: PackageJson) => {\n  try {\n    return packageJson.read(p)\n  } catch {\n    return {}\n  }\n}\n\n/**\n * Find the nearest package in a node_modules folder between the cwd\n * and the projectRoot. This should only be used to look for local packages.\n * Note that the `resolved` value in the VlxInfo object is a bit useless,\n * as we didn't install anything and so don't need to do a full resolution.\n */\nexport const findPackage = async (\n  name: string,\n  projectRoot: string,\n  packageJson: PackageJson,\n): Promise<undefined | VlxInfo> => {\n  for (const path of walkUp(process.cwd())) {\n    const p = resolve(path, 'node_modules', name)\n    const manifest = maybeManifest(path, packageJson)\n    try {\n      const m = packageJson.read(p, { reload: true })\n      const bin = inferDefaultExecutable(m)\n      const { vlx = {} } = manifest as VlxManifest\n      return {\n        path,\n        name,\n        version: m.version,\n        resolved: String(pathToFileURL(p)),\n        arg0: bin?.[0],\n        ...vlx,\n      }\n    } catch {}\n    if (relative(path, projectRoot) === '') break\n  }\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,48 @@
+import type { InstallOptions } from '@vltpkg/graph';
+import type { PackageInfoClientOptions, PackageInfoClientRequestOptions, Resolution } from '@vltpkg/package-info';
+import type { Spec, SpecOptions } from '@vltpkg/spec';
+import type { Integrity, Manifest } from '@vltpkg/types';
+export type VlxManifest = Manifest & {
+    vlx?: {
+        integrity?: Integrity;
+        signatures?: Resolution['signatures'];
+    };
+};
+/**
+ * Provide a promptFn which is `()=>Promise<string>` if you want to confirm
+ * before installing things. If it returns a string that does not start with
+ * the letter 'y', then operation will be aborted. If not provided, consent is
+ * assumed.
+ */
+export type PromptFn = (pkgSpec: Spec, path: string, resolution: string) => Promise<string>;
+/** The info about a given vlx installation */
+export type VlxInfo = VlxManifest['vlx'] & {
+    /** name of the package that is being run */
+    name: string;
+    /** version of the package being run */
+    version?: string;
+    /**
+     * path to the synthetic project for non-local installs, or to the
+     * current projectRoot if the resolution is local.
+     */
+    path: string;
+    /**
+     * resolution of the package installed, for non-local installs,
+     * or a file URL into the node_modules for project local installs.
+     */
+    resolved: string;
+    /**
+     * Full path to the inferred default binary for the dependency if it exists.
+     */
+    arg0?: string;
+};
+export type VlxOptions = SpecOptions & PackageInfoClientOptions & PackageInfoClientRequestOptions & InstallOptions & {
+    package?: string;
+    yes?: boolean;
+};
+export { vlxDelete as delete } from './delete.ts';
+export { vlxInfo as info } from './info.ts';
+export { vlxInstall as install } from './install.ts';
+export { vlxList as list } from './list.ts';
+export { vlxResolve as resolve } from './resolve.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,KAAK,EACV,wBAAwB,EACxB,+BAA+B,EAC/B,UAAU,EACX,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG;IACnC,GAAG,CAAC,EAAE;QACJ,SAAS,CAAC,EAAE,SAAS,CAAA;QACrB,UAAU,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,CAAA;KACtC,CAAA;CACF,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,CACrB,OAAO,EAAE,IAAI,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,MAAM,CAAC,CAAA;AAEpB,8CAA8C;AAC9C,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG;IACzC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IAEZ,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAClC,wBAAwB,GACxB,+BAA+B,GAC/B,cAAc,GAAG;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAEH,OAAO,EAAE,SAAS,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+export { vlxDelete as delete } from "./delete.js";
+export { vlxInfo as info } from "./info.js";
+export { vlxInstall as install } from "./install.js";
+export { vlxList as list } from "./list.js";
+export { vlxResolve as resolve } from "./resolve.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AA8DA,OAAO,EAAE,SAAS,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,cAAc,CAAA","sourcesContent":["import type { InstallOptions } from '@vltpkg/graph'\nimport type {\n  PackageInfoClientOptions,\n  PackageInfoClientRequestOptions,\n  Resolution,\n} from '@vltpkg/package-info'\nimport type { Spec, SpecOptions } from '@vltpkg/spec'\nimport type { Integrity, Manifest } from '@vltpkg/types'\n\nexport type VlxManifest = Manifest & {\n  vlx?: {\n    integrity?: Integrity\n    signatures?: Resolution['signatures']\n  }\n}\n\n/**\n * Provide a promptFn which is `()=>Promise<string>` if you want to confirm\n * before installing things. If it returns a string that does not start with\n * the letter 'y', then operation will be aborted. If not provided, consent is\n * assumed.\n */\nexport type PromptFn = (\n  pkgSpec: Spec,\n  path: string,\n  resolution: string,\n) => Promise<string>\n\n/** The info about a given vlx installation */\nexport type VlxInfo = VlxManifest['vlx'] & {\n  /** name of the package that is being run */\n  name: string\n\n  /** version of the package being run */\n  version?: string\n\n  /**\n   * path to the synthetic project for non-local installs, or to the\n   * current projectRoot if the resolution is local.\n   */\n  path: string\n\n  /**\n   * resolution of the package installed, for non-local installs,\n   * or a file URL into the node_modules for project local installs.\n   */\n  resolved: string\n\n  /**\n   * Full path to the inferred default binary for the dependency if it exists.\n   */\n  arg0?: string\n}\n\nexport type VlxOptions = SpecOptions &\n  PackageInfoClientOptions &\n  PackageInfoClientRequestOptions &\n  InstallOptions & {\n    package?: string\n    yes?: boolean\n  }\n\nexport { vlxDelete as delete } from './delete.ts'\nexport { vlxInfo as info } from './info.ts'\nexport { vlxInstall as install } from './install.ts'\nexport { vlxList as list } from './list.ts'\nexport { vlxResolve as resolve } from './resolve.ts'\n"]}

package/dist/esm/infer-default-executable.d.ts

@@ -0,0 +1,8 @@
+import type { Manifest } from '@vltpkg/types';
+/**
+ * Infer the default binary from a package.
+ *
+ * Returns `undefined` if it couldn't be determined
+ */
+export declare const inferDefaultExecutable: ({ name, bin, }: Manifest) => undefined | [string, string];
+//# sourceMappingURL=infer-default-executable.d.ts.map

package/dist/esm/infer-default-executable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer-default-executable.d.ts","sourceRoot":"","sources":["../../src/infer-default-executable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,mBAGhC,QAAQ,KAAG,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,CAcxC,CAAA"}

package/dist/esm/infer-default-executable.js

@@ -0,0 +1,20 @@
+/**
+ * Infer the default binary from a package.
+ *
+ * Returns `undefined` if it couldn't be determined
+ */
+export const inferDefaultExecutable = ({ name, bin, }) => {
+    if (!bin)
+        return undefined;
+    const binName = name?.startsWith('@') ? name.split('/')[1] : name;
+    if (!binName)
+        return undefined;
+    if (typeof bin === 'string') {
+        return [binName, bin];
+    }
+    bin = bin[binName];
+    if (!bin)
+        return undefined;
+    return [binName, bin];
+};
+//# sourceMappingURL=infer-default-executable.js.map

package/dist/esm/infer-default-executable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer-default-executable.js","sourceRoot":"","sources":["../../src/infer-default-executable.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,EACrC,IAAI,EACJ,GAAG,GACM,EAAgC,EAAE;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAE1B,MAAM,OAAO,GAAG,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACjE,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAE9B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IACvB,CAAC;IAED,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAA;IAClB,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAE1B,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;AACvB,CAAC,CAAA","sourcesContent":["import type { Manifest } from '@vltpkg/types'\n\n/**\n * Infer the default binary from a package.\n *\n * Returns `undefined` if it couldn't be determined\n */\nexport const inferDefaultExecutable = ({\n  name,\n  bin,\n}: Manifest): undefined | [string, string] => {\n  if (!bin) return undefined\n\n  const binName = name?.startsWith('@') ? name.split('/')[1] : name\n  if (!binName) return undefined\n\n  if (typeof bin === 'string') {\n    return [binName, bin]\n  }\n\n  bin = bin[binName]\n  if (!bin) return undefined\n\n  return [binName, bin]\n}\n"]}

package/dist/esm/info.d.ts

@@ -0,0 +1,4 @@
+import type { Manifest } from '@vltpkg/types';
+import type { VlxInfo, VlxOptions } from './index.ts';
+export declare const vlxInfo: (path: string, options: VlxOptions, manifest?: Manifest) => VlxInfo;
+//# sourceMappingURL=info.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../src/info.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAG7C,OAAO,KAAK,EAAE,OAAO,EAAe,UAAU,EAAE,MAAM,YAAY,CAAA;AAKlE,eAAO,MAAM,OAAO,SACZ,MAAM,WACH,UAAU,aACR,QAAQ,KAClB,OA8BF,CAAA"}

package/dist/esm/info.js

@@ -0,0 +1,36 @@
+import { error } from '@vltpkg/error-cause';
+import { XDG } from '@vltpkg/xdg';
+import { resolve } from 'node:path';
+import { inferDefaultExecutable } from "./infer-default-executable.js";
+import { mountPath } from "./mount-path.js";
+export const vlxInfo = (path, options, manifest) => {
+    const root = new XDG('vlt/vlx').data();
+    path = mountPath(root, path);
+    try {
+        // do not allow it to traverse up or read arbitrary paths
+        const { packageJson } = options;
+        manifest ??= packageJson.read(path);
+        const { dependencies = {} } = manifest;
+        // every one of these has exactly one dep, on the resolved url
+        for (const [name, resolved] of Object.entries(dependencies)) {
+            const p = resolve(path, 'node_modules', name);
+            const pj = packageJson.read(p, { reload: true });
+            const def = inferDefaultExecutable(pj);
+            const arg0 = def?.[0];
+            const { vlx } = manifest;
+            return {
+                path,
+                name,
+                version: pj.version,
+                resolved,
+                arg0,
+                ...vlx,
+            };
+        }
+    }
+    catch (er) {
+        throw error('Could not get vlx information', er);
+    }
+    throw error('Could not get vlx information');
+};
+//# sourceMappingURL=info.js.map

package/dist/esm/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../src/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAE3C,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,IAAY,EACZ,OAAmB,EACnB,QAAmB,EACV,EAAE;IACX,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAA;IACtC,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAE5B,IAAI,CAAC;QACH,yDAAyD;QACzD,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAA;QAC/B,QAAQ,KAAK,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,EAAE,YAAY,GAAG,EAAE,EAAE,GAAG,QAAQ,CAAA;QAEtC,8DAA8D;QAC9D,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAA;YAC7C,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;YAChD,MAAM,GAAG,GAAG,sBAAsB,CAAC,EAAE,CAAC,CAAA;YACtC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;YACrB,MAAM,EAAE,GAAG,EAAE,GAAG,QAAuB,CAAA;YACvC,OAAO;gBACL,IAAI;gBACJ,IAAI;gBACJ,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,QAAQ;gBACR,IAAI;gBACJ,GAAG,GAAG;aACP,CAAA;QACH,CAAC;IACH,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,MAAM,KAAK,CAAC,+BAA+B,EAAE,EAAW,CAAC,CAAA;IAC3D,CAAC;IACD,MAAM,KAAK,CAAC,+BAA+B,CAAC,CAAA;AAC9C,CAAC,CAAA","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport type { Manifest } from '@vltpkg/types'\nimport { XDG } from '@vltpkg/xdg'\nimport { resolve } from 'node:path'\nimport type { VlxInfo, VlxManifest, VlxOptions } from './index.ts'\nimport { inferDefaultExecutable } from './infer-default-executable.ts'\n\nimport { mountPath } from './mount-path.ts'\n\nexport const vlxInfo = (\n  path: string,\n  options: VlxOptions,\n  manifest?: Manifest,\n): VlxInfo => {\n  const root = new XDG('vlt/vlx').data()\n  path = mountPath(root, path)\n\n  try {\n    // do not allow it to traverse up or read arbitrary paths\n    const { packageJson } = options\n    manifest ??= packageJson.read(path)\n    const { dependencies = {} } = manifest\n\n    // every one of these has exactly one dep, on the resolved url\n    for (const [name, resolved] of Object.entries(dependencies)) {\n      const p = resolve(path, 'node_modules', name)\n      const pj = packageJson.read(p, { reload: true })\n      const def = inferDefaultExecutable(pj)\n      const arg0 = def?.[0]\n      const { vlx } = manifest as VlxManifest\n      return {\n        path,\n        name,\n        version: pj.version,\n        resolved,\n        arg0,\n        ...vlx,\n      }\n    }\n  } catch (er) {\n    throw error('Could not get vlx information', er as Error)\n  }\n  throw error('Could not get vlx information')\n}\n"]}

package/dist/esm/install.d.ts

@@ -0,0 +1,8 @@
+import { Spec } from '@vltpkg/spec';
+import type { PromptFn, VlxInfo, VlxOptions } from './index.ts';
+/**
+ * Install a given package spec in the appropriate folder, if it's not
+ * already present.
+ */
+export declare const vlxInstall: (spec: Spec | string, options: VlxOptions, promptFn?: PromptFn) => Promise<VlxInfo>;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/install.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAQnC,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAG/D;;;GAGG;AACH,eAAO,MAAM,UAAU,SACf,IAAI,GAAG,MAAM,WACV,UAAU,aACR,QAAQ,KAClB,OAAO,CAAC,OAAO,CAyDjB,CAAA"}

package/dist/esm/install.js

@@ -0,0 +1,63 @@
+import { error } from '@vltpkg/error-cause';
+import { install } from '@vltpkg/graph';
+import { PackageInfoClient } from '@vltpkg/package-info';
+import { Spec } from '@vltpkg/spec';
+import { XDG } from '@vltpkg/xdg';
+import { createHash } from 'node:crypto';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { PathScurry } from 'path-scurry';
+import { dirExists } from "./dir-exists.js";
+import { doPrompt } from "./do-prompt.js";
+import { vlxInfo } from "./info.js";
+/**
+ * Install a given package spec in the appropriate folder, if it's not
+ * already present.
+ */
+export const vlxInstall = async (spec, options, promptFn) => {
+    const pkgSpec = typeof spec === 'string' ? Spec.parseArgs(spec) : spec;
+    const { name } = pkgSpec.final;
+    // We always use the cache as much as possible, to prevent unnecessarily
+    // waiting to run a command while installing something. The one we used
+    // last time is almost certainly fine.
+    options = {
+        ...options,
+        ['stale-while-revalidate-factor']: Infinity,
+    };
+    const packageInfo = (options.packageInfo = new PackageInfoClient(options));
+    const resolution = await packageInfo.resolve(pkgSpec, options);
+    const hash = createHash('sha512')
+        .update(resolution.resolved)
+        .digest('hex')
+        .substring(0, 8);
+    const xdg = new XDG('vlt/vlx');
+    const dir = xdg.data(pkgSpec.name.replace('/', '§') + '-' + hash);
+    if (await dirExists(dir)) {
+        return vlxInfo(dir, options);
+    }
+    const ok = options.yes ||
+        (await doPrompt(pkgSpec, dir, resolution.resolved, promptFn));
+    if (!ok)
+        throw error('Operation aborted');
+    await mkdir(resolve(dir, 'node_modules/.vlt'), { recursive: true });
+    const manifest = {
+        name: 'vlx',
+        dependencies: {
+            [name]: resolution.resolved,
+        },
+        vlx: {
+            integrity: resolution.integrity,
+            signatures: resolution.signatures,
+        },
+    };
+    await writeFile(resolve(dir, 'package.json'), JSON.stringify(manifest, null, 2) + '\n');
+    await install({
+        ...options,
+        packageInfo,
+        projectRoot: dir,
+        monorepo: undefined,
+        scurry: new PathScurry(dir),
+    });
+    return vlxInfo(dir, options, manifest);
+};
+//# sourceMappingURL=install.js.map

package/dist/esm/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/install.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { install } from '@vltpkg/graph'\nimport { PackageInfoClient } from '@vltpkg/package-info'\nimport { Spec } from '@vltpkg/spec'\nimport { XDG } from '@vltpkg/xdg'\nimport { createHash } from 'node:crypto'\nimport { mkdir, writeFile } from 'node:fs/promises'\nimport { resolve } from 'node:path'\nimport { PathScurry } from 'path-scurry'\nimport { dirExists } from './dir-exists.ts'\nimport { doPrompt } from './do-prompt.ts'\nimport type { PromptFn, VlxInfo, VlxOptions } from './index.ts'\nimport { vlxInfo } from './info.ts'\n\n/**\n * Install a given package spec in the appropriate folder, if it's not\n * already present.\n */\nexport const vlxInstall = async (\n  spec: Spec | string,\n  options: VlxOptions,\n  promptFn?: PromptFn,\n): Promise<VlxInfo> => {\n  const pkgSpec =\n    typeof spec === 'string' ? Spec.parseArgs(spec) : spec\n  const { name } = pkgSpec.final\n  // We always use the cache as much as possible, to prevent unnecessarily\n  // waiting to run a command while installing something. The one we used\n  // last time is almost certainly fine.\n  options = {\n    ...options,\n    ['stale-while-revalidate-factor']: Infinity,\n  }\n  const packageInfo = (options.packageInfo = new PackageInfoClient(\n    options,\n  ))\n  const resolution = await packageInfo.resolve(pkgSpec, options)\n  const hash = createHash('sha512')\n    .update(resolution.resolved)\n    .digest('hex')\n    .substring(0, 8)\n  const xdg = new XDG('vlt/vlx')\n  const dir = xdg.data(pkgSpec.name.replace('/', '§') + '-' + hash)\n  if (await dirExists(dir)) {\n    return vlxInfo(dir, options)\n  }\n\n  const ok =\n    options.yes ||\n    (await doPrompt(pkgSpec, dir, resolution.resolved, promptFn))\n  if (!ok) throw error('Operation aborted')\n\n  await mkdir(resolve(dir, 'node_modules/.vlt'), { recursive: true })\n\n  const manifest = {\n    name: 'vlx',\n    dependencies: {\n      [name]: resolution.resolved,\n    },\n    vlx: {\n      integrity: resolution.integrity,\n      signatures: resolution.signatures,\n    },\n  }\n\n  await writeFile(\n    resolve(dir, 'package.json'),\n    JSON.stringify(manifest, null, 2) + '\\n',\n  )\n\n  await install({\n    ...options,\n    packageInfo,\n    projectRoot: dir,\n    monorepo: undefined,\n    scurry: new PathScurry(dir),\n  })\n\n  return vlxInfo(dir, options, manifest)\n}\n"]}

package/dist/esm/list.d.ts

@@ -0,0 +1,2 @@
+export declare function vlxList(): AsyncGenerator<string, void, unknown>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/list.ts"],"names":[],"mappings":"AAIA,wBAAuB,OAAO,0CAM7B"}

package/dist/esm/list.js

@@ -0,0 +1,11 @@
+import { XDG } from '@vltpkg/xdg';
+import { opendir } from 'node:fs/promises';
+import { resolve } from 'node:path';
+export async function* vlxList() {
+    const path = new XDG('vlt/vlx').data();
+    const dir = await opendir(path);
+    for await (const dirent of dir) {
+        yield resolve(path, dirent.name);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/esm/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,OAAO;IAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAA;IACtC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,GAAG,EAAE,CAAC;QAC/B,MAAM,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;AACH,CAAC","sourcesContent":["import { XDG } from '@vltpkg/xdg'\nimport { opendir } from 'node:fs/promises'\nimport { resolve } from 'node:path'\n\nexport async function* vlxList() {\n  const path = new XDG('vlt/vlx').data()\n  const dir = await opendir(path)\n  for await (const dirent of dir) {\n    yield resolve(path, dirent.name)\n  }\n}\n"]}

package/dist/esm/mount-path.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Prevent `vlx exec-cache info/delete/ls` from reaching out of its
+ * safe little sandbox.
+ */
+export declare const mountPath: (root: string, path: string) => string;
+//# sourceMappingURL=mount-path.d.ts.map

package/dist/esm/mount-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-path.d.ts","sourceRoot":"","sources":["../../src/mount-path.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,SAAS,SAAU,MAAM,QAAQ,MAAM,KAAG,MAItD,CAAA"}

package/dist/esm/mount-path.js

@@ -0,0 +1,11 @@
+import { join } from 'node:path';
+/**
+ * Prevent `vlx exec-cache info/delete/ls` from reaching out of its
+ * safe little sandbox.
+ */
+export const mountPath = (root, path) => {
+    path = join(path);
+    path = path.startsWith(root) ? path.substring(root.length) : path;
+    return join(root, join('/', path));
+};
+//# sourceMappingURL=mount-path.js.map

package/dist/esm/mount-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-path.js","sourceRoot":"","sources":["../../src/mount-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,IAAY,EAAU,EAAE;IAC9D,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IACjB,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACjE,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAA;AACpC,CAAC,CAAA","sourcesContent":["import { join } from 'node:path'\n\n/**\n * Prevent `vlx exec-cache info/delete/ls` from reaching out of its\n * safe little sandbox.\n */\nexport const mountPath = (root: string, path: string): string => {\n  path = join(path)\n  path = path.startsWith(root) ? path.substring(root.length) : path\n  return join(root, join('/', path))\n}\n"]}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/resolve.d.ts

@@ -0,0 +1,9 @@
+import type { PromptFn, VlxOptions } from './index.ts';
+/**
+ * Figure out the `arg0` to use for an exec command.
+ *
+ * If `undefined` is returned, then the caller should spawn an interactive
+ * shell, or in multi-workspace mode, raise an error.
+ */
+export declare const vlxResolve: (positionals: string[], options: VlxOptions, promptFn?: PromptFn) => Promise<undefined | string>;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/resolve.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAW,UAAU,EAAE,MAAM,YAAY,CAAA;AAG/D;;;;;GAKG;AACH,eAAO,MAAM,UAAU,gBACR,MAAM,EAAE,WACZ,UAAU,aACR,QAAQ,KAClB,OAAO,CAAC,SAAS,GAAG,MAAM,CA6E5B,CAAA"}

package/dist/esm/resolve.js

@@ -0,0 +1,84 @@
+import { error } from '@vltpkg/error-cause';
+import { Spec } from '@vltpkg/spec';
+import { resolve } from 'node:path';
+import { addToPATH } from "./add-to-path.js";
+import { findExecutable } from "./find-executable.js";
+import { findPackage } from "./find-package.js";
+import { vlxInstall } from "./install.js";
+/**
+ * Figure out the `arg0` to use for an exec command.
+ *
+ * If `undefined` is returned, then the caller should spawn an interactive
+ * shell, or in multi-workspace mode, raise an error.
+ */
+export const vlxResolve = async (positionals, options, promptFn) => {
+    const noArgs = positionals.length === 0;
+    let arg0 = positionals[0];
+    let pkgOption = options.package;
+    const { projectRoot, packageJson } = options;
+    if (!pkgOption) {
+        // can come from any package
+        if (!arg0) {
+            // caller will run interactive shell
+            return undefined;
+        }
+        const found = await findExecutable(arg0, projectRoot);
+        // if found locally, then that's the bin, whatever the package is
+        // since no package option was provided anyway.
+        if (found)
+            return found;
+        // ok, not local, might have to install something.
+        // treat the arg0 as a package specifier
+        pkgOption = arg0;
+        arg0 = undefined;
+    }
+    let pkgTarget = undefined;
+    if (pkgOption) {
+        // check for local option, otherwise install in data dir we can
+        // ONLY do the local option if the spec is a simple name. otherwise
+        // it's too complicated to know if it's a match, especially in this
+        // world of multiple registries and such, and it's easy enough to
+        // just install it externally.
+        const pkgSpec = Spec.parseArgs(pkgOption, options);
+        const { name, bareSpec } = pkgSpec.final;
+        // if it's just a name, we can use the local version
+        if (!bareSpec) {
+            pkgTarget = await findPackage(name, projectRoot, packageJson);
+        }
+        pkgTarget ??= await vlxInstall(pkgSpec, options, promptFn);
+    }
+    if (pkgTarget) {
+        addToPATH(resolve(pkgTarget.path, 'node_modules/.bin'));
+        // if we now have a pkgTarget, and we did not have any arguments, then
+        // the user did something like `vlx --package=foo`, but didn't give us
+        // a command. In that case, we add the relevant exec-cache .bin folder to
+        // the PATH env, and let the caller invoke an interactive shell.
+        if (noArgs)
+            return undefined;
+    }
+    // now if we had a package option, then pkgTarget is set
+    // if arg0 isn't set, then we need to infer from the manifest
+    // This is like doing `vlx foo@version`, where we treat arg0
+    // as the package option. A default exec *must* be inferred then.
+    if (!arg0) {
+        /* c8 ignore start - impossible, case already handled */
+        if (!pkgTarget) {
+            throw error('Must supply a --package option and/or arguments', {
+                code: 'EUSAGE',
+            });
+        }
+        /* c8 ignore stop */
+        // infer arg0 from the manifst found at pkgTarget[1]
+        arg0 = pkgTarget.arg0;
+        if (!arg0) {
+            const { name, version, bin } = packageJson.read(resolve(pkgTarget.path, 'node_modules', pkgTarget.name));
+            throw error('Package executable could not be inferred', {
+                name,
+                version,
+                found: bin,
+            });
+        }
+    }
+    return arg0;
+};
+//# sourceMappingURL=resolve.js.map

package/dist/esm/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/resolve.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { Spec } from '@vltpkg/spec'\nimport { resolve } from 'node:path'\nimport { addToPATH } from './add-to-path.ts'\nimport { findExecutable } from './find-executable.ts'\nimport { findPackage } from './find-package.ts'\nimport type { PromptFn, VlxInfo, VlxOptions } from './index.ts'\nimport { vlxInstall } from './install.ts'\n\n/**\n * Figure out the `arg0` to use for an exec command.\n *\n * If `undefined` is returned, then the caller should spawn an interactive\n * shell, or in multi-workspace mode, raise an error.\n */\nexport const vlxResolve = async (\n  positionals: string[],\n  options: VlxOptions,\n  promptFn?: PromptFn,\n): Promise<undefined | string> => {\n  const noArgs = positionals.length === 0\n  let arg0 = positionals[0]\n  let pkgOption = options.package\n  const { projectRoot, packageJson } = options\n\n  if (!pkgOption) {\n    // can come from any package\n    if (!arg0) {\n      // caller will run interactive shell\n      return undefined\n    }\n\n    const found = await findExecutable(arg0, projectRoot)\n    // if found locally, then that's the bin, whatever the package is\n    // since no package option was provided anyway.\n    if (found) return found\n    // ok, not local, might have to install something.\n    // treat the arg0 as a package specifier\n    pkgOption = arg0\n    arg0 = undefined\n  }\n\n  let pkgTarget: undefined | VlxInfo = undefined\n\n  if (pkgOption) {\n    // check for local option, otherwise install in data dir we can\n    // ONLY do the local option if the spec is a simple name. otherwise\n    // it's too complicated to know if it's a match, especially in this\n    // world of multiple registries and such, and it's easy enough to\n    // just install it externally.\n    const pkgSpec = Spec.parseArgs(pkgOption, options)\n    const { name, bareSpec } = pkgSpec.final\n    // if it's just a name, we can use the local version\n    if (!bareSpec) {\n      pkgTarget = await findPackage(name, projectRoot, packageJson)\n    }\n    pkgTarget ??= await vlxInstall(pkgSpec, options, promptFn)\n  }\n\n  if (pkgTarget) {\n    addToPATH(resolve(pkgTarget.path, 'node_modules/.bin'))\n    // if we now have a pkgTarget, and we did not have any arguments, then\n    // the user did something like `vlx --package=foo`, but didn't give us\n    // a command. In that case, we add the relevant exec-cache .bin folder to\n    // the PATH env, and let the caller invoke an interactive shell.\n    if (noArgs) return undefined\n  }\n\n  // now if we had a package option, then pkgTarget is set\n  // if arg0 isn't set, then we need to infer from the manifest\n  // This is like doing `vlx foo@version`, where we treat arg0\n  // as the package option. A default exec *must* be inferred then.\n  if (!arg0) {\n    /* c8 ignore start - impossible, case already handled */\n    if (!pkgTarget) {\n      throw error('Must supply a --package option and/or arguments', {\n        code: 'EUSAGE',\n      })\n    }\n    /* c8 ignore stop */\n\n    // infer arg0 from the manifst found at pkgTarget[1]\n    arg0 = pkgTarget.arg0\n    if (!arg0) {\n      const { name, version, bin } = packageJson.read(\n        resolve(pkgTarget.path, 'node_modules', pkgTarget.name),\n      )\n      throw error('Package executable could not be inferred', {\n        name,\n        version,\n        found: bin,\n      })\n    }\n  }\n\n  return arg0\n}\n"]}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@vltpkg/vlx",
+  "description": "vlt exec management",
+  "version": "0.0.0-10",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vltpkg/vltpkg.git",
+    "directory": "src/vlx"
+  },
+  "tshy": {
+    "selfLink": false,
+    "liveDev": true,
+    "dialects": [
+      "esm"
+    ],
+    "exports": {
+      "./package.json": "./package.json",
+      ".": "./src/index.ts"
+    }
+  },
+  "dependencies": {
+    "path-scurry": "^2.0.0",
+    "walk-up-path": "^4.0.0",
+    "@vltpkg/cmd-shim": "0.0.0-10",
+    "@vltpkg/error-cause": "0.0.0-10",
+    "@vltpkg/graph": "0.0.0-10",
+    "@vltpkg/package-info": "0.0.0-10",
+    "@vltpkg/package-json": "0.0.0-10",
+    "@vltpkg/spec": "0.0.0-10",
+    "@vltpkg/rollback-remove": "0.0.0-10",
+    "@vltpkg/types": "0.0.0-10",
+    "@vltpkg/run": "0.0.0-10",
+    "@vltpkg/xdg": "0.0.0-10"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.25.0",
+    "@types/node": "^22.14.1",
+    "eslint": "^9.25.0",
+    "prettier": "^3.5.3",
+    "tap": "^21.1.0",
+    "tshy": "^3.0.2",
+    "typedoc": "~0.27.6",
+    "typescript": "5.7.3",
+    "typescript-eslint": "^8.30.1"
+  },
+  "license": "BSD-2-Clause-Patent",
+  "engines": {
+    "node": ">=22"
+  },
+  "tap": {
+    "extends": "../../tap-config.yaml"
+  },
+  "prettier": "../../.prettierrc.js",
+  "module": "./dist/esm/index.js",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "format": "prettier --write . --log-level warn --ignore-path ../../.prettierignore --cache",
+    "format:check": "prettier --check . --ignore-path ../../.prettierignore --cache",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "snap": "tap",
+    "test": "tap",
+    "posttest": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
+  }
+}