@vltpkg/cli-sdk 0.0.0-11 → 0.0.0-13

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/commands/config.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAGV,WAAW,EACZ,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,eAAO,MAAM,KAAK,EAAE,YA8ChB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAC7B,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,WAAW,CA+B1D,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/commands/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAIV,WAAW,EACZ,MAAM,oBAAoB,CAAA;AAQ3B,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1D,eAAO,MAAM,KAAK,EAAE,YA8ChB,CAAA;AAEJ,eAAO,MAAM,OAAO,EAAE,SAAS,CAC7B,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,WAAW,CA+B1D,CAAA"}

package/dist/esm/commands/config.js

@@ -1,5 +1,8 @@
 import { error } from '@vltpkg/error-cause';
+import { asRootError } from '@vltpkg/output/error';
+import { isObject } from '@vltpkg/types';
 import { spawnSync } from 'node:child_process';
+import { getSortedKeys } from "../config/definition.js";
 import { definition, isRecordField, pairsToRecords, recordsToPairs, } from "../config/index.js";
 import { commandUsage } from "../config/usage.js";
 export const usage = () => commandUsage({
@@ -148,6 +151,43 @@ const set = async (conf) => {
             code: 'EUSAGE',
         });
     }
-    await conf.addConfigToFile(conf.get('config'), pairsToRecords(conf.jack.parseRaw(pairs.map(kv => `--${kv}`)).values));
+    let parsed = null;
+    try {
+        parsed = conf.jack.parseRaw(pairs.map(kv => `--${kv}`)).values;
+    }
+    catch (er) {
+        const { name, found, value, wanted, validOptions } = asRootError(er).cause;
+        // when a boolean gets a value, it throw a parse error
+        if (isObject(found) &&
+            typeof found.name === 'string' &&
+            typeof found.value === 'string') {
+            const { name, value } = found;
+            throw error(`Boolean flag must be "${name}" or "no-${name}", not a value`, {
+                code: 'ECONFIG',
+                name,
+                found: `${name}=${value}`,
+            });
+        }
+        if (wanted && !value && typeof name === 'string') {
+            throw error(`No value provided for ${JSON.stringify(name.replace(/^-+/, ''))}`, {
+                code: 'ECONFIG',
+                wanted,
+            });
+        }
+        if (Array.isArray(validOptions)) {
+            throw error(`Invalid value provided for ${name}`, {
+                code: 'ECONFIG',
+                found,
+                validOptions,
+            });
+        }
+        // an unknown property
+        throw error('Invalid config keys', {
+            code: 'ECONFIG',
+            found: pairs.map(kv => kv.split('=')[0]),
+            validOptions: getSortedKeys(),
+        });
+    }
+    await conf.addConfigToFile(conf.get('config'), pairsToRecords(parsed));
 };
 //# sourceMappingURL=config.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/commands/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { spawnSync } from 'node:child_process'\nimport {\n  definition,\n  isRecordField,\n  pairsToRecords,\n  recordsToPairs,\n} from '../config/index.ts'\nimport type {\n  ConfigDefinitions,\n  LoadedConfig,\n  RecordPairs,\n} from '../config/index.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'config',\n    usage: '<command> [flags]',\n    description: 'Work with vlt configuration',\n\n    subcommands: {\n      get: {\n        usage: '<key> [<key> ...]',\n        description: 'Print the named config value',\n      },\n\n      list: {\n        description:\n          'Print all configuration settings currently in effect',\n      },\n\n      set: {\n        usage:\n          '<key>=<value> [<key>=<value> ...] [--config=<user | project>]',\n        description: `Set config values. By default, these are\n                      written to the project config file, \\`vlt.json\\`\n                      in the root of the project. To set things for all\n                      projects, run with \\`--config=user\\``,\n      },\n\n      del: {\n        usage: '<key> [<key> ...] [--config=<user | project>]',\n        description: `Delete the named config fields. If no values remain in\n                      the config file, delete the file as well. By default,\n                      operates on the \\`vlt.json\\` file in the root of the\n                      current project. To delete a config field from the user\n                      config file, specify \\`--config=user\\`.`,\n      },\n\n      edit: {\n        usage: '[--config=<user | project>]',\n        description: 'Edit the configuration file',\n      },\n\n      help: {\n        usage: '[field ...]',\n        description: `Get information about a config field, or show a list\n                      of known config field names.`,\n      },\n    },\n  })\n\nexport const command: CommandFn<\n  string | number | boolean | void | string[] | RecordPairs\n> = async conf => {\n  const sub = conf.positionals[0]\n  switch (sub) {\n    case 'set':\n      return set(conf)\n\n    case 'get':\n      return get(conf)\n\n    case 'ls':\n    case 'list':\n      return list(conf)\n\n    case 'edit':\n      return edit(conf)\n\n    case 'help':\n      return help(conf)\n\n    case 'del':\n      return del(conf)\n\n    default: {\n      throw error('Unrecognized config command', {\n        code: 'EUSAGE',\n        found: sub,\n        validOptions: ['set', 'get', 'list', 'edit', 'help', 'del'],\n      })\n    }\n  }\n}\n\nconst help = (conf: LoadedConfig) => {\n  const j = definition.toJSON()\n  const fields = conf.positionals.slice(1)\n  if (!fields.length) {\n    return [\n      'Specify one or more options to see information:',\n      ...Object.keys(j)\n        .sort((a, b) => a.localeCompare(b, 'en'))\n        .map(c => `  ${c}`),\n    ].join('\\n')\n  }\n\n  // TODO: some kind of fuzzy search?\n  const res: string[] = []\n  for (const f of fields) {\n    const def = j[f]\n    if (!def) {\n      res.push(`unknown config field: ${f}`)\n    } else {\n      const hint = def.hint ? `=<${def.hint}>` : ''\n      const type =\n        isRecordField(f) ?\n          'Record<string, string>'\n        : def.type + (def.multiple ? '[]' : '')\n\n      res.push(`--${f}${hint}`)\n      res.push(`  type: ${type}`)\n      if (def.default) {\n        res.push(`  default: ${JSON.stringify(def.default)}`)\n      }\n      if (def.description) {\n        res.push(def.description)\n      }\n    }\n  }\n  return res.join('\\n')\n}\n\nconst list = (conf: LoadedConfig) => {\n  return recordsToPairs(conf.options)\n}\n\nconst del = async (conf: LoadedConfig) => {\n  const fields = conf.positionals.slice(1)\n  if (!fields.length) {\n    throw error('At least one key is required', {\n      code: 'EUSAGE',\n    })\n  }\n  await conf.deleteConfigKeys(conf.get('config'), fields)\n}\n\nconst get = async (conf: LoadedConfig) => {\n  const keys = conf.positionals.slice(1)\n  const k = keys[0]\n  if (!k || keys.length > 1) {\n    throw error('Exactly one key is required', {\n      code: 'EUSAGE',\n    })\n  }\n  return conf.get(k as keyof ConfigDefinitions)\n}\n\nconst edit = async (conf: LoadedConfig) => {\n  const [command, ...args] = conf.get('editor').split(' ')\n  if (!command) {\n    throw error(`editor is empty`)\n  }\n  await conf.editConfigFile(conf.get('config'), file => {\n    args.push(file)\n    const res = spawnSync(command, args, {\n      stdio: 'inherit',\n    })\n    if (res.status !== 0) {\n      throw error(`${command} command failed`, {\n        ...res,\n        command,\n        args,\n      })\n    }\n  })\n}\n\nconst set = async (conf: LoadedConfig) => {\n  const pairs = conf.positionals.slice(1)\n  if (!pairs.length) {\n    throw error('At least one key=value pair is required', {\n      code: 'EUSAGE',\n    })\n  }\n  await conf.addConfigToFile(\n    conf.get('config'),\n    pairsToRecords(\n      conf.jack.parseRaw(pairs.map(kv => `--${kv}`)).values,\n    ),\n  )\n}\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/commands/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { asRootError } from '@vltpkg/output/error'\nimport { isObject } from '@vltpkg/types'\nimport { spawnSync } from 'node:child_process'\nimport { getSortedKeys } from '../config/definition.ts'\nimport type {\n  ConfigDefinitions,\n  ConfigFileData,\n  LoadedConfig,\n  RecordPairs,\n} from '../config/index.ts'\nimport {\n  definition,\n  isRecordField,\n  pairsToRecords,\n  recordsToPairs,\n} from '../config/index.ts'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\n\nexport const usage: CommandUsage = () =>\n  commandUsage({\n    command: 'config',\n    usage: '<command> [flags]',\n    description: 'Work with vlt configuration',\n\n    subcommands: {\n      get: {\n        usage: '<key> [<key> ...]',\n        description: 'Print the named config value',\n      },\n\n      list: {\n        description:\n          'Print all configuration settings currently in effect',\n      },\n\n      set: {\n        usage:\n          '<key>=<value> [<key>=<value> ...] [--config=<user | project>]',\n        description: `Set config values. By default, these are\n                      written to the project config file, \\`vlt.json\\`\n                      in the root of the project. To set things for all\n                      projects, run with \\`--config=user\\``,\n      },\n\n      del: {\n        usage: '<key> [<key> ...] [--config=<user | project>]',\n        description: `Delete the named config fields. If no values remain in\n                      the config file, delete the file as well. By default,\n                      operates on the \\`vlt.json\\` file in the root of the\n                      current project. To delete a config field from the user\n                      config file, specify \\`--config=user\\`.`,\n      },\n\n      edit: {\n        usage: '[--config=<user | project>]',\n        description: 'Edit the configuration file',\n      },\n\n      help: {\n        usage: '[field ...]',\n        description: `Get information about a config field, or show a list\n                      of known config field names.`,\n      },\n    },\n  })\n\nexport const command: CommandFn<\n  string | number | boolean | void | string[] | RecordPairs\n> = async conf => {\n  const sub = conf.positionals[0]\n  switch (sub) {\n    case 'set':\n      return set(conf)\n\n    case 'get':\n      return get(conf)\n\n    case 'ls':\n    case 'list':\n      return list(conf)\n\n    case 'edit':\n      return edit(conf)\n\n    case 'help':\n      return help(conf)\n\n    case 'del':\n      return del(conf)\n\n    default: {\n      throw error('Unrecognized config command', {\n        code: 'EUSAGE',\n        found: sub,\n        validOptions: ['set', 'get', 'list', 'edit', 'help', 'del'],\n      })\n    }\n  }\n}\n\nconst help = (conf: LoadedConfig) => {\n  const j = definition.toJSON()\n  const fields = conf.positionals.slice(1)\n  if (!fields.length) {\n    return [\n      'Specify one or more options to see information:',\n      ...Object.keys(j)\n        .sort((a, b) => a.localeCompare(b, 'en'))\n        .map(c => `  ${c}`),\n    ].join('\\n')\n  }\n\n  // TODO: some kind of fuzzy search?\n  const res: string[] = []\n  for (const f of fields) {\n    const def = j[f]\n    if (!def) {\n      res.push(`unknown config field: ${f}`)\n    } else {\n      const hint = def.hint ? `=<${def.hint}>` : ''\n      const type =\n        isRecordField(f) ?\n          'Record<string, string>'\n        : def.type + (def.multiple ? '[]' : '')\n\n      res.push(`--${f}${hint}`)\n      res.push(`  type: ${type}`)\n      if (def.default) {\n        res.push(`  default: ${JSON.stringify(def.default)}`)\n      }\n      if (def.description) {\n        res.push(def.description)\n      }\n    }\n  }\n  return res.join('\\n')\n}\n\nconst list = (conf: LoadedConfig) => {\n  return recordsToPairs(conf.options)\n}\n\nconst del = async (conf: LoadedConfig) => {\n  const fields = conf.positionals.slice(1)\n  if (!fields.length) {\n    throw error('At least one key is required', {\n      code: 'EUSAGE',\n    })\n  }\n  await conf.deleteConfigKeys(conf.get('config'), fields)\n}\n\nconst get = async (conf: LoadedConfig) => {\n  const keys = conf.positionals.slice(1)\n  const k = keys[0]\n  if (!k || keys.length > 1) {\n    throw error('Exactly one key is required', {\n      code: 'EUSAGE',\n    })\n  }\n  return conf.get(k as keyof ConfigDefinitions)\n}\n\nconst edit = async (conf: LoadedConfig) => {\n  const [command, ...args] = conf.get('editor').split(' ')\n  if (!command) {\n    throw error(`editor is empty`)\n  }\n  await conf.editConfigFile(conf.get('config'), file => {\n    args.push(file)\n    const res = spawnSync(command, args, {\n      stdio: 'inherit',\n    })\n    if (res.status !== 0) {\n      throw error(`${command} command failed`, {\n        ...res,\n        command,\n        args,\n      })\n    }\n  })\n}\n\nconst set = async (conf: LoadedConfig) => {\n  const pairs = conf.positionals.slice(1)\n  if (!pairs.length) {\n    throw error('At least one key=value pair is required', {\n      code: 'EUSAGE',\n    })\n  }\n  let parsed: ConfigFileData['config'] | null = null\n  try {\n    parsed = conf.jack.parseRaw(pairs.map(kv => `--${kv}`)).values\n  } catch (er) {\n    const { name, found, value, wanted, validOptions } =\n      asRootError(er).cause\n    // when a boolean gets a value, it throw a parse error\n    if (\n      isObject(found) &&\n      typeof found.name === 'string' &&\n      typeof found.value === 'string'\n    ) {\n      const { name, value } = found\n      throw error(\n        `Boolean flag must be \"${name}\" or \"no-${name}\", not a value`,\n        {\n          code: 'ECONFIG',\n          name,\n          found: `${name}=${value}`,\n        },\n      )\n    }\n    if (wanted && !value && typeof name === 'string') {\n      throw error(\n        `No value provided for ${JSON.stringify(name.replace(/^-+/, ''))}`,\n        {\n          code: 'ECONFIG',\n          wanted,\n        },\n      )\n    }\n    if (Array.isArray(validOptions)) {\n      throw error(`Invalid value provided for ${name}`, {\n        code: 'ECONFIG',\n        found,\n        validOptions,\n      })\n    }\n    // an unknown property\n    throw error('Invalid config keys', {\n      code: 'ECONFIG',\n      found: pairs.map(kv => kv.split('=')[0]),\n      validOptions: getSortedKeys(),\n    })\n  }\n  await conf.addConfigToFile(\n    conf.get('config'),\n    pairsToRecords(parsed),\n  )\n}\n"]}

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

