@vltpkg/cli-sdk 0.0.0-2 → 0.0.0-20

package/dist/esm/commands/query.js

@@ -1,16 +1,37 @@
-import { actual, humanReadableOutput, jsonOutput, mermaidOutput, } from '@vltpkg/graph';
+import { actual, asNode, humanReadableOutput, jsonOutput, mermaidOutput, GraphModifier, } from '@vltpkg/graph';
+import { error } from '@vltpkg/error-cause';
+import LZString from 'lz-string';
 import { Query } from '@vltpkg/query';
+import { SecurityArchive } from '@vltpkg/security-archive';
 import { commandUsage } from "../config/usage.js";
 import { startGUI } from "../start-gui.js";
 export const usage = () => commandUsage({
     command: 'query',
-    usage: ['', '<query> --view=[human | json | mermaid | gui]'],
-    description: 'List installed dependencies matching the provided query.',
+    usage: [
+        '',
+        '<query> --view=<human | json | mermaid | gui>',
+        '<query> --expect-results=<comparison string>',
+        '--target=<query> --view=<human | json | mermaid | gui>',
+    ],
+    description: `List installed dependencies matching the provided query.
+
+      The vlt Dependency Selector Syntax is a CSS-like query language that
+      allows you to filter installed dependencies using a variety of metadata
+      in the form of CSS-like attributes, pseudo selectors & combinators.
+
+      The --scope and --target options accepts DSS query selectors to filter
+      packages. Using --scope, you can specify which packages to treat as the
+      top-level items in the output graph. The --target option can be used as
+      an alternative to positional arguments, it allows you to filter what
+      dependencies to include in the output. Using both options allows you to
+      render subgraphs of the dependency graph.
+
+      Defaults to listing all dependencies of the project root and workspaces.`,
     examples: {
         [`'#foo'`]: {
-            description: 'Query packages with the name "foo"',
+            description: 'Query dependencies declared as "foo"',
         },
-        [`'*.workspace > *.peer'`]: {
+        [`'*:workspace > *:peer'`]: {
             description: 'Query all peer dependencies of workspaces',
         },
         [`':project > *:attr(scripts, [build])'`]: {
@@ -19,56 +40,148 @@ export const usage = () => commandUsage({
         [`'[name^="@vltpkg"]'`]: {
             description: 'Query packages with names starting with "@vltpkg"',
         },
+        [`'*:license(copyleft) --expect-results=0'`]: {
+            description: 'Errors if a copyleft licensed package is found',
+        },
+        '--scope=":root > #dependency-name"': {
+            description: 'Defines a direct dependency as the output top-level scope',
+        },
+        [`'--target="*"'`]: {
+            description: 'Query all dependencies using the target option',
+        },
+        [`'--target=":workspace > *:peer"'`]: {
+            description: 'Query all peer dependencies of workspaces using target option',
+        },
     },
     options: {
+        'expect-results': {
+            value: '[number | string]',
+            description: 'Sets an expected number of resulting items. Errors if the number of resulting items does not match the set value. Accepts a specific numeric value or a string value starting with either ">", "<", ">=" or "<=" followed by a numeric value to be compared.',
+        },
+        scope: {
+            value: '<query>',
+            description: 'Query selector to select top-level packages using the DSS query language syntax.',
+        },
+        target: {
+            value: '<query>',
+            description: 'Query selector to filter packages using DSS syntax.',
+        },
         view: {
             value: '[human | json | mermaid | gui]',
             description: 'Output format. Defaults to human-readable or json if no tty.',
         },
     },
 });
+const validateExpectedResult = (conf, edges) => {
+    const expectResults = conf.values['expect-results'];
+    if (expectResults?.startsWith('>=')) {
+        return edges.length >= parseInt(expectResults.slice(2).trim(), 10);
+    }
+    else if (expectResults?.startsWith('<=')) {
+        return edges.length <= parseInt(expectResults.slice(2).trim(), 10);
+    }
+    else if (expectResults?.startsWith('>')) {
+        return edges.length > parseInt(expectResults.slice(1).trim(), 10);
+    }
+    else if (expectResults?.startsWith('<')) {
+        return edges.length < parseInt(expectResults.slice(1).trim(), 10);
+    }
+    else if (expectResults) {
+        return edges.length === parseInt(expectResults.trim(), 10);
+    }
+    return true;
+};
 export const views = {
     json: jsonOutput,
     mermaid: mermaidOutput,
     human: humanReadableOutput,
     gui: async ({ queryString }, _, conf) => {
-        await startGUI({
-            conf,
-            startingRoute: '/explore?query=' + encodeURIComponent(queryString),
-        });
+        await startGUI(conf, `/explore/${LZString.compressToEncodedURIComponent(queryString)}/overview`);
     },
 };
 export const command = async (conf) => {
+    const modifiers = GraphModifier.maybeLoad(conf.options);
     const monorepo = conf.options.monorepo;
     const mainManifest = conf.options.packageJson.read(conf.options.projectRoot);
     const graph = actual.load({
         ...conf.options,
         mainManifest,
+        modifiers,
         monorepo,
         loadManifests: true,
     });
     const defaultQueryString = '*';
-    const queryString = conf.positionals[0];
-    const query = new Query({ graph, specOptions: conf.options });
-    const { edges, nodes } = await query.search(queryString || defaultQueryString);
+    const positionalQueryString = conf.positionals[0];
+    const targetQueryString = conf.get('target');
+    const queryString = targetQueryString || positionalQueryString;
+    const securityArchive = await SecurityArchive.start({
+        graph,
+        specOptions: conf.options,
+    });
+    const query = new Query({
+        graph,
+        specOptions: conf.options,
+        securityArchive,
+    });
     const importers = new Set();
-    if (monorepo) {
-        for (const workspace of monorepo.filter(conf.values)) {
-            const w = graph.nodes.get(workspace.id);
-            if (w)
-                importers.add(w);
+    const scopeIDs = [];
+    // Handle --scope option to add scope nodes as importers
+    const scopeQueryString = conf.get('scope');
+    let scopeNodes;
+    if (scopeQueryString) {
+        // Run scope query to get all matching nodes
+        const scopeQuery = new Query({
+            graph,
+            specOptions: conf.options,
+            securityArchive,
+        });
+        const { nodes } = await scopeQuery.search(scopeQueryString, {
+            signal: new AbortController().signal,
+        });
+        scopeNodes = nodes;
+    }
+    if (scopeQueryString && scopeNodes) {
+        // Add all scope nodes to importers Set (treat them as top-level items)
+        for (const queryNode of scopeNodes) {
+            importers.add(asNode(queryNode));
         }
     }
-    if (importers.size === 0) {
-        for (const importer of graph.importers) {
-            importers.add(importer);
+    else {
+        // if in a workspace environment, select only the specified
+        // workspaces as top-level items
+        if (monorepo) {
+            for (const workspace of monorepo.filter(conf.values)) {
+                const w = graph.nodes.get(workspace.id);
+                if (w) {
+                    importers.add(w);
+                    scopeIDs.push(workspace.id);
+                }
+            }
+        }
+        // if no top-level item was set then by default
+        // we just set all importers as top-level items
+        if (importers.size === 0) {
+            for (const importer of graph.importers) {
+                importers.add(importer);
+            }
         }
     }
+    // retrieve the selected nodes and edges
+    const { edges, nodes } = await query.search(queryString || defaultQueryString, {
+        signal: new AbortController().signal,
+        scopeIDs: scopeIDs.length > 0 ? scopeIDs : undefined,
+    });
+    if (!validateExpectedResult(conf, edges)) {
+        throw error('Unexpected number of items', {
+            found: edges.length,
+            wanted: conf.values['expect-results'],
+        });
+    }
     return {
         importers,
         edges,
         nodes,
-        highlightSelection: !!queryString,
+        highlightSelection: !!(targetQueryString || positionalQueryString),
         queryString: queryString || defaultQueryString,
     };
 };

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

@@ -1 +1 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/commands/query.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  actual,\n  humanReadableOutput,\n  jsonOutput,\n  mermaidOutput,\n} from '@vltpkg/graph'\nimport type {\n  HumanReadableOutputGraph,\n  JSONOutputGraph,\n  MermaidOutputGraph,\n  Node,\n} from '@vltpkg/graph'\nimport { Query } from '@vltpkg/query'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { startGUI } from '../start-gui.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'query',\n    usage: ['', '<query> --view=[human | json | mermaid | gui]'],\n    description:\n      'List installed dependencies matching the provided query.',\n    examples: {\n      [`'#foo'`]: {\n        description: 'Query packages with the name \"foo\"',\n      },\n      [`'*.workspace > *.peer'`]: {\n        description: 'Query all peer dependencies of workspaces',\n      },\n      [`':project > *:attr(scripts, [build])'`]: {\n        description:\n          'Query all direct project dependencies with a \"build\" script',\n      },\n      [`'[name^=\"@vltpkg\"]'`]: {\n        description:\n          'Query packages with names starting with \"@vltpkg\"',\n      },\n    },\n    options: {\n      view: {\n        value: '[human | json | mermaid | gui]',\n        description:\n          'Output format. Defaults to human-readable or json if no tty.',\n      },\n    },\n  })\n\ntype QueryResult = JSONOutputGraph &\n  MermaidOutputGraph &\n  HumanReadableOutputGraph & { queryString: string }\n\nexport const views = {\n  json: jsonOutput,\n  mermaid: mermaidOutput,\n  human: humanReadableOutput,\n  gui: async ({ queryString }, _, conf) => {\n    await startGUI({\n      conf,\n      startingRoute:\n        '/explore?query=' + encodeURIComponent(queryString),\n    })\n  },\n} as const satisfies Views<QueryResult>\n\nexport const command: CommandFn<QueryResult> = async conf => {\n  const monorepo = conf.options.monorepo\n  const mainManifest = conf.options.packageJson.read(\n    conf.options.projectRoot,\n  )\n  const graph = actual.load({\n    ...conf.options,\n    mainManifest,\n    monorepo,\n    loadManifests: true,\n  })\n\n  const defaultQueryString = '*'\n  const queryString = conf.positionals[0]\n  const query = new Query({ graph, specOptions: conf.options })\n  const { edges, nodes } = await query.search(\n    queryString || defaultQueryString,\n  )\n\n  const importers = new Set<Node>()\n  if (monorepo) {\n    for (const workspace of monorepo.filter(conf.values)) {\n      const w: Node | undefined = graph.nodes.get(workspace.id)\n      if (w) importers.add(w)\n    }\n  }\n  if (importers.size === 0) {\n    for (const importer of graph.importers) {\n      importers.add(importer)\n    }\n  }\n\n  return {\n    importers,\n    edges,\n    nodes,\n    highlightSelection: !!queryString,\n    queryString: queryString || defaultQueryString,\n  }\n}\n"]}
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/commands/query.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  EdgeLike,\n  HumanReadableOutputGraph,\n  JSONOutputGraph,\n  MermaidOutputGraph,\n  Node,\n} from '@vltpkg/graph'\nimport {\n  actual,\n  asNode,\n  humanReadableOutput,\n  jsonOutput,\n  mermaidOutput,\n  GraphModifier,\n} from '@vltpkg/graph'\nimport { error } from '@vltpkg/error-cause'\nimport LZString from 'lz-string'\nimport { Query } from '@vltpkg/query'\nimport { SecurityArchive } from '@vltpkg/security-archive'\nimport type { DepID } from '@vltpkg/dep-id'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { startGUI } from '../start-gui.ts'\nimport type { Views } from '../view.ts'\nimport type { LoadedConfig } from '../config/index.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'query',\n    usage: [\n      '',\n      '<query> --view=<human | json | mermaid | gui>',\n      '<query> --expect-results=<comparison string>',\n      '--target=<query> --view=<human | json | mermaid | gui>',\n    ],\n    description: `List installed dependencies matching the provided query.\n\n      The vlt Dependency Selector Syntax is a CSS-like query language that\n      allows you to filter installed dependencies using a variety of metadata\n      in the form of CSS-like attributes, pseudo selectors & combinators.\n\n      The --scope and --target options accepts DSS query selectors to filter\n      packages. Using --scope, you can specify which packages to treat as the\n      top-level items in the output graph. The --target option can be used as\n      an alternative to positional arguments, it allows you to filter what\n      dependencies to include in the output. Using both options allows you to\n      render subgraphs of the dependency graph.\n\n      Defaults to listing all dependencies of the project root and workspaces.`,\n\n    examples: {\n      [`'#foo'`]: {\n        description: 'Query dependencies declared as \"foo\"',\n      },\n      [`'*:workspace > *:peer'`]: {\n        description: 'Query all peer dependencies of workspaces',\n      },\n      [`':project > *:attr(scripts, [build])'`]: {\n        description:\n          'Query all direct project dependencies with a \"build\" script',\n      },\n      [`'[name^=\"@vltpkg\"]'`]: {\n        description:\n          'Query packages with names starting with \"@vltpkg\"',\n      },\n      [`'*:license(copyleft) --expect-results=0'`]: {\n        description: 'Errors if a copyleft licensed package is found',\n      },\n      '--scope=\":root > #dependency-name\"': {\n        description:\n          'Defines a direct dependency as the output top-level scope',\n      },\n      [`'--target=\"*\"'`]: {\n        description: 'Query all dependencies using the target option',\n      },\n      [`'--target=\":workspace > *:peer\"'`]: {\n        description:\n          'Query all peer dependencies of workspaces using target option',\n      },\n    },\n    options: {\n      'expect-results': {\n        value: '[number | string]',\n        description:\n          'Sets an expected number of resulting items. Errors if the number of resulting items does not match the set value. Accepts a specific numeric value or a string value starting with either \">\", \"<\", \">=\" or \"<=\" followed by a numeric value to be compared.',\n      },\n      scope: {\n        value: '<query>',\n        description:\n          'Query selector to select top-level packages using the DSS query language syntax.',\n      },\n      target: {\n        value: '<query>',\n        description:\n          'Query selector to filter packages using DSS syntax.',\n      },\n      view: {\n        value: '[human | json | mermaid | gui]',\n        description:\n          'Output format. Defaults to human-readable or json if no tty.',\n      },\n    },\n  })\n\ntype QueryResult = JSONOutputGraph &\n  MermaidOutputGraph &\n  HumanReadableOutputGraph & { queryString: string }\n\nconst validateExpectedResult = (\n  conf: LoadedConfig,\n  edges: EdgeLike[],\n): boolean => {\n  const expectResults = conf.values['expect-results']\n  if (expectResults?.startsWith('>=')) {\n    return edges.length >= parseInt(expectResults.slice(2).trim(), 10)\n  } else if (expectResults?.startsWith('<=')) {\n    return edges.length <= parseInt(expectResults.slice(2).trim(), 10)\n  } else if (expectResults?.startsWith('>')) {\n    return edges.length > parseInt(expectResults.slice(1).trim(), 10)\n  } else if (expectResults?.startsWith('<')) {\n    return edges.length < parseInt(expectResults.slice(1).trim(), 10)\n  } else if (expectResults) {\n    return edges.length === parseInt(expectResults.trim(), 10)\n  }\n  return true\n}\n\nexport const views = {\n  json: jsonOutput,\n  mermaid: mermaidOutput,\n  human: humanReadableOutput,\n  gui: async ({ queryString }, _, conf) => {\n    await startGUI(\n      conf,\n      `/explore/${LZString.compressToEncodedURIComponent(queryString)}/overview`,\n    )\n  },\n} as const satisfies Views<QueryResult>\n\nexport const command: CommandFn<QueryResult> = async conf => {\n  const modifiers = GraphModifier.maybeLoad(conf.options)\n  const monorepo = conf.options.monorepo\n  const mainManifest = conf.options.packageJson.read(\n    conf.options.projectRoot,\n  )\n  const graph = actual.load({\n    ...conf.options,\n    mainManifest,\n    modifiers,\n    monorepo,\n    loadManifests: true,\n  })\n\n  const defaultQueryString = '*'\n  const positionalQueryString = conf.positionals[0]\n  const targetQueryString = conf.get('target')\n  const queryString = targetQueryString || positionalQueryString\n  const securityArchive = await SecurityArchive.start({\n    graph,\n    specOptions: conf.options,\n  })\n  const query = new Query({\n    graph,\n    specOptions: conf.options,\n    securityArchive,\n  })\n\n  const importers = new Set<Node>()\n  const scopeIDs: DepID[] = []\n\n  // Handle --scope option to add scope nodes as importers\n  const scopeQueryString = conf.get('scope')\n  let scopeNodes\n  if (scopeQueryString) {\n    // Run scope query to get all matching nodes\n    const scopeQuery = new Query({\n      graph,\n      specOptions: conf.options,\n      securityArchive,\n    })\n    const { nodes } = await scopeQuery.search(scopeQueryString, {\n      signal: new AbortController().signal,\n    })\n    scopeNodes = nodes\n  }\n\n  if (scopeQueryString && scopeNodes) {\n    // Add all scope nodes to importers Set (treat them as top-level items)\n    for (const queryNode of scopeNodes) {\n      importers.add(asNode(queryNode))\n    }\n  } else {\n    // if in a workspace environment, select only the specified\n    // workspaces as top-level items\n    if (monorepo) {\n      for (const workspace of monorepo.filter(conf.values)) {\n        const w: Node | undefined = graph.nodes.get(workspace.id)\n        if (w) {\n          importers.add(w)\n          scopeIDs.push(workspace.id)\n        }\n      }\n    }\n    // if no top-level item was set then by default\n    // we just set all importers as top-level items\n    if (importers.size === 0) {\n      for (const importer of graph.importers) {\n        importers.add(importer)\n      }\n    }\n  }\n\n  // retrieve the selected nodes and edges\n  const { edges, nodes } = await query.search(\n    queryString || defaultQueryString,\n    {\n      signal: new AbortController().signal,\n      scopeIDs: scopeIDs.length > 0 ? scopeIDs : undefined,\n    },\n  )\n\n  if (!validateExpectedResult(conf, edges)) {\n    throw error('Unexpected number of items', {\n      found: edges.length,\n      wanted: conf.values['expect-results'],\n    })\n  }\n\n  return {\n    importers,\n    edges,\n    nodes,\n    highlightSelection: !!(\n      targetQueryString || positionalQueryString\n    ),\n    queryString: queryString || defaultQueryString,\n  }\n}\n"]}

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

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

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

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

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

@@ -1,6 +1,7 @@
 import { runExec, runExecFG } from '@vltpkg/run';
 import { commandUsage } from "../config/usage.js";
 import { ExecCommand } from "../exec-command.js";
+export { views } from "../exec-command.js";
 export const usage = () => commandUsage({
     command: 'run-exec',
     usage: '[command ...]',

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

@@ -1 +1 @@
-{"version":3,"file":"run-exec.js","sourceRoot":"","sources":["../../../src/commands/run-exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAIhD,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE;;;mEAGkD;CAChE,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE,CACzD,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,GAAG,EAAE,CAAA","sourcesContent":["import { runExec, runExecFG } from '@vltpkg/run'\nimport { commandUsage } from '../config/usage.ts'\nimport { ExecCommand } from '../exec-command.ts'\nimport type { ExecResult } from '../exec-command.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'run-exec',\n    usage: '[command ...]',\n    description: `If the first argument is a defined script in package.json, then this is\n                  equivalent to \\`vlt run\\`.\n\n                  If not, then this is equivalent to \\`vlt exec\\`.`,\n  })\n\nexport const command: CommandFn<ExecResult> = async conf =>\n  await new ExecCommand(conf, runExec, runExecFG).run()\n"]}
+{"version":3,"file":"run-exec.js","sourceRoot":"","sources":["../../../src/commands/run-exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE;;;mEAGkD;CAChE,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE,CACzD,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,GAAG,EAAE,CAAA","sourcesContent":["import { runExec, runExecFG } from '@vltpkg/run'\nimport { commandUsage } from '../config/usage.ts'\nimport type { ExecResult } from '../exec-command.ts'\nimport { ExecCommand } from '../exec-command.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nexport { views } from '../exec-command.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'run-exec',\n    usage: '[command ...]',\n    description: `If the first argument is a defined script in package.json, then this is\n                  equivalent to \\`vlt run\\`.\n\n                  If not, then this is equivalent to \\`vlt exec\\`.`,\n  })\n\nexport const command: CommandFn<ExecResult> = async conf =>\n  await new ExecCommand(conf, runExec, runExecFG).run()\n"]}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/run.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1D,eAAO,MAAM,KAAK,EAAE,YAQhB,CAAA;AAgCJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CACR,CAAA"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EAGX,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,eAAO,MAAM,KAAK,EAAE,YAQhB,CAAA;AA2BJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CACR,CAAA"}

package/dist/esm/commands/run.js

@@ -1,8 +1,7 @@
-import { PackageJson } from '@vltpkg/package-json';
 import { run, runFG } from '@vltpkg/run';
 import { commandUsage } from "../config/usage.js";
 import { ExecCommand } from "../exec-command.js";
-import { stdout } from "../output.js";
+export { views } from "../exec-command.js";
 export const usage = () => commandUsage({
     command: 'run',
     usage: '<script> [args ...]',
@@ -15,24 +14,22 @@ class RunCommand extends ExecCommand {
     constructor(conf) {
         super(conf, run, runFG);
     }
-    defaultArg0() {
+    // do not provide the interactive shell arg, just do nothing
+    // so that it falls back up to the noArgsSingle() method
+    defaultArg0() { }
+    noArgsSingle() {
         // called when there's no arg0, with a single workspace or root
-        const ws = this.monorepo?.values().next().value;
-        const cwd = ws?.fullpath ?? this.projectRoot;
-        const packageJson = this.monorepo?.packageJson ?? new PackageJson();
-        const mani = packageJson.read(cwd);
-        stdout('Scripts available:', mani.scripts);
-        return undefined;
+        const cwd = this.getCwd();
+        const { scripts = {} } = this.conf.options.packageJson.read(cwd);
+        return scripts;
     }
     noArgsMulti() {
-        const m = this.monorepo;
-        /* c8 ignore next - already guarded */
-        if (!m)
-            return;
-        stdout('Scripts available:');
-        for (const [ws, scripts] of m.runSync(ws => ws.manifest.scripts)) {
-            stdout(ws.path, scripts);
+        const scripts = {};
+        for (const { label, manifest } of this.getTargets()) {
+            if (manifest.scripts)
+                scripts[label] = manifest.scripts;
         }
+        return scripts;
     }
 }
 export const command = async (conf) => await new RunCommand(conf).run();

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

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGhD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE;;;sCAGqB;CACnC,CAAC,CAAA;AAEJ,MAAM,UAAW,SAAQ,WAAqC;IAC5D,YAAY,IAAkB;QAC5B,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;IACzB,CAAC;IAED,WAAW;QACT,+DAA+D;QAC/D,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;QAC/C,MAAM,GAAG,GAAG,EAAE,EAAE,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAA;QAC5C,MAAM,WAAW,GACf,IAAI,CAAC,QAAQ,EAAE,WAAW,IAAI,IAAI,WAAW,EAAE,CAAA;QACjD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClC,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1C,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,WAAW;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAA;QACvB,sCAAsC;QACtC,IAAI,CAAC,CAAC;YAAE,OAAM;QAEd,MAAM,CAAC,oBAAoB,CAAC,CAAA;QAC5B,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CACnC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAC1B,EAAE,CAAC;YACF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE,CACzD,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA","sourcesContent":["import { PackageJson } from '@vltpkg/package-json'\nimport { run, runFG } from '@vltpkg/run'\nimport type { LoadedConfig } from '../config/index.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport { ExecCommand } from '../exec-command.ts'\nimport type { ExecResult } from '../exec-command.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { stdout } from '../output.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'run',\n    usage: '<script> [args ...]',\n    description: `Run a script defined in 'package.json', passing along any extra\n                  arguments. Note that vlt config values must be specified *before*\n                  the script name, because everything after that is handed off to\n                  the script process.`,\n  })\n\nclass RunCommand extends ExecCommand<typeof run, typeof runFG> {\n  constructor(conf: LoadedConfig) {\n    super(conf, run, runFG)\n  }\n\n  defaultArg0(): string | undefined {\n    // called when there's no arg0, with a single workspace or root\n    const ws = this.monorepo?.values().next().value\n    const cwd = ws?.fullpath ?? this.projectRoot\n    const packageJson =\n      this.monorepo?.packageJson ?? new PackageJson()\n    const mani = packageJson.read(cwd)\n    stdout('Scripts available:', mani.scripts)\n    return undefined\n  }\n\n  noArgsMulti(): void {\n    const m = this.monorepo\n    /* c8 ignore next - already guarded */\n    if (!m) return\n\n    stdout('Scripts available:')\n    for (const [ws, scripts] of m.runSync(\n      ws => ws.manifest.scripts,\n    )) {\n      stdout(ws.path, scripts)\n    }\n  }\n}\n\nexport const command: CommandFn<ExecResult> = async conf =>\n  await new RunCommand(conf).run()\n"]}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAMjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGhD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE;;;sCAGqB;CACnC,CAAC,CAAA;AAEJ,MAAM,UAAW,SAAQ,WAAqC;IAC5D,YAAY,IAAkB;QAC5B,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;IACzB,CAAC;IAED,4DAA4D;IAC5D,wDAAwD;IACxD,WAAW,KAAe,CAAC;IAE3B,YAAY;QACV,+DAA+D;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;QACzB,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,WAAW;QACT,MAAM,OAAO,GAAmB,EAAE,CAAA;QAClC,KAAK,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YACpD,IAAI,QAAQ,CAAC,OAAO;gBAAE,OAAO,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAA;QACzD,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE,CACzD,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA","sourcesContent":["import { run, runFG } from '@vltpkg/run'\nimport type { LoadedConfig } from '../config/index.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type {\n  ExecResult,\n  MultiScriptSet,\n  ScriptSet,\n} from '../exec-command.ts'\nimport { ExecCommand } from '../exec-command.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\n\nexport { views } from '../exec-command.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'run',\n    usage: '<script> [args ...]',\n    description: `Run a script defined in 'package.json', passing along any extra\n                  arguments. Note that vlt config values must be specified *before*\n                  the script name, because everything after that is handed off to\n                  the script process.`,\n  })\n\nclass RunCommand extends ExecCommand<typeof run, typeof runFG> {\n  constructor(conf: LoadedConfig) {\n    super(conf, run, runFG)\n  }\n\n  // do not provide the interactive shell arg, just do nothing\n  // so that it falls back up to the noArgsSingle() method\n  defaultArg0(): undefined {}\n\n  noArgsSingle(): ScriptSet {\n    // called when there's no arg0, with a single workspace or root\n    const cwd = this.getCwd()\n    const { scripts = {} } = this.conf.options.packageJson.read(cwd)\n    return scripts\n  }\n\n  noArgsMulti(): MultiScriptSet {\n    const scripts: MultiScriptSet = {}\n    for (const { label, manifest } of this.getTargets()) {\n      if (manifest.scripts) scripts[label] = manifest.scripts\n    }\n    return scripts\n  }\n}\n\nexport const command: CommandFn<ExecResult> = async conf =>\n  await new RunCommand(conf).run()\n"]}

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

@@ -1,4 +1,10 @@
+import type { Graph } from '@vltpkg/graph';
 import type { CommandFn, CommandUsage } from '../index.ts';
+import { InstallReporter } from './install/reporter.ts';
 export declare const usage: CommandUsage;
-export declare const command: CommandFn<void>;
+export declare const views: {
+    readonly json: (g: Graph) => import("@vltpkg/graph").LockfileData;
+    readonly human: typeof InstallReporter;
+};
+export declare const command: CommandFn<Graph>;
 //# 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":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1D,eAAO,MAAM,KAAK,EAAE,YAMhB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,IAAI,CAInC,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,eAAO,MAAM,KAAK,EAAE,YAMhB,CAAA;AAEJ,eAAO,MAAM,KAAK;;;CAGe,CAAA;AAEjC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,KAAK,CAKpC,CAAA"}

package/dist/esm/commands/uninstall.js

@@ -1,15 +1,21 @@
 import { uninstall } from '@vltpkg/graph';
 import { commandUsage } from "../config/usage.js";
 import { parseRemoveArgs } from "../parse-add-remove-args.js";
+import { InstallReporter } from "./install/reporter.js";
 export const usage = () => commandUsage({
     command: 'uninstall',
     usage: '[package ...]',
     description: `The opposite of \`vlt install\`. Removes deps and updates
                   vlt-lock.json and package.json appropriately.`,
 });
+export const views = {
+    json: g => g.toJSON(),
+    human: InstallReporter,
+};
 export const command = async (conf) => {
     const monorepo = conf.options.monorepo;
     const { remove } = parseRemoveArgs(conf, monorepo);
-    await uninstall(conf.options, remove);
+    const { graph } = await uninstall(conf.options, 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;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAE7D,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,OAAO,GAAoB,KAAK,EAAC,IAAI,EAAC,EAAE;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAClD,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AACvC,CAAC,CAAA","sourcesContent":["import { uninstall } from '@vltpkg/graph'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { parseRemoveArgs } from '../parse-add-remove-args.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 command: CommandFn<void> = async conf => {\n  const monorepo = conf.options.monorepo\n  const { remove } = parseRemoveArgs(conf, monorepo)\n  await uninstall(conf.options, remove)\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;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"]}

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

@@ -0,0 +1,10 @@
+import type { Graph } from '@vltpkg/graph';
+import type { CommandFn, CommandUsage } from '../index.ts';
+import { InstallReporter } from './install/reporter.ts';
+export declare const usage: CommandUsage;
+export declare const views: {
+    readonly json: (g: Graph) => import("@vltpkg/graph").LockfileData;
+    readonly human: typeof InstallReporter;
+};
+export declare const command: CommandFn<Graph>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +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"}

package/dist/esm/commands/update.js

@@ -0,0 +1,25 @@
+import { update } from '@vltpkg/graph';
+import { error } from '@vltpkg/error-cause';
+import { commandUsage } from "../config/usage.js";
+import { InstallReporter } from "./install/reporter.js";
+export const usage = () => commandUsage({
+    command: 'update',
+    usage: '',
+    description: `Update dependencies to their latest in-range versions.
+                  Discards the lockfile and resolves dependencies from scratch.`,
+});
+export const views = {
+    json: g => g.toJSON(),
+    human: InstallReporter,
+};
+export const command = async (conf) => {
+    // Throw error if any arguments are provided
+    if (conf.positionals.length > 0) {
+        throw error('Arguments are not yet supported for vlt update', {
+            code: 'EUSAGE',
+        });
+    }
+    const { graph } = await update(conf.options);
+    return graph;
+};
+//# sourceMappingURL=update.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,22 @@
+import type { CommandFn, CommandUsage } from '../index.ts';
+export type VersionOptions = {
+    prereleaseId?: string;
+    commit?: boolean;
+    tag?: boolean;
+    message?: string;
+    tagMessage?: string;
+};
+export type VersionResult = {
+    oldVersion: string;
+    newVersion: string;
+    dir: string;
+    committed?: string[];
+    tag?: string;
+};
+export declare const usage: CommandUsage;
+export declare const views: {
+    readonly json: (result: VersionResult) => VersionResult;
+    readonly human: (result: VersionResult) => string;
+};
+export declare const command: CommandFn<VersionResult>;
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/commands/version.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM1D,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAoKD,eAAO,MAAM,KAAK,EAAE,YAanB,CAAA;AAED,eAAO,MAAM,KAAK;;;CAYuB,CAAA;AAEzC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,aAAa,CAG5C,CAAA"}