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

package/dist/esm/commands/publish.js

@@ -0,0 +1,239 @@
+import { error } from '@vltpkg/error-cause';
+import { RegistryClient } from '@vltpkg/registry-client';
+import { run } from '@vltpkg/run';
+import { commandUsage } from "../config/usage.js";
+import { packTarball } from "../pack-tarball.js";
+import assert from 'node:assert';
+import { asError } from '@vltpkg/types';
+import { dirname, resolve } from 'node:path';
+import prettyBytes from 'pretty-bytes';
+import { actual } from '@vltpkg/graph';
+import { Query } from '@vltpkg/query';
+import { createHostContextsMap } from "../query-host-contexts.js";
+export const usage = () => commandUsage({
+    command: 'publish',
+    usage: '',
+    description: `Create a tarball from a package and publish it to the configured registry.
+    
+    This command will pack the package in the current directory or specified folder,
+    and then upload it to the configured registry.`,
+    options: {
+        tag: {
+            description: 'Publish the package with the given tag',
+            value: '<tag>',
+        },
+        access: {
+            description: 'Set access level (public or restricted)',
+            value: '<level>',
+        },
+        otp: {
+            description: `Provide an OTP to use when publishing a package.`,
+            value: '<otp>',
+        },
+        'publish-directory': {
+            description: `Directory to use for pack and publish operations instead of the current directory.
+                    The directory must exist and nothing will be copied to it.`,
+            value: '<path>',
+        },
+    },
+});
+export const views = {
+    human: results => {
+        const item = (r) => {
+            const lines = [
+                `📦 Package: ${r.id}`,
+                `🏷️ Tag: ${r.tag}`,
+                `📡 Registry: ${r.registry}`,
+                `📁 ${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');
+        };
+        return Array.isArray(results) ?
+            results.map(item).join('\n\n')
+            : item(results);
+    },
+    json: r => r,
+};
+export const command = async (conf) => {
+    const { options, projectRoot } = conf;
+    const queryString = conf.get('scope');
+    const paths = conf.get('workspace');
+    const groups = conf.get('workspace-group');
+    const recursive = conf.get('recursive');
+    const locations = [];
+    let single = null;
+    if (queryString) {
+        const mainManifest = options.packageJson.maybeRead(projectRoot);
+        let graph;
+        if (mainManifest) {
+            graph = actual.load({
+                ...options,
+                mainManifest,
+                monorepo: options.monorepo,
+                loadManifests: false,
+            });
+        }
+        const hostContexts = await createHostContextsMap(conf);
+        const query = new Query({
+            /* c8 ignore next */
+            nodes: graph ? new Set(graph.nodes.values()) : new Set(),
+            edges: graph?.edges ?? new Set(),
+            importers: graph?.importers ?? new Set(),
+            securityArchive: undefined,
+            hostContexts,
+        });
+        const { nodes } = await query.search(queryString, {
+            signal: new AbortController().signal,
+        });
+        for (const node of nodes) {
+            const { location } = node.toJSON();
+            assert(location, error(`node ${node.id} has no location`, {
+                found: node,
+            }));
+            locations.push(resolve(projectRoot, location));
+        }
+    }
+    else if (paths?.length || groups?.length || recursive) {
+        for (const workspace of options.monorepo ?? []) {
+            locations.push(workspace.fullpath);
+        }
+    }
+    else {
+        single = options.packageJson.find(process.cwd()) ?? projectRoot;
+    }
+    if (single) {
+        return commandSingle(single, conf);
+    }
+    assert(locations.length > 0, error('No workspaces or query results found'));
+    const results = [];
+    for (const location of locations) {
+        results.push(await commandSingle(location, conf));
+    }
+    return results;
+};
+const commandSingle = async (location, conf) => {
+    const manifestPath = conf.options.packageJson.find(location);
+    assert(manifestPath, 'No package.json found');
+    const manifestDir = dirname(manifestPath);
+    const manifest = conf.options.packageJson.read(manifestDir);
+    assert(!manifest.private, error('Package has been marked as private'));
+    const { tag = 'latest', access, registry, 'dry-run': dry = false, otp, } = conf.options;
+    const registryUrl = new URL(registry);
+    const runOptions = {
+        cwd: manifestDir,
+        projectRoot: conf.projectRoot,
+        packageJson: conf.options.packageJson,
+        manifest,
+        ignoreMissing: true,
+        ignorePrePost: true,
+    };
+    await run({
+        ...runOptions,
+        arg0: 'prepublishOnly',
+    });
+    await run({
+        ...runOptions,
+        arg0: 'prepublish',
+    });
+    await run({
+        ...runOptions,
+        arg0: 'prepack',
+    });
+    await run({
+        ...runOptions,
+        arg0: 'prepare',
+    });
+    const { name, version, tarballName, tarballData, unpackedSize, files, integrity, shasum, } = await packTarball(manifest, manifestDir, conf);
+    await run({
+        ...runOptions,
+        arg0: 'postpack',
+    });
+    await run({
+        ...runOptions,
+        arg0: 'publish',
+    });
+    const publishMetadata = {
+        _id: name,
+        name,
+        description: manifest.description || '',
+        'dist-tags': {
+            [tag]: version,
+        },
+        versions: {
+            [version]: {
+                ...manifest,
+                _id: `${name}@${version}`,
+                _nodeVersion: process.versions.node,
+                dist: {
+                    ...manifest.dist,
+                    integrity,
+                    shasum,
+                    tarball: new URL(`${name}/-/${tarballName}`, registryUrl)
+                        .href,
+                },
+            },
+        },
+        access,
+        _attachments: {
+            [tarballName]: {
+                content_type: 'application/octet-stream',
+                data: tarballData.toString('base64'),
+                length: tarballData.length,
+            },
+        },
+    };
+    const rc = new RegistryClient(conf.options);
+    const publishUrl = new URL(name.startsWith('@') ? name.replace('/', '%2F') : name, registryUrl);
+    if (!dry) {
+        let response;
+        try {
+            response = await rc.request(publishUrl, {
+                method: 'PUT',
+                headers: {
+                    'content-type': 'application/json',
+                    // These control what type of OTP auth flow is used
+                    'npm-auth-type': 'web',
+                    'npm-command': 'publish',
+                },
+                body: JSON.stringify(publishMetadata),
+                otp,
+            });
+        }
+        catch (err) {
+            throw error('Failed to publish package', {
+                cause: asError(err),
+            });
+        }
+        if (response.statusCode !== 200 && response.statusCode !== 201) {
+            throw error('Failed to publish package', {
+                url: publishUrl,
+                response,
+            });
+        }
+    }
+    await run({
+        ...runOptions,
+        arg0: 'postpublish',
+    });
+    return {
+        id: `${name}@${version}`,
+        name,
+        version,
+        tag,
+        access,
+        registry: registryUrl.origin,
+        integrity,
+        shasum,
+        size: tarballData.length,
+        unpackedSize,
+        files,
+    };
+};
+//# sourceMappingURL=publish.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/commands/publish.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { RegistryClient } from '@vltpkg/registry-client'\nimport type { CacheEntry } from '@vltpkg/registry-client'\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 assert from 'node:assert'\nimport { asError } from '@vltpkg/types'\nimport { dirname, resolve } from 'node:path'\nimport prettyBytes from 'pretty-bytes'\nimport { actual } from '@vltpkg/graph'\nimport { Query } from '@vltpkg/query'\nimport type { LoadedConfig } from '../config/index.ts'\nimport { createHostContextsMap } from '../query-host-contexts.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'publish',\n    usage: '',\n    description: `Create a tarball from a package and publish it to the configured registry.\n    \n    This command will pack the package in the current directory or specified folder,\n    and then upload it to the configured registry.`,\n    options: {\n      tag: {\n        description: 'Publish the package with the given tag',\n        value: '<tag>',\n      },\n      access: {\n        description: 'Set access level (public or restricted)',\n        value: '<level>',\n      },\n      otp: {\n        description: `Provide an OTP to use when publishing a package.`,\n        value: '<otp>',\n      },\n      'publish-directory': {\n        description: `Directory to use for pack and publish operations instead of the current directory.\n                    The directory must exist and nothing will be copied to it.`,\n        value: '<path>',\n      },\n    },\n  })\n\nexport type CommandResultSingle = {\n  id: string\n  name: string\n  version: string\n  tag: string\n  registry: string\n  shasum?: string\n  integrity?: string\n  size: number\n  access: string\n  unpackedSize: number\n  files: string[]\n}\n\nexport type CommandResult =\n  | CommandResultSingle\n  | CommandResultSingle[]\n\nexport const views = {\n  human: results => {\n    const item = (r: CommandResultSingle) => {\n      const lines = [\n        `📦 Package: ${r.id}`,\n        `🏷️ Tag: ${r.tag}`,\n        `📡 Registry: ${r.registry}`,\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    return Array.isArray(results) ?\n        results.map(item).join('\\n\\n')\n      : item(results)\n  },\n  json: r => r,\n} as const satisfies Views<CommandResult>\n\nexport const command: CommandFn<CommandResult> = async conf => {\n  const { options, projectRoot } = conf\n  const queryString = conf.get('scope')\n  const paths = conf.get('workspace')\n  const groups = conf.get('workspace-group')\n  const recursive = conf.get('recursive')\n\n  const locations: string[] = []\n  let single: string | null = null\n\n  if (queryString) {\n    const mainManifest = options.packageJson.maybeRead(projectRoot)\n    let graph\n    if (mainManifest) {\n      graph = actual.load({\n        ...options,\n        mainManifest,\n        monorepo: options.monorepo,\n        loadManifests: false,\n      })\n    }\n    const hostContexts = await createHostContextsMap(conf)\n    const query = new Query({\n      /* c8 ignore next */\n      nodes: graph ? new Set(graph.nodes.values()) : new Set(),\n      edges: graph?.edges ?? new Set(),\n      importers: graph?.importers ?? new Set(),\n      securityArchive: undefined,\n      hostContexts,\n    })\n    const { nodes } = await query.search(queryString, {\n      signal: new AbortController().signal,\n    })\n    for (const node of nodes) {\n      const { location } = node.toJSON()\n      assert(\n        location,\n        error(`node ${node.id} has no location`, {\n          found: node,\n        }),\n      )\n      locations.push(resolve(projectRoot, location))\n    }\n  } else if (paths?.length || groups?.length || recursive) {\n    for (const workspace of options.monorepo ?? []) {\n      locations.push(workspace.fullpath)\n    }\n  } else {\n    single = options.packageJson.find(process.cwd()) ?? projectRoot\n  }\n\n  if (single) {\n    return commandSingle(single, conf)\n  }\n\n  assert(\n    locations.length > 0,\n    error('No workspaces or query results found'),\n  )\n\n  const results: CommandResultSingle[] = []\n  for (const location of locations) {\n    results.push(await commandSingle(location, conf))\n  }\n  return results\n}\n\nconst commandSingle = async (\n  location: string,\n  conf: LoadedConfig,\n) => {\n  const manifestPath = conf.options.packageJson.find(location)\n  assert(manifestPath, 'No package.json found')\n  const manifestDir = dirname(manifestPath)\n  const manifest = conf.options.packageJson.read(manifestDir)\n\n  assert(\n    !manifest.private,\n    error('Package has been marked as private'),\n  )\n\n  const {\n    tag = 'latest',\n    access,\n    registry,\n    'dry-run': dry = false,\n    otp,\n  } = conf.options\n  const registryUrl = new URL(registry)\n\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: 'prepublishOnly',\n  })\n\n  await run({\n    ...runOptions,\n    arg0: 'prepublish',\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    tarballName,\n    tarballData,\n    unpackedSize,\n    files,\n    integrity,\n    shasum,\n  } = await packTarball(manifest, manifestDir, conf)\n\n  await run({\n    ...runOptions,\n    arg0: 'postpack',\n  })\n\n  await run({\n    ...runOptions,\n    arg0: 'publish',\n  })\n\n  const publishMetadata = {\n    _id: name,\n    name,\n    description: manifest.description || '',\n    'dist-tags': {\n      [tag]: version,\n    },\n    versions: {\n      [version]: {\n        ...manifest,\n        _id: `${name}@${version}`,\n        _nodeVersion: process.versions.node,\n        dist: {\n          ...manifest.dist,\n          integrity,\n          shasum,\n          tarball: new URL(`${name}/-/${tarballName}`, registryUrl)\n            .href,\n        },\n      },\n    },\n    access,\n    _attachments: {\n      [tarballName]: {\n        content_type: 'application/octet-stream',\n        data: tarballData.toString('base64'),\n        length: tarballData.length,\n      },\n    },\n  }\n\n  const rc = new RegistryClient(conf.options)\n  const publishUrl = new URL(\n    name.startsWith('@') ? name.replace('/', '%2F') : name,\n    registryUrl,\n  )\n\n  if (!dry) {\n    let response: CacheEntry\n    try {\n      response = await rc.request(publishUrl, {\n        method: 'PUT',\n        headers: {\n          'content-type': 'application/json',\n          // These control what type of OTP auth flow is used\n          'npm-auth-type': 'web',\n          'npm-command': 'publish',\n        },\n        body: JSON.stringify(publishMetadata),\n        otp,\n      })\n    } catch (err) {\n      throw error('Failed to publish package', {\n        cause: asError(err),\n      })\n    }\n\n    if (response.statusCode !== 200 && response.statusCode !== 201) {\n      throw error('Failed to publish package', {\n        url: publishUrl,\n        response,\n      })\n    }\n  }\n\n  await run({\n    ...runOptions,\n    arg0: 'postpublish',\n  })\n\n  return {\n    id: `${name}@${version}`,\n    name,\n    version,\n    tag,\n    access,\n    registry: registryUrl.origin,\n    integrity,\n    shasum,\n    size: tarballData.length,\n    unpackedSize,\n    files,\n  }\n}\n"]}

package/dist/esm/commands/query.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 }: QueryResult, _: import("../view.ts").ViewOptions, conf: import("../config/index.ts").LoadedConfig) => Promise<void>;
+    readonly gui: ({ queryString }: QueryResult, _: import("../view.ts").ViewOptions, conf: import("../config/index.ts").ParsedConfig) => Promise<void>;
 };
 export declare const command: CommandFn<QueryResult>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/commands/query.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,YA6BhB,CAAA;AAEJ,KAAK,WAAW,GAAG,eAAe,GAChC,kBAAkB,GAClB,wBAAwB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD,eAAO,MAAM,KAAK;;;;;CAWqB,CAAA;AAEvC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAuC1C,CAAA"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/commands/query.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;AAI1D,eAAO,MAAM,KAAK,EAAE,YA4EhB,CAAA;AAEJ,KAAK,WAAW,GAAG,eAAe,GAChC,kBAAkB,GAClB,wBAAwB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAA;AAqBpD,eAAO,MAAM,KAAK;;;;;CAUqB,CAAA;AAEvC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAqI1C,CAAA"}

package/dist/esm/commands/query.js

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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