@@ -4,7 +4,7 @@ import Spinner from 'ink-spinner';
 import { createElement as $, Fragment, useLayoutEffect, useState, } from 'react';
 import { stdout } from "../../output.js";
 import { ViewClass } from "../../view.js";
-import { asError } from '@vltpkg/error-cause';
+import { asError } from '@vltpkg/types';
 const GraphStep = ({ text, step }) => {
     if (step.state === 'waiting') {
         return $(Text, { color: 'gray' }, text);

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'\nimport { asError } from '@vltpkg/error-cause'\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(asError(err))\n  }\n}\n"]}
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../../../src/commands/install/reporter.ts"],"names":[],"mappings":"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","sourcesContent":["import { emitter } from '@vltpkg/output'\nimport type { Events } from '@vltpkg/output'\nimport { Box, render, Text } from 'ink'\nimport type { Instance } from 'ink'\nimport Spinner from 'ink-spinner'\nimport {\n  createElement as $,\n  Fragment,\n  useLayoutEffect,\n  useState,\n} from 'react'\nimport { stdout } from '../../output.ts'\nimport { ViewClass } from '../../view.ts'\nimport { asError } from '@vltpkg/types'\n\ntype Step = {\n  state: 'waiting' | 'in_progress' | 'completed'\n}\n\nconst GraphStep = ({ text, step }: { text: string; step: Step }) => {\n  if (step.state === 'waiting') {\n    return $(Text, { color: 'gray' }, text)\n  }\n  if (step.state === 'in_progress') {\n    return $(\n      Text,\n      { color: 'yellow' },\n      text,\n      $(Spinner, { type: 'dots' }),\n    )\n  }\n  return $(Text, { color: 'green' }, text, ' ✓')\n}\n\nconst App = () => {\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(asError(err))\n  }\n}\n"]}

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,KAAK,EACV,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAEnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAEL,mBAAmB,EACnB,UAAU,EACV,aAAa,EACd,MAAM,eAAe,CAAA;AAItB,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,eAAO,MAAM,KAAK,EAAE,YA4ChB,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,CAmEzC,CAAA"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAEnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAEL,mBAAmB,EACnB,UAAU,EACV,aAAa,EACd,MAAM,eAAe,CAAA;AAKtB,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1D,eAAO,MAAM,KAAK,EAAE,YA4ChB,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,CA0EzC,CAAA"}

package/dist/esm/commands/list.js

@@ -77,6 +77,7 @@ export const command = async (conf) => {
     const projectQueryString = ':project, :project > *';
     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);
@@ -84,6 +85,7 @@ export const command = async (conf) => {
                 importers.add(w);
                 selectImporters.push(`[name="${w.name}"]`);
                 selectImporters.push(`[name="${w.name}"] > *`);
+                scopeIDs.push(workspace.id);
             }
         }
     }
@@ -97,7 +99,10 @@ export const command = async (conf) => {
         selectImporters.length < graph.importers.size) ?
         selectImportersQueryString
         : projectQueryString;
-    const { edges, nodes } = await query.search(queryString || defaultQueryString);
+    const { edges, nodes } = await query.search(queryString || defaultQueryString, {
+        signal: new AbortController().signal,
+        scopeIDs: scopeIDs.length > 0 ? scopeIDs : undefined,
+    });
     return {
         importers,
         edges,

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

@@ -1 +1 @@
-{"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  humanReadableOutput,\n  jsonOutput,\n  mermaidOutput,\n} from '@vltpkg/graph'\nimport { Query } from '@vltpkg/query'\nimport { SecurityArchive } from '@vltpkg/security-archive'\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  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 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"]}

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,KAAK,EAEV,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAEnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAEL,mBAAmB,EACnB,UAAU,EACV,aAAa,EACd,MAAM,eAAe,CAAA;AAKtB,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1D,eAAO,MAAM,KAAK,EAAE,YA4ChB,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,CA0D1C,CAAA"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/commands/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAEnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAEL,mBAAmB,EACnB,UAAU,EACV,aAAa,EACd,MAAM,eAAe,CAAA;AAMtB,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1D,eAAO,MAAM,KAAK,EAAE,YA4ChB,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,CAmE1C,CAAA"}

