@vltpkg/cli-js 1.0.0-rc.32 → 1.0.0-rc.34

package/{chunk-NLFBANVO.js → chunk-Y7CQIZ7Y.js}

@@ -14,7 +14,10 @@ import {
 } from "./chunk-WGDTG44V.js";
 import {
   loadPackageJson
-} from "./chunk-2V4AQPBR.js";
+} from "./chunk-E74WGW5C.js";
+import {
+  commandAliases
+} from "./chunk-WP6CYBPM.js";
 
 // ../../src/cli-sdk/src/custom-help.ts
 var { version } = loadPackageJson(
@@ -58,235 +61,182 @@ var makeStyler = (colors) => {
     return styledText;
   };
 };
-var allCommands = [
-  {
-    name: "bugs",
-    aliases: [],
+var commandHelp = {
+  access: {
+    args: "<command> [<args>]",
+    desc: "Manage package access and team permissions"
+  },
+  bugs: {
     args: "[<spec>]",
-    desc: "Open the bug tracker for a package",
-    showByDefault: false
+    desc: "Open the bug tracker for a package"
   },
-  {
-    name: "build",
-    aliases: ["b"],
+  build: {
     args: "<selector>",
     desc: "Build packages with lifecycle scripts",
-    showByDefault: true,
     defaultOrder: 4
   },
-  {
-    name: "cache",
-    aliases: [],
+  cache: {
     args: "[add|ls|info|clean|delete|delete-before|delete-all]",
-    desc: "Manage the package cache",
-    showByDefault: false
+    desc: "Manage the package cache"
   },
-  {
-    name: "ci",
-    aliases: [],
+  ci: {
     args: "",
-    desc: "Clean install (frozen lockfile)",
-    showByDefault: false
+    desc: "Clean install (frozen lockfile)"
   },
-  {
-    name: "config",
-    aliases: [],
+  config: {
     args: "[get|pick|list|set|delete|edit|location]",
-    desc: "Get or set configuration",
-    showByDefault: false
+    desc: "Get or set configuration"
   },
-  {
-    name: "create",
-    aliases: [],
+  create: {
     args: "<initializer> [args...]",
-    desc: "Create a new project from a template",
-    showByDefault: false
+    desc: "Create a new project from a template"
+  },
+  deprecate: {
+    args: "<pkg>[@<version>] <message>",
+    desc: "Deprecate a package or version range"
   },
-  {
-    name: "docs",
-    aliases: [],
+  "dist-tag": {
+    args: "[add|rm|ls] [<args>]",
+    desc: "Manage package distribution tags"
+  },
+  docs: {
     args: "",
-    desc: "Open the docs of the current project",
-    showByDefault: false
+    desc: "Open the docs of the current project"
   },
-  {
-    name: "exec",
-    aliases: ["x"],
+  exec: {
     args: "<executable>",
     desc: "Execute a package bin",
-    showByDefault: true,
     defaultOrder: 6
   },
-  {
-    name: "exec-cache",
-    aliases: ["xc"],
+  "exec-cache": {
     args: "[ls|delete|info|install]",
-    desc: "Manage the exec cache",
-    showByDefault: false
+    desc: "Manage the exec cache"
   },
-  {
-    name: "exec-local",
-    aliases: ["xl"],
+  "exec-local": {
     args: "<command>",
-    desc: "Execute a local package bin",
-    showByDefault: false
+    desc: "Execute a local package bin"
   },
-  {
-    name: "help",
-    aliases: ["h", "?"],
+  help: {
     args: "[<command>]",
-    desc: "Show help for a command",
-    showByDefault: false
+    desc: "Show help for a command"
   },
-  {
-    name: "init",
-    aliases: [],
+  init: {
     args: "",
     desc: "Initialize a new project",
-    showByDefault: true,
     defaultOrder: 1
   },
-  {
-    name: "install",
-    aliases: ["i", "add"],
+  install: {
     args: "[<package>...]",
     desc: "Install dependencies",
-    showByDefault: true,
     defaultOrder: 2
   },
-  {
-    name: "list",
-    aliases: ["ls"],
+  list: {
     args: "",
-    desc: "List installed packages",
-    showByDefault: false
+    desc: "List installed packages"
   },
-  {
-    name: "login",
-    aliases: [],
+  login: {
     args: "",
-    desc: "Authenticate with a registry",
-    showByDefault: false
+    desc: "Authenticate with a registry"
   },
-  {
-    name: "logout",
-    aliases: [],
+  logout: {
     args: "",
-    desc: "Log out from a registry",
-    showByDefault: false
+    desc: "Log out from a registry"
   },
-  {
-    name: "pack",
-    aliases: [],
+  pack: {
     args: "",
-    desc: "Create a tarball from a package",
-    showByDefault: false
+    desc: "Create a tarball from a package"
   },
-  {
-    name: "ping",
-    aliases: [],
+  ping: {
     args: "[<registry-alias>]",
-    desc: "Ping configured registries",
-    showByDefault: false
+    desc: "Ping configured registries"
   },
-  {
-    name: "pkg",
-    aliases: ["p"],
+  pkg: {
     args: "<command>",
     desc: "Manage package metadata",
-    showByDefault: true,
     defaultOrder: 7
   },
-  {
-    name: "publish",
-    aliases: ["pub"],
+  profile: {
+    args: "<command> [<args>]",
+    desc: "Get or set registry profile properties"
+  },
+  publish: {
     args: "",
     desc: "Publish package to registry",
-    showByDefault: true,
     defaultOrder: 8
   },
-  {
-    name: "query",
-    aliases: ["q"],
+  query: {
     args: "<selector>",
     desc: "Query for packages in the project",
-    showByDefault: true,
     defaultOrder: 3
   },
-  {
-    name: "repo",
-    aliases: [],
+  registry: {
+    args: "<alias> <command>",
+    desc: "Run an account command against a named registry",
+    defaultOrder: 9
+  },
+  repo: {
     args: "[<spec>]",
-    desc: "Open the repository page for a package",
-    showByDefault: false
+    desc: "Open the repository page for a package"
   },
-  {
-    name: "run",
-    aliases: ["r"],
+  run: {
     args: "<script>",
     desc: "Run a script defined in package.json",
-    showByDefault: true,
     defaultOrder: 5
   },
-  {
-    name: "run-exec",
-    aliases: ["rx"],
+  "run-exec": {
     args: "<script>",
-    desc: "Run a script &/or fallback to executing a binary",
-    showByDefault: false
+    desc: "Run a script &/or fallback to executing a binary"
   },
-  {
-    name: "token",
-    aliases: [],
+  setup: {
+    args: "[<account>]",
+    desc: "Configure your vlt.io account registries",
+    defaultOrder: 0
+  },
+  token: {
     args: "[add|rm]",
-    desc: "Manage authentication tokens",
-    showByDefault: false
+    desc: "Manage authentication tokens"
   },
-  {
-    name: "uninstall",
-    aliases: ["rm"],
+  uninstall: {
     args: "[<package>...]",
-    desc: "Remove dependencies",
-    showByDefault: false
+    desc: "Remove dependencies"
   },
-  {
-    name: "unpublish",
-    aliases: [],
+  unpublish: {
     args: "<pkg>[@<version>]",
-    desc: "Remove a package from the registry",
-    showByDefault: false
+    desc: "Remove a package from the registry"
   },
-  {
-    name: "update",
-    aliases: ["u"],
+  update: {
     args: "",
-    desc: "Update package versions to latest in-range",
-    showByDefault: false
+    desc: "Update package versions to latest in-range"
   },
-  {
-    name: "version",
-    aliases: [],
+  version: {
     args: "<increment>",
-    desc: "Bump package version",
-    showByDefault: false
+    desc: "Bump package version"
+  },
+  view: {
+    args: "<pkg>[@<version>] [<field>]",
+    desc: "View registry information about a package"
   },
-  {
-    name: "whoami",
-    aliases: [],
+  whoami: {
     args: "",
-    desc: "Display the current user",
-    showByDefault: false
+    desc: "Display the current user"
   }
-];
+};
+var allCommands = Object.entries(commandHelp).map(
+  ([name, metadata]) => ({
+    name,
+    aliases: commandAliases.get(name) ?? [],
+    ...metadata
+  })
+);
 var generateDefaultHelp = (colors = false) => {
   const s = makeStyler(colors);
-  const defaultCommands = allCommands.filter((cmd) => cmd.showByDefault).sort((a, b) => (a.defaultOrder || 0) - (b.defaultOrder || 0));
+  const defaultCommands = allCommands.filter((cmd) => cmd.defaultOrder !== void 0).sort((a, b) => (a.defaultOrder ?? 0) - (b.defaultOrder ?? 0));
   const commandsSection = defaultCommands.map((cmd) => {
     const firstAlias = cmd.aliases.length > 0 ? cmd.aliases[0] : "";
     const aliasColumn = firstAlias ? (firstAlias + ", ").padEnd(5) : "     ";
     const nameColumn = cmd.name.padEnd(10);
     const argsColumn = cmd.args.padEnd(16);
-    return `  ${s("dim", aliasColumn)}${s(["yellow", "bold"], nameColumn)}${s("dim", argsColumn)}${cmd.desc}`;
+    return `  ${s("dim", aliasColumn)}${s(["yellow", "bold"], nameColumn)}${s("dim", argsColumn)} ${cmd.desc}`;
   }).join("\n");
   return `${s(["bold"], "\u26A1\uFE0F vlt")} ${s("dim", "/v\u014Dlt/")} next-gen package management ${s("dim", `v${version}`)}
 
@@ -319,6 +269,12 @@ var generateFullHelp = (colors = false) => {
   const commands = [...allCommands].sort(
     (a, b) => a.name.localeCompare(b.name)
   );
+  const aliasLabels = commands.map(
+    (cmd) => cmd.aliases.length ? `${cmd.aliases.join(", ")},` : ""
+  );
+  const aliasWidth = Math.max(
+    ...aliasLabels.map((label) => label.length)
+  );
   const flags = [
     {
       shorts: ["a"],
@@ -348,7 +304,7 @@ var generateFullHelp = (colors = false) => {
       shorts: [],
       long: "registry",
       args: "<url>",
-      desc: "Override default registry"
+      desc: "Set the registry to resolve packages against"
     },
     {
       shorts: ["v"],
@@ -370,11 +326,11 @@ var generateFullHelp = (colors = false) => {
     if (firstLetter !== lastFirstLetter && index > 0) {
       commandsSection += "\n";
     }
-    const aliasColumn = cmd.aliases.length > 0 ? (cmd.aliases.join(", ") + ", ").padEnd(9) : "         ";
+    const aliasColumn = aliasLabels[index]?.padEnd(aliasWidth) ?? "";
     const nameColumn = cmd.name.padEnd(12);
     const truncatedArgs = cmd.args.length > 16 ? cmd.args.substring(0, 13) + "..." : cmd.args;
     const argsColumn = truncatedArgs.padEnd(16);
-    commandsSection += `${s("dim", aliasColumn)}${s(["yellow", "bold"], nameColumn)}${s("dim", argsColumn)}${cmd.desc}`;
+    commandsSection += `  ${s("dim", aliasColumn)} ${s(["yellow", "bold"], nameColumn)} ${s("dim", argsColumn)} ${cmd.desc}`;
     if (index < commands.length - 1) {
       commandsSection += "\n";
     }

package/{ci-FQJANSQW.js → ci-MTYU2K2A.js}

@@ -11,29 +11,32 @@ import {createRequire as _vlt_createRequire} from "node:module";
 var require = _vlt_createRequire(import.meta.filename);
 import {
   InstallReporter
-} from "./chunk-ZUP6UTME.js";
+} from "./chunk-4RZDJQ5U.js";
 import {
   install
-} from "./chunk-YQXDHMHG.js";
-import "./chunk-DM3WGEVB.js";
+} from "./chunk-E5YE7UTZ.js";
+import "./chunk-F2FKLPZD.js";
 import "./chunk-VTEFO2FT.js";
 import "./chunk-RXNA2XCX.js";
 import "./chunk-WGDTG44V.js";
-import "./chunk-KRGA5VLT.js";
-import "./chunk-IAKUGHGT.js";
-import "./chunk-JKAZKVQU.js";
+import "./chunk-ICJRCXSG.js";
+import "./chunk-MT76WHSM.js";
 import "./chunk-HTOTG4TS.js";
 import {
   commandUsage
-} from "./chunk-FBTBHRPG.js";
-import "./chunk-R44FR7BY.js";
-import "./chunk-2V4AQPBR.js";
-import "./chunk-6YXVQ5HC.js";
+} from "./chunk-LCDBW6IT.js";
+import "./chunk-7NHXV6AH.js";
+import "./chunk-PW6S6AIO.js";
+import "./chunk-E74WGW5C.js";
+import "./chunk-WP6CYBPM.js";
+import "./chunk-UBLFPJHV.js";
+import "./chunk-2PLIV3N3.js";
 import "./chunk-XNLSTHDK.js";
 import "./chunk-WZWDS3W4.js";
 import "./chunk-PZLD7RTK.js";
 
 // ../../src/cli-sdk/src/commands/ci.ts
+var needsRegistry = true;
 var usage = () => commandUsage({
   command: "ci",
   usage: "",
@@ -73,6 +76,7 @@ var command = async (conf) => {
 };
 export {
   command,
+  needsRegistry,
   usage,
   views
 };

package/cli-package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vltpkg/cli-sdk",
   "description": "The source for the vlt CLI",
-  "version": "1.0.0-rc.32",
+  "version": "1.0.0-rc.34",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
@@ -116,5 +116,9 @@
   ],
   "keywords": [
     "vltpkg"
-  ]
+  ],
+  "bugs": {
+    "url": "https://github.com/vltpkg/vltpkg/issues"
+  },
+  "homepage": "https://github.com/vltpkg/vltpkg/tree/main/src/cli-sdk#readme"
 }

package/{config-4KQTTXJH.js → config-6NXV2BXW.js}

@@ -15,33 +15,35 @@ import {
 } from "./chunk-DBANBIL2.js";
 import {
   asRootError
-} from "./chunk-DFNHGGGV.js";
+} from "./chunk-EFWPI6IY.js";
 import {
   pairsToRecords,
   recordsToPairs
-} from "./chunk-G6PG3AGN.js";
-import "./chunk-LEX7YPHR.js";
-import "./chunk-HQ4US6G3.js";
-import "./chunk-KRGA5VLT.js";
-import "./chunk-IAKUGHGT.js";
-import "./chunk-JKAZKVQU.js";
+} from "./chunk-3SQ5Y324.js";
+import "./chunk-WXMYKCQW.js";
+import "./chunk-FWKQ7YDF.js";
+import "./chunk-ICJRCXSG.js";
+import "./chunk-MT76WHSM.js";
 import {
   find,
   load
 } from "./chunk-HTOTG4TS.js";
 import {
   commandUsage
-} from "./chunk-FBTBHRPG.js";
-import "./chunk-DI2CYYXF.js";
-import "./chunk-YCQTLBWF.js";
-import "./chunk-R44FR7BY.js";
+} from "./chunk-LCDBW6IT.js";
+import "./chunk-U6DM3ROE.js";
+import "./chunk-CNSTFT7U.js";
+import "./chunk-7NHXV6AH.js";
+import "./chunk-PW6S6AIO.js";
+import "./chunk-E74WGW5C.js";
 import {
   getSortedKeys,
   isRecordField
-} from "./chunk-2V4AQPBR.js";
+} from "./chunk-WP6CYBPM.js";
+import "./chunk-UBLFPJHV.js";
 import {
   isObject
-} from "./chunk-6YXVQ5HC.js";
+} from "./chunk-2PLIV3N3.js";
 import "./chunk-XNLSTHDK.js";
 import {
   error

package/{config-LRL3N7TN.js → config-TVAXCTQO.js}

@@ -14,23 +14,25 @@ import {
   kCustomInspect,
   pairsToRecords,
   recordsToPairs
-} from "./chunk-G6PG3AGN.js";
-import "./chunk-LEX7YPHR.js";
-import "./chunk-HQ4US6G3.js";
-import "./chunk-KRGA5VLT.js";
-import "./chunk-IAKUGHGT.js";
-import "./chunk-JKAZKVQU.js";
+} from "./chunk-3SQ5Y324.js";
+import "./chunk-WXMYKCQW.js";
+import "./chunk-FWKQ7YDF.js";
+import "./chunk-ICJRCXSG.js";
+import "./chunk-MT76WHSM.js";
 import "./chunk-HTOTG4TS.js";
-import "./chunk-DI2CYYXF.js";
-import "./chunk-YCQTLBWF.js";
-import "./chunk-R44FR7BY.js";
+import "./chunk-U6DM3ROE.js";
+import "./chunk-CNSTFT7U.js";
+import "./chunk-7NHXV6AH.js";
+import "./chunk-PW6S6AIO.js";
+import "./chunk-E74WGW5C.js";
 import {
   commands,
   definition,
   isRecordField,
   recordFields
-} from "./chunk-2V4AQPBR.js";
-import "./chunk-6YXVQ5HC.js";
+} from "./chunk-WP6CYBPM.js";
+import "./chunk-UBLFPJHV.js";
+import "./chunk-2PLIV3N3.js";
 import "./chunk-XNLSTHDK.js";
 import "./chunk-WZWDS3W4.js";
 import "./chunk-PZLD7RTK.js";

package/{create-KN6AXEA6.js → create-LXI5DCDW.js}

@@ -11,41 +11,44 @@ import {createRequire as _vlt_createRequire} from "node:module";
 var require = _vlt_createRequire(import.meta.filename);
 import {
   vlxResolve
-} from "./chunk-SIXXDCBI.js";
+} from "./chunk-CCQYIYTA.js";
 import {
   ExecCommand,
   views
-} from "./chunk-SDBTQF2Y.js";
+} from "./chunk-UCD3RJYG.js";
 import "./chunk-RIYFGX27.js";
-import "./chunk-XFQ2EH5D.js";
+import "./chunk-VM2RMMY4.js";
 import {
   styleTextStdout
-} from "./chunk-5UXEBLLT.js";
+} from "./chunk-EHEVBLDB.js";
 import "./chunk-G2YT2GWF.js";
-import "./chunk-NLFBANVO.js";
+import "./chunk-Y7CQIZ7Y.js";
 import {
   exec,
   execFG
-} from "./chunk-YQXDHMHG.js";
-import "./chunk-DM3WGEVB.js";
+} from "./chunk-E5YE7UTZ.js";
+import "./chunk-F2FKLPZD.js";
 import "./chunk-VTEFO2FT.js";
 import "./chunk-RXNA2XCX.js";
 import "./chunk-WGDTG44V.js";
-import "./chunk-DFNHGGGV.js";
-import "./chunk-LEX7YPHR.js";
-import "./chunk-HQ4US6G3.js";
-import "./chunk-KRGA5VLT.js";
-import "./chunk-IAKUGHGT.js";
-import "./chunk-JKAZKVQU.js";
+import "./chunk-EFWPI6IY.js";
+import "./chunk-WXMYKCQW.js";
+import "./chunk-FWKQ7YDF.js";
+import "./chunk-ICJRCXSG.js";
+import "./chunk-MT76WHSM.js";
 import "./chunk-HTOTG4TS.js";
+import "./chunk-FAG776ZD.js";
 import {
   commandUsage
-} from "./chunk-FBTBHRPG.js";
-import "./chunk-DI2CYYXF.js";
-import "./chunk-YCQTLBWF.js";
-import "./chunk-R44FR7BY.js";
-import "./chunk-2V4AQPBR.js";
-import "./chunk-6YXVQ5HC.js";
+} from "./chunk-LCDBW6IT.js";
+import "./chunk-U6DM3ROE.js";
+import "./chunk-CNSTFT7U.js";
+import "./chunk-7NHXV6AH.js";
+import "./chunk-PW6S6AIO.js";
+import "./chunk-E74WGW5C.js";
+import "./chunk-WP6CYBPM.js";
+import "./chunk-UBLFPJHV.js";
+import "./chunk-2PLIV3N3.js";
 import "./chunk-XNLSTHDK.js";
 import "./chunk-WZWDS3W4.js";
 import "./chunk-PZLD7RTK.js";
@@ -53,6 +56,7 @@ import "./chunk-PZLD7RTK.js";
 // ../../src/cli-sdk/src/commands/create.ts
 import { homedir } from "node:os";
 import { createInterface } from "node:readline/promises";
+var needsRegistry = true;
 var usage = () => commandUsage({
   command: "create",
   usage: "<initializer> [args...]",
@@ -154,6 +158,7 @@ var command = async (conf) => {
 };
 export {
   command,
+  needsRegistry,
   prettyPath,
   promptFn,
   usage,

package/{deprecate-P26WHVFB.js → deprecate-2AQBL5XT.js}

@@ -11,27 +11,32 @@ import {createRequire as _vlt_createRequire} from "node:module";
 var require = _vlt_createRequire(import.meta.filename);
 import {
   PackageInfoClient
-} from "./chunk-LEX7YPHR.js";
-import "./chunk-HQ4US6G3.js";
-import "./chunk-KRGA5VLT.js";
-import "./chunk-IAKUGHGT.js";
-import {
-  Spec2 as Spec
-} from "./chunk-JKAZKVQU.js";
+} from "./chunk-WXMYKCQW.js";
+import "./chunk-FWKQ7YDF.js";
+import "./chunk-ICJRCXSG.js";
+import "./chunk-MT76WHSM.js";
 import "./chunk-HTOTG4TS.js";
+import {
+  resolveRegistry
+} from "./chunk-FAG776ZD.js";
 import {
   commandUsage
-} from "./chunk-FBTBHRPG.js";
+} from "./chunk-LCDBW6IT.js";
 import {
   RegistryClient
-} from "./chunk-DI2CYYXF.js";
-import "./chunk-YCQTLBWF.js";
-import "./chunk-R44FR7BY.js";
-import "./chunk-2V4AQPBR.js";
+} from "./chunk-U6DM3ROE.js";
+import "./chunk-CNSTFT7U.js";
+import "./chunk-7NHXV6AH.js";
+import {
+  Spec2 as Spec
+} from "./chunk-PW6S6AIO.js";
+import "./chunk-E74WGW5C.js";
+import "./chunk-WP6CYBPM.js";
+import "./chunk-UBLFPJHV.js";
 import {
   asError,
   satisfies
-} from "./chunk-6YXVQ5HC.js";
+} from "./chunk-2PLIV3N3.js";
 import "./chunk-XNLSTHDK.js";
 import {
   error
@@ -39,6 +44,7 @@ import {
 import "./chunk-PZLD7RTK.js";
 
 // ../../src/cli-sdk/src/commands/deprecate.ts
+var needsRegistry = true;
 var usage = () => commandUsage({
   command: "deprecate",
   usage: "<pkg>[@<version>] <message>",
@@ -103,7 +109,8 @@ var command = async (conf) => {
       found: specArg
     });
   }
-  const { registry, otp } = conf.options;
+  const { otp } = conf.options;
+  const registry = await resolveRegistry(conf);
   const registryUrl = new URL(registry);
   const pic = new PackageInfoClient(conf.options);
   const packument = await pic.packument(spec);
@@ -171,6 +178,7 @@ var command = async (conf) => {
 };
 export {
   command,
+  needsRegistry,
   usage,
   views
 };