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

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,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,CAazC,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

@@ -68,9 +68,15 @@ Is this ok? (y) `);
     return response;
 };
 export const command = async (conf) => {
+    /* 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;

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,IAAI,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,KAAK,GAAG,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,gCAAgC;IACvC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmCZ;IACD,QAAQ,EAAE;QACR,4BAA4B,EAAE;YAC5B,WAAW,EAAE,0CAA0C;SACxD;QACD,oBAAoB,EAAE;YACpB,WAAW,EAAE,wCAAwC;SACtD;QACD,yBAAyB,EAAE;YACzB,WAAW,EACT,qDAAqD;SACxD;KACF;CACF,CAAC,CAAA;AAEJ,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;AACtB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAElE,MAAM,CAAC,MAAM,QAAQ,GAAa,KAAK,EACrC,OAAO,EACP,IAAI,EACJ,UAAU,EACV,EAAE;IACF,MAAM,QAAQ,GAAG,MAAM,eAAe,CACpC,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,MAAM,CACf,CAAC,QAAQ,CACR,qBAAqB,eAAe,CAClC,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,MAAM,CAAC,OAAO,CAAC,CAChB;QACG,eAAe,CACjB,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,UAAU,CACX;QACG,eAAe,CACjB,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,UAAU,CAAC,IAAI,CAAC,CACjB;iBACY,CACd,CAAA;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACrB,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE;IACzD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAC5B,IAAI,CAAC,WAAW,EAChB;QACE,GAAG,IAAI,CAAC,OAAO;QACf,KAAK,EAAE,SAAS;KACjB,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  const arg0 = await vlx.resolve(\n    conf.positionals,\n    {\n      ...conf.options,\n      query: undefined,\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"]}
+{"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/install/reporter.d.ts

@@ -1,8 +1,9 @@
 import { ViewClass } from '../../view.ts';
+import type { InstallResult } from '../install.ts';
 export declare class InstallReporter extends ViewClass {
     #private;
     start(): void;
-    done(_result: unknown, { time }: {
+    done(_result: InstallResult, { time }: {
         time: number;
     }): Promise<undefined>;
     error(err: unknown): void;

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

@@ -1 +1 @@
-{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../../src/commands/install/reporter.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAkFzC,qBAAa,eAAgB,SAAQ,SAAS;;IAG5C,KAAK;IAIC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAKvD,KAAK,CAAC,GAAG,EAAE,OAAO;CAGnB"}
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../../src/commands/install/reporter.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAqGlD,qBAAa,eAAgB,SAAQ,SAAS;;IAG5C,KAAK;IAIC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAe7D,KAAK,CAAC,GAAG,EAAE,OAAO;CAGnB"}

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

@@ -4,6 +4,11 @@ import Spinner from 'ink-spinner';
 import { createElement as $, Fragment, useEffect, useState, } from 'react';
 import { ViewClass } from "../../view.js";
 import { asError } from '@vltpkg/types';
+const labels = {
+    build: 'resolving dependencies',
+    actual: '',
+    reify: 'extracting files',
+};
 const GraphStep = ({ text, step }) => {
     if (step.state === 'waiting') {
         return $(Text, { color: 'gray' }, text);
@@ -15,6 +20,7 @@ const GraphStep = ({ text, step }) => {
 };
 const App = ({ trailer }) => {
     const [requests, setRequests] = useState(0);
+    const [cacheHit, setCacheHit] = useState(0);
     const [steps, setSteps] = useState({
         build: {
             state: 'waiting',
@@ -27,9 +33,16 @@ const App = ({ trailer }) => {
         },
     });
     useEffect(() => {
-        const update = () => setRequests(p => p + 1);
-        emitter.on('request', update);
-        return () => emitter.off('request', update);
+        const updateRequests = ({ state }) => {
+            if (state === 'start') {
+                setRequests(p => p + 1);
+            }
+            else if (state === 'cache' || state === 'stale') {
+                setCacheHit(p => p + 1);
+            }
+        };
+        emitter.on('request', updateRequests);
+        return () => emitter.off('request', updateRequests);
     }, []);
     useEffect(() => {
         const update = ({ step, state }) => {
@@ -46,8 +59,15 @@ const App = ({ trailer }) => {
     }, []);
     return $(Fragment, null, $(Box, null, ...['build', 'actual', 'reify'].map((step, idx, list) => {
         const separator = idx === list.length - 1 ? '' : ' > ';
-        return $(Text, { key: step }, $(GraphStep, { text: step, step: steps[step] }), $(Text, { color: 'gray' }, separator));
-    })), requests > 0 ? $(Text, null, `${requests} requests`) : null, trailer ? $(Text, null, trailer) : null);
+        const label = labels[step];
+        if (!label)
+            return null;
+        return $(Text, { key: step }, $(GraphStep, { text: label, step: steps[step] }), $(Text, { color: 'gray' }, separator));
+    })), cacheHit > 0 ?
+        $(Text, null, `${cacheHit} cache hit${cacheHit > 1 ? 's' : ''}`)
+        : null, requests > 0 ?
+        $(Text, null, `${requests} request${requests > 1 ? 's' : ''}`)
+        : null, trailer ? $(Text, null, trailer) : null);
 };
 export class InstallReporter extends ViewClass {
     #instance = null;
@@ -55,7 +75,16 @@ export class InstallReporter extends ViewClass {
         this.#instance = render($(App));
     }
     async done(_result, { time }) {
-        this.#instance?.rerender($(App, { trailer: `Done in ${time}ms` }));
+        let out = `Done in ${time}ms`;
+        // prints a very complete message explaining users the next steps
+        // in case there are packages to be built
+        if (_result.buildQueue?.length) {
+            out += `\n\n📦 ${_result.buildQueue.length} packages have install scripts defined & were not fully built\n`;
+            out += '🔎 Run `vlt query :scripts` to list them\n';
+            out +=
+                '🔨 Run `vlt build` to run all required scripts to build installed packages.\n';
+        }
+        this.#instance?.rerender($(App, { trailer: out }));
         return undefined;
     }
     error(err) {

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

@@ -1 +1 @@
-{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../../../src/commands/install/reporter.ts"],"names":[],"mappings":"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","sourcesContent":["import { emitter } from '@vltpkg/output'\nimport type { Events } from '@vltpkg/output'\nimport { Box, render, Text } from 'ink'\nimport type { Instance } from 'ink'\nimport Spinner from 'ink-spinner'\nimport {\n  createElement as $,\n  Fragment,\n  useEffect,\n  useState,\n} from 'react'\nimport { ViewClass } from '../../view.ts'\nimport { asError } from '@vltpkg/types'\n\ntype Step = {\n  state: 'waiting' | 'in_progress' | 'completed'\n}\n\nconst GraphStep = ({ text, step }: { text: string; step: Step }) => {\n  if (step.state === 'waiting') {\n    return $(Text, { color: 'gray' }, text)\n  }\n  if (step.state === 'in_progress') {\n    return $(\n      Text,\n      { color: 'yellow' },\n      text + ' ',\n      $(Spinner, { type: 'dots' }),\n    )\n  }\n  return $(Text, { color: 'green' }, text, ' ✓')\n}\n\nconst App = ({ trailer }: { trailer?: string }) => {\n  const [requests, setRequests] = useState(0)\n\n  const [steps, setSteps] = useState<\n    Record<Events['graphStep']['step'], Step>\n  >({\n    build: {\n      state: 'waiting',\n    },\n    actual: {\n      state: 'waiting',\n    },\n    reify: {\n      state: 'waiting',\n    },\n  })\n\n  useEffect(() => {\n    const update = () => setRequests(p => p + 1)\n    emitter.on('request', update)\n    return () => emitter.off('request', update)\n  }, [])\n\n  useEffect(() => {\n    const update = ({ step, state }: Events['graphStep']) => {\n      setSteps(p => ({\n        ...p,\n        [step]: {\n          ...p[step],\n          state: state === 'start' ? 'in_progress' : 'completed',\n        },\n      }))\n    }\n    emitter.on('graphStep', update)\n    return () => emitter.off('graphStep', update)\n  }, [])\n\n  return $(\n    Fragment,\n    null,\n    $(\n      Box,\n      null,\n      ...(['build', 'actual', 'reify'] as const).map(\n        (step, idx, list) => {\n          const separator = idx === list.length - 1 ? '' : ' > '\n          return $(\n            Text,\n            { key: step },\n            $(GraphStep, { text: step, step: steps[step] }),\n            $(Text, { color: 'gray' }, separator),\n          )\n        },\n      ),\n    ),\n    requests > 0 ? $(Text, null, `${requests} requests`) : null,\n    trailer ? $(Text, null, trailer) : null,\n  )\n}\n\nexport class InstallReporter extends ViewClass {\n  #instance: Instance | null = null\n\n  start() {\n    this.#instance = render($(App))\n  }\n\n  async done(_result: unknown, { time }: { time: number }) {\n    this.#instance?.rerender($(App, { trailer: `Done in ${time}ms` }))\n    return undefined\n  }\n\n  error(err: unknown) {\n    this.#instance?.unmount(asError(err))\n  }\n}\n"]}
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../../../src/commands/install/reporter.ts"],"names":[],"mappings":"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","sourcesContent":["import { emitter } from '@vltpkg/output'\nimport type { Events } from '@vltpkg/output'\nimport { Box, render, Text } from 'ink'\nimport type { Instance } from 'ink'\nimport Spinner from 'ink-spinner'\nimport {\n  createElement as $,\n  Fragment,\n  useEffect,\n  useState,\n} from 'react'\nimport { ViewClass } from '../../view.ts'\nimport { asError } from '@vltpkg/types'\nimport type { InstallResult } from '../install.ts'\n\ntype Step = {\n  state: 'waiting' | 'in_progress' | 'completed'\n}\n\nconst labels: Record<Events['graphStep']['step'], string> = {\n  build: 'resolving dependencies',\n  actual: '',\n  reify: 'extracting files',\n}\n\nconst GraphStep = ({ text, step }: { text: string; step: Step }) => {\n  if (step.state === 'waiting') {\n    return $(Text, { color: 'gray' }, text)\n  }\n  if (step.state === 'in_progress') {\n    return $(\n      Text,\n      { color: 'yellow' },\n      text + ' ',\n      $(Spinner, { type: 'dots' }),\n    )\n  }\n  return $(Text, { color: 'green' }, text, ' ✓')\n}\n\nconst App = ({ trailer }: { trailer?: string }) => {\n  const [requests, setRequests] = useState(0)\n  const [cacheHit, setCacheHit] = useState(0)\n\n  const [steps, setSteps] = useState<\n    Record<Events['graphStep']['step'], Step>\n  >({\n    build: {\n      state: 'waiting',\n    },\n    actual: {\n      state: 'waiting',\n    },\n    reify: {\n      state: 'waiting',\n    },\n  })\n\n  useEffect(() => {\n    const updateRequests = ({ state }: Events['request']) => {\n      if (state === 'start') {\n        setRequests(p => p + 1)\n      } else if (state === 'cache' || state === 'stale') {\n        setCacheHit(p => p + 1)\n      }\n    }\n    emitter.on('request', updateRequests)\n    return () => emitter.off('request', updateRequests)\n  }, [])\n\n  useEffect(() => {\n    const update = ({ step, state }: Events['graphStep']) => {\n      setSteps(p => ({\n        ...p,\n        [step]: {\n          ...p[step],\n          state: state === 'start' ? 'in_progress' : 'completed',\n        },\n      }))\n    }\n    emitter.on('graphStep', update)\n    return () => emitter.off('graphStep', update)\n  }, [])\n\n  return $(\n    Fragment,\n    null,\n    $(\n      Box,\n      null,\n      ...(['build', 'actual', 'reify'] as const).map(\n        (step, idx, list) => {\n          const separator = idx === list.length - 1 ? '' : ' > '\n          const label = labels[step]\n          if (!label) return null\n          return $(\n            Text,\n            { key: step },\n            $(GraphStep, { text: label, step: steps[step] }),\n            $(Text, { color: 'gray' }, separator),\n          )\n        },\n      ),\n    ),\n    cacheHit > 0 ?\n      $(Text, null, `${cacheHit} cache hit${cacheHit > 1 ? 's' : ''}`)\n    : null,\n    requests > 0 ?\n      $(Text, null, `${requests} request${requests > 1 ? 's' : ''}`)\n    : null,\n    trailer ? $(Text, null, trailer) : null,\n  )\n}\n\nexport class InstallReporter extends ViewClass {\n  #instance: Instance | null = null\n\n  start() {\n    this.#instance = render($(App))\n  }\n\n  async done(_result: InstallResult, { time }: { time: number }) {\n    let out = `Done in ${time}ms`\n\n    // prints a very complete message explaining users the next steps\n    // in case there are packages to be built\n    if (_result.buildQueue?.length) {\n      out += `\\n\\n📦 ${_result.buildQueue.length} packages have install scripts defined & were not fully built\\n`\n      out += '🔎 Run `vlt query :scripts` to list them\\n'\n      out +=\n        '🔨 Run `vlt build` to run all required scripts to build installed packages.\\n'\n    }\n    this.#instance?.rerender($(App, { trailer: out }))\n    return undefined\n  }\n\n  error(err: unknown) {\n    this.#instance?.unmount(asError(err))\n  }\n}\n"]}

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

@@ -1,10 +1,28 @@
+import { InstallReporter } from './install/reporter.ts';
+import type { DepID } from '@vltpkg/dep-id';
 import type { Graph } from '@vltpkg/graph';
 import type { CommandFn, CommandUsage } from '../index.ts';
-import { InstallReporter } from './install/reporter.ts';
+/**
+ * The resulting object of an install operation. To be used by the view impl.
+ */
+export type InstallResult = {
+    /**
+     * A queue of package IDs that need to be built after the install is complete.
+     */
+    buildQueue?: DepID[];
+    /**
+     * The resulting graph structure at the end of an install.
+     */
+    graph: Graph;
+};
 export declare const usage: CommandUsage;
 export declare const views: {
-    readonly json: (g: Graph) => import("@vltpkg/graph").LockfileData;
+    readonly json: (i: InstallResult) => {
+        graph: import("@vltpkg/graph").LockfileData;
+        buildQueue?: DepID[] | undefined;
+        message?: string | undefined;
+    };
     readonly human: typeof InstallReporter;
 };
-export declare const command: CommandFn<Graph>;
+export declare const command: CommandFn<InstallResult>;
 //# sourceMappingURL=install.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,eAAO,MAAM,KAAK,EAAE,YAMhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;;CAGe,CAAA;AAEjC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,KAAK,CAcpC,CAAA"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/install.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,EAAE,CAAA;IACpB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,YAMhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;;;;;;CAWuB,CAAA;AAEzC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,aAAa,CAyB5C,CAAA"}

package/dist/esm/commands/install.js

@@ -9,19 +9,37 @@ export const usage = () => commandUsage({
                   vlt-lock.json appropriately.`,
 });
 export const views = {
-    json: g => g.toJSON(),
+    json: i => ({
+        ...(i.buildQueue?.length ?
+            {
+                buildQueue: i.buildQueue,
+                message: `${i.buildQueue.length} packages that will need to be built, run "vlt build" to complete the install.`,
+            }
+            : null),
+        graph: i.graph.toJSON(),
+    }),
     human: InstallReporter,
 };
 export const command = async (conf) => {
+    // TODO: we should probably throw an error if the user
+    // tries to install using either view=mermaid or view=gui
     const monorepo = conf.options.monorepo;
     const { add } = parseAddArgs(conf, monorepo);
     const frozenLockfile = conf.options['frozen-lockfile'];
     const expectLockfile = conf.options['expect-lockfile'];
-    const { graph } = await install({
+    const lockfileOnly = conf.options['lockfile-only'];
+    /* c8 ignore start */
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    /* c8 ignore stop */
+    const { buildQueue, graph } = await install({
         ...conf.options,
         frozenLockfile,
         expectLockfile,
+        allowScripts,
+        lockfileOnly,
     }, add);
-    return graph;
+    return { buildQueue, graph };
 };
 //# sourceMappingURL=install.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/install.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE;+CAC8B;CAC5C,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,eAAe;CACS,CAAA;AAEjC,MAAM,CAAC,MAAM,OAAO,GAAqB,KAAK,EAAC,IAAI,EAAC,EAAE;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IACtC,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACtD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACtD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAC7B;QACE,GAAG,IAAI,CAAC,OAAO;QACf,cAAc;QACd,cAAc;KACf,EACD,GAAG,CACJ,CAAA;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import type { Graph } from '@vltpkg/graph'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { install } from '@vltpkg/graph'\nimport { parseAddArgs } from '../parse-add-remove-args.ts'\nimport type { Views } from '../view.ts'\nimport { InstallReporter } from './install/reporter.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'install',\n    usage: '[packages ...]',\n    description: `Install the specified packages, updating package.json and\n                  vlt-lock.json appropriately.`,\n  })\n\nexport const views = {\n  json: g => g.toJSON(),\n  human: InstallReporter,\n} as const satisfies Views<Graph>\n\nexport const command: CommandFn<Graph> = async conf => {\n  const monorepo = conf.options.monorepo\n  const { add } = parseAddArgs(conf, monorepo)\n  const frozenLockfile = conf.options['frozen-lockfile']\n  const expectLockfile = conf.options['expect-lockfile']\n  const { graph } = await install(\n    {\n      ...conf.options,\n      frozenLockfile,\n      expectLockfile,\n    },\n    add,\n  )\n  return graph\n}\n"]}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAoBvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE;+CAC8B;CAC5C,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACV,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACxB;gBACE,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,OAAO,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,gFAAgF;aAChH;YACH,CAAC,CAAC,IAAI,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE;KACxB,CAAC;IACF,KAAK,EAAE,eAAe;CACiB,CAAA;AAEzC,MAAM,CAAC,MAAM,OAAO,GAA6B,KAAK,EAAC,IAAI,EAAC,EAAE;IAC5D,sDAAsD;IACtD,yDAAyD;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IACtC,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACtD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAA;IAClD,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,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CACzC;QACE,GAAG,IAAI,CAAC,OAAO;QACf,cAAc;QACd,cAAc;QACd,YAAY;QACZ,YAAY;KACb,EACD,GAAG,CACJ,CAAA;IACD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AAC9B,CAAC,CAAA","sourcesContent":["import { commandUsage } from '../config/usage.ts'\nimport { install } from '@vltpkg/graph'\nimport { parseAddArgs } from '../parse-add-remove-args.ts'\nimport { InstallReporter } from './install/reporter.ts'\nimport type { DepID } from '@vltpkg/dep-id'\nimport type { Graph } from '@vltpkg/graph'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { Views } from '../view.ts'\n\n/**\n * The resulting object of an install operation. To be used by the view impl.\n */\nexport type InstallResult = {\n  /**\n   * A queue of package IDs that need to be built after the install is complete.\n   */\n  buildQueue?: DepID[]\n  /**\n   * The resulting graph structure at the end of an install.\n   */\n  graph: Graph\n}\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'install',\n    usage: '[packages ...]',\n    description: `Install the specified packages, updating package.json and\n                  vlt-lock.json appropriately.`,\n  })\n\nexport const views = {\n  json: i => ({\n    ...(i.buildQueue?.length ?\n      {\n        buildQueue: i.buildQueue,\n        message: `${i.buildQueue.length} packages that will need to be built, run \"vlt build\" to complete the install.`,\n      }\n    : null),\n    graph: i.graph.toJSON(),\n  }),\n  human: InstallReporter,\n} as const satisfies Views<InstallResult>\n\nexport const command: CommandFn<InstallResult> = async conf => {\n  // TODO: we should probably throw an error if the user\n  // tries to install using either view=mermaid or view=gui\n  const monorepo = conf.options.monorepo\n  const { add } = parseAddArgs(conf, monorepo)\n  const frozenLockfile = conf.options['frozen-lockfile']\n  const expectLockfile = conf.options['expect-lockfile']\n  const lockfileOnly = conf.options['lockfile-only']\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 { buildQueue, graph } = await install(\n    {\n      ...conf.options,\n      frozenLockfile,\n      expectLockfile,\n      allowScripts,\n      lockfileOnly,\n    },\n    add,\n  )\n  return { buildQueue, graph }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/commands/serve.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,eAAO,MAAM,KAAK,EAAE,YAyBhB,CAAA;AAEJ,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,KAAK;6BACA,WAAW;4BAcZ,WAAW;CACW,CAAA;AAEvC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAgE1C,CAAA"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/commands/serve.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,eAAO,MAAM,KAAK,EAAE,YAyBhB,CAAA;AAEJ,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,KAAK;6BACA,WAAW;4BAcZ,WAAW;CACW,CAAA;AAEvC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAuE1C,CAAA"}

package/dist/esm/commands/serve.js

@@ -61,9 +61,15 @@ export const command = async (conf) => {
         DAEMON_URL: `http://localhost:${actualGuiPort}`,
     };
     // runs the exec command internally
+    /* c8 ignore start */
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    /* c8 ignore stop */
     const arg0 = await vlx.resolve(['@vltpkg/vsr'], {
         ...conf.options,
         query: undefined,
+        allowScripts,
     }, async () => 'y');
     if (arg0) {
         conf.positionals[0] = arg0;

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

@@ -1 +1 @@
-{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/commands/serve.ts"],"names":[],"mappings":"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","sourcesContent":["import { onExit } from 'signal-exit'\nimport { error } from '@vltpkg/error-cause'\nimport { exec, execFG } from '@vltpkg/run'\nimport * as vlx from '@vltpkg/vlx'\nimport { ExecCommand } from '../exec-command.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport { stdout, styleTextStdout } from '../output.ts'\nimport { startGUI } from '../start-gui.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { LoadedConfig } from '../config/index.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'serve',\n    usage: '',\n    description: `Start a local development server that runs both the browser-based\n                  UI server and the VSR (vlt serverless registry) registry instance.\n\n                  The UI server will start first on port 8000 (or the next\n                  available port), and then the VSR registry will start on\n                  port 1337.\n\n                  This allows you to develop and test the full vlt ecosystem\n                  locally, including package publishing and installation from\n                  your local registry.`,\n    options: {\n      port: {\n        value: '<number>',\n        description:\n          'Port for the broser-based UI server (default: 8000)',\n      },\n      'registry-port': {\n        value: '<number>',\n        description: 'Port for the VSR registry (default: 1337)',\n      },\n    },\n  })\n\nexport type ServeResult = {\n  guiPort: number\n  registryPort: number\n  uiURL: string\n  registryURL: string\n}\n\nexport const views = {\n  human: (result: ServeResult) => {\n    stdout('')\n    stdout(\n      styleTextStdout(\n        ['bgWhiteBright', 'black', 'bold'],\n        ' vlt serve running ',\n      ),\n    )\n    stdout('')\n    stdout(`UI Server:       ${result.uiURL}`)\n    stdout(`VSR Registry:    ${result.registryURL}`)\n    stdout('')\n    stdout('Press Ctrl+C to stop both servers')\n  },\n  json: (result: ServeResult) => result,\n} as const satisfies Views<ServeResult>\n\nexport const command: CommandFn<ServeResult> = async (\n  conf: LoadedConfig,\n) => {\n  const registryPort = Number(conf.get('registry-port') ?? 1337)\n\n  // Start the GUI server first\n  stdout('Starting UI server...')\n  const server = await startGUI(conf, '/')\n  const actualGuiPort = server.port\n\n  if (!actualGuiPort) {\n    throw error('missing ui server port')\n  }\n\n  // Start the VSR registry with the GUI server port\n  stdout('Starting VSR registry...')\n\n  // Prepare environment for VSR registry\n  const registryEnv = {\n    ARG_DAEMON: 'true',\n    DAEMON_START_SERVER: 'false',\n    DAEMON_PORT: String(actualGuiPort),\n    DAEMON_URL: `http://localhost:${actualGuiPort}`,\n  }\n\n  // runs the exec command internally\n  const arg0 = await vlx.resolve(\n    ['@vltpkg/vsr'],\n    {\n      ...conf.options,\n      query: undefined,\n    },\n    async () => 'y',\n  )\n  if (arg0) {\n    conf.positionals[0] = arg0\n  }\n  delete conf.options['script-shell']\n  const ex = new ExecCommand(conf, exec, execFG)\n  ex.env = registryEnv\n  await ex.run()\n\n  // Handle process termination\n  /* c8 ignore start */\n  const cleanup = () => {\n    stdout('\\nShutting down servers...')\n    try {\n      void server.close()\n      stdout('UI server stopped')\n    } catch {}\n  }\n  onExit(cleanup)\n  /* c8 ignore stop */\n\n  // Return the server information\n  const result: ServeResult = {\n    guiPort: actualGuiPort,\n    registryPort,\n    uiURL: `http://localhost:${actualGuiPort}`,\n    registryURL: `http://localhost:${registryPort}`,\n  }\n\n  // This return will never be reached due to the infinite promise above\n  return result\n}\n"]}
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/commands/serve.ts"],"names":[],"mappings":"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","sourcesContent":["import { onExit } from 'signal-exit'\nimport { error } from '@vltpkg/error-cause'\nimport { exec, execFG } from '@vltpkg/run'\nimport * as vlx from '@vltpkg/vlx'\nimport { ExecCommand } from '../exec-command.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport { stdout, styleTextStdout } from '../output.ts'\nimport { startGUI } from '../start-gui.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { LoadedConfig } from '../config/index.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'serve',\n    usage: '',\n    description: `Start a local development server that runs both the browser-based\n                  UI server and the VSR (vlt serverless registry) registry instance.\n\n                  The UI server will start first on port 8000 (or the next\n                  available port), and then the VSR registry will start on\n                  port 1337.\n\n                  This allows you to develop and test the full vlt ecosystem\n                  locally, including package publishing and installation from\n                  your local registry.`,\n    options: {\n      port: {\n        value: '<number>',\n        description:\n          'Port for the broser-based UI server (default: 8000)',\n      },\n      'registry-port': {\n        value: '<number>',\n        description: 'Port for the VSR registry (default: 1337)',\n      },\n    },\n  })\n\nexport type ServeResult = {\n  guiPort: number\n  registryPort: number\n  uiURL: string\n  registryURL: string\n}\n\nexport const views = {\n  human: (result: ServeResult) => {\n    stdout('')\n    stdout(\n      styleTextStdout(\n        ['bgWhiteBright', 'black', 'bold'],\n        ' vlt serve running ',\n      ),\n    )\n    stdout('')\n    stdout(`UI Server:       ${result.uiURL}`)\n    stdout(`VSR Registry:    ${result.registryURL}`)\n    stdout('')\n    stdout('Press Ctrl+C to stop both servers')\n  },\n  json: (result: ServeResult) => result,\n} as const satisfies Views<ServeResult>\n\nexport const command: CommandFn<ServeResult> = async (\n  conf: LoadedConfig,\n) => {\n  const registryPort = Number(conf.get('registry-port') ?? 1337)\n\n  // Start the GUI server first\n  stdout('Starting UI server...')\n  const server = await startGUI(conf, '/')\n  const actualGuiPort = server.port\n\n  if (!actualGuiPort) {\n    throw error('missing ui server port')\n  }\n\n  // Start the VSR registry with the GUI server port\n  stdout('Starting VSR registry...')\n\n  // Prepare environment for VSR registry\n  const registryEnv = {\n    ARG_DAEMON: 'true',\n    DAEMON_START_SERVER: 'false',\n    DAEMON_PORT: String(actualGuiPort),\n    DAEMON_URL: `http://localhost:${actualGuiPort}`,\n  }\n\n  // runs the exec command internally\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    ['@vltpkg/vsr'],\n    {\n      ...conf.options,\n      query: undefined,\n      allowScripts,\n    },\n    async () => 'y',\n  )\n  if (arg0) {\n    conf.positionals[0] = arg0\n  }\n  delete conf.options['script-shell']\n  const ex = new ExecCommand(conf, exec, execFG)\n  ex.env = registryEnv\n  await ex.run()\n\n  // Handle process termination\n  /* c8 ignore start */\n  const cleanup = () => {\n    stdout('\\nShutting down servers...')\n    try {\n      void server.close()\n      stdout('UI server stopped')\n    } catch {}\n  }\n  onExit(cleanup)\n  /* c8 ignore stop */\n\n  // Return the server information\n  const result: ServeResult = {\n    guiPort: actualGuiPort,\n    registryPort,\n    uiURL: `http://localhost:${actualGuiPort}`,\n    registryURL: `http://localhost:${registryPort}`,\n  }\n\n  // This return will never be reached due to the infinite promise above\n  return result\n}\n"]}

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

@@ -1,10 +1,16 @@
 import type { Graph } from '@vltpkg/graph';
 import type { CommandFn, CommandUsage } from '../index.ts';
 import { InstallReporter } from './install/reporter.ts';
+export type UninstallResult = {
+    /**
+     * The resulting graph structure at the end of an uninstall.
+     */
+    graph: Graph;
+};
 export declare const usage: CommandUsage;
 export declare const views: {
-    readonly json: (g: Graph) => import("@vltpkg/graph").LockfileData;
+    readonly json: (i: UninstallResult) => import("@vltpkg/graph").LockfileData;
     readonly human: typeof InstallReporter;
 };
-export declare const command: CommandFn<Graph>;
+export declare const command: CommandFn<UninstallResult>;
 //# sourceMappingURL=uninstall.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/commands/uninstall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGvD,eAAO,MAAM,KAAK,EAAE,YAMhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;;CAGe,CAAA;AAEjC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,KAAK,CAKpC,CAAA"}
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/commands/uninstall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGvD,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,YAMhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;;CAGyB,CAAA;AAE3C,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,eAAe,CAc9C,CAAA"}

package/dist/esm/commands/uninstall.js

@@ -9,13 +9,18 @@ export const usage = () => commandUsage({
                   vlt-lock.json and package.json appropriately.`,
 });
 export const views = {
-    json: g => g.toJSON(),
+    json: i => i.graph.toJSON(),
     human: InstallReporter,
 };
 export const command = async (conf) => {
     const monorepo = conf.options.monorepo;
     const { remove } = parseRemoveArgs(conf, monorepo);
-    const { graph } = await uninstall(conf.options, remove);
-    return graph;
+    /* c8 ignore start */
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    /* c8 ignore stop */
+    const { graph } = await uninstall({ ...conf.options, allowScripts }, remove);
+    return { graph };
 };
 //# sourceMappingURL=uninstall.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../../src/commands/uninstall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE;gEAC+C;CAC7D,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,eAAe;CACS,CAAA;AAEjC,MAAM,CAAC,MAAM,OAAO,GAAqB,KAAK,EAAC,IAAI,EAAC,EAAE;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAClD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACvD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import { uninstall } from '@vltpkg/graph'\nimport type { Graph } from '@vltpkg/graph'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { parseRemoveArgs } from '../parse-add-remove-args.ts'\nimport { InstallReporter } from './install/reporter.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'uninstall',\n    usage: '[package ...]',\n    description: `The opposite of \\`vlt install\\`. Removes deps and updates\n                  vlt-lock.json and package.json appropriately.`,\n  })\n\nexport const views = {\n  json: g => g.toJSON(),\n  human: InstallReporter,\n} as const satisfies Views<Graph>\n\nexport const command: CommandFn<Graph> = async conf => {\n  const monorepo = conf.options.monorepo\n  const { remove } = parseRemoveArgs(conf, monorepo)\n  const { graph } = await uninstall(conf.options, remove)\n  return graph\n}\n"]}
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../../src/commands/uninstall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAUvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE;gEAC+C;CAC7D,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE;IAC3B,KAAK,EAAE,eAAe;CACmB,CAAA;AAE3C,MAAM,CAAC,MAAM,OAAO,GAA+B,KAAK,EAAC,IAAI,EAAC,EAAE;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAClD,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,EAAE,KAAK,EAAE,GAAG,MAAM,SAAS,CAC/B,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,EACjC,MAAM,CACP,CAAA;IACD,OAAO,EAAE,KAAK,EAAE,CAAA;AAClB,CAAC,CAAA","sourcesContent":["import { uninstall } from '@vltpkg/graph'\nimport type { Graph } from '@vltpkg/graph'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { parseRemoveArgs } from '../parse-add-remove-args.ts'\nimport { InstallReporter } from './install/reporter.ts'\nimport type { Views } from '../view.ts'\n\nexport type UninstallResult = {\n  /**\n   * The resulting graph structure at the end of an uninstall.\n   */\n  graph: Graph\n}\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'uninstall',\n    usage: '[package ...]',\n    description: `The opposite of \\`vlt install\\`. Removes deps and updates\n                  vlt-lock.json and package.json appropriately.`,\n  })\n\nexport const views = {\n  json: i => i.graph.toJSON(),\n  human: InstallReporter,\n} as const satisfies Views<UninstallResult>\n\nexport const command: CommandFn<UninstallResult> = async conf => {\n  const monorepo = conf.options.monorepo\n  const { remove } = parseRemoveArgs(conf, monorepo)\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 { graph } = await uninstall(\n    { ...conf.options, allowScripts },\n    remove,\n  )\n  return { graph }\n}\n"]}

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

@@ -1,10 +1,14 @@
-import type { Graph } from '@vltpkg/graph';
 import type { CommandFn, CommandUsage } from '../index.ts';
 import { InstallReporter } from './install/reporter.ts';
+import type { InstallResult } from './install.ts';
 export declare const usage: CommandUsage;
 export declare const views: {
-    readonly json: (g: Graph) => import("@vltpkg/graph").LockfileData;
+    readonly json: (i: InstallResult) => {
+        graph: import("@vltpkg/graph").LockfileData;
+        buildQueue?: import("@vltpkg/dep-id").DepID[] | undefined;
+        message?: string | undefined;
+    };
     readonly human: typeof InstallReporter;
 };
-export declare const command: CommandFn<Graph>;
+export declare const command: CommandFn<InstallResult>;
 //# sourceMappingURL=update.d.ts.map

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

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

package/dist/esm/commands/update.js

@@ -9,7 +9,15 @@ export const usage = () => commandUsage({
                   Discards the lockfile and resolves dependencies from scratch.`,
 });
 export const views = {
-    json: g => g.toJSON(),
+    json: i => ({
+        ...(i.buildQueue?.length ?
+            {
+                buildQueue: i.buildQueue,
+                message: `${i.buildQueue.length} packages that will need to be built, run "vlt build" to complete the update.`,
+            }
+            : null),
+        graph: i.graph.toJSON(),
+    }),
     human: InstallReporter,
 };
 export const command = async (conf) => {
@@ -19,7 +27,15 @@ export const command = async (conf) => {
             code: 'EUSAGE',
         });
     }
-    const { graph } = await update(conf.options);
-    return graph;
+    /* c8 ignore start */
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    /* c8 ignore stop */
+    const { buildQueue, graph } = await update({
+        ...conf.options,
+        allowScripts,
+    });
+    return { buildQueue, graph };
 };
 //# sourceMappingURL=update.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,EAAE;IACT,WAAW,EAAE;gFAC+D;CAC7E,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,eAAe;CACS,CAAA;AAEjC,MAAM,CAAC,MAAM,OAAO,GAAqB,KAAK,EAAC,IAAI,EAAC,EAAE;IACpD,4CAA4C;IAC5C,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,KAAK,CAAC,gDAAgD,EAAE;YAC5D,IAAI,EAAE,QAAQ;SACf,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC5C,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import { update } from '@vltpkg/graph'\nimport { error } from '@vltpkg/error-cause'\nimport type { Graph } from '@vltpkg/graph'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { InstallReporter } from './install/reporter.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'update',\n    usage: '',\n    description: `Update dependencies to their latest in-range versions.\n                  Discards the lockfile and resolves dependencies from scratch.`,\n  })\n\nexport const views = {\n  json: g => g.toJSON(),\n  human: InstallReporter,\n} as const satisfies Views<Graph>\n\nexport const command: CommandFn<Graph> = async conf => {\n  // Throw error if any arguments are provided\n  if (conf.positionals.length > 0) {\n    throw error('Arguments are not yet supported for vlt update', {\n      code: 'EUSAGE',\n    })\n  }\n\n  const { graph } = await update(conf.options)\n  return graph\n}\n"]}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAIvD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,EAAE;IACT,WAAW,EAAE;gFAC+D;CAC7E,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACV,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACxB;gBACE,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,OAAO,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,+EAA+E;aAC/G;YACH,CAAC,CAAC,IAAI,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE;KACxB,CAAC;IACF,KAAK,EAAE,eAAe;CACiB,CAAA;AAEzC,MAAM,CAAC,MAAM,OAAO,GAA6B,KAAK,EAAC,IAAI,EAAC,EAAE;IAC5D,4CAA4C;IAC5C,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,KAAK,CAAC,gDAAgD,EAAE;YAC5D,IAAI,EAAE,QAAQ;SACf,CAAC,CAAA;IACJ,CAAC;IAED,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,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC;QACzC,GAAG,IAAI,CAAC,OAAO;QACf,YAAY;KACb,CAAC,CAAA;IACF,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AAC9B,CAAC,CAAA","sourcesContent":["import { update } from '@vltpkg/graph'\nimport { error } from '@vltpkg/error-cause'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { InstallReporter } from './install/reporter.ts'\nimport type { Views } from '../view.ts'\nimport type { InstallResult } from './install.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'update',\n    usage: '',\n    description: `Update dependencies to their latest in-range versions.\n                  Discards the lockfile and resolves dependencies from scratch.`,\n  })\n\nexport const views = {\n  json: i => ({\n    ...(i.buildQueue?.length ?\n      {\n        buildQueue: i.buildQueue,\n        message: `${i.buildQueue.length} packages that will need to be built, run \"vlt build\" to complete the update.`,\n      }\n    : null),\n    graph: i.graph.toJSON(),\n  }),\n  human: InstallReporter,\n} as const satisfies Views<InstallResult>\n\nexport const command: CommandFn<InstallResult> = async conf => {\n  // Throw error if any arguments are provided\n  if (conf.positionals.length > 0) {\n    throw error('Arguments are not yet supported for vlt update', {\n      code: 'EUSAGE',\n    })\n  }\n\n  /* 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 { buildQueue, graph } = await update({\n    ...conf.options,\n    allowScripts,\n  })\n  return { buildQueue, graph }\n}\n"]}

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

@@ -15,9 +15,9 @@ export declare const commands: {
     readonly xl: "exec-local";
     readonly h: "help";
     readonly '?': "help";
-    readonly conf: "config";
     readonly ls: "list";
     readonly xc: "exec-cache";
+    readonly build: "build";
     readonly cache: "cache";
     readonly ci: "ci";
     readonly config: "config";
@@ -202,10 +202,12 @@ export declare const definition: import("jackspeak").Jack<{
 } & {
     scope: {
         short: string;
+        hint: string;
         description: string;
     };
     target: {
         short: string;
+        hint: string;
         description: string;
     };
 } & {
@@ -239,7 +241,7 @@ export declare const definition: import("jackspeak").Jack<{
     config: {
         hint: string;
         description: string;
-        validOptions: readonly ["user", "project"];
+        validOptions: readonly ["all", "user", "project"];
         default: string;
     };
     editor: {
@@ -324,10 +326,21 @@ export declare const definition: import("jackspeak").Jack<{
     'frozen-lockfile': {
         description: string;
     };
+    'lockfile-only': {
+        description: string;
+    };
 } & {
     'dry-run': import("jackspeak").ConfigOption<"boolean", false, undefined>;
     'expect-lockfile': import("jackspeak").ConfigOption<"boolean", false, undefined>;
     'frozen-lockfile': import("jackspeak").ConfigOption<"boolean", false, undefined>;
+    'lockfile-only': import("jackspeak").ConfigOption<"boolean", false, undefined>;
+} & {
+    'allow-scripts': {
+        hint: string;
+        description: string;
+    };
+} & {
+    'allow-scripts': import("jackspeak").ConfigOption<"string", false, readonly string[] | undefined>;
 } & {
     access: {
         description: string;

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

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