package/dist/esm/commands/query.js

@@ -93,13 +93,15 @@ export const command = async (conf) => {
         specOptions: conf.options,
         securityArchive,
     });
-    const { edges, nodes } = await query.search(queryString || defaultQueryString);
     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)
+            if (w) {
                 importers.add(w);
+                scopeIDs.push(workspace.id);
+            }
         }
     }
     if (importers.size === 0) {
@@ -107,6 +109,10 @@ export const command = async (conf) => {
             importers.add(importer);
         }
     }
+    const { edges, nodes } = await query.search(queryString || defaultQueryString, {
+        signal: new AbortController().signal,
+        scopeIDs: scopeIDs.length > 0 ? scopeIDs : undefined,
+    });
     if (!validateExpectedResult(conf, edges)) {
         throw error('Unexpected number of items', {
             found: edges.length,

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 type {\n  EdgeLike,\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 { error } from '@vltpkg/error-cause'\nimport { Query } from '@vltpkg/query'\nimport { SecurityArchive } from '@vltpkg/security-archive'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { startGUI } from '../start-gui.ts'\nimport type { Views } from '../view.ts'\nimport type { LoadedConfig } from '../config/index.js'\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    ],\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    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    },\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      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?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 securityArchive =\n    queryString && 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\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  if (!validateExpectedResult(conf, edges)) {\n    throw error('Unexpected number of items', {\n      found: edges.length,\n      wanted: conf.values['expect-results'],\n    })\n  }\n\n  return {\n    importers,\n    edges,\n    nodes,\n    highlightSelection: !!queryString,\n    queryString: queryString || defaultQueryString,\n  }\n}\n"]}
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/commands/query.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  EdgeLike,\n  HumanReadableOutputGraph,\n  JSONOutputGraph,\n  MermaidOutputGraph,\n  Node,\n} from '@vltpkg/graph'\nimport {\n  actual,\n  humanReadableOutput,\n  jsonOutput,\n  mermaidOutput,\n} from '@vltpkg/graph'\nimport { error } from '@vltpkg/error-cause'\nimport { Query } from '@vltpkg/query'\nimport { SecurityArchive } from '@vltpkg/security-archive'\nimport type { DepID } from '@vltpkg/dep-id'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport { startGUI } from '../start-gui.ts'\nimport type { Views } from '../view.ts'\nimport type { LoadedConfig } from '../config/index.js'\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    ],\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    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    },\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      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?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 securityArchive =\n    queryString && 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\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        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 { edges, nodes } = await query.search(\n    queryString || defaultQueryString,\n    {\n      signal: new AbortController().signal,\n      scopeIDs: scopeIDs.length > 0 ? scopeIDs : undefined,\n    },\n  )\n\n  if (!validateExpectedResult(conf, edges)) {\n    throw error('Unexpected number of items', {\n      found: edges.length,\n      wanted: conf.values['expect-results'],\n    })\n  }\n\n  return {\n    importers,\n    edges,\n    nodes,\n    highlightSelection: !!queryString,\n    queryString: queryString || defaultQueryString,\n  }\n}\n"]}

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

@@ -1,4 +1,5 @@
 export declare const defaultView: string;
+export declare const defaultEditor: () => string;
 /**
  * Command aliases mapped to their canonical names
  */
@@ -46,7 +47,7 @@ export declare const getCommand: (s?: string) => Commands[keyof Commands] | unde
 /**
  * Fields that are parsed as a set of key=value pairs
  */
