@vltpkg/cli-sdk 0.0.0-15 → 0.0.0-17

package/dist/esm/commands/list.js

@@ -1,21 +1,27 @@
-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";
 export const usage = () => commandUsage({
     command: 'ls',
     usage: [
         '',
-        '[query | specs] [--view=human | json | mermaid | gui]',
+        '[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 resulting
-      packages from matching a given Dependency Selector Syntax query if one
-      is provided.
+    description: `List installed dependencies matching given package names or query selectors.
 
-      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.
+      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.`,
@@ -23,20 +29,28 @@ export const usage = () => commandUsage({
         '': {
             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.',
@@ -48,27 +62,38 @@ export const views = {
     mermaid: mermaidOutput,
     human: humanReadableOutput,
     gui: async ({ queryString }, _, conf) => {
-        await startGUI(conf, '/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 queryString = conf.positionals
-        .map(k => (/^[@\w-]/.test(k) ? `#${k.replace(/\//, '\\/')}` : k))
+    // 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.`,
+            });
+        }
+    }
+    const positionalQueryString = conf.positionals
+        .map(k => `#${k.replace(/\//, '\\/')}`)
         .join(', ');
-    const securityArchive = Query.hasSecuritySelectors(queryString) ?
-        await SecurityArchive.start({
-            graph,
-            specOptions: conf.options,
-        })
-        : undefined;
+    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,
@@ -78,27 +103,56 @@ export const command = async (conf) => {
     const selectImporters = [];
     const importers = new Set();
     const scopeIDs = [];
-    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}"] > *`);
-                scopeIDs.push(workspace.id);
-            }
+    // 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);
+                    selectImporters.push(`[name="${w.name}"]`);
+                    selectImporters.push(`[name="${w.name}"] > *`);
+                    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);
+            }
         }
     }
+    // build a default query string to use in the target search
     const selectImportersQueryString = selectImporters.join(', ');
     const defaultQueryString = (selectImporters.length &&
         selectImporters.length < graph.importers.size) ?
         selectImportersQueryString
         : projectQueryString;
