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

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

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAInC,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,0DAA0D;CACxE,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,KAAK,GAEd;IACF,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QACpC,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,kDAAkD;QAClD,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,IAAI;;EAExC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;CAC9B,CAAC,CAAA;QACE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;;2CAE2B,CAAC,CAAA;QACxC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;CACF,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAA+B,KAAK,IAAI,EAAE,CAC5D,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA","sourcesContent":["import { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { init } from '@vltpkg/init'\nimport type { InitFileResults } from '@vltpkg/init'\nimport type { ViewFn, Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'init',\n    usage: '',\n    description: `Create a new package.json file in the current directory.`,\n  })\n\nexport const views: Views<InitFileResults> & {\n  human: ViewFn<InitFileResults>\n} = {\n  human: (results, _options, _config) => {\n    const output: string[] = []\n    // TODO: colorize the JSON if config.options.color\n    for (const [type, { path, data }] of Object.entries(results)) {\n      output.push(`Wrote ${type} to ${path}:\n\n${JSON.stringify(data, null, 2)}\n`)\n    }\n    output.push(`Modify/add properties using \\`vlt pkg\\`. For example:\n\n  vlt pkg set \"description=My new project\"`)\n    return output.join('\\n')\n  },\n}\n\nexport const command: CommandFn<InitFileResults> = async () =>\n  await init({ cwd: process.cwd() })\n"]}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdirSync } from 'node:fs'\nimport { relative, resolve } from 'node:path'\nimport { minimatch } from 'minimatch'\nimport { init } from '@vltpkg/init'\nimport { load, save } from '@vltpkg/vlt-json'\nimport { assertWSConfig, asWSConfig } from '@vltpkg/workspaces'\nimport { commandUsage } from '../config/usage.ts'\nimport type { InitFileResults } from '@vltpkg/init'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'init',\n    usage: '',\n    description: `Create a new package.json file in the current directory.`,\n  })\n\n// TODO: colorize the JSON if config.options.color\nexport const views = {\n  human: (results: InitFileResults | InitFileResults[]) => {\n    const output: string[] = []\n    // if results is an array, it means multiple workspaces were initialized\n    if (Array.isArray(results)) {\n      for (const result of results) {\n        for (const [type, { path }] of Object.entries(result)) {\n          output.push(`Wrote ${type} to ${path}:`)\n        }\n      }\n    } else {\n      // otherwise, it's a single result\n      for (const [type, { path, data }] of Object.entries(results)) {\n        output.push(`Wrote ${type} to ${path}:\n\n${JSON.stringify(data, null, 2)}`)\n      }\n    }\n    output.push(`\\nModify/add properties using \\`vlt pkg\\`. For example:\n\n  vlt pkg set \"description=My new project\"`)\n    return output.join('\\n')\n  },\n} as const satisfies Views<InitFileResults>\n\nexport const command: CommandFn<\n  InitFileResults | InitFileResults[]\n> = async conf => {\n  if (conf.values.workspace?.length) {\n    const workspacesConfig = load('workspaces', assertWSConfig)\n    const parsedWSConfig = asWSConfig(workspacesConfig ?? {})\n    const results: InitFileResults[] = []\n    const addToConfig: string[] = []\n\n    // create a new package.json file for every workspace\n    // defined as cli --workspace options\n    for (const workspace of conf.values.workspace) {\n      // cwd is the resolved location of the workspace\n      const cwd = resolve(conf.options.projectRoot, workspace)\n\n      // create the folder in case it's missing\n      mkdirSync(cwd, { recursive: true })\n\n      // run the initialization script and collect results\n      results.push(await init({ cwd }))\n\n      // Check if this workspace path is covered by existing workspace patterns\n      const isMatched = Object.values(parsedWSConfig).some(\n        (patterns: string[]) => {\n          return patterns.some(pattern =>\n            minimatch(workspace, pattern),\n          )\n        },\n      )\n\n      // When a workspace is not matched we track it for insertion later\n      if (!isMatched) {\n        addToConfig.push(\n          relative(conf.options.projectRoot, cwd).replace(/\\\\/g, '/'),\n        )\n      }\n    }\n\n    // if there are workspaces that were not matched by existing\n    // patterns, we add them to the workspaces config\n    if (addToConfig.length > 0) {\n      let workspaces = workspacesConfig\n      // if the original workspaces config is a string, we'll need\n      // to convert it to an array in order to append the recently\n      // added workspaces\n      if (typeof workspacesConfig === 'string') {\n        workspaces = [workspacesConfig, ...addToConfig]\n      } else if (Array.isArray(workspacesConfig)) {\n        // if the original workspaces config is an array, we simply\n        // append the missing items to it\n        workspaces = [...workspacesConfig, ...addToConfig]\n      } else {\n        // otherwise we assume it's an Record<string, string[]> object\n        // and we'll add the new workspaces to the `packages` keys\n        workspaces = (workspacesConfig ?? {}) as Record<\n          string,\n          string[]\n        >\n        // if the `packages` key is not being used\n        if (!workspaces.packages) {\n          workspaces.packages = addToConfig\n        } else {\n          // if the `packages` key is defined as a string, we\n          // convert it to an array to append the new items\n          if (typeof workspaces.packages === 'string') {\n            workspaces.packages = [\n              workspaces.packages,\n              ...addToConfig,\n            ]\n          } else {\n            // if it is, we simply append the new workspaces\n            workspaces.packages = [\n              ...workspaces.packages,\n              ...addToConfig,\n            ]\n          }\n        }\n      }\n      // finally, we add the new workspaces to the config file\n      save('workspaces', workspaces)\n    }\n    return results\n  }\n\n  return init({ cwd: process.cwd() })\n}\n"]}

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

@@ -1,10 +1,11 @@
 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;
-    }): undefined;
+    }): Promise<undefined>;
     error(err: unknown): void;
 }
 //# sourceMappingURL=reporter.d.ts.map

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":"AAYA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAgFzC,qBAAa,eAAgB,SAAQ,SAAS;;IAG5C,KAAK;IAIL,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAMjD,KAAK,CAAC,GAAG,EAAE,OAAO;CAGnB"}
+{"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

@@ -1,20 +1,26 @@
 import { emitter } from '@vltpkg/output';
 import { Box, render, Text } from 'ink';
 import Spinner from 'ink-spinner';
-import { createElement as $, Fragment, useLayoutEffect, useState, } from 'react';
-import { stdout } from "../../output.js";
+import { 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);
     }
     if (step.state === 'in_progress') {
-        return $(Text, { color: 'yellow' }, text, $(Spinner, { type: 'dots' }));
+        return $(Text, { color: 'yellow' }, text + ' ', $(Spinner, { type: 'dots' }));
     }
     return $(Text, { color: 'green' }, text, ' ✓');
 };