-export declare const recordFields: readonly ["git-hosts", "registries", "git-host-archives", "scope-registries"];
+export declare const recordFields: readonly ["git-hosts", "registries", "git-host-archives", "scope-registries", "jsr-registries"];
 export type RecordField = (typeof recordFields)[number];
 export declare const isRecordField: (s: string) => s is RecordField;
 export declare const definition: import("jackspeak").Jack<{
@@ -78,6 +79,10 @@ export declare const definition: import("jackspeak").Jack<{
         hint: string;
         description: string;
     };
+    'jsr-registries': {
+        hint: string;
+        description: string;
+    };
     'git-hosts': {
         hint: string;
         short: string;
@@ -91,6 +96,7 @@ export declare const definition: import("jackspeak").Jack<{
 } & {
     registries: import("jackspeak").ConfigOption<"string", true, readonly string[] | undefined>;
     'scope-registries': import("jackspeak").ConfigOption<"string", true, readonly string[] | undefined>;
+    'jsr-registries': import("jackspeak").ConfigOption<"string", true, readonly string[] | undefined>;
     'git-hosts': import("jackspeak").ConfigOption<"string", true, readonly string[] | undefined>;
     'git-host-archives': import("jackspeak").ConfigOption<"string", true, readonly string[] | undefined>;
 } & {
@@ -303,4 +309,6 @@ export declare const definition: import("jackspeak").Jack<{
     version: import("jackspeak").ConfigOption<"boolean", false, undefined>;
     help: import("jackspeak").ConfigOption<"boolean", false, undefined>;
 }>;
+export declare const getSortedCliOptions: () => string[];
+export declare const getSortedKeys: () => string[];
 //# sourceMappingURL=definition.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/config/definition.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,QAA0C,CAAA;AA0ClE;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGX,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,cAAc,uBAW1B,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAA;AAEtC,eAAO,MAAM,UAAU,OACjB,MAAM,KACT,QAAQ,CAAC,MAAM,QAAQ,CAAC,GAAG,SACkC,CAAA;AAKhE;;GAEG;AACH,eAAO,MAAM,YAAY,+EAKf,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvD,eAAO,MAAM,aAAa,MAAO,MAAM,KAAG,CAAC,IAAI,WACN,CAAA;AAwCzC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAwNH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAoMP,OAAO;;;;;;;;;;;;;;;;;;;;;;EA0BvB,CAAA"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/config/definition.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAA0C,CAAA;AAElE,eAAO,MAAM,aAAa,cAKjB,CAAA;AA0CT;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGX,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,cAAc,uBAW1B,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAA;AAEtC,eAAO,MAAM,UAAU,OACjB,MAAM,KACT,QAAQ,CAAC,MAAM,QAAQ,CAAC,GAAG,SACkC,CAAA;AAKhE;;GAEG;AACH,eAAO,MAAM,YAAY,iGAMf,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvD,eAAO,MAAM,aAAa,MAAO,MAAM,KAAG,CAAC,IAAI,WACN,CAAA;AAwCzC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA2OH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA+LP,OAAO;;;;;;;;;;;;;;;;;;;;;;EA0BvB,CAAA;AAEJ,eAAO,MAAM,mBAAmB,gBAS/B,CAAA;AAED,eAAO,MAAM,aAAa,gBAC2C,CAAA"}

package/dist/esm/config/definition.js

@@ -1,6 +1,12 @@
+import { error } from '@vltpkg/error-cause';
 import { XDG } from '@vltpkg/xdg';
 import { jack } from 'jackspeak';
 export const defaultView = process.stdout.isTTY ? 'human' : 'json';
+export const defaultEditor = () => process.env.EDITOR ||
+    process.env.VISUAL ||
+    (process.platform === 'win32' ?
+        `${process.env.SYSTEMROOT}\\notepad.exe`
+        : 'vi');
 const canonicalCommands = {
     cache: 'cache',
     config: 'config',
@@ -70,6 +76,7 @@ export const recordFields = [
     'registries',
     'git-host-archives',
     'scope-registries',
+    'jsr-registries',
 ];
 export const isRecordField = (s) => recordFields.includes(s);
 const stopParsingCommands = [
@@ -191,6 +198,24 @@ export const definition = j
                     However, custom registry aliases are not supported by other
                     package managers.`,
     },
+    'jsr-registries': {
+        hint: 'name=url',
+        description: `Map alias names to JSR.io registry urls.
+
+                    For example,
+                    \`--jsr-registries acme=https://jsr.acme.io/\` would
+                    tell vlt to fetch any packages with the \`acme:\` registry
+                    prefix from the \`https://jsr.acme.io/\` registry, using
+                    the "npm Compatibility" translation. So for example,
+                    the package \`acme:@foo/bar\` would fetch the
+                    \`@jsr/foo__bar\` package from the \`jsr.acme.io\`
+                    registry.
+
+                    By default the \`jsr\` alias is always mapped to
+                    \`https://npm.jsr.io/\`, so existing \`jsr:\` packages will
+                    be fetched from the public \`jsr\` registry appropriately.
+                   `,
+    },
     'git-hosts': {
         hint: `name=template`,
         short: 'G',
@@ -380,11 +405,7 @@ export const definition = j
 
                     Defaults to the \`EDITOR\` or \`VISUAL\` env if set, or
                     \`notepad.exe\` on Windows, or \`vi\` elsewhere.`,
-        default: process.env.EDITOR ||
-            process.env.VISUAL ||
-            (process.platform === 'win32' ?
-                `${process.env.SYSTEMROOT}\\notepad.exe`
-                : 'vi'),
+        default: defaultEditor(),
     },
     'script-shell': {
         hint: 'program',
@@ -514,4 +535,17 @@ export const definition = j
         description: 'Print helpful information',
     },
 });
+export const getSortedCliOptions = () => {
+    const defs = definition.toJSON();
+    return getSortedKeys().map((k) => {
+        const def = defs[k];
+        /* c8 ignore next */
+        if (!def)
+            throw error('invalid key found', { found: k });
+        if (def.type === 'boolean')
+            return `--${k}`;
+        return `--${k}=<${def.hint ?? k}>`;
+    });
+};
+export const getSortedKeys = () => Object.keys(definition.toJSON()).sort((a, b) => a.localeCompare(b));
 //# sourceMappingURL=definition.js.map

package/dist/esm/config/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/config/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAA;AAElE,MAAM,iBAAiB,GAAG;IACxB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,YAAY;IAC1B,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,IAAI;IACR,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,UAAU;IACtB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,YAAY;IAC1B,MAAM,EAAE,QAAQ;CACR,CAAA;AAEV,MAAM,OAAO,GAAG;IACd,CAAC,EAAE,SAAS;IACZ,GAAG,EAAE,SAAS;IACd,EAAE,EAAE,WAAW;IACf,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,KAAK;IACR,YAAY,EAAE,KAAK;IACnB,EAAE,EAAE,UAAU;IACd,CAAC,EAAE,MAAM;IACT,EAAE,EAAE,YAAY;IAChB,CAAC,EAAE,MAAM;IACT,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,YAAY;CACR,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,iBAAiB;IACpB,GAAG,OAAO;CACF,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAC1D,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE;IAC1B,MAAM,cAAc,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACzC,IAAI,cAAc,EAAE,CAAC;QACnB,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5B,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,EACD,IAAI,GAAG,EAAoB,CAC5B,CAAA;AAID,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,CAAU,EAC4B,EAAE,CACxC,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAEhE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;AAC1B,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,EAAE,CAAA;AAE5B;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW;IACX,YAAY;IACZ,mBAAmB;IACnB,kBAAkB;CACV,CAAA;AAIV,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAS,EAAoB,EAAE,CAC3D,YAAY,CAAC,QAAQ,CAAC,CAAgB,CAAC,CAAA;AAEzC,MAAM,mBAAmB,GAA+B;IACtD,KAAK;IACL,UAAU;IACV,YAAY;IACZ,MAAM;CACP,CAAA;AAED,IAAI,WAAW,GAAwB,SAAS,CAAA;AAEhD,MAAM,CAAC,GAAG,IAAI,CAAC;IACb,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,IAAI;IACtB,KAAK,EAAE,sCAAsC;IAC7C,oBAAoB,EAAE,GAAG,CAAC,EAAE;QAC1B,IAAI,WAAW;YAAE,OAAO,IAAI,CAAA;QAC5B,MAAM,CAAC,GAAG,GAAqB,CAAA;QAC/B,iDAAiD;QACjD,2DAA2D;QAC3D,KAAK;QACL,0DAA0D;QAC1D,IAAI,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,WAAW,GAAG,IAAI,CAAA;QACpB,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;CACF,CAAC;KACC,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CACV,uDAAuD,CACxD;KACA,OAAO,CAAC,aAAa,CAAC,CAAA;AAEzB,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;IACvD,GAAG,EAAE,IAAI;CACV,CAAC,CAAC,WAAW,CACZ,sEAAsE,CACvE,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;IACzB;;OAEG;KACF,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CACV;;;;;;;;;;;KAWC,CACF;KAEA,IAAI,CAAC;IACJ,KAAK,EAAE;QACL,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,8BAA8B;KAC5C;IACD,UAAU,EAAE;QACV,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,yCAAyC;KACvD;CACF,CAAC;KAED,GAAG,CAAC;IACH,QAAQ,EAAE;QACR,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,6BAA6B;QACtC,WAAW,EAAE;;;;;;;;;;OAUZ;KACF;CACF,CAAC;KAED,OAAO,CAAC;IACP,UAAU,EAAE;QACV,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;;;;;;;;;;qBAaE;KAChB;IAED,kBAAkB,EAAE;QAClB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;sCAsBmB;KACjC;IAED,WAAW,EAAE;QACX,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,GAAG;QACV,WAAW,EAAE;;;;;;;;iDAQ8B;KAC5C;IAED,mBAAmB,EAAE;QACnB,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,GAAG;QACV,WAAW,EAAE;;;;;;;;qEAQkD;KAChE;CACF,CAAC;KAED,GAAG,CAAC;IACH,KAAK,EAAE;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE;;;OAGZ;QACD,OAAO,EAAE,QAAQ;KAClB;IACD,GAAG,EAAE;QACH,WAAW,EAAE,iCAAiC;QAC9C,OAAO,EAAE,QAAQ;KAClB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,uDAAuD;KACrE;IACD,EAAE,EAAE;QACF,WAAW,EAAE;0DACuC;QACpD,OAAO,EAAE,OAAO,CAAC,QAAQ;KAC1B;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;2DACwC;QACrD,OAAO,EAAE,OAAO,CAAC,IAAI;KACtB;IACD,cAAc,EAAE;QACd,IAAI,EAAE,SAAS;QACf,WAAW,EAAE;kDAC+B;QAC5C,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB;CACF,CAAC;KAED,IAAI,CAAC;IACJ,aAAa,EAAE;QACb,WAAW,EAAE;;;;;8DAK2C;KACzD;CACF,CAAC;KACD,GAAG,CAAC;IACH,eAAe,EAAE;QACf,IAAI,EAAE,GAAG;QACT,WAAW,EAAE;sEACmD;QAChE,OAAO,EAAE,CAAC;KACX;IACD,oBAAoB,EAAE;QACpB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE;oDACiC;QAC9C,OAAO,EAAE,CAAC;KACX;IACD,wBAAwB,EAAE;QACxB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,oDAAoD;QACjE,OAAO,EAAE,CAAC;KACX;IACD,wBAAwB,EAAE;QACxB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,oDAAoD;QACjE,OAAO,EAAE,MAAM;KAChB;IACD,+BAA+B,EAAE;QAC/B,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,EAAE;QACX,WAAW,EAAE;;;;;;;;;;;;;;OAcZ;KACF;CACF,CAAC;KAED,GAAG,CAAC;IACH,QAAQ,EAAE;QACR,KAAK,EAAE,GAAG;QACV,QAAQ,EAAE,CAAC,CAAU,EAAE,EAAE,CACvB,OAAO,CAAC,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,EAAE;QACX,WAAW,EAAE;;;;;;;;;;qBAUE;KAChB;CACF,CAAC;KAED,OAAO,CAAC;IACP,SAAS,EAAE;QACT,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,GAAG;QACV,WAAW,EAAE;;;;;;+BAMY;KAC1B;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,GAAG;QACV,WAAW,EAAE;mEACgD;KAC9D;CACF,CAAC;KAED,IAAI,CAAC;IACJ,SAAS,EAAE;QACT,KAAK,EAAE,GAAG;QACV,WAAW,EAAE;;;;;yEAKsD;KACpE;IAED,IAAI,EAAE;QACJ,KAAK,EAAE,GAAG;QACV,WAAW,EAAE;0CACuB;QACpC,OAAO,EAAE,IAAI;KACd;IAED,SAAS,EAAE;QACT,KAAK,EAAE,GAAG;QACV,WAAW,EAAE;uEACoD;KAClE;CACF,CAAC;KAED,GAAG,CAAC;IACH,MAAM,EAAE;QACN,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE;8EAC2D;QACxE,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,CAAU;QAC1C,OAAO,EAAE,SAAS;KACnB;IAED,MAAM,EAAE;QACN,IAAI,EAAE,SAAS;QACf,WAAW,EAAE;;;;;qEAKkD;QAC/D,OAAO,EACL,OAAO,CAAC,GAAG,CAAC,MAAM;YAClB,OAAO,CAAC,GAAG,CAAC,MAAM;YAClB,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;gBAC7B,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,eAAe;gBAC1C,CAAC,CAAC,IAAI,CAAC;KACV;IAED,cAAc,EAAE;QACd,IAAI,EAAE,SAAS;QACf,WAAW,EAAE;;;;;;;;;;;;OAYZ;KACF;IAED,kBAAkB,EAAE;QAClB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE;;;;;;2BAMQ;QACrB,OAAO,EAAE,MAAM;QACf,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC;KAC7C;CACF,CAAC;KAED,GAAG,CAAC;IACH,OAAO,EAAE;QACP,IAAI,EAAE,GAAG;QACT,WAAW,EAAE;;;2DAGwC;KACtD;CACF,CAAC;KAED,GAAG,CAAC;IACH,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE;;;;;;;;;;;;;;;;;;OAkBZ;QACD,YAAY,EAAE;YACZ,OAAO;YACP,MAAM;YACN,SAAS;YACT,KAAK;YACL,SAAS;SACD;KACX;CACF,CAAC;KAED,OAAO,CAAC;IACP,gBAAgB,EAAE;QAChB,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE;iEAC8C;KAC5D;CACF,CAAC;KAED,IAAI,CAAC;IACJ,UAAU,EAAE;QACV,KAAK,EAAE,GAAG;QACV,WAAW,EAAE;oCACiB;KAC/B;IACD,eAAe,EAAE;QACf,KAAK,EAAE,GAAG;QACV,WAAW,EAAE;yCACsB;KACpC;IACD,WAAW,EAAE;QACX,WAAW,EAAE;qCACkB;KAChC;IACD,WAAW,EAAE;QACX,KAAK,EAAE,GAAG;QACV,WAAW,EAAE;;;wEAGqD;KACnE;CACF,CAAC;KAED,GAAG,CAAC;IACH,gBAAgB,EAAE;QAChB,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,CAAC,CAAU,EAAE,EAAE,CACvB,OAAO,CAAC,KAAK,QAAQ,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,WAAW,EAAE;;;;;;;oEAOiD;KAC/D;CACF,CAAC;KAED,IAAI,CAAC;IACJ,GAAG,EAAE;QACH,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,+CAA+C;KAC7D;IACD,OAAO,EAAE;QACP,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,mBAAmB;KACjC;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,2BAA2B;KACzC;CACF,CAAC,CAAA","sourcesContent":["import { XDG } from '@vltpkg/xdg'\nimport { jack } from 'jackspeak'\n\nexport const defaultView = process.stdout.isTTY ? 'human' : 'json'\n\nconst canonicalCommands = {\n  cache: 'cache',\n  config: 'config',\n  exec: 'exec',\n  'exec-local': 'exec-local',\n  gui: 'gui',\n  help: 'help',\n  init: 'init',\n  install: 'install',\n  login: 'login',\n  logout: 'logout',\n  list: 'list',\n  ls: 'ls',\n  pkg: 'pkg',\n  query: 'query',\n  'run-exec': 'run-exec',\n  run: 'run',\n  token: 'token',\n  uninstall: 'uninstall',\n  'exec-cache': 'exec-cache',\n  whoami: 'whoami',\n} as const\n\nconst aliases = {\n  i: 'install',\n  add: 'install',\n  rm: 'uninstall',\n  u: 'uninstall',\n  r: 'run',\n  'run-script': 'run',\n  rx: 'run-exec',\n  x: 'exec',\n  xl: 'exec-local',\n  h: 'help',\n  '?': 'help',\n  conf: 'config',\n  ls: 'list',\n  xc: 'exec-cache',\n} as const\n\n/**\n * Command aliases mapped to their canonical names\n */\nexport const commands = {\n  ...canonicalCommands,\n  ...aliases,\n} as const\n\n/**\n * Canonical command names mapped to an array of its aliases\n */\nexport const commandAliases = Object.entries(aliases).reduce(\n  (acc, [alias, canonical]) => {\n    const commandAliases = acc.get(canonical)\n    if (commandAliases) {\n      commandAliases.push(alias)\n    } else {\n      acc.set(canonical, [alias])\n    }\n    return acc\n  },\n  new Map<string, string[]>(),\n)\n\nexport type Commands = typeof commands\n\nexport const getCommand = (\n  s?: string,\n): Commands[keyof Commands] | undefined =>\n  s && s in commands ? commands[s as keyof Commands] : undefined\n\nconst xdg = new XDG('vlt')\nconst cacheDir = xdg.cache()\n\n/**\n * Fields that are parsed as a set of key=value pairs\n */\nexport const recordFields = [\n  'git-hosts',\n  'registries',\n  'git-host-archives',\n  'scope-registries',\n] as const\n\nexport type RecordField = (typeof recordFields)[number]\n\nexport const isRecordField = (s: string): s is RecordField =>\n  recordFields.includes(s as RecordField)\n\nconst stopParsingCommands: Commands[keyof Commands][] = [\n  'run',\n  'run-exec',\n  'exec-local',\n  'exec',\n]\n\nlet stopParsing: boolean | undefined = undefined\n\nconst j = jack({\n  envPrefix: 'VLT',\n  allowPositionals: true,\n  usage: `vlt [<options>] [<cmd> [<args> ...]]`,\n  stopAtPositionalTest: arg => {\n    if (stopParsing) return true\n    const a = arg as keyof Commands\n    // we stop parsing AFTER the thing, so you can do\n    // vlt run --vlt --configs scriptName --args --for --script\n    // or\n    // vlt exec --vlt --configs command --args --for --command\n    if (stopParsingCommands.includes(commands[a])) {\n      stopParsing = true\n    }\n    return false\n  },\n})\n  .heading('vlt')\n  .description(\n    `More documentation available at <https://docs.vlt.sh>`,\n  )\n  .heading('Subcommands')\n\nj.description(Object.keys(canonicalCommands).join(', '), {\n  pre: true,\n}).description(\n  'Run `vlt <cmd> --help` for more information about a specific command',\n)\n\nexport const definition = j\n  /**\n   * Definition of all configuration values used by vlt.\n   */\n  .heading('Configuration')\n  .description(\n    `If a \\`vlt.json\\` file is present in the root of the current project,\n     then that will be used as a source of configuration information.\n\n     Next, the \\`vlt.json\\` file in the XDG specified config directory\n     will be checked, and loaded for any fields not set in the local project.\n\n     Object type values will be merged together. Set a field to \\`null\\` in\n     the JSON configuration to explicitly remove it.\n\n     Command-specific fields may be set in a nested \\`command\\` object that\n     overrides any options defined at the top level.\n    `,\n  )\n\n  .flag({\n    color: {\n      short: 'c',\n      description: 'Use colors (Default for TTY)',\n    },\n    'no-color': {\n      short: 'C',\n      description: 'Do not use colors (Default for non-TTY)',\n    },\n  })\n\n  .opt({\n    registry: {\n      hint: 'url',\n      default: 'https://registry.npmjs.org/',\n      description: `Sets the registry for fetching packages, when no registry\n                    is explicitly set on a specifier.\n\n                    For example, \\`express@latest\\` will be resolved by looking\n                    up the metadata from this registry.\n\n                    Note that alias specifiers starting with \\`npm:\\` will\n                    still map to \\`https://registry.npmjs.org/\\` if this is\n                    changed, unless the a new mapping is created via the\n                    \\`--registries\\` option.\n      `,\n    },\n  })\n\n  .optList({\n    registries: {\n      hint: 'name=url',\n      description: `Specify named registry hosts by their prefix. To set the\n                    default registry used for non-namespaced specifiers,\n                    use the \\`--registry\\` option.\n\n                    Prefixes can be used as a package alias. For example:\n\n                    \\`\\`\\`\n                    vlt --registries loc=http://reg.local install foo@loc:foo@1.x\n                    \\`\\`\\`\n\n                    By default, the public npm registry is registered to the\n                    \\`npm:\\` prefix. It is not recommended to change this\n                    mapping in most cases.\n                    `,\n    },\n\n    'scope-registries': {\n      hint: '@scope=url',\n      description: `Map package name scopes to registry URLs.\n\n                    For example,\n                    \\`--scope-registries @acme=https://registry.acme/\\`\n                    would tell vlt to fetch any packages named\n                    \\`@acme/...\\` from the \\`https://registry.acme/\\`\n                    registry.\n\n                    Note: this way of specifying registries is more ambiguous,\n                    compared with using the \\`--registries\\` field and explicit\n                    prefixes, because instead of failing when the configuration\n                    is absent, it will instead attempt to fetch from the\n                    default registry.\n\n                    By comparison, using\n                    \\`--registries acme=https://registry.acme/\\` and then\n                    specifying dependencies such as \\`\"foo\": \"acme:foo@1.x\"\\`\n                    means that regardless of the name, the package will be\n                    fetched from the explicitly named registry, or fail if\n                    no registry is defined with that name.\n\n                    However, custom registry aliases are not supported by other\n                    package managers.`,\n    },\n\n    'git-hosts': {\n      hint: `name=template`,\n      short: 'G',\n      description: `Map a shorthand name to a git remote URL template.\n\n                    The \\`template\\` may contain placeholders, which will be\n                    swapped with the relevant values.\n\n                    \\`$1\\`, \\`$2\\`, etc. are replaced with the appropriate\n                    n-th path portion. For example, \\`github:user/project\\`\n                    would replace the \\`$1\\` in the template with \\`user\\`,\n                    and \\`$2\\` with \\`project\\`.`,\n    },\n\n    'git-host-archives': {\n      hint: `name=template`,\n      short: 'A',\n      description: `Similar to the \\`--git-host <name>=<template>\\` option,\n                    this option can define a template string that will be\n                    expanded to provide the URL to download a pre-built\n                    tarball of the git repository.\n\n                    In addition to the n-th path portion expansions performed\n                    by \\`--git-host\\`, this field will also expand the\n                    string \\`$committish\\` in the template, replacing it with\n                    the resolved git committish value to be fetched.`,\n    },\n  })\n\n  .opt({\n    cache: {\n      hint: 'path',\n      description: `\n        Location of the vlt on-disk cache. Defaults to the platform-specific\n        directory recommended by the XDG specification.\n      `,\n      default: cacheDir,\n    },\n    tag: {\n      description: `Default \\`dist-tag\\` to install`,\n      default: 'latest',\n    },\n    before: {\n      hint: 'date',\n      description: `Do not install any packages published after this date`,\n    },\n    os: {\n      description: `The operating system to use as the selector when choosing\n                    packages based on their \\`os\\` value.`,\n      default: process.platform,\n    },\n    arch: {\n      description: `CPU architecture to use as the selector when choosing\n                    packages based on their \\`cpu\\` value.`,\n      default: process.arch,\n    },\n    'node-version': {\n      hint: 'version',\n      description: `Node version to use when choosing packages based on\n                    their \\`engines.node\\` value.`,\n      default: process.version,\n    },\n  })\n\n  .flag({\n    'git-shallow': {\n      description: `Set to force \\`--depth=1\\` on all git clone actions.\n                    When set explicitly to false with --no-git-shallow,\n                    then \\`--depth=1\\` will not be used.\n\n                    When not set explicitly, \\`--depth=1\\` will be used for\n                    git hosts known to support this behavior.`,\n    },\n  })\n  .num({\n    'fetch-retries': {\n      hint: 'n',\n      description: `Number of retries to perform when encountering network\n                    errors or likely-transient errors from git hosts.`,\n      default: 3,\n    },\n    'fetch-retry-factor': {\n      hint: 'n',\n      description: `The exponential backoff factor to use when retrying\n                    requests due to network issues.`,\n      default: 2,\n    },\n    'fetch-retry-mintimeout': {\n      hint: 'n',\n      description: `Number of milliseconds before starting first retry`,\n      default: 0,\n    },\n    'fetch-retry-maxtimeout': {\n      hint: 'n',\n      description: `Maximum number of milliseconds between two retries`,\n      default: 30_000,\n    },\n    'stale-while-revalidate-factor': {\n      hint: 'n',\n      default: 60,\n      description: `If the server does not serve a \\`stale-while-revalidate\\`\n                    value in the \\`cache-control\\` header, then this multiplier\n                    is applied to the \\`max-age\\` or \\`s-maxage\\` values.\n\n                    By default, this is \\`60\\`, so for example a response that\n                    is cacheable for 5 minutes will allow a stale response\n                    while revalidating for up to 5 hours.\n\n                    If the server *does* provide a \\`stale-while-revalidate\\`\n                    value, then that is always used.\n\n                    Set to 0 to prevent any \\`stale-while-revalidate\\` behavior\n                    unless explicitly allowed by the server's \\`cache-control\\`\n                    header.\n      `,\n    },\n  })\n\n  .opt({\n    identity: {\n      short: 'i',\n      validate: (v: unknown) =>\n        typeof v === 'string' && /^[a-z0-9]*$/.test(v),\n      hint: 'name',\n      default: '',\n      description: `Provide a string to define an identity for storing auth\n                    information when logging into registries.\n\n                    Authentication tokens will be stored in the XDG data\n                    directory, in \\`vlt/auth/$\\{identity}/keychain.json\\`.\n\n                    If no identity is provided, then the default \\`''\\` will\n                    be used, storing the file at \\`vlt/auth/keychain.json\\`.\n\n                    May only contain lowercase alphanumeric characters.\n                    `,\n    },\n  })\n\n  .optList({\n    workspace: {\n      hint: 'ws',\n      short: 'w',\n      description: `Set to limit the spaces being worked on when working on\n                    workspaces.\n\n                    Can be paths or glob patterns matching paths.\n\n                    Specifying workspaces by package.json name is not\n                    supported.`,\n    },\n    'workspace-group': {\n      short: 'g',\n      description: `Specify named workspace group names to load and operate on\n                    when doing recursive operations on workspaces.`,\n    },\n  })\n\n  .flag({\n    recursive: {\n      short: 'r',\n      description: `Run an operation across multiple workspaces.\n\n                    No effect when used in non-monorepo projects.\n\n                    Implied by setting --workspace or --workspace-group. If\n                    not set, then the action is run on the project root.`,\n    },\n\n    bail: {\n      short: 'b',\n      description: `When running scripts across multiple workspaces, stop\n                    on the first failure.`,\n      default: true,\n    },\n\n    'no-bail': {\n      short: 'B',\n      description: `When running scripts across multiple workspaces, continue\n                    on failure, running the script for all workspaces.`,\n    },\n  })\n\n  .opt({\n    config: {\n      hint: 'user | project',\n      description: `Specify whether to operate on user-level or project-level\n                    configuration files when running \\`vlt config\\` commands.`,\n      validOptions: ['user', 'project'] as const,\n      default: 'project',\n    },\n\n    editor: {\n      hint: 'program',\n      description: `The blocking editor to use for \\`vlt config edit\\` and\n                    any other cases where a file should be opened for\n                    editing.\n\n                    Defaults to the \\`EDITOR\\` or \\`VISUAL\\` env if set, or\n                    \\`notepad.exe\\` on Windows, or \\`vi\\` elsewhere.`,\n      default:\n        process.env.EDITOR ||\n        process.env.VISUAL ||\n        (process.platform === 'win32' ?\n          `${process.env.SYSTEMROOT}\\\\notepad.exe`\n        : 'vi'),\n    },\n\n    'script-shell': {\n      hint: 'program',\n      description: `The shell to use when executing \\`package.json#scripts\\`.\n\n                    For \\`vlt exec\\` and \\`vlt exec-local\\`, this is never set,\n                    meaning that command arguments are run exactly as provided.\n\n                    For \\`vlt run\\` (and other things that run lifecycle\n                    scripts in \\`package.json#scripts\\`), the entire command\n                    with all arguments is provided as a single string, meaning\n                    that some value must be provided for shell interpretation,\n                    and so for these contexts, the \\`script-shell\\` value will\n                    default to \\`/bin/sh\\` on POSIX systems or \\`cmd.exe\\` on\n                    Windows.\n      `,\n    },\n\n    'fallback-command': {\n      hint: 'command',\n      description: `The command to run when the first argument doesn't\n                    match any known commands.\n\n                    For pnpm-style behavior, set this to 'run-exec'. e.g:\n                    \\`\\`\\`\n                    vlt config set fallback-command=run-exec\n                    \\`\\`\\``,\n      default: 'help',\n      validOptions: Object.keys(canonicalCommands),\n    },\n  })\n\n  .opt({\n    package: {\n      hint: 'p',\n      description: `When running \\`vlt exec\\`, this allows you to explicitly\n                    set the package to search for bins. If not provided, then\n                    vlt will interpret the first argument as the package, and\n                    attempt to run the default executable.`,\n    },\n  })\n\n  .opt({\n    view: {\n      hint: 'output',\n      default: defaultView,\n      description: `Configures the output format for commands.\n\n                    Defaults to \\`human\\` if stdout is a TTY, or \\`json\\`\n                    if it is not.\n\n                    - human: Maximally ergonomic output reporting for human\n                      consumption.\n                    - json: Parseable JSON output for machines.\n                    - inspect: Output results with \\`util.inspect\\`.\n                    - gui: Start a local web server and opens a browser to\n                      explore the results. (Only relevant for certain\n                      commands.)\n                    - mermaid: Output mermaid diagramming syntax. (Only\n                      relevant for certain commands.)\n\n                    If the requested view format is not supported for the\n                    current command, or if no option is provided, then it\n                    will fall back to the default.\n      `,\n      validOptions: [\n        'human',\n        'json',\n        'mermaid',\n        'gui',\n        'inspect',\n      ] as const,\n    },\n  })\n\n  .optList({\n    'dashboard-root': {\n      hint: 'path',\n      description: `The root directory to use for the dashboard GUI.\n                    If not set, the user home directory is used.`,\n    },\n  })\n\n  .flag({\n    'save-dev': {\n      short: 'D',\n      description: `Save installed packages to a package.json file as\n                    devDependencies`,\n    },\n    'save-optional': {\n      short: 'O',\n      description: `Save installed packages to a package.json file as\n                    optionalDependencies`,\n    },\n    'save-peer': {\n      description: `Save installed packages to a package.json file as\n                    peerDependencies`,\n    },\n    'save-prod': {\n      short: 'P',\n      description: `Save installed packages into dependencies specifically.\n                    This is useful if a package already exists in\n                    devDependencies or optionalDependencies, but you want to\n                    move it to be a non-optional production dependency.`,\n    },\n  })\n\n  .opt({\n    'expect-results': {\n      hint: 'value',\n      validate: (v: unknown) =>\n        typeof v === 'string' && /^([<>]=?)?[0-9]+$/.test(v),\n      description: `When running \\`vlt query\\`, this option allows you to\n                    set a expected number of resulting items.\n\n                    Accepted values are numbers and strings.\n\n                    Strings starting with \\`>\\`, \\`<\\`, \\`>=\\` or \\`<=\\`\n                    followed by a number can be used to check if the result\n                    is greater than or less than a specific number.`,\n    },\n  })\n\n  .flag({\n    yes: {\n      short: 'y',\n      description: `Automatically accept any confirmation prompts`,\n    },\n    version: {\n      short: 'v',\n      description: 'Print the version',\n    },\n    help: {\n      short: 'h',\n      description: 'Print helpful information',\n    },\n  })\n"]}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/config/definition.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { XDG } from '@vltpkg/xdg'\nimport { jack } from 'jackspeak'\n\nexport const defaultView = process.stdout.isTTY ? 'human' : 'json'\n\nexport const defaultEditor = () =>\n  process.env.EDITOR ||\n  process.env.VISUAL ||\n  (process.platform === 'win32' ?\n    `${process.env.SYSTEMROOT}\\\\notepad.exe`\n  : 'vi')\n\nconst canonicalCommands = {\n  cache: 'cache',\n  config: 'config',\n  exec: 'exec',\n  'exec-local': 'exec-local',\n  gui: 'gui',\n  help: 'help',\n  init: 'init',\n  install: 'install',\n  login: 'login',\n  logout: 'logout',\n  list: 'list',\n  ls: 'ls',\n  pkg: 'pkg',\n  query: 'query',\n  'run-exec': 'run-exec',\n  run: 'run',\n  token: 'token',\n  uninstall: 'uninstall',\n  'exec-cache': 'exec-cache',\n  whoami: 'whoami',\n} as const\n\nconst aliases = {\n  i: 'install',\n  add: 'install',\n  rm: 'uninstall',\n  u: 'uninstall',\n  r: 'run',\n  'run-script': 'run',\n  rx: 'run-exec',\n  x: 'exec',\n  xl: 'exec-local',\n  h: 'help',\n  '?': 'help',\n  conf: 'config',\n  ls: 'list',\n  xc: 'exec-cache',\n} as const\n\n/**\n * Command aliases mapped to their canonical names\n */\nexport const commands = {\n  ...canonicalCommands,\n  ...aliases,\n} as const\n\n/**\n * Canonical command names mapped to an array of its aliases\n */\nexport const commandAliases = Object.entries(aliases).reduce(\n  (acc, [alias, canonical]) => {\n    const commandAliases = acc.get(canonical)\n    if (commandAliases) {\n      commandAliases.push(alias)\n    } else {\n      acc.set(canonical, [alias])\n    }\n    return acc\n  },\n  new Map<string, string[]>(),\n)\n\nexport type Commands = typeof commands\n\nexport const getCommand = (\n  s?: string,\n): Commands[keyof Commands] | undefined =>\n  s && s in commands ? commands[s as keyof Commands] : undefined\n\nconst xdg = new XDG('vlt')\nconst cacheDir = xdg.cache()\n\n/**\n * Fields that are parsed as a set of key=value pairs\n */\nexport const recordFields = [\n  'git-hosts',\n  'registries',\n  'git-host-archives',\n  'scope-registries',\n  'jsr-registries',\n] as const\n\nexport type RecordField = (typeof recordFields)[number]\n\nexport const isRecordField = (s: string): s is RecordField =>\n  recordFields.includes(s as RecordField)\n\nconst stopParsingCommands: Commands[keyof Commands][] = [\n  'run',\n  'run-exec',\n  'exec-local',\n  'exec',\n]\n\nlet stopParsing: boolean | undefined = undefined\n\nconst j = jack({\n  envPrefix: 'VLT',\n  allowPositionals: true,\n  usage: `vlt [<options>] [<cmd> [<args> ...]]`,\n  stopAtPositionalTest: arg => {\n    if (stopParsing) return true\n    const a = arg as keyof Commands\n    // we stop parsing AFTER the thing, so you can do\n    // vlt run --vlt --configs scriptName --args --for --script\n    // or\n    // vlt exec --vlt --configs command --args --for --command\n    if (stopParsingCommands.includes(commands[a])) {\n      stopParsing = true\n    }\n    return false\n  },\n})\n  .heading('vlt')\n  .description(\n    `More documentation available at <https://docs.vlt.sh>`,\n  )\n  .heading('Subcommands')\n\nj.description(Object.keys(canonicalCommands).join(', '), {\n  pre: true,\n}).description(\n  'Run `vlt <cmd> --help` for more information about a specific command',\n)\n\nexport const definition = j\n  /**\n   * Definition of all configuration values used by vlt.\n   */\n  .heading('Configuration')\n  .description(\n    `If a \\`vlt.json\\` file is present in the root of the current project,\n     then that will be used as a source of configuration information.\n\n     Next, the \\`vlt.json\\` file in the XDG specified config directory\n     will be checked, and loaded for any fields not set in the local project.\n\n     Object type values will be merged together. Set a field to \\`null\\` in\n     the JSON configuration to explicitly remove it.\n\n     Command-specific fields may be set in a nested \\`command\\` object that\n     overrides any options defined at the top level.\n    `,\n  )\n\n  .flag({\n    color: {\n      short: 'c',\n      description: 'Use colors (Default for TTY)',\n    },\n    'no-color': {\n      short: 'C',\n      description: 'Do not use colors (Default for non-TTY)',\n    },\n  })\n\n  .opt({\n    registry: {\n      hint: 'url',\n      default: 'https://registry.npmjs.org/',\n      description: `Sets the registry for fetching packages, when no registry\n                    is explicitly set on a specifier.\n\n                    For example, \\`express@latest\\` will be resolved by looking\n                    up the metadata from this registry.\n\n                    Note that alias specifiers starting with \\`npm:\\` will\n                    still map to \\`https://registry.npmjs.org/\\` if this is\n                    changed, unless the a new mapping is created via the\n                    \\`--registries\\` option.\n      `,\n    },\n  })\n\n  .optList({\n    registries: {\n      hint: 'name=url',\n      description: `Specify named registry hosts by their prefix. To set the\n                    default registry used for non-namespaced specifiers,\n                    use the \\`--registry\\` option.\n\n                    Prefixes can be used as a package alias. For example:\n\n                    \\`\\`\\`\n                    vlt --registries loc=http://reg.local install foo@loc:foo@1.x\n                    \\`\\`\\`\n\n                    By default, the public npm registry is registered to the\n                    \\`npm:\\` prefix. It is not recommended to change this\n                    mapping in most cases.\n                    `,\n    },\n\n    'scope-registries': {\n      hint: '@scope=url',\n      description: `Map package name scopes to registry URLs.\n\n                    For example,\n                    \\`--scope-registries @acme=https://registry.acme/\\`\n                    would tell vlt to fetch any packages named\n                    \\`@acme/...\\` from the \\`https://registry.acme/\\`\n                    registry.\n\n                    Note: this way of specifying registries is more ambiguous,\n                    compared with using the \\`--registries\\` field and explicit\n                    prefixes, because instead of failing when the configuration\n                    is absent, it will instead attempt to fetch from the\n                    default registry.\n\n                    By comparison, using\n                    \\`--registries acme=https://registry.acme/\\` and then\n                    specifying dependencies such as \\`\"foo\": \"acme:foo@1.x\"\\`\n                    means that regardless of the name, the package will be\n                    fetched from the explicitly named registry, or fail if\n                    no registry is defined with that name.\n\n                    However, custom registry aliases are not supported by other\n                    package managers.`,\n    },\n\n    'jsr-registries': {\n      hint: 'name=url',\n      description: `Map alias names to JSR.io registry urls.\n\n                    For example,\n                    \\`--jsr-registries acme=https://jsr.acme.io/\\` would\n                    tell vlt to fetch any packages with the \\`acme:\\` registry\n                    prefix from the \\`https://jsr.acme.io/\\` registry, using\n                    the \"npm Compatibility\" translation. So for example,\n                    the package \\`acme:@foo/bar\\` would fetch the\n                    \\`@jsr/foo__bar\\` package from the \\`jsr.acme.io\\`\n                    registry.\n\n                    By default the \\`jsr\\` alias is always mapped to\n                    \\`https://npm.jsr.io/\\`, so existing \\`jsr:\\` packages will\n                    be fetched from the public \\`jsr\\` registry appropriately.\n                   `,\n    },\n\n    'git-hosts': {\n      hint: `name=template`,\n      short: 'G',\n      description: `Map a shorthand name to a git remote URL template.\n\n                    The \\`template\\` may contain placeholders, which will be\n                    swapped with the relevant values.\n\n                    \\`$1\\`, \\`$2\\`, etc. are replaced with the appropriate\n                    n-th path portion. For example, \\`github:user/project\\`\n                    would replace the \\`$1\\` in the template with \\`user\\`,\n                    and \\`$2\\` with \\`project\\`.`,\n    },\n\n    'git-host-archives': {\n      hint: `name=template`,\n      short: 'A',\n      description: `Similar to the \\`--git-host <name>=<template>\\` option,\n                    this option can define a template string that will be\n                    expanded to provide the URL to download a pre-built\n                    tarball of the git repository.\n\n                    In addition to the n-th path portion expansions performed\n                    by \\`--git-host\\`, this field will also expand the\n                    string \\`$committish\\` in the template, replacing it with\n                    the resolved git committish value to be fetched.`,\n    },\n  })\n\n  .opt({\n    cache: {\n      hint: 'path',\n      description: `\n        Location of the vlt on-disk cache. Defaults to the platform-specific\n        directory recommended by the XDG specification.\n      `,\n      default: cacheDir,\n    },\n    tag: {\n      description: `Default \\`dist-tag\\` to install`,\n      default: 'latest',\n    },\n    before: {\n      hint: 'date',\n      description: `Do not install any packages published after this date`,\n    },\n    os: {\n      description: `The operating system to use as the selector when choosing\n                    packages based on their \\`os\\` value.`,\n      default: process.platform,\n    },\n    arch: {\n      description: `CPU architecture to use as the selector when choosing\n                    packages based on their \\`cpu\\` value.`,\n      default: process.arch,\n    },\n    'node-version': {\n      hint: 'version',\n      description: `Node version to use when choosing packages based on\n                    their \\`engines.node\\` value.`,\n      default: process.version,\n    },\n  })\n\n  .flag({\n    'git-shallow': {\n      description: `Set to force \\`--depth=1\\` on all git clone actions.\n                    When set explicitly to false with --no-git-shallow,\n                    then \\`--depth=1\\` will not be used.\n\n                    When not set explicitly, \\`--depth=1\\` will be used for\n                    git hosts known to support this behavior.`,\n    },\n  })\n  .num({\n    'fetch-retries': {\n      hint: 'n',\n      description: `Number of retries to perform when encountering network\n                    errors or likely-transient errors from git hosts.`,\n      default: 3,\n    },\n    'fetch-retry-factor': {\n      hint: 'n',\n      description: `The exponential backoff factor to use when retrying\n                    requests due to network issues.`,\n      default: 2,\n    },\n    'fetch-retry-mintimeout': {\n      hint: 'n',\n      description: `Number of milliseconds before starting first retry`,\n      default: 0,\n    },\n    'fetch-retry-maxtimeout': {\n      hint: 'n',\n      description: `Maximum number of milliseconds between two retries`,\n      default: 30_000,\n    },\n    'stale-while-revalidate-factor': {\n      hint: 'n',\n      default: 60,\n      description: `If the server does not serve a \\`stale-while-revalidate\\`\n                    value in the \\`cache-control\\` header, then this multiplier\n                    is applied to the \\`max-age\\` or \\`s-maxage\\` values.\n\n                    By default, this is \\`60\\`, so for example a response that\n                    is cacheable for 5 minutes will allow a stale response\n                    while revalidating for up to 5 hours.\n\n                    If the server *does* provide a \\`stale-while-revalidate\\`\n                    value, then that is always used.\n\n                    Set to 0 to prevent any \\`stale-while-revalidate\\` behavior\n                    unless explicitly allowed by the server's \\`cache-control\\`\n                    header.\n      `,\n    },\n  })\n\n  .opt({\n    identity: {\n      short: 'i',\n      validate: (v: unknown) =>\n        typeof v === 'string' && /^[a-z0-9]*$/.test(v),\n      hint: 'name',\n      default: '',\n      description: `Provide a string to define an identity for storing auth\n                    information when logging into registries.\n\n                    Authentication tokens will be stored in the XDG data\n                    directory, in \\`vlt/auth/$\\{identity}/keychain.json\\`.\n\n                    If no identity is provided, then the default \\`''\\` will\n                    be used, storing the file at \\`vlt/auth/keychain.json\\`.\n\n                    May only contain lowercase alphanumeric characters.\n                    `,\n    },\n  })\n\n  .optList({\n    workspace: {\n      hint: 'ws',\n      short: 'w',\n      description: `Set to limit the spaces being worked on when working on\n                    workspaces.\n\n                    Can be paths or glob patterns matching paths.\n\n                    Specifying workspaces by package.json name is not\n                    supported.`,\n    },\n    'workspace-group': {\n      short: 'g',\n      description: `Specify named workspace group names to load and operate on\n                    when doing recursive operations on workspaces.`,\n    },\n  })\n\n  .flag({\n    recursive: {\n      short: 'r',\n      description: `Run an operation across multiple workspaces.\n\n                    No effect when used in non-monorepo projects.\n\n                    Implied by setting --workspace or --workspace-group. If\n                    not set, then the action is run on the project root.`,\n    },\n\n    bail: {\n      short: 'b',\n      description: `When running scripts across multiple workspaces, stop\n                    on the first failure.`,\n      default: true,\n    },\n\n    'no-bail': {\n      short: 'B',\n      description: `When running scripts across multiple workspaces, continue\n                    on failure, running the script for all workspaces.`,\n    },\n  })\n\n  .opt({\n    config: {\n      hint: 'user | project',\n      description: `Specify whether to operate on user-level or project-level\n                    configuration files when running \\`vlt config\\` commands.`,\n      validOptions: ['user', 'project'] as const,\n      default: 'project',\n    },\n\n    editor: {\n      hint: 'program',\n      description: `The blocking editor to use for \\`vlt config edit\\` and\n                    any other cases where a file should be opened for\n                    editing.\n\n                    Defaults to the \\`EDITOR\\` or \\`VISUAL\\` env if set, or\n                    \\`notepad.exe\\` on Windows, or \\`vi\\` elsewhere.`,\n      default: defaultEditor(),\n    },\n\n    'script-shell': {\n      hint: 'program',\n      description: `The shell to use when executing \\`package.json#scripts\\`.\n\n                    For \\`vlt exec\\` and \\`vlt exec-local\\`, this is never set,\n                    meaning that command arguments are run exactly as provided.\n\n                    For \\`vlt run\\` (and other things that run lifecycle\n                    scripts in \\`package.json#scripts\\`), the entire command\n                    with all arguments is provided as a single string, meaning\n                    that some value must be provided for shell interpretation,\n                    and so for these contexts, the \\`script-shell\\` value will\n                    default to \\`/bin/sh\\` on POSIX systems or \\`cmd.exe\\` on\n                    Windows.\n      `,\n    },\n\n    'fallback-command': {\n      hint: 'command',\n      description: `The command to run when the first argument doesn't\n                    match any known commands.\n\n                    For pnpm-style behavior, set this to 'run-exec'. e.g:\n                    \\`\\`\\`\n                    vlt config set fallback-command=run-exec\n                    \\`\\`\\``,\n      default: 'help',\n      validOptions: Object.keys(canonicalCommands),\n    },\n  })\n\n  .opt({\n    package: {\n      hint: 'p',\n      description: `When running \\`vlt exec\\`, this allows you to explicitly\n                    set the package to search for bins. If not provided, then\n                    vlt will interpret the first argument as the package, and\n                    attempt to run the default executable.`,\n    },\n  })\n\n  .opt({\n    view: {\n      hint: 'output',\n      default: defaultView,\n      description: `Configures the output format for commands.\n\n                    Defaults to \\`human\\` if stdout is a TTY, or \\`json\\`\n                    if it is not.\n\n                    - human: Maximally ergonomic output reporting for human\n                      consumption.\n                    - json: Parseable JSON output for machines.\n                    - inspect: Output results with \\`util.inspect\\`.\n                    - gui: Start a local web server and opens a browser to\n                      explore the results. (Only relevant for certain\n                      commands.)\n                    - mermaid: Output mermaid diagramming syntax. (Only\n                      relevant for certain commands.)\n\n                    If the requested view format is not supported for the\n                    current command, or if no option is provided, then it\n                    will fall back to the default.\n      `,\n      validOptions: [\n        'human',\n        'json',\n        'mermaid',\n        'gui',\n        'inspect',\n      ] as const,\n    },\n  })\n\n  .optList({\n    'dashboard-root': {\n      hint: 'path',\n      description: `The root directory to use for the dashboard GUI.\n                    If not set, the user home directory is used.`,\n    },\n  })\n\n  .flag({\n    'save-dev': {\n      short: 'D',\n      description: `Save installed packages to a package.json file as\n                    devDependencies`,\n    },\n    'save-optional': {\n      short: 'O',\n      description: `Save installed packages to a package.json file as\n                    optionalDependencies`,\n    },\n    'save-peer': {\n      description: `Save installed packages to a package.json file as\n                    peerDependencies`,\n    },\n    'save-prod': {\n      short: 'P',\n      description: `Save installed packages into dependencies specifically.\n                    This is useful if a package already exists in\n                    devDependencies or optionalDependencies, but you want to\n                    move it to be a non-optional production dependency.`,\n    },\n  })\n\n  .opt({\n    'expect-results': {\n      hint: 'value',\n      validate: (v: unknown) =>\n        typeof v === 'string' && /^([<>]=?)?[0-9]+$/.test(v),\n      description: `When running \\`vlt query\\`, this option allows you to\n                    set a expected number of resulting items.\n\n                    Accepted values are numbers and strings.\n\n                    Strings starting with \\`>\\`, \\`<\\`, \\`>=\\` or \\`<=\\`\n                    followed by a number can be used to check if the result\n                    is greater than or less than a specific number.`,\n    },\n  })\n\n  .flag({\n    yes: {\n      short: 'y',\n      description: `Automatically accept any confirmation prompts`,\n    },\n    version: {\n      short: 'v',\n      description: 'Print the version',\n    },\n    help: {\n      short: 'h',\n      description: 'Print helpful information',\n    },\n  })\n\nexport const getSortedCliOptions = () => {\n  const defs = definition.toJSON()\n  return getSortedKeys().map((k: keyof typeof defs) => {\n    const def = defs[k]\n    /* c8 ignore next */\n    if (!def) throw error('invalid key found', { found: k })\n    if (def.type === 'boolean') return `--${k}`\n    return `--${k}=<${def.hint ?? k}>`\n  })\n}\n\nexport const getSortedKeys = () =>\n  Object.keys(definition.toJSON()).sort((a, b) => a.localeCompare(b))\n"]}