+    // retrieve the selected nodes and edges
     const { edges, nodes } = await query.search(queryString || defaultQueryString, {
         signal: new AbortController().signal,
         scopeIDs: scopeIDs.length > 0 ? scopeIDs : undefined,
@@ -108,7 +162,7 @@ export const command = async (conf) => {
         edges,
         nodes,
         queryString: queryString || defaultQueryString,
-        highlightSelection: !!queryString,
+        highlightSelection: !!(targetQueryString || positionalQueryString),
     };
 };
 //# 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":"AAMA,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,UAAU,EACV,aAAa,GACd,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE1D,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;QACL,EAAE;QACF,uDAAuD;KACxD;IACD,WAAW,EAAE;;;;;;;;;iBASA;IACb,QAAQ,EAAE;QACR,EAAE,EAAE;YACF,WAAW,EACT,6DAA6D;SAChE;QACD,KAAK,EAAE;YACL,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,CACZ,IAAI,EACJ,iBAAiB,GAAG,kBAAkB,CAAC,WAAW,CAAC,CACpD,CAAA;IACH,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,eAAe,GACnB,KAAK,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC;QACvC,MAAM,eAAe,CAAC,KAAK,CAAC;YAC1B,KAAK;YACL,WAAW,EAAE,IAAI,CAAC,OAAO;SAC1B,CAAC;QACJ,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,KAAK;QACL,WAAW,EAAE,IAAI,CAAC,OAAO;QACzB,eAAe;KAChB,CAAC,CAAA;IACF,MAAM,kBAAkB,GAAG,wBAAwB,CAAA;IACnD,MAAM,eAAe,GAAa,EAAE,CAAA;IAEpC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAQ,CAAA;IACjC,MAAM,QAAQ,GAAY,EAAE,CAAA;IAE5B,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;gBAC9C,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;YAC7B,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,EACjC;QACE,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;QACpC,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KACrD,CACF,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 type {\n  HumanReadableOutputGraph,\n  JSONOutputGraph,\n  MermaidOutputGraph,\n  Node,\n} from '@vltpkg/graph'\nimport {\n  actual,\n  humanReadableOutput,\n  jsonOutput,\n  mermaidOutput,\n} from '@vltpkg/graph'\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'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'ls',\n    usage: [\n      '',\n      '[query | specs] [--view=human | json | mermaid | gui]',\n    ],\n    description: `List installed dependencies matching given package names or resulting\n      packages from matching a given Dependency Selector Syntax query if one\n      is provided.\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      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      '\"*\"': {\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      '/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 securityArchive =\n    Query.hasSecuritySelectors(queryString) ?\n      await SecurityArchive.start({\n        graph,\n        specOptions: conf.options,\n      })\n    : undefined\n  const query = new Query({\n    graph,\n    specOptions: conf.options,\n    securityArchive,\n  })\n  const projectQueryString = ':project, :project > *'\n  const selectImporters: string[] = []\n\n  const importers = new Set<Node>()\n  const scopeIDs: DepID[] = []\n\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        scopeIDs.push(workspace.id)\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      signal: new AbortController().signal,\n      scopeIDs: scopeIDs.length > 0 ? scopeIDs : undefined,\n    },\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 type {\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 LZString from 'lz-string'\nimport { Query } from '@vltpkg/query'\nimport { SecurityArchive } from '@vltpkg/security-archive'\nimport type { DepID } from '@vltpkg/dep-id'\nimport { error } from '@vltpkg/error-cause'\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: [\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.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  // 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  const positionalQueryString = conf.positionals\n    .map(k => `#${k.replace(/\\//, '\\\\/')}`)\n    .join(', ')\n  const targetQueryString = conf.get('target')\n  const queryString = targetQueryString || positionalQueryString\n\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  const projectQueryString = ':project, :project > *'\n  const selectImporters: string[] = []\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          selectImporters.push(`[name=\"${w.name}\"]`)\n          selectImporters.push(`[name=\"${w.name}\"] > *`)\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  // build a default query string to use in the target search\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  // 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  return {\n    importers,\n    edges,\n    nodes,\n    queryString: queryString || defaultQueryString,\n    highlightSelection: !!(\n      targetQueryString || positionalQueryString\n    ),\n  }\n}\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../../src/commands/pack.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1D,eAAO,MAAM,KAAK,EAAE,YAchB,CAAA;AAEJ,KAAK,aAAa,GAAG;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,KAAK;;;CAeuB,CAAA;AAEzC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,aAAa,CAyD5C,CAAA"}

package/dist/esm/commands/pack.js

@@ -0,0 +1,81 @@
+import { writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import assert from 'node:assert';
+import { run } from '@vltpkg/run';
+import { commandUsage } from "../config/usage.js";
+import { packTarball } from "../pack-tarball.js";
+import prettyBytes from 'pretty-bytes';
+export const usage = () => commandUsage({
+    command: 'pack',
+    usage: '',
+    description: `Create a tarball from a package in the current directory or specified folder.
+    
+    The tarball will be saved to the current directory with the name
+    <name>-<version>.tgz.`,
+    options: {
+        'dry-run': {
+            description: 'Show what would be packed without creating a tarball',
+        },
+    },
+});
+export const views = {
+    human: r => {
+        const lines = [
+            `📦 ${r.name}@${r.version}`,
+            `📄 ${r.filename}`,
+            `📁 ${r.files.length} files`,
+            ...r.files.map(f => `  - ${f}`),
+            `📊 package size: ${prettyBytes(r.size)}`,
+            `📂 unpacked size: ${prettyBytes(r.unpackedSize)}`,
+        ];
+        if (r.shasum)
+            lines.push(`🔒 shasum: ${r.shasum}`);
+        if (r.integrity)
+            lines.push(`🔐 integrity: ${r.integrity}`);
+        return lines.join('\n');
+    },
+    json: r => r,
+};
+export const command = async (conf) => {
+    const manifestPath = conf.options.packageJson.find();
+    assert(manifestPath, 'No package.json found');
+    const manifestDir = dirname(manifestPath);
+    const manifest = conf.options.packageJson.read(manifestDir);
+    const isDryRun = conf.options['dry-run'];
+    const runOptions = {
+        cwd: manifestDir,
+        projectRoot: conf.projectRoot,
+        packageJson: conf.options.packageJson,
+        manifest,
+        ignoreMissing: true,
+        ignorePrePost: true,
+    };
+    await run({
+        ...runOptions,
+        arg0: 'prepack',
+    });
+    await run({
+        ...runOptions,
+        arg0: 'prepare',
+    });
+    const { name, version, filename, tarballData, unpackedSize, files, integrity, shasum, } = await packTarball(manifest, manifestDir, conf);
+    if (!isDryRun) {
+        await writeFile(join(manifestDir, filename), tarballData);
+    }
+    await run({
+        ...runOptions,
+        arg0: 'postpack',
+    });
+    return {
+        id: `${name}@${version}`,
+        name,
+        version,
+        filename,
+        files,
+        size: tarballData.length,
+        unpackedSize,
+        shasum,
+        integrity,
+    };
+};
+//# sourceMappingURL=pack.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../../src/commands/pack.ts"],"names":[],"mappings":"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","sourcesContent":["import { writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport assert from 'node:assert'\nimport { run } from '@vltpkg/run'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { packTarball } from '../pack-tarball.ts'\nimport type { Views } from '../view.ts'\nimport prettyBytes from 'pretty-bytes'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'pack',\n    usage: '',\n    description: `Create a tarball from a package in the current directory or specified folder.\n    \n    The tarball will be saved to the current directory with the name\n    <name>-<version>.tgz.`,\n    options: {\n      'dry-run': {\n        description:\n          'Show what would be packed without creating a tarball',\n      },\n    },\n  })\n\ntype CommandResult = {\n  id: string\n  name: string\n  version: string\n  filename: string\n  files: string[]\n  size: number\n  unpackedSize: number\n  shasum?: string\n  integrity?: string\n}\n\nexport const views = {\n  human: r => {\n    const lines = [\n      `📦 ${r.name}@${r.version}`,\n      `📄 ${r.filename}`,\n      `📁 ${r.files.length} files`,\n      ...r.files.map(f => `  - ${f}`),\n      `📊 package size: ${prettyBytes(r.size)}`,\n      `📂 unpacked size: ${prettyBytes(r.unpackedSize)}`,\n    ]\n    if (r.shasum) lines.push(`🔒 shasum: ${r.shasum}`)\n    if (r.integrity) lines.push(`🔐 integrity: ${r.integrity}`)\n    return lines.join('\\n')\n  },\n  json: r => r,\n} as const satisfies Views<CommandResult>\n\nexport const command: CommandFn<CommandResult> = async conf => {\n  const manifestPath = conf.options.packageJson.find()\n  assert(manifestPath, 'No package.json found')\n  const manifestDir = dirname(manifestPath)\n  const manifest = conf.options.packageJson.read(manifestDir)\n\n  const isDryRun = conf.options['dry-run']\n  const runOptions = {\n    cwd: manifestDir,\n    projectRoot: conf.projectRoot,\n    packageJson: conf.options.packageJson,\n    manifest,\n    ignoreMissing: true,\n    ignorePrePost: true,\n  }\n\n  await run({\n    ...runOptions,\n    arg0: 'prepack',\n  })\n\n  await run({\n    ...runOptions,\n    arg0: 'prepare',\n  })\n\n  const {\n    name,\n    version,\n    filename,\n    tarballData,\n    unpackedSize,\n    files,\n    integrity,\n    shasum,\n  } = await packTarball(manifest, manifestDir, conf)\n\n  if (!isDryRun) {\n    await writeFile(join(manifestDir, filename), tarballData)\n  }\n\n  await run({\n    ...runOptions,\n    arg0: 'postpack',\n  })\n\n  return {\n    id: `${name}@${version}`,\n    name,\n    version,\n    filename,\n    files,\n    size: tarballData.length,\n    unpackedSize,\n    shasum,\n    integrity,\n  }\n}\n"]}

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

@@ -1,6 +1,6 @@
 import type { CommandFn, CommandUsage } from '../index.ts';
 export declare const views: {
-    readonly human: (results: unknown, options: import("../view.ts").ViewOptions, config: import("../config/index.ts").ParsedConfig) => unknown;
+    readonly human: (_results: unknown, _options: import("../view.ts").ViewOptions, config: import("../config/index.ts").ParsedConfig) => string;
 };
 export declare const usage: CommandUsage;
 export declare const command: CommandFn;

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

@@ -1 +1 @@
-{"version":3,"file":"pkg.d.ts","sourceRoot":"","sources":["../../../src/commands/pkg.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM1D,eAAO,MAAM,KAAK;;CAmBQ,CAAA;AAE1B,eAAO,MAAM,KAAK,EAAE,YAoChB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SA6BrB,CAAA"}
+{"version":3,"file":"pkg.d.ts","sourceRoot":"","sources":["../../../src/commands/pkg.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAoB1D,eAAO,MAAM,KAAK;;CAmBQ,CAAA;AAE1B,eAAO,MAAM,KAAK,EAAE,YAoChB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SA8FrB,CAAA"}

package/dist/esm/commands/pkg.js

@@ -1,19 +1,27 @@
+import { resolve } from 'node:path';
 import * as dotProp from '@vltpkg/dot-prop';
 import { error } from '@vltpkg/error-cause';
 import assert from 'node:assert';
 import { commandUsage } from "../config/usage.js";
 import { init } from '@vltpkg/init';
 import { views as initViews } from "./init.js";
+import { actual, GraphModifier } from '@vltpkg/graph';
+import { Query } from '@vltpkg/query';
+import { SecurityArchive } from '@vltpkg/security-archive';
+const json = (results) => JSON.stringify(results, null, 2);
 export const views = {
-    human: (results, options, config) => {
+    human: (_results, _options, config) => {
+        const results = _results;
         // `vlt pkg init` is an alias for `vlt init`
         // use the same output handling
         if (config.positionals[0] === 'init') {
-            return initViews.human(results, options, config);
+            return initViews.human(results);
         }
-        return results && typeof results === 'object' ?
-            Object.fromEntries(Object.entries(results).filter(([k]) => typeof k !== 'symbol'))
-            : results;
+        return (Array.isArray(results) ?
+            typeof results[0] === 'string' ?
+                results.join('\n')
+                : json(results)
+            : json(results));
     },
 };
 export const usage = () => commandUsage({
@@ -57,19 +65,71 @@ export const command = async (conf) => {
         return await init({ cwd: process.cwd() });
     }
     const pkg = conf.options.packageJson;
-    const mani = pkg.read(conf.projectRoot);
+    // Handle --scope option to get multiple manifests
+    const scopeQueryString = conf.get('scope');
+    let manifests;
+    if (scopeQueryString) {
+        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: false,
+        });
+        const securityArchive = Query.hasSecuritySelectors(scopeQueryString) ?
+            await SecurityArchive.start({
+                graph,
+                specOptions: conf.options,
+            })
+            : undefined;
+        const query = new Query({
+            graph,
+            specOptions: conf.options,
+            securityArchive,
+        });
+        const { nodes } = await query.search(scopeQueryString, {
+            signal: new AbortController().signal,
+        });
+        // collects the paths of the nodes selected using --scope
+        const scopePaths = nodes
+            .filter((n) => n.location !== undefined)
+            .map(n => resolve(conf.options.projectRoot, n.location));
+        // reads multiple manifests for each selected scope
+        manifests = scopePaths.map(location => ({
+            manifest: pkg.read(location),
+            location,
+        }));
+        if (manifests.length === 0) {
+            throw error('No matching package found using scope', {
+                found: scopeQueryString,
+            });
+        }
+    }
+    else {
+        // Single manifest mode
+        const location = pkg.find() ?? conf.projectRoot;
+        manifests = [
+            {
+                manifest: pkg.read(location),
+                location,
+            },
+        ];
+    }
     switch (sub) {
         case 'get':
-            return get(mani, args);
+            return get(manifests, args);
         case 'pick':
-            return pick(mani, args);
+            return pick(manifests, args);
         case 'set':
-            return set(conf, mani, pkg, args);
+            return set(conf, manifests, pkg, args);
         case 'rm':
         case 'remove':
         case 'unset':
         case 'delete':
-            return rm(conf, mani, pkg, args);
+            return rm(conf, manifests, pkg, args);
         default: {
             throw error('Unrecognized pkg command', {
                 code: 'EUSAGE',
@@ -79,45 +139,85 @@ export const command = async (conf) => {
         }
     }
 };
-const get = (mani, args) => {
+const get = (manifests, args) => {
     const noArg = () => error('get requires not more than 1 argument. use `pick` to get more than 1.', { code: 'EUSAGE' }, noArg);
     if (args.length !== 1) {
         if (args.length > 1) {
             throw noArg();
         }
-        return pick(mani, args);
+        return pick(manifests, args);
     }
-    assert(args[0], noArg());
-    return dotProp.get(mani, args[0]);
+    assert(args[0] != null, noArg());
+    const [key] = args;
+    if (manifests.length === 1) {
+        const [firstManifest] = manifests;
+        if (!firstManifest?.manifest) {
+            /* c8 ignore start */
+            throw error('No manifest found', firstManifest?.location ?
+                { path: firstManifest.location }
+                : {});
+            /* c8 ignore stop */
+        }
+        return dotProp.get(firstManifest.manifest, key);
+    }
+    return manifests.map(manifest => dotProp.get(manifest.manifest, key));
 };
-const pick = (mani, args) => {
-    return args.length ?
-        args.reduce((acc, key) => dotProp.set(acc, key, dotProp.get(mani, key)), {})
-        : mani;
+const pick = (manifests, args) => {
+    if (manifests.length === 1) {
+        const [firstManifest] = manifests;
+        /* c8 ignore start */
+        if (!firstManifest?.manifest) {
+            throw error('No manifest found', firstManifest?.location ?
+                { path: firstManifest.location }
+                : {});
+        }
+        /* c8 ignore stop */
+        const { manifest } = firstManifest;
+        return args.length ?
+            args.reduce((acc, key) => dotProp.set(acc, key, dotProp.get(manifest, key)), {})
+            : manifest;
+    }
+    // Multiple manifests - return results keyed by location
+    return manifests.map(manifest => args.length ?
+        args.reduce((acc, key) => dotProp.set(acc, key, dotProp.get(manifest.manifest, key)), {})
+        : manifest.manifest);
 };
-const set = (conf, mani, pkg, args) => {
+const set = (_conf, manifests, pkg, args) => {
     if (args.length < 1) {
         throw error('set requires arguments', { code: 'EUSAGE' });
     }
-    const res = args.reduce((acc, p) => {
-        const index = p.indexOf('=');
-        if (index === -1) {
-            throw error('set arguments must contain `=`', {
-                code: 'EUSAGE',
-            });
-        }
-        return dotProp.set(acc, p.substring(0, index), p.substring(index + 1));
-    }, mani);
-    pkg.write(conf.projectRoot, res);
+    for (const { manifest, location } of manifests) {
+        const res = args.reduce((acc, p) => {
+            const index = p.indexOf('=');
+            if (index === -1) {
+                throw error('set arguments must contain `=`', {
+                    code: 'EUSAGE',
+                });
+            }
+            return dotProp.set(acc, p.substring(0, index), p.substring(index + 1));
+        }, manifest);
+        pkg.write(location, res);
+    }
 };
-const rm = (conf, mani, pkg, args) => {
+const rm = (_conf, manifests, pkg, args) => {
     if (args.length < 1) {
         throw error('rm requires arguments', { code: 'EUSAGE' });
     }
-    const res = args.reduce((acc, key) => {
-        dotProp.del(acc, key);
-        return acc;
-    }, mani);
-    pkg.write(conf.projectRoot, res);
+    const results = [];
+    for (const { manifest, location } of manifests) {
+        const res = args.reduce((acc, key) => {
+            dotProp.del(acc, key);
+            return acc;
+        }, manifest);
+        pkg.write(location, res);
+        results.push({
+            manifest: res,
+            location,
+        });
+    }
+    if (manifests.length === 1) {
+        return results[0];
+    }
+    return results;
 };
 //# sourceMappingURL=pkg.js.map