-const App = () => {
+const App = ({ trailer }) => {
     const [requests, setRequests] = useState(0);
+    const [cacheHit, setCacheHit] = useState(0);
     const [steps, setSteps] = useState({
         build: {
             state: 'waiting',
@@ -26,12 +32,19 @@ const App = () => {
             state: 'waiting',
         },
     });
-    useLayoutEffect(() => {
-        const update = () => setRequests(p => p + 1);
-        emitter.on('request', update);
-        return () => emitter.off('request', update);
+    useEffect(() => {
+        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);
     }, []);
-    useLayoutEffect(() => {
+    useEffect(() => {
         const update = ({ step, state }) => {
             setSteps(p => ({
                 ...p,
@@ -46,21 +59,36 @@ const App = () => {
     }, []);
     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);
+        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;
     start() {
         this.#instance = render($(App));
     }
-    done(_result, { time }) {
-        this.#instance?.unmount();
-        stdout(`Done in ${time}ms`);
+    async done(_result, { time }) {
+        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) {
-        this.#instance?.unmount(err);
+        this.#instance?.unmount(asError(err));
     }
 }
 //# sourceMappingURL=reporter.js.map

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  useLayoutEffect,\n  useState,\n} from 'react'\nimport { stdout } from '../../output.ts'\nimport { ViewClass } from '../../view.ts'\n\ntype Step = {\n  state: 'waiting' | 'in_progress' | 'completed'\n}\n\nconst GraphStep = ({ text, step }: { text: string; step: Step }) => {\n  if (step.state === 'waiting') {\n    return $(Text, { color: 'gray' }, text)\n  }\n  if (step.state === 'in_progress') {\n    return $(\n      Text,\n      { color: 'yellow' },\n      text,\n      $(Spinner, { type: 'dots' }),\n    )\n  }\n  return $(Text, { color: 'green' }, text, ' ✓')\n}\n\nconst App = () => {\n  const [requests, setRequests] = useState(0)\n\n  const [steps, setSteps] = useState<\n    Record<Events['graphStep']['step'], Step>\n  >({\n    build: {\n      state: 'waiting',\n    },\n    actual: {\n      state: 'waiting',\n    },\n    reify: {\n      state: 'waiting',\n    },\n  })\n\n  useLayoutEffect(() => {\n    const update = () => setRequests(p => p + 1)\n    emitter.on('request', update)\n    return () => emitter.off('request', update)\n  }, [])\n\n  useLayoutEffect(() => {\n    const update = ({ step, state }: Events['graphStep']) => {\n      setSteps(p => ({\n        ...p,\n        [step]: {\n          ...p[step],\n          state: state === 'start' ? 'in_progress' : 'completed',\n        },\n      }))\n    }\n    emitter.on('graphStep', update)\n    return () => emitter.off('graphStep', update)\n  }, [])\n\n  return $(\n    Fragment,\n    null,\n    $(\n      Box,\n      null,\n      ...(['build', 'actual', 'reify'] as const).map(\n        (step, idx, list) => {\n          const separator = idx === list.length - 1 ? '' : ' > '\n          return $(\n            Text,\n            { key: step },\n            $(GraphStep, { text: step, step: steps[step] }),\n            $(Text, { color: 'gray' }, separator),\n          )\n        },\n      ),\n    ),\n    requests > 0 ? $(Text, null, `${requests} requests`) : null,\n  )\n}\n\nexport class InstallReporter extends ViewClass {\n  #instance: Instance | null = null\n\n  start() {\n    this.#instance = render($(App))\n  }\n\n  done(_result: unknown, { time }: { time: number }) {\n    this.#instance?.unmount()\n    stdout(`Done in ${time}ms`)\n    return undefined\n  }\n\n  error(err: unknown) {\n    this.#instance?.unmount(err as Error)\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,7 +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 type { Views } from '../view.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: Views<Graph>;
-export declare const command: CommandFn<Graph>;
+export declare const views: {
+    readonly json: (i: InstallResult) => {
+        graph: import("@vltpkg/graph").LockfileData;
+        buildQueue?: DepID[] | undefined;
+        message?: string | undefined;
+    };
+    readonly human: typeof InstallReporter;
+};
+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;AAG1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAGvC,eAAO,MAAM,KAAK,EAAE,YAMhB,CAAA;AAEJ,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAG9B,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,KAAK,CAKpC,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,13 +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 { graph } = await install(conf.options, add);
-    return graph;
+    const frozenLockfile = conf.options['frozen-lockfile'];
+    const expectLockfile = conf.options['expect-lockfile'];
+    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 { 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,GAAiB;IACjC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,eAAe;CACvB,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAqB,KAAK,EAAC,IAAI,EAAC,EAAE;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IACtC,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC5C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAClD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import type { Graph } from '@vltpkg/graph'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { install } from '@vltpkg/graph'\nimport { parseAddArgs } from '../parse-add-remove-args.ts'\nimport type { Views } from '../view.ts'\nimport { InstallReporter } from './install/reporter.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'install',\n    usage: '[packages ...]',\n    description: `Install the specified packages, updating package.json and\n                  vlt-lock.json appropriately.`,\n  })\n\nexport const views: Views<Graph> = {\n  json: g => g.toJSON(),\n  human: InstallReporter,\n}\n\nexport const command: CommandFn<Graph> = async conf => {\n  const monorepo = conf.options.monorepo\n  const { add } = parseAddArgs(conf, monorepo)\n  const { graph } = await install(conf.options, add)\n  return graph\n}\n"]}
+{"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/list.d.ts

@@ -9,7 +9,7 @@ export declare const views: {
     readonly json: typeof jsonOutput;
     readonly mermaid: typeof mermaidOutput;
     readonly human: typeof humanReadableOutput;
-    readonly gui: ({ queryString }: ListResult, _: import("../view.ts").ViewOptions, conf: import("../config/index.ts").LoadedConfig) => Promise<void>;
+    readonly gui: ({ queryString }: ListResult, _: import("../view.ts").ViewOptions, conf: import("../config/index.ts").ParsedConfig) => Promise<void>;
 };
 export declare const command: CommandFn<ListResult>;
 //# sourceMappingURL=list.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,EACnB,UAAU,EACV,aAAa,EACd,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAEnB,MAAM,eAAe,CAAA;AAGtB,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,eAAO,MAAM,KAAK,EAAE,YAkChB,CAAA;AAEJ,MAAM,MAAM,UAAU,GAAG,eAAe,GACtC,kBAAkB,GAClB,wBAAwB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD,eAAO,MAAM,KAAK;;;;;CAWoB,CAAA;AAEtC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CAwDzC,CAAA"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,mBAAmB,EACnB,UAAU,EACV,aAAa,EAEd,MAAM,eAAe,CAAA;AAQtB,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAGnB,MAAM,eAAe,CAAA;AAGtB,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1D,eAAO,MAAM,KAAK,EAAE,YAyDhB,CAAA;AAEJ,MAAM,MAAM,UAAU,GAAG,eAAe,GACtC,kBAAkB,GAClB,wBAAwB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD,eAAO,MAAM,KAAK;;;;;CAUoB,CAAA;AAEtC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,UAAU,CA+JzC,CAAA"}

package/dist/esm/commands/list.js

@@ -1,31 +1,57 @@
-import { actual, humanReadableOutput, jsonOutput, mermaidOutput, } from '@vltpkg/graph';
+import { actual, asNode, humanReadableOutput, jsonOutput, mermaidOutput, GraphModifier, } from '@vltpkg/graph';
+import LZString from 'lz-string';
 import { Query } from '@vltpkg/query';
+import { SecurityArchive } from '@vltpkg/security-archive';
+import { error } from '@vltpkg/error-cause';
 import { commandUsage } from "../config/usage.js";
 import { startGUI } from "../start-gui.js";
+import { createHostContextsMap } from "../query-host-contexts.js";
 export const usage = () => commandUsage({
     command: 'ls',
-    usage: ['', '<query> --view=[human | json | mermaid | gui]'],
-    description: `List installed dependencies matching the provided query.
-                  Defaults to listing direct dependencies of a project and
-                  any configured workspace.`,
+    usage: [
+        '',
+        '[package-names...] [--view=human | json | mermaid | gui]',
+        '[--scope=<query>] [--target=<query>] [--view=human | json | mermaid | gui]',
+    ],
+    description: `List installed dependencies matching given package names or query selectors.
+
+      Package names provided as positional arguments will be used to filter
+      the results to show only dependencies with those names.
+
+      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 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 direct dependencies of a project and any configured
+      workspace.`,
     examples: {
         '': {
             description: 'List direct dependencies of the current project / workspace',
         },
-        '*': {
-            description: 'List all dependencies for the current project / workspace',
-        },
         'foo bar baz': {
             description: `List all dependencies named 'foo', 'bar', or 'baz'`,
         },
-        [`'[name="@scoped/package"] > *'`]: {
-            description: 'Lists direct dependencies of a specific package',
+        '--scope=":root > #dependency-name"': {
+            description: 'Defines a direct dependency as the output top-level scope',
+        },
+        '--target="*"': {
+            description: 'List all dependencies using a query selector',
         },
-        [`'*.workspace > *.peer'`]: {
+        '--target=":workspace > *:peer"': {
             description: 'List all peer dependencies of all workspaces',
         },
     },
     options: {
+        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 the DSS query language syntax.',
+        },
         view: {
             value: '[human | json | mermaid | gui]',
             description: 'Output format. Defaults to human-readable or json if no tty.',
@@ -37,55 +63,137 @@ export const views = {
     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,
-        monorepo,
-        loadManifests: true,
-    });
-    const queryString = conf.positionals
-        .map(k => (/^[@\w-]/.test(k) ? `#${k.replace(/\//, '\\/')}` : k))
+    const mainManifest = conf.options.packageJson.maybeRead(conf.options.projectRoot);
+    let graph;
+    let securityArchive;
+    // optionally load the cwd graph if we found a package.json file
+    if (mainManifest) {
+        graph = actual.load({
+            ...conf.options,
+            mainManifest,
+            modifiers,
+            monorepo,
+            loadManifests: true,
+        });
+        securityArchive = await SecurityArchive.start({
+            nodes: [...graph.nodes.values()],
+        });
+    }
+    // Validate positional arguments - only allow package names, not direct queries
+    for (const arg of conf.positionals) {
+        if (!/^[@\w-]/.test(arg)) {
+            throw error(`Direct queries are not supported as positional arguments. Use package names only.`, {
+                code: 'EUSAGE',
+                cause: `Argument '${arg}' appears to be a query syntax. Only package names are allowed as positional arguments.`,
+            });
+        }
+    }
+    // retrieve default values and set up host contexts
+    const positionalQueryString = conf.positionals
+        .map(k => `#${k.replace(/\//, '\\/')}`)
         .join(', ');
-    const query = new Query({ graph, specOptions: conf.options });
-    const projectQueryString = ':project, :project > *';
+    const targetQueryString = conf.get('target');
+    const scopeQueryString = conf.get('scope');
+    const queryString = targetQueryString || positionalQueryString;
+    const projectQueryString = ':workspace, :project > *';
     const selectImporters = [];
+    const hostContexts = await createHostContextsMap(conf);
     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);
-                selectImporters.push(`[name="${w.name}"]`);
-                selectImporters.push(`[name="${w.name}"] > *`);
-            }
+    const scopeIDs = [];
+    // handle --scope option to add scope nodes as importers
+    let scopeNodes;
+    if (scopeQueryString) {
+        // run scope query to get all matching nodes
+        /* c8 ignore start */
+        const edges = graph?.edges ?? new Set();
+        const nodes = graph?.nodes ?
+            new Set(graph.nodes.values())
+            : new Set();
+        const importers = graph?.importers ?? new Set();
+        /* c8 ignore stop */
+        const scopeQuery = new Query({
+            nodes,
+            edges,
+            importers,
+            securityArchive,
+            hostContexts,
+        });
+        const { nodes: resultNodes } = await scopeQuery.search(scopeQueryString, {
+            signal: new AbortController().signal,
+        });
+        scopeNodes = resultNodes;
+    }
+    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 ('workspace' in conf.values) {
+        // if in a workspace environment, select only the specified
+        // workspaces as top-level items
+        if (monorepo && graph) {
+            for (const workspace of monorepo.filter(conf.values)) {
+                const w = graph.nodes.get(workspace.id);
+                if (w) {
+                    importers.add(w);
+                    selectImporters.push(`[name="${w.name}"]`);
+                    selectImporters.push(`[name="${w.name}"] > *`);
+                    scopeIDs.push(workspace.id);
+                }
+            }
         }
     }
+    // build a default query string to use in the target search
     const selectImportersQueryString = selectImporters.join(', ');
-    const defaultQueryString = (selectImporters.length &&
+    const defaultProjectQueryString = (graph &&
+        selectImporters.length &&
         selectImporters.length < graph.importers.size) ?
         selectImportersQueryString
         : projectQueryString;
-    const { edges, nodes } = await query.search(queryString || defaultQueryString);
+    const defaultLocalScopeQueryString = ':host(local) :root > *';
+    // retrieve the selected nodes and edges
+    /* c8 ignore start */
+    const edges_ = graph?.edges ?? new Set();
+    const nodes_ = graph?.nodes ?
+        new Set(graph.nodes.values())
+        : new Set();
+    const importers_ = importers.size === 0 && graph ?
+        new Set([graph.mainImporter])
+        : importers;
+    /* c8 ignore stop */
+    const q = new Query({
+        nodes: nodes_,
+        edges: edges_,
+        importers: importers_,
+        securityArchive,
+        hostContexts,
+    });
+    const query = queryString ||
+        /* c8 ignore next */
+        (graph ? defaultProjectQueryString : defaultLocalScopeQueryString);
+    const { edges, nodes, importers: queryResultImporters, } = await q.search(query, {
+        signal: new AbortController().signal,
+        scopeIDs: scopeIDs.length > 0 ? scopeIDs : undefined,
+    });
     return {
-        importers,
+        importers: importers.size === 0 ?
+            new Set(queryResultImporters)
+            : importers,
         edges,
         nodes,
-        queryString: queryString || defaultQueryString,
-        highlightSelection: !!queryString,
+        highlightSelection: !!(targetQueryString || positionalQueryString),
+        queryString: queryString ||
+            (graph ?
+                /* c8 ignore next 2 */
+                defaultProjectQueryString
+                : defaultLocalScopeQueryString),
     };
 };
 //# sourceMappingURL=list.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,UAAU,EACV,aAAa,GACd,MAAM,eAAe,CAAA;AAOtB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAG1C,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE,CACtC,YAAY,CAAC;IACX,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,CAAC,EAAE,EAAE,+CAA+C,CAAC;IAC5D,WAAW,EAAE;;4CAE2B;IACxC,QAAQ,EAAE;QACR,EAAE,EAAE;YACF,WAAW,EACT,6DAA6D;SAChE;QACD,GAAG,EAAE;YACH,WAAW,EACT,2DAA2D;SAC9D;QACD,aAAa,EAAE;YACb,WAAW,EAAE,oDAAoD;SAClE;QACD,CAAC,gCAAgC,CAAC,EAAE;YAClC,WAAW,EACT,iDAAiD;SACpD;QACD,CAAC,wBAAwB,CAAC,EAAE;YAC1B,WAAW,EAAE,8CAA8C;SAC5D;KACF;IACD,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,KAAK,EAAE,gCAAgC;YACvC,WAAW,EACT,8DAA8D;SACjE;KACF;CACF,CAAC,CAAA;AAMJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,aAAa;IACtB,KAAK,EAAE,mBAAmB;IAC1B,GAAG,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QACtC,MAAM,QAAQ,CAAC;YACb,IAAI;YACJ,aAAa,EACX,iBAAiB,GAAG,kBAAkB,CAAC,WAAW,CAAC;SACtD,CAAC,CAAA;IACJ,CAAC;CACmC,CAAA;AAEtC,MAAM,CAAC,MAAM,OAAO,GAA0B,KAAK,EAAC,IAAI,EAAC,EAAE;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IACtC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAChD,IAAI,CAAC,OAAO,CAAC,WAAW,CACzB,CAAA;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,GAAG,IAAI,CAAC,OAAO;QACf,YAAY;QACZ,QAAQ;QACR,aAAa,EAAE,IAAI;KACpB,CAAC,CAAA;IAEF,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW;SACjC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAChE,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IAC7D,MAAM,kBAAkB,GAAG,wBAAwB,CAAA;IACnD,MAAM,eAAe,GAAa,EAAE,CAAA;IAEpC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAQ,CAAA;IACjC,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACrD,MAAM,CAAC,GAAqB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;YACzD,IAAI,CAAC,EAAE,CAAC;gBACN,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBAChB,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,IAAI,CAAC,CAAA;gBAC1C,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAA;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACvC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAED,MAAM,0BAA0B,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7D,MAAM,kBAAkB,GACtB,CACE,eAAe,CAAC,MAAM;QACtB,eAAe,CAAC,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAC9C,CAAC,CAAC;QACD,0BAA0B;QAC5B,CAAC,CAAC,kBAAkB,CAAA;IAEtB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,KAAK,CAAC,MAAM,CACzC,WAAW,IAAI,kBAAkB,CAClC,CAAA;IAED,OAAO;QACL,SAAS;QACT,KAAK;QACL,KAAK;QACL,WAAW,EAAE,WAAW,IAAI,kBAAkB;QAC9C,kBAAkB,EAAE,CAAC,CAAC,WAAW;KAClC,CAAA;AACH,CAAC,CAAA","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: 'ls',\n    usage: ['', '<query> --view=[human | json | mermaid | gui]'],\n    description: `List installed dependencies matching the provided query.\n                  Defaults to listing direct dependencies of a project and\n                  any configured workspace.`,\n    examples: {\n      '': {\n        description:\n          'List direct dependencies of the current project / workspace',\n      },\n      '*': {\n        description:\n          'List all dependencies for the current project / workspace',\n      },\n      'foo bar baz': {\n        description: `List all dependencies named 'foo', 'bar', or 'baz'`,\n      },\n      [`'[name=\"@scoped/package\"] > *'`]: {\n        description:\n          'Lists direct dependencies of a specific package',\n      },\n      [`'*.workspace > *.peer'`]: {\n        description: 'List all peer dependencies of all workspaces',\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\nexport type ListResult = 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<ListResult>\n\nexport const command: CommandFn<ListResult> = 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 queryString = conf.positionals\n    .map(k => (/^[@\\w-]/.test(k) ? `#${k.replace(/\\//, '\\\\/')}` : k))\n    .join(', ')\n  const query = new Query({ graph, specOptions: conf.options })\n  const projectQueryString = ':project, :project > *'\n  const selectImporters: string[] = []\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) {\n        importers.add(w)\n        selectImporters.push(`[name=\"${w.name}\"]`)\n        selectImporters.push(`[name=\"${w.name}\"] > *`)\n      }\n    }\n  }\n  if (importers.size === 0) {\n    for (const importer of graph.importers) {\n      importers.add(importer)\n    }\n  }\n\n  const selectImportersQueryString = selectImporters.join(', ')\n  const defaultQueryString =\n    (\n      selectImporters.length &&\n      selectImporters.length < graph.importers.size\n    ) ?\n      selectImportersQueryString\n    : projectQueryString\n\n  const { edges, nodes } = await query.search(\n    queryString || defaultQueryString,\n  )\n\n  return {\n    importers,\n    edges,\n    nodes,\n    queryString: queryString || defaultQueryString,\n    highlightSelection: !!queryString,\n  }\n}\n"]}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/list.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  actual,\n  asNode,\n  humanReadableOutput,\n  jsonOutput,\n  mermaidOutput,\n  GraphModifier,\n} from '@vltpkg/graph'\nimport LZString from 'lz-string'\nimport { Query } from '@vltpkg/query'\nimport { SecurityArchive } from '@vltpkg/security-archive'\nimport { error } from '@vltpkg/error-cause'\nimport { commandUsage } from '../config/usage.ts'\nimport { startGUI } from '../start-gui.ts'\nimport { createHostContextsMap } from '../query-host-contexts.ts'\nimport type {\n  HumanReadableOutputGraph,\n  JSONOutputGraph,\n  MermaidOutputGraph,\n  Node,\n  Graph,\n} from '@vltpkg/graph'\nimport type { DepID } from '@vltpkg/dep-id'\nimport type { NodeLike } from '@vltpkg/types'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { Views } from '../view.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'ls',\n    usage: [\n      '',\n      '[package-names...] [--view=human | json | mermaid | gui]',\n      '[--scope=<query>] [--target=<query>] [--view=human | json | mermaid | gui]',\n    ],\n    description: `List installed dependencies matching given package names or query selectors.\n\n      Package names provided as positional arguments will be used to filter\n      the results to show only dependencies with those names.\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 allows you to\n      filter what dependencies to include in the output. Using both options\n      allows you to render subgraphs of the dependency graph.\n\n      Defaults to listing direct dependencies of a project and any configured\n      workspace.`,\n    examples: {\n      '': {\n        description:\n          'List direct dependencies of the current project / workspace',\n      },\n      'foo bar baz': {\n        description: `List all dependencies named 'foo', 'bar', or 'baz'`,\n      },\n      '--scope=\":root > #dependency-name\"': {\n        description:\n          'Defines a direct dependency as the output top-level scope',\n      },\n      '--target=\"*\"': {\n        description: 'List all dependencies using a query selector',\n      },\n      '--target=\":workspace > *:peer\"': {\n        description: 'List all peer dependencies of all workspaces',\n      },\n    },\n    options: {\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 the DSS query language 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\nexport type ListResult = 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      `/explore/${LZString.compressToEncodedURIComponent(queryString)}/overview`,\n    )\n  },\n} as const satisfies Views<ListResult>\n\nexport const command: CommandFn<ListResult> = async conf => {\n  const modifiers = GraphModifier.maybeLoad(conf.options)\n  const monorepo = conf.options.monorepo\n  const mainManifest = conf.options.packageJson.maybeRead(\n    conf.options.projectRoot,\n  )\n  let graph: Graph | undefined\n  let securityArchive: SecurityArchive | undefined\n\n  // optionally load the cwd graph if we found a package.json file\n  if (mainManifest) {\n    graph = actual.load({\n      ...conf.options,\n      mainManifest,\n      modifiers,\n      monorepo,\n      loadManifests: true,\n    })\n    securityArchive = await SecurityArchive.start({\n      nodes: [...graph.nodes.values()],\n    })\n  }\n\n  // Validate positional arguments - only allow package names, not direct queries\n  for (const arg of conf.positionals) {\n    if (!/^[@\\w-]/.test(arg)) {\n      throw error(\n        `Direct queries are not supported as positional arguments. Use package names only.`,\n        {\n          code: 'EUSAGE',\n          cause: `Argument '${arg}' appears to be a query syntax. Only package names are allowed as positional arguments.`,\n        },\n      )\n    }\n  }\n\n  // retrieve default values and set up host contexts\n  const positionalQueryString = conf.positionals\n    .map(k => `#${k.replace(/\\//, '\\\\/')}`)\n    .join(', ')\n  const targetQueryString = conf.get('target')\n  const scopeQueryString = conf.get('scope')\n  const queryString = targetQueryString || positionalQueryString\n  const projectQueryString = ':workspace, :project > *'\n  const selectImporters: string[] = []\n  const hostContexts = await createHostContextsMap(conf)\n  const importers = new Set<Node>()\n  const scopeIDs: DepID[] = []\n\n  // handle --scope option to add scope nodes as importers\n  let scopeNodes\n  if (scopeQueryString) {\n    // run scope query to get all matching nodes\n    /* c8 ignore start */\n    const edges = graph?.edges ?? new Set()\n    const nodes =\n      graph?.nodes ?\n        new Set<NodeLike>(graph.nodes.values())\n      : new Set<NodeLike>()\n    const importers = graph?.importers ?? new Set()\n    /* c8 ignore stop */\n    const scopeQuery = new Query({\n      nodes,\n      edges,\n      importers,\n      securityArchive,\n      hostContexts,\n    })\n    const { nodes: resultNodes } = await scopeQuery.search(\n      scopeQueryString,\n      {\n        signal: new AbortController().signal,\n      },\n    )\n    scopeNodes = resultNodes\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 if ('workspace' in conf.values) {\n    // if in a workspace environment, select only the specified\n    // workspaces as top-level items\n    if (monorepo && graph) {\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          selectImporters.push(`[name=\"${w.name}\"]`)\n          selectImporters.push(`[name=\"${w.name}\"] > *`)\n          scopeIDs.push(workspace.id)\n        }\n      }\n    }\n  }\n\n  // build a default query string to use in the target search\n  const selectImportersQueryString = selectImporters.join(', ')\n  const defaultProjectQueryString =\n    (\n      graph &&\n      selectImporters.length &&\n      selectImporters.length < graph.importers.size\n    ) ?\n      selectImportersQueryString\n    : projectQueryString\n  const defaultLocalScopeQueryString = ':host(local) :root > *'\n\n  // retrieve the selected nodes and edges\n  /* c8 ignore start */\n  const edges_ = graph?.edges ?? new Set()\n  const nodes_ =\n    graph?.nodes ?\n      new Set<NodeLike>(graph.nodes.values())\n    : new Set<NodeLike>()\n  const importers_ =\n    importers.size === 0 && graph ?\n      new Set([graph.mainImporter])\n    : importers\n  /* c8 ignore stop */\n  const q = new Query({\n    nodes: nodes_,\n    edges: edges_,\n    importers: importers_,\n    securityArchive,\n    hostContexts,\n  })\n  const query =\n    queryString ||\n    /* c8 ignore next */\n    (graph ? defaultProjectQueryString : defaultLocalScopeQueryString)\n  const {\n    edges,\n    nodes,\n    importers: queryResultImporters,\n  } = await q.search(query, {\n    signal: new AbortController().signal,\n    scopeIDs: scopeIDs.length > 0 ? scopeIDs : undefined,\n  })\n\n  return {\n    importers:\n      importers.size === 0 ?\n        new Set(queryResultImporters)\n      : importers,\n    edges,\n    nodes,\n    highlightSelection: !!(\n      targetQueryString || positionalQueryString\n    ),\n    queryString:\n      queryString ||\n      (graph ?\n        /* c8 ignore next 2 */\n        defaultProjectQueryString\n      : defaultLocalScopeQueryString),\n  }\n}\n"]}

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

@@ -0,0 +1,32 @@
+import type { CommandFn, CommandUsage } from '../index.ts';
+import type { LoadedConfig } from '../config/index.ts';
+export declare const usage: CommandUsage;
+export type CommandResultSingle = {
+    id: string;
+    name: string;
+    version: string;
+    filename: string;
+    files: string[];
+    size: number;
+    unpackedSize: number;
+    shasum?: string;
+    integrity?: string;
+};
+export type CommandResult = CommandResultSingle | CommandResultSingle[];
+export declare const views: {
+    readonly human: (results: CommandResult) => string;
+    readonly json: (r: CommandResult) => CommandResult;
+};
+export declare const command: CommandFn<CommandResult>;
+export declare const commandSingle: (location: string, conf: LoadedConfig) => Promise<{
+    id: string;
+    name: string;
+    version: string;
+    filename: string;
+    files: string[];
+    size: number;
+    unpackedSize: number;
+    shasum: string | undefined;
+    integrity: string | undefined;
+}>;
+//# sourceMappingURL=pack.d.ts.map