@vltpkg/cli-sdk 0.0.0-20 → 0.0.0-22

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

@@ -5,18 +5,22 @@ export type VersionOptions = {
     tag?: boolean;
     message?: string;
     tagMessage?: string;
+    includeNameInCommit?: boolean;
+    includeNameInTag?: boolean;
 };
-export type VersionResult = {
+export type CommandResultSingle = {
+    name: string;
     oldVersion: string;
     newVersion: string;
     dir: string;
     committed?: string[];
     tag?: string;
 };
+export type CommandResult = CommandResultSingle | CommandResultSingle[];
 export declare const usage: CommandUsage;
 export declare const views: {
-    readonly json: (result: VersionResult) => VersionResult;
-    readonly human: (result: VersionResult) => string;
+    readonly json: (result: CommandResult) => CommandResult;
+    readonly human: (results: CommandResult) => string;
 };
-export declare const command: CommandFn<VersionResult>;
+export declare const command: CommandFn<CommandResult>;
 //# sourceMappingURL=version.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/commands/version.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM1D,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAoKD,eAAO,MAAM,KAAK,EAAE,YAanB,CAAA;AAED,eAAO,MAAM,KAAK;;;CAYuB,CAAA;AAEzC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,aAAa,CAG5C,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/commands/version.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAQ1D,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,mBAAmB,EAAE,CAAA;AA2LzB,eAAO,MAAM,KAAK,EAAE,YAanB,CAAA;AAED,eAAO,MAAM,KAAK;;;CAiBuB,CAAA;AAEzC,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,aAAa,CA8D5C,CAAA"}

package/dist/esm/commands/version.js

@@ -3,13 +3,15 @@ import { is as isGit, spawn as spawn_, isClean } from '@vltpkg/git';
 import { error } from '@vltpkg/error-cause';
 import { asError } from '@vltpkg/types';
 import { commandUsage } from "../config/usage.js";
-import { dirname } from 'node:path';
+import { dirname, resolve } from 'node:path';
 import assert from 'node:assert';
+import { actual } from '@vltpkg/graph';
+import { Query } from '@vltpkg/query';
 const isValidVersionIncrement = (value) => versionIncrements.includes(value);
 const version = async (conf, increment, cwd, { 
 // Hardcode happy path options for now.
 // TODO: make these config definitions
-prereleaseId = 'pre', commit = true, tag = true, message = 'v%s', tagMessage = 'v%s', } = {}) => {
+prereleaseId = 'pre', commit = true, tag = true, message = 'v%s', tagMessage = 'v%s', includeNameInCommit = false, includeNameInTag = false, } = {}) => {
     assert(increment, error('Version increment argument is required', {
         code: 'EUSAGE',
         validOptions: versionIncrements,
@@ -22,6 +24,9 @@ prereleaseId = 'pre', commit = true, tag = true, message = 'v%s', tagMessage = '
     const spawn = (args, opts) => spawn_(args, { cwd: manifestDir, ...opts });
     const manifestDir = dirname(manifestPath);
     const manifest = conf.options.packageJson.read(manifestDir);
+    assert(manifest.name, error('No name field found in package.json', {
+        path: manifestPath,
+    }));
     assert(manifest.version, error('No version field found in package.json', {
         path: manifestPath,
     }));
@@ -53,6 +58,7 @@ prereleaseId = 'pre', commit = true, tag = true, message = 'v%s', tagMessage = '
     manifest.version = newVersion;
     conf.options.packageJson.write(manifestDir, manifest);
     const result = {
+        name: manifest.name,
         oldVersion,
         newVersion,
         dir: manifestDir,
@@ -66,12 +72,19 @@ prereleaseId = 'pre', commit = true, tag = true, message = 'v%s', tagMessage = '
         if (!(await isClean({ cwd: conf.options.projectRoot }))) {
             try {
                 // Check if there are changes other than package.json
-                const gitResult = await spawn(['diff', '--name-only', 'HEAD']);
+                const gitResult = await spawn([
+                    'diff',
+                    '--name-only',
+                    'HEAD',
+                    '--',
+                    '.',
+                ]);
                 const changedFiles = gitResult.stdout
                     .trim()
                     .split('\n')
-                    .filter(Boolean);
-                const nonPackageJsonChanges = changedFiles.filter(file => file !== 'package.json');
+                    .filter(Boolean)
+                    .map(f => resolve(conf.options.projectRoot, f));
+                const nonPackageJsonChanges = changedFiles.filter(file => file !== resolve(manifestDir, 'package.json'));
                 assert(nonPackageJsonChanges.length === 0, error('Git working directory not clean. Please commit or stash your changes first.', { found: nonPackageJsonChanges }));
             }
             catch (err) {
@@ -86,9 +99,9 @@ prereleaseId = 'pre', commit = true, tag = true, message = 'v%s', tagMessage = '
                 await spawn([
                     'commit',
                     '-m',
-                    message.replace('%s', newVersion),
+                    `${includeNameInCommit ? `${manifest.name}: ` : ''}${message.replace('%s', newVersion)}`,
                 ]);
-                result.committed = files;
+                result.committed = files.map(f => resolve(manifestDir, f));
             }
             catch (err) {
                 throw error('Failed to commit version changes', {
@@ -99,12 +112,15 @@ prereleaseId = 'pre', commit = true, tag = true, message = 'v%s', tagMessage = '
         }
         if (tag) {
             try {
-                const tagName = `v${newVersion}`;
+                const tagName = (includeNameInTag ?
+                    `${manifest.name.replace('/', '-').replace('@', '')}-`
+                    : '') + `v${newVersion}`;
                 await spawn([
                     'tag',
                     tagName,
                     '-m',
-                    tagMessage.replace('%s', newVersion),
+                    (includeNameInTag ? `${manifest.name}: ` : '') +
+                        tagMessage.replace('%s', newVersion),
                 ]);
                 result.tag = tagName;
             }
@@ -133,19 +149,72 @@ export const usage = () => {
 };
 export const views = {
     json: result => result,
-    human: result => {
-        let output = `v${result.newVersion}`;
-        if (result.committed) {
-            output += ` +commit`;
-        }
-        if (result.tag) {
-            output += ` +tag`;
-        }
-        return output;
+    human: results => {
+        const item = (result) => {
+            let output = `${result.name}: v${result.newVersion}`;
+            if (result.committed) {
+                output += ` +commit`;
+            }
+            if (result.tag) {
+                output += ` +tag`;
+            }
+            return output;
+        };
+        return Array.isArray(results) ?
+            results.map(item).join('\n')
+            : item(results);
     },
 };
 export const command = async (conf) => {
-    const { positionals } = conf;
-    return version(conf, positionals[0], process.cwd());
+    const { positionals, options, projectRoot } = conf;
+    const queryString = conf.get('scope');
+    const paths = conf.get('workspace');
+    const groups = conf.get('workspace-group');
+    const recursive = conf.get('recursive');
+    const locations = [];
+    let single = null;
+    if (queryString) {
+        const graph = actual.load({
+            ...options,
+            mainManifest: options.packageJson.read(projectRoot),
+            monorepo: options.monorepo,
+            loadManifests: false,
+        });
+        const query = new Query({
+            graph,
+            specOptions: conf.options,
+            securityArchive: undefined,
+        });
+        const { nodes } = await query.search(queryString, {
+            signal: new AbortController().signal,
+        });
+        for (const node of nodes) {
+            const { location } = node.toJSON();
+            assert(location, error(`node ${node.id} has no location`, {
+                found: node,
+            }));
+            locations.push(resolve(projectRoot, location));
+        }
+    }
+    else if (paths?.length || groups?.length || recursive) {
+        for (const workspace of options.monorepo ?? []) {
+            locations.push(workspace.fullpath);
+        }
+    }
+    else {
+        single = options.packageJson.find(process.cwd()) ?? projectRoot;
+    }
+    if (single) {
+        return version(conf, positionals[0], single);
+    }
+    assert(locations.length > 0, error('No workspaces or query results found'));
+    const results = [];
+    for (const location of locations) {
+        results.push(await version(conf, positionals[0], location, {
+            includeNameInCommit: true,
+            includeNameInTag: true,
+        }));
+    }
+    return results;
 };
 //# sourceMappingURL=version.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/commands/version.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,KAAK,IAAI,YAAY,EACrB,iBAAiB,GAClB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,EAAE,IAAI,KAAK,EAAE,KAAK,IAAI,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAEnE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAIjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,MAAM,MAAM,aAAa,CAAA;AAkBhC,MAAM,uBAAuB,GAAG,CAC9B,KAAa,EACW,EAAE,CAC1B,iBAAiB,CAAC,QAAQ,CAAC,KAAsB,CAAC,CAAA;AAEpD,MAAM,OAAO,GAAG,KAAK,EACnB,IAAkB,EAClB,SAA6B,EAC7B,GAAW,EACX;AACE,uCAAuC;AACvC,sCAAsC;AACtC,YAAY,GAAG,KAAK,EACpB,MAAM,GAAG,IAAI,EACb,GAAG,GAAG,IAAI,EACV,OAAO,GAAG,KAAK,EACf,UAAU,GAAG,KAAK,MACA,EAAE,EACE,EAAE;IAC1B,MAAM,CACJ,SAAS,EACT,KAAK,CAAC,wCAAwC,EAAE;QAC9C,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,iBAAiB;KAChC,CAAC,CACH,CAAA;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACvD,MAAM,CACJ,YAAY,EACZ,KAAK,CAAC,uBAAuB,EAAE;QAC7B,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,GAAG;KACV,CAAC,CACH,CAAA;IAED,MAAM,KAAK,GAAG,CAAC,IAAc,EAAE,IAAiB,EAAE,EAAE,CAClD,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;IAE7C,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAE3D,MAAM,CACJ,QAAQ,CAAC,OAAO,EAChB,KAAK,CAAC,wCAAwC,EAAE;QAC9C,IAAI,EAAE,YAAY;KACnB,CAAC,CACH,CAAA;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAA;IACnC,IAAI,UAAkB,CAAA;IAEtB,sDAAsD;IACtD,MAAM,eAAe,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;IAC/C,IAAI,eAAe,EAAE,CAAC;QACpB,UAAU,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAA;IACzC,CAAC;SAAM,IAAI,uBAAuB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9C,uBAAuB;QACvB,MAAM,aAAa,GAAG,SAAS,CAAA;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,YAAY,CAAC,CAAA;YAC3D,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,CACT,oCAAoC,UAAU,SAAS,SAAS,EAAE,EAClE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CACvD,CAAA;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,CACT,8BAA8B,SAAS,2GAA2G,EAClJ;YACE,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,iBAAiB;SAChC,CACF,CAAA;IACH,CAAC;IAED,sBAAsB;IACtB,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAA;IAC7B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IAErD,MAAM,MAAM,GAAkB;QAC5B,UAAU;QACV,UAAU;QACV,GAAG,EAAE,WAAW;KACjB,CAAA;IAED,qDAAqD;IACrD;IACE,8DAA8D;IAC9D,CAAC,MAAM,IAAI,GAAG,CAAC;QACf,CAAC,MAAM,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAChD,CAAC;QACD,mFAAmF;QACnF,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC;gBACH,qDAAqD;gBACrD,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAA;gBAC9D,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM;qBAClC,IAAI,EAAE;qBACN,KAAK,CAAC,IAAI,CAAC;qBACX,MAAM,CAAC,OAAO,CAAC,CAAA;gBAClB,MAAM,qBAAqB,GAAG,YAAY,CAAC,MAAM,CAC/C,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,cAAc,CAChC,CAAA;gBACD,MAAM,CACJ,qBAAqB,CAAC,MAAM,KAAK,CAAC,EAClC,KAAK,CACH,6EAA6E,EAC7E,EAAE,KAAK,EAAE,qBAAqB,EAAE,CACjC,CACF,CAAA;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,KAAK,CACT,6EAA6E,EAC7E,OAAO,CAAC,GAAG,CAAC,CACb,CAAA;YACH,CAAC;QACH,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBACH,qBAAqB;gBACrB,MAAM,KAAK,GAAG,CAAC,cAAc,CAAC,CAAA;gBAC9B,MAAM,KAAK,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAA;gBAC9B,MAAM,KAAK,CAAC;oBACV,QAAQ;oBACR,IAAI;oBACJ,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC;iBAClC,CAAC,CAAA;gBACF,MAAM,CAAC,SAAS,GAAG,KAAK,CAAA;YAC1B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,KAAK,CAAC,kCAAkC,EAAE;oBAC9C,OAAO,EAAE,UAAU;oBACnB,KAAK,EAAE,GAAG;iBACX,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,UAAU,EAAE,CAAA;gBAChC,MAAM,KAAK,CAAC;oBACV,KAAK;oBACL,OAAO;oBACP,IAAI;oBACJ,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC;iBACrC,CAAC,CAAA;gBACF,MAAM,CAAC,GAAG,GAAG,OAAO,CAAA;YACtB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,KAAK,CAAC,0BAA0B,EAAE;oBACtC,OAAO,EAAE,UAAU;oBACnB,KAAK,EAAE,GAAG;iBACX,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAiB,GAAG,EAAE;IACtC,OAAO,YAAY,CAAC;QAClB,OAAO,EAAE,SAAS;QAClB,KAAK,EACH,sFAAsF;QACxF,WAAW,EAAE;;;;;;8EAM6D;KAC3E,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM;IACtB,KAAK,EAAE,MAAM,CAAC,EAAE;QACd,IAAI,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAA;QACpC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,MAAM,IAAI,UAAU,CAAA;QACtB,CAAC;QACD,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,OAAO,CAAA;QACnB,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;CACsC,CAAA;AAEzC,MAAM,CAAC,MAAM,OAAO,GAA6B,KAAK,EAAC,IAAI,EAAC,EAAE;IAC5D,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAA;IAC5B,OAAO,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;AACrD,CAAC,CAAA","sourcesContent":["import {\n  inc,\n  parse as parseVersion,\n  versionIncrements,\n} from '@vltpkg/semver'\nimport type { IncrementType } from '@vltpkg/semver'\nimport { is as isGit, spawn as spawn_, isClean } from '@vltpkg/git'\nimport type { GitOptions } from '@vltpkg/git'\nimport { error } from '@vltpkg/error-cause'\nimport { asError } from '@vltpkg/types'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { Views } from '../view.ts'\nimport type { ParsedConfig } from '../config/index.ts'\nimport { dirname } from 'node:path'\nimport assert from 'node:assert'\n\nexport type VersionOptions = {\n  prereleaseId?: string\n  commit?: boolean\n  tag?: boolean\n  message?: string\n  tagMessage?: string\n}\n\nexport type VersionResult = {\n  oldVersion: string\n  newVersion: string\n  dir: string\n  committed?: string[]\n  tag?: string\n}\n\nconst isValidVersionIncrement = (\n  value: string,\n): value is IncrementType =>\n  versionIncrements.includes(value as IncrementType)\n\nconst version = async (\n  conf: ParsedConfig,\n  increment: string | undefined,\n  cwd: string,\n  {\n    // Hardcode happy path options for now.\n    // TODO: make these config definitions\n    prereleaseId = 'pre',\n    commit = true,\n    tag = true,\n    message = 'v%s',\n    tagMessage = 'v%s',\n  }: VersionOptions = {},\n): Promise<VersionResult> => {\n  assert(\n    increment,\n    error('Version increment argument is required', {\n      code: 'EUSAGE',\n      validOptions: versionIncrements,\n    }),\n  )\n\n  const manifestPath = conf.options.packageJson.find(cwd)\n  assert(\n    manifestPath,\n    error('No package.json found', {\n      code: 'ENOENT',\n      path: cwd,\n    }),\n  )\n\n  const spawn = (args: string[], opts?: GitOptions) =>\n    spawn_(args, { cwd: manifestDir, ...opts })\n\n  const manifestDir = dirname(manifestPath)\n  const manifest = conf.options.packageJson.read(manifestDir)\n\n  assert(\n    manifest.version,\n    error('No version field found in package.json', {\n      path: manifestPath,\n    }),\n  )\n\n  const oldVersion = manifest.version\n  let newVersion: string\n\n  // Check if increment is a valid semver version string\n  const parsedIncrement = parseVersion(increment)\n  if (parsedIncrement) {\n    newVersion = parsedIncrement.toString()\n  } else if (isValidVersionIncrement(increment)) {\n    // Use semver increment\n    const incrementType = increment\n    try {\n      const result = inc(oldVersion, incrementType, prereleaseId)\n      newVersion = result.toString()\n    } catch (err) {\n      throw error(\n        `Failed to increment version from ${oldVersion} with ${increment}`,\n        { version: oldVersion, wanted: increment, cause: err },\n      )\n    }\n  } else {\n    throw error(\n      `Invalid version increment: ${increment}. Must be a valid semver version or one of: major, minor, patch, premajor, preminor, prepatch, prerelease`,\n      {\n        found: increment,\n        validOptions: versionIncrements,\n      },\n    )\n  }\n\n  // Update the manifest\n  manifest.version = newVersion\n  conf.options.packageJson.write(manifestDir, manifest)\n\n  const result: VersionResult = {\n    oldVersion,\n    newVersion,\n    dir: manifestDir,\n  }\n\n  // Handle git operations if we're in a git repository\n  if (\n    /* c8 ignore next -- commit and tag are always true for now */\n    (commit || tag) &&\n    (await isGit({ cwd: conf.options.projectRoot }))\n  ) {\n    // Check for uncommitted changes (excluding package.json since we just modified it)\n    if (!(await isClean({ cwd: conf.options.projectRoot }))) {\n      try {\n        // Check if there are changes other than package.json\n        const gitResult = await spawn(['diff', '--name-only', 'HEAD'])\n        const changedFiles = gitResult.stdout\n          .trim()\n          .split('\\n')\n          .filter(Boolean)\n        const nonPackageJsonChanges = changedFiles.filter(\n          file => file !== 'package.json',\n        )\n        assert(\n          nonPackageJsonChanges.length === 0,\n          error(\n            'Git working directory not clean. Please commit or stash your changes first.',\n            { found: nonPackageJsonChanges },\n          ),\n        )\n      } catch (err) {\n        throw error(\n          'Git working directory not clean. Please commit or stash your changes first.',\n          asError(err),\n        )\n      }\n    }\n\n    if (commit) {\n      try {\n        // Stage package.json\n        const files = ['package.json']\n        await spawn(['add', ...files])\n        await spawn([\n          'commit',\n          '-m',\n          message.replace('%s', newVersion),\n        ])\n        result.committed = files\n      } catch (err) {\n        throw error('Failed to commit version changes', {\n          version: newVersion,\n          cause: err,\n        })\n      }\n    }\n\n    if (tag) {\n      try {\n        const tagName = `v${newVersion}`\n        await spawn([\n          'tag',\n          tagName,\n          '-m',\n          tagMessage.replace('%s', newVersion),\n        ])\n        result.tag = tagName\n      } catch (err) {\n        throw error('Failed to create git tag', {\n          version: newVersion,\n          cause: err,\n        })\n      }\n    }\n  }\n\n  return result\n}\n\nexport const usage: CommandUsage = () => {\n  return commandUsage({\n    command: 'version',\n    usage:\n      '[<newversion> | major | minor | patch | premajor | preminor | prepatch | prerelease]',\n    description: `Bump a package's version.\n\n    Run in a package directory to bump the version and write the new data back to package.json.\n\n    The \\`<newversion>\\` argument should be a valid semver string or a valid increment type (one of patch, minor, major, prepatch, preminor, premajor, prerelease).\n\n    If run in a git repository, it will also create a version commit and tag.`,\n  })\n}\n\nexport const views = {\n  json: result => result,\n  human: result => {\n    let output = `v${result.newVersion}`\n    if (result.committed) {\n      output += ` +commit`\n    }\n    if (result.tag) {\n      output += ` +tag`\n    }\n    return output\n  },\n} as const satisfies Views<VersionResult>\n\nexport const command: CommandFn<VersionResult> = async conf => {\n  const { positionals } = conf\n  return version(conf, positionals[0], process.cwd())\n}\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/commands/version.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  inc,\n  parse as parseVersion,\n  versionIncrements,\n} from '@vltpkg/semver'\nimport type { IncrementType } from '@vltpkg/semver'\nimport { is as isGit, spawn as spawn_, isClean } from '@vltpkg/git'\nimport type { GitOptions } from '@vltpkg/git'\nimport { error } from '@vltpkg/error-cause'\nimport { asError } from '@vltpkg/types'\nimport { commandUsage } from '../config/usage.ts'\nimport type { CommandFn, CommandUsage } from '../index.ts'\nimport type { Views } from '../view.ts'\nimport type { ParsedConfig } from '../config/index.ts'\nimport { dirname, resolve } from 'node:path'\nimport assert from 'node:assert'\nimport { actual } from '@vltpkg/graph'\nimport { Query } from '@vltpkg/query'\n\nexport type VersionOptions = {\n  prereleaseId?: string\n  commit?: boolean\n  tag?: boolean\n  message?: string\n  tagMessage?: string\n  includeNameInCommit?: boolean\n  includeNameInTag?: boolean\n}\n\nexport type CommandResultSingle = {\n  name: string\n  oldVersion: string\n  newVersion: string\n  dir: string\n  committed?: string[]\n  tag?: string\n}\n\nexport type CommandResult =\n  | CommandResultSingle\n  | CommandResultSingle[]\n\nconst isValidVersionIncrement = (\n  value: string,\n): value is IncrementType =>\n  versionIncrements.includes(value as IncrementType)\n\nconst version = async (\n  conf: ParsedConfig,\n  increment: string | undefined,\n  cwd: string,\n  {\n    // Hardcode happy path options for now.\n    // TODO: make these config definitions\n    prereleaseId = 'pre',\n    commit = true,\n    tag = true,\n    message = 'v%s',\n    tagMessage = 'v%s',\n    includeNameInCommit = false,\n    includeNameInTag = false,\n  }: VersionOptions = {},\n): Promise<CommandResultSingle> => {\n  assert(\n    increment,\n    error('Version increment argument is required', {\n      code: 'EUSAGE',\n      validOptions: versionIncrements,\n    }),\n  )\n\n  const manifestPath = conf.options.packageJson.find(cwd)\n  assert(\n    manifestPath,\n    error('No package.json found', {\n      code: 'ENOENT',\n      path: cwd,\n    }),\n  )\n\n  const spawn = (args: string[], opts?: GitOptions) =>\n    spawn_(args, { cwd: manifestDir, ...opts })\n\n  const manifestDir = dirname(manifestPath)\n  const manifest = conf.options.packageJson.read(manifestDir)\n\n  assert(\n    manifest.name,\n    error('No name field found in package.json', {\n      path: manifestPath,\n    }),\n  )\n  assert(\n    manifest.version,\n    error('No version field found in package.json', {\n      path: manifestPath,\n    }),\n  )\n\n  const oldVersion = manifest.version\n  let newVersion: string\n\n  // Check if increment is a valid semver version string\n  const parsedIncrement = parseVersion(increment)\n  if (parsedIncrement) {\n    newVersion = parsedIncrement.toString()\n  } else if (isValidVersionIncrement(increment)) {\n    // Use semver increment\n    const incrementType = increment\n    try {\n      const result = inc(oldVersion, incrementType, prereleaseId)\n      newVersion = result.toString()\n    } catch (err) {\n      throw error(\n        `Failed to increment version from ${oldVersion} with ${increment}`,\n        { version: oldVersion, wanted: increment, cause: err },\n      )\n    }\n  } else {\n    throw error(\n      `Invalid version increment: ${increment}. Must be a valid semver version or one of: major, minor, patch, premajor, preminor, prepatch, prerelease`,\n      {\n        found: increment,\n        validOptions: versionIncrements,\n      },\n    )\n  }\n\n  // Update the manifest\n  manifest.version = newVersion\n  conf.options.packageJson.write(manifestDir, manifest)\n\n  const result: CommandResultSingle = {\n    name: manifest.name,\n    oldVersion,\n    newVersion,\n    dir: manifestDir,\n  }\n\n  // Handle git operations if we're in a git repository\n  if (\n    /* c8 ignore next -- commit and tag are always true for now */\n    (commit || tag) &&\n    (await isGit({ cwd: conf.options.projectRoot }))\n  ) {\n    // Check for uncommitted changes (excluding package.json since we just modified it)\n    if (!(await isClean({ cwd: conf.options.projectRoot }))) {\n      try {\n        // Check if there are changes other than package.json\n        const gitResult = await spawn([\n          'diff',\n          '--name-only',\n          'HEAD',\n          '--',\n          '.',\n        ])\n        const changedFiles = gitResult.stdout\n          .trim()\n          .split('\\n')\n          .filter(Boolean)\n          .map(f => resolve(conf.options.projectRoot, f))\n        const nonPackageJsonChanges = changedFiles.filter(\n          file => file !== resolve(manifestDir, 'package.json'),\n        )\n        assert(\n          nonPackageJsonChanges.length === 0,\n          error(\n            'Git working directory not clean. Please commit or stash your changes first.',\n            { found: nonPackageJsonChanges },\n          ),\n        )\n      } catch (err) {\n        throw error(\n          'Git working directory not clean. Please commit or stash your changes first.',\n          asError(err),\n        )\n      }\n    }\n\n    if (commit) {\n      try {\n        // Stage package.json\n        const files = ['package.json']\n        await spawn(['add', ...files])\n        await spawn([\n          'commit',\n          '-m',\n          `${includeNameInCommit ? `${manifest.name}: ` : ''}${message.replace(\n            '%s',\n            newVersion,\n          )}`,\n        ])\n        result.committed = files.map(f => resolve(manifestDir, f))\n      } catch (err) {\n        throw error('Failed to commit version changes', {\n          version: newVersion,\n          cause: err,\n        })\n      }\n    }\n\n    if (tag) {\n      try {\n        const tagName =\n          (includeNameInTag ?\n            `${manifest.name.replace('/', '-').replace('@', '')}-`\n          : '') + `v${newVersion}`\n        await spawn([\n          'tag',\n          tagName,\n          '-m',\n          (includeNameInTag ? `${manifest.name}: ` : '') +\n            tagMessage.replace('%s', newVersion),\n        ])\n        result.tag = tagName\n      } catch (err) {\n        throw error('Failed to create git tag', {\n          version: newVersion,\n          cause: err,\n        })\n      }\n    }\n  }\n\n  return result\n}\n\nexport const usage: CommandUsage = () => {\n  return commandUsage({\n    command: 'version',\n    usage:\n      '[<newversion> | major | minor | patch | premajor | preminor | prepatch | prerelease]',\n    description: `Bump a package's version.\n\n    Run in a package directory to bump the version and write the new data back to package.json.\n\n    The \\`<newversion>\\` argument should be a valid semver string or a valid increment type (one of patch, minor, major, prepatch, preminor, premajor, prerelease).\n\n    If run in a git repository, it will also create a version commit and tag.`,\n  })\n}\n\nexport const views = {\n  json: result => result,\n  human: results => {\n    const item = (result: CommandResultSingle) => {\n      let output = `${result.name}: v${result.newVersion}`\n      if (result.committed) {\n        output += ` +commit`\n      }\n      if (result.tag) {\n        output += ` +tag`\n      }\n      return output\n    }\n    return Array.isArray(results) ?\n        results.map(item).join('\\n')\n      : item(results)\n  },\n} as const satisfies Views<CommandResult>\n\nexport const command: CommandFn<CommandResult> = async conf => {\n  const { positionals, options, projectRoot } = conf\n  const queryString = conf.get('scope')\n  const paths = conf.get('workspace')\n  const groups = conf.get('workspace-group')\n  const recursive = conf.get('recursive')\n\n  const locations: string[] = []\n  let single: string | null = null\n\n  if (queryString) {\n    const graph = actual.load({\n      ...options,\n      mainManifest: options.packageJson.read(projectRoot),\n      monorepo: options.monorepo,\n      loadManifests: false,\n    })\n    const query = new Query({\n      graph,\n      specOptions: conf.options,\n      securityArchive: undefined,\n    })\n    const { nodes } = await query.search(queryString, {\n      signal: new AbortController().signal,\n    })\n    for (const node of nodes) {\n      const { location } = node.toJSON()\n      assert(\n        location,\n        error(`node ${node.id} has no location`, {\n          found: node,\n        }),\n      )\n      locations.push(resolve(projectRoot, location))\n    }\n  } else if (paths?.length || groups?.length || recursive) {\n    for (const workspace of options.monorepo ?? []) {\n      locations.push(workspace.fullpath)\n    }\n  } else {\n    single = options.packageJson.find(process.cwd()) ?? projectRoot\n  }\n\n  if (single) {\n    return version(conf, positionals[0], single)\n  }\n\n  assert(\n    locations.length > 0,\n    error('No workspaces or query results found'),\n  )\n\n  const results: CommandResultSingle[] = []\n  for (const location of locations) {\n    results.push(\n      await version(conf, positionals[0], location, {\n        includeNameInCommit: true,\n        includeNameInTag: true,\n      }),\n    )\n  }\n  return results\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/config/definition.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAOd,CAAA;AAEV,eAAO,MAAM,aAAa,cAKjB,CAAA;AA+CT;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA8MP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DvB,CAAA;AAEJ,eAAO,MAAM,mBAAmB,gBAS/B,CAAA;AAED,eAAO,MAAM,aAAa,gBAC2C,CAAA"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/config/definition.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAOd,CAAA;AAEV,eAAO,MAAM,aAAa,cAKjB,CAAA;AA+CT;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA8MP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyDvB,CAAA;AAEJ,eAAO,MAAM,mBAAmB,gBAS/B,CAAA;AAED,eAAO,MAAM,aAAa,gBAC2C,CAAA"}

package/dist/esm/config/definition.js

@@ -570,7 +570,6 @@ export const definition = j
     'publish-directory': {
         hint: 'path',
         description: `Directory to use for pack and publish operations instead of the current directory.
-                    Similar to pnpm's publishConfig.directory feature.
                     The directory must exist and nothing will be copied to it.`,
     },
 })

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

@@ -1 +1 @@
-{"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 =\n  // If stdout is a TTY, use human output\n  process.stdout.isTTY ? 'human'\n    // If its not a TTY but is a CI environment, use human output\n    // TODO: make a better view option for CI environments\n  : process.env.CI ? 'human'\n    // Otherwise, use json output\n  : '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  ci: 'ci',\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  pack: 'pack',\n  pkg: 'pkg',\n  publish: 'publish',\n  query: 'query',\n  'run-exec': 'run-exec',\n  run: 'run',\n  token: 'token',\n  uninstall: 'uninstall',\n  update: 'update',\n  'exec-cache': 'exec-cache',\n  version: 'version',\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 or publish`,\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  .opt({\n    scope: {\n      short: 's',\n      description:\n        'Set to filter the scope of an operation using a DSS Query.',\n    },\n    target: {\n      short: 't',\n      description:\n        'Set to select packages using a DSS Query selector.',\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                    - silent: Suppress all output to stdout.\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        'silent',\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    'dry-run': {\n      description: 'Run command without making any changes',\n    },\n    'expect-lockfile': {\n      description:\n        'Fail if lockfile is missing or out of date. Used by ci command to enforce lockfile integrity.',\n    },\n    'frozen-lockfile': {\n      description:\n        'Fail if lockfile is missing or out of sync with package.json. Prevents any lockfile modifications.',\n    },\n  })\n  .opt({\n    access: {\n      description: 'Set the access level of the package',\n      validOptions: ['public', 'restricted'] as const,\n      default: 'public',\n    },\n  })\n  .opt({\n    otp: {\n      description: `Provide an OTP to use when publishing a package.`,\n    },\n    'publish-directory': {\n      hint: 'path',\n      description: `Directory to use for pack and publish operations instead of the current directory.\n                    Similar to pnpm's publishConfig.directory feature.\n                    The directory must exist and nothing will be copied to it.`,\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"]}
+{"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 =\n  // If stdout is a TTY, use human output\n  process.stdout.isTTY ? 'human'\n    // If its not a TTY but is a CI environment, use human output\n    // TODO: make a better view option for CI environments\n  : process.env.CI ? 'human'\n    // Otherwise, use json output\n  : '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  ci: 'ci',\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  pack: 'pack',\n  pkg: 'pkg',\n  publish: 'publish',\n  query: 'query',\n  'run-exec': 'run-exec',\n  run: 'run',\n  token: 'token',\n  uninstall: 'uninstall',\n  update: 'update',\n  'exec-cache': 'exec-cache',\n  version: 'version',\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 or publish`,\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  .opt({\n    scope: {\n      short: 's',\n      description:\n        'Set to filter the scope of an operation using a DSS Query.',\n    },\n    target: {\n      short: 't',\n      description:\n        'Set to select packages using a DSS Query selector.',\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                    - silent: Suppress all output to stdout.\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        'silent',\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    'dry-run': {\n      description: 'Run command without making any changes',\n    },\n    'expect-lockfile': {\n      description:\n        'Fail if lockfile is missing or out of date. Used by ci command to enforce lockfile integrity.',\n    },\n    'frozen-lockfile': {\n      description:\n        'Fail if lockfile is missing or out of sync with package.json. Prevents any lockfile modifications.',\n    },\n  })\n  .opt({\n    access: {\n      description: 'Set the access level of the package',\n      validOptions: ['public', 'restricted'] as const,\n      default: 'public',\n    },\n  })\n  .opt({\n    otp: {\n      description: `Provide an OTP to use when publishing a package.`,\n    },\n    'publish-directory': {\n      hint: 'path',\n      description: `Directory to use for pack and publish operations instead of the current directory.\n                    The directory must exist and nothing will be copied to it.`,\n    },\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"]}

package/dist/esm/output.d.ts

@@ -8,7 +8,7 @@ type StyleTextFn = (format: Parameters<typeof utilStyleText>[0], s: string) => s
 export declare let styleTextStdout: StyleTextFn;
 export declare let styleTextStderr: StyleTextFn;
 export declare const getView: <T>(conf: LoadedConfig, views?: Views<T>) => View<T>;
-export type OnDone<T> = ((result: T) => Promise<unknown>) | ((result: T) => unknown);
+export type OnDone<T> = (result: T) => Promise<unknown>;
 /**
  * Main export. Run the command appropriately, displaying output using
  * the user-requested view, or the default if the user requested a view

package/dist/esm/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,IAAI,aAAa,EAC3B,MAAM,WAAW,CAAA;AAGlB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,OAAO,KAAK,EAAE,IAAI,EAAe,KAAK,EAAE,MAAM,WAAW,CAAA;AAWzD,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAAyB,CAAA;AAElE,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAA2B,CAAA;AAEpE,KAAK,WAAW,GAAG,CACjB,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,EAC3C,CAAC,EAAE,MAAM,KACN,MAAM,CAAA;AASX,eAAO,IAAI,eAAe,EAAE,WAAyB,CAAA;AACrD,eAAO,IAAI,eAAe,EAAE,WAAyB,CAAA;AAKrD,eAAO,MAAM,OAAO,GAAI,CAAC,QACjB,YAAY,UACV,KAAK,CAAC,CAAC,CAAC,KACf,IAAI,CAAC,CAAC,CA2BR,CAAA;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,IAChB,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GACjC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAA;AAsC5B;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,CAAC,cACvB,OAAO,CAAC,CAAC,CAAC,QAChB,YAAY,cACP;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,kBAoD7B,CAAA"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,IAAI,aAAa,EAC3B,MAAM,WAAW,CAAA;AAGlB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,OAAO,KAAK,EAAE,IAAI,EAAe,KAAK,EAAE,MAAM,WAAW,CAAA;AAWzD,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAAyB,CAAA;AAElE,eAAO,MAAM,MAAM,YAAa,OAAO,EAAE,SAA2B,CAAA;AAEpE,KAAK,WAAW,GAAG,CACjB,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,EAC3C,CAAC,EAAE,MAAM,KACN,MAAM,CAAA;AASX,eAAO,IAAI,eAAe,EAAE,WAAyB,CAAA;AACrD,eAAO,IAAI,eAAe,EAAE,WAAyB,CAAA;AAKrD,eAAO,MAAM,OAAO,GAAI,CAAC,QACjB,YAAY,UACV,KAAK,CAAC,CAAC,CAAC,KACf,IAAI,CAAC,CAAC,CA2BR,CAAA;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAsCvD;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,CAAC,cACvB,OAAO,CAAC,CAAC,CAAC,QAChB,YAAY,cACP;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,kBAoD7B,CAAA"}

package/dist/esm/output.js

@@ -55,7 +55,7 @@ const startView = (conf, opts, views, { start } = { start: Date.now() }) => {
         const view = new View(opts, conf);
         view.start();
         return {
-            onDone(r) {
+            async onDone(r) {
                 return view.done(r, { time: Date.now() - start });
             },
             onError(err) {

package/dist/esm/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"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","sourcesContent":["import type { WriteStream } from 'node:tty'\nimport {\n  formatWithOptions,\n  styleText as utilStyleText,\n} from 'node:util'\nimport { createSupportsColor } from 'supports-color'\nimport { defaultView } from './config/definition.ts'\nimport type { LoadedConfig } from './config/index.ts'\nimport type { Command } from './index.ts'\nimport { printErr, formatOptions } from './print-err.ts'\nimport type { View, ViewOptions, Views } from './view.ts'\nimport { isViewClass } from './view.ts'\n\nconst supportsColor = (stream: WriteStream) => {\n  const res = createSupportsColor(stream, { sniffFlags: false })\n  if (res === false) return false\n  /* c8 ignore next */\n  return res.level > 0\n}\n\n// eslint-disable-next-line no-console\nexport const stdout = (...args: unknown[]) => console.log(...args)\n// eslint-disable-next-line no-console\nexport const stderr = (...args: unknown[]) => console.error(...args)\n\ntype StyleTextFn = (\n  format: Parameters<typeof utilStyleText>[0],\n  s: string,\n) => string\n\n/* c8 ignore start */\nconst styleText: StyleTextFn = (f, s) =>\n  utilStyleText(f, s, { validateStream: false })\n/* c8 ignore stop */\n\n// TODO: stop exporting mutable variables once exec output is refactored\n/* c8 ignore start */\nexport let styleTextStdout: StyleTextFn = (_, s) => s\nexport let styleTextStderr: StyleTextFn = (_, s) => s\n/* c8 ignore stop */\n\nconst identity = <T>(x: T): T => x\n\nexport const getView = <T>(\n  conf: LoadedConfig,\n  views?: Views<T>,\n): View<T> => {\n  const viewName = conf.values.view\n\n  const viewFn =\n    viewName === 'inspect' ? identity\n    : viewName === 'silent' ? () => undefined\n    : typeof views === 'function' ? views\n    : views && typeof views === 'object' ? views[viewName]\n    : identity\n\n  // if the user specified a view that doesn't exist, then set it back to the\n  // default, and try again. This will fall back to identity if it's also\n  // missing. We also always treat 'json' as a valid view that falls back to\n  // identity. This allows the explicit use of `--view=json` to work even\n  // when the default view is `human`.\n  if (\n    !viewFn &&\n    conf.values.view !== defaultView &&\n    conf.values.view !== 'json' &&\n    conf.values.view !== 'silent'\n  ) {\n    conf.values.view = defaultView\n    process.env.VLT_VIEW = defaultView\n    return getView(conf, views)\n  }\n\n  return viewFn ?? identity\n}\n\nexport type OnDone<T> =\n  | ((result: T) => Promise<unknown>)\n  | ((result: T) => unknown)\n\n/**\n * If the view is a View class, then instantiate and start it.\n * If it's a view function, then just define the onDone method.\n */\nconst startView = <T>(\n  conf: LoadedConfig,\n  opts: ViewOptions,\n  views?: Views<T>,\n  { start }: { start: number } = { start: Date.now() },\n): {\n  onDone: OnDone<T>\n  onError?: (err: unknown) => void\n} => {\n  const View = getView<T>(conf, views)\n\n  if (isViewClass(View)) {\n    const view = new View(opts, conf)\n    view.start()\n    return {\n      onDone(r) {\n        return view.done(r, { time: Date.now() - start })\n      },\n      onError(err) {\n        view.error(err)\n      },\n    }\n  }\n\n  return {\n    async onDone(r) {\n      if (r === undefined) return\n      return View(r, opts, conf)\n    },\n  }\n}\n\n/**\n * Main export. Run the command appropriately, displaying output using\n * the user-requested view, or the default if the user requested a view\n * that is not defined for this command.\n */\nexport const outputCommand = async <T>(\n  cliCommand: Command<T>,\n  conf: LoadedConfig,\n  { start }: { start: number } = { start: Date.now() },\n) => {\n  const { usage, views, command } = cliCommand\n\n  if (conf.values.help) {\n    return stdout(usage().usage())\n  }\n\n  const stdoutColor =\n    conf.values.color ?? supportsColor(process.stdout)\n  const stderrColor =\n    conf.values.color ?? supportsColor(process.stderr)\n\n  /* c8 ignore start */\n  if (stdoutColor) styleTextStdout = styleText\n  if (stderrColor) styleTextStderr = styleText\n  /* c8 ignore stop */\n\n  const { onDone, onError } = startView(\n    conf,\n    // assume views will always output to stdout so use color support from there\n    { colors: stdoutColor },\n    views,\n    { start },\n  )\n\n  try {\n    const output = await onDone(await command(conf))\n    if (output !== undefined && conf.values.view !== 'silent') {\n      stdout(\n        conf.values.view === 'json' ?\n          JSON.stringify(output, null, 2)\n        : formatWithOptions(\n            {\n              ...formatOptions,\n              colors: stdoutColor,\n            },\n            output,\n          ),\n      )\n    }\n  } catch (err) {\n    onError?.(err)\n    process.exitCode ||= 1\n\n    printErr(err, usage, stderr, {\n      ...formatOptions,\n      colors: stderrColor,\n    })\n\n    process.exit(process.exitCode)\n  }\n}\n"]}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,SAAS,IAAI,aAAa,GAC3B,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAGpD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEvC,MAAM,aAAa,GAAG,CAAC,MAAmB,EAAE,EAAE;IAC5C,MAAM,GAAG,GAAG,mBAAmB,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9D,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,KAAK,CAAA;IAC/B,oBAAoB;IACpB,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,CAAA;AACtB,CAAC,CAAA;AAED,sCAAsC;AACtC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAA;AAClE,sCAAsC;AACtC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;AAOpE,qBAAqB;AACrB,MAAM,SAAS,GAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACtC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAA;AAChD,oBAAoB;AAEpB,wEAAwE;AACxE,qBAAqB;AACrB,MAAM,CAAC,IAAI,eAAe,GAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;AACrD,MAAM,CAAC,IAAI,eAAe,GAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;AACrD,oBAAoB;AAEpB,MAAM,QAAQ,GAAG,CAAI,CAAI,EAAK,EAAE,CAAC,CAAC,CAAA;AAElC,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,IAAkB,EAClB,KAAgB,EACP,EAAE;IACX,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAA;IAEjC,MAAM,MAAM,GACV,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ;QACjC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS;YACzC,CAAC,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK;gBACrC,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;oBACtD,CAAC,CAAC,QAAQ,CAAA;IAEZ,2EAA2E;IAC3E,uEAAuE;IACvE,0EAA0E;IAC1E,uEAAuE;IACvE,oCAAoC;IACpC,IACE,CAAC,MAAM;QACP,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,WAAW;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,EAC7B,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,WAAW,CAAA;QAC9B,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,WAAW,CAAA;QAClC,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC7B,CAAC;IAED,OAAO,MAAM,IAAI,QAAQ,CAAA;AAC3B,CAAC,CAAA;AAID;;;GAGG;AACH,MAAM,SAAS,GAAG,CAChB,IAAkB,EAClB,IAAiB,EACjB,KAAgB,EAChB,EAAE,KAAK,KAAwB,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAIpD,EAAE;IACF,MAAM,IAAI,GAAG,OAAO,CAAI,IAAI,EAAE,KAAK,CAAC,CAAA;IAEpC,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACjC,IAAI,CAAC,KAAK,EAAE,CAAA;QACZ,OAAO;YACL,KAAK,CAAC,MAAM,CAAC,CAAC;gBACZ,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;YACnD,CAAC;YACD,OAAO,CAAC,GAAG;gBACT,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACjB,CAAC;SACF,CAAA;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,CAAC;YACZ,IAAI,CAAC,KAAK,SAAS;gBAAE,OAAM;YAC3B,OAAO,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QAC5B,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,UAAsB,EACtB,IAAkB,EAClB,EAAE,KAAK,KAAwB,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EACpD,EAAE;IACF,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,CAAA;IAE5C,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,CAAA;IAChC,CAAC;IAED,MAAM,WAAW,GACf,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACpD,MAAM,WAAW,GACf,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAEpD,qBAAqB;IACrB,IAAI,WAAW;QAAE,eAAe,GAAG,SAAS,CAAA;IAC5C,IAAI,WAAW;QAAE,eAAe,GAAG,SAAS,CAAA;IAC5C,oBAAoB;IAEpB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CACnC,IAAI;IACJ,4EAA4E;IAC5E,EAAE,MAAM,EAAE,WAAW,EAAE,EACvB,KAAK,EACL,EAAE,KAAK,EAAE,CACV,CAAA;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QAChD,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1D,MAAM,CACJ,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;gBAC3B,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjC,CAAC,CAAC,iBAAiB,CACf;oBACE,GAAG,aAAa;oBAChB,MAAM,EAAE,WAAW;iBACpB,EACD,MAAM,CACP,CACJ,CAAA;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,CAAC,GAAG,CAAC,CAAA;QACd,OAAO,CAAC,QAAQ,KAAK,CAAC,CAAA;QAEtB,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE;YAC3B,GAAG,aAAa;YAChB,MAAM,EAAE,WAAW;SACpB,CAAC,CAAA;QAEF,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAChC,CAAC;AACH,CAAC,CAAA","sourcesContent":["import type { WriteStream } from 'node:tty'\nimport {\n  formatWithOptions,\n  styleText as utilStyleText,\n} from 'node:util'\nimport { createSupportsColor } from 'supports-color'\nimport { defaultView } from './config/definition.ts'\nimport type { LoadedConfig } from './config/index.ts'\nimport type { Command } from './index.ts'\nimport { printErr, formatOptions } from './print-err.ts'\nimport type { View, ViewOptions, Views } from './view.ts'\nimport { isViewClass } from './view.ts'\n\nconst supportsColor = (stream: WriteStream) => {\n  const res = createSupportsColor(stream, { sniffFlags: false })\n  if (res === false) return false\n  /* c8 ignore next */\n  return res.level > 0\n}\n\n// eslint-disable-next-line no-console\nexport const stdout = (...args: unknown[]) => console.log(...args)\n// eslint-disable-next-line no-console\nexport const stderr = (...args: unknown[]) => console.error(...args)\n\ntype StyleTextFn = (\n  format: Parameters<typeof utilStyleText>[0],\n  s: string,\n) => string\n\n/* c8 ignore start */\nconst styleText: StyleTextFn = (f, s) =>\n  utilStyleText(f, s, { validateStream: false })\n/* c8 ignore stop */\n\n// TODO: stop exporting mutable variables once exec output is refactored\n/* c8 ignore start */\nexport let styleTextStdout: StyleTextFn = (_, s) => s\nexport let styleTextStderr: StyleTextFn = (_, s) => s\n/* c8 ignore stop */\n\nconst identity = <T>(x: T): T => x\n\nexport const getView = <T>(\n  conf: LoadedConfig,\n  views?: Views<T>,\n): View<T> => {\n  const viewName = conf.values.view\n\n  const viewFn =\n    viewName === 'inspect' ? identity\n    : viewName === 'silent' ? () => undefined\n    : typeof views === 'function' ? views\n    : views && typeof views === 'object' ? views[viewName]\n    : identity\n\n  // if the user specified a view that doesn't exist, then set it back to the\n  // default, and try again. This will fall back to identity if it's also\n  // missing. We also always treat 'json' as a valid view that falls back to\n  // identity. This allows the explicit use of `--view=json` to work even\n  // when the default view is `human`.\n  if (\n    !viewFn &&\n    conf.values.view !== defaultView &&\n    conf.values.view !== 'json' &&\n    conf.values.view !== 'silent'\n  ) {\n    conf.values.view = defaultView\n    process.env.VLT_VIEW = defaultView\n    return getView(conf, views)\n  }\n\n  return viewFn ?? identity\n}\n\nexport type OnDone<T> = (result: T) => Promise<unknown>\n\n/**\n * If the view is a View class, then instantiate and start it.\n * If it's a view function, then just define the onDone method.\n */\nconst startView = <T>(\n  conf: LoadedConfig,\n  opts: ViewOptions,\n  views?: Views<T>,\n  { start }: { start: number } = { start: Date.now() },\n): {\n  onDone: OnDone<T>\n  onError?: (err: unknown) => void\n} => {\n  const View = getView<T>(conf, views)\n\n  if (isViewClass(View)) {\n    const view = new View(opts, conf)\n    view.start()\n    return {\n      async onDone(r) {\n        return view.done(r, { time: Date.now() - start })\n      },\n      onError(err) {\n        view.error(err)\n      },\n    }\n  }\n\n  return {\n    async onDone(r) {\n      if (r === undefined) return\n      return View(r, opts, conf)\n    },\n  }\n}\n\n/**\n * Main export. Run the command appropriately, displaying output using\n * the user-requested view, or the default if the user requested a view\n * that is not defined for this command.\n */\nexport const outputCommand = async <T>(\n  cliCommand: Command<T>,\n  conf: LoadedConfig,\n  { start }: { start: number } = { start: Date.now() },\n) => {\n  const { usage, views, command } = cliCommand\n\n  if (conf.values.help) {\n    return stdout(usage().usage())\n  }\n\n  const stdoutColor =\n    conf.values.color ?? supportsColor(process.stdout)\n  const stderrColor =\n    conf.values.color ?? supportsColor(process.stderr)\n\n  /* c8 ignore start */\n  if (stdoutColor) styleTextStdout = styleText\n  if (stderrColor) styleTextStderr = styleText\n  /* c8 ignore stop */\n\n  const { onDone, onError } = startView(\n    conf,\n    // assume views will always output to stdout so use color support from there\n    { colors: stdoutColor },\n    views,\n    { start },\n  )\n\n  try {\n    const output = await onDone(await command(conf))\n    if (output !== undefined && conf.values.view !== 'silent') {\n      stdout(\n        conf.values.view === 'json' ?\n          JSON.stringify(output, null, 2)\n        : formatWithOptions(\n            {\n              ...formatOptions,\n              colors: stdoutColor,\n            },\n            output,\n          ),\n      )\n    }\n  } catch (err) {\n    onError?.(err)\n    process.exitCode ||= 1\n\n    printErr(err, usage, stderr, {\n      ...formatOptions,\n      colors: stderrColor,\n    })\n\n    process.exit(process.exitCode)\n  }\n}\n"]}

package/dist/esm/view.d.ts

@@ -20,7 +20,7 @@ export declare class ViewClass<T = unknown> {
     start(): void;
     done(_result: T, _opts: {
         time: number;
-    }): unknown;
+    }): Promise<unknown>;
     error(_err: unknown): void;
 }
 export type ViewFn<T = unknown> = (result: T, options: ViewOptions, conf: LoadedConfig) => unknown;

package/dist/esm/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE9C;;;;;;;;;;GAUG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;IAChC,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,YAAY,CAAA;gBAER,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY;IAQtD,KAAK;IACL,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAGlD,KAAK,CAAC,IAAI,EAAE,OAAO;CACpB;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,OAAO,IAAI,CAChC,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,YAAY,KACf,OAAO,CAAA;AAEZ,MAAM,MAAM,IAAI,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,SAAS,CAAC,CAAC,CAAC,CAAA;AAE/D,eAAO,MAAM,WAAW,GAAI,CAAC,kBACrB,IAAI,CAAC,CAAC,CAAC,KACZ,IAAI,IAAI,OAAO,SAAS,CAAC,CAAC,CAGQ,CAAA;AAErC,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE9C;;;;;;;;;;GAUG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;IAChC,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,YAAY,CAAA;gBAER,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY;IAQtD,KAAK;IACC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAGjE,KAAK,CAAC,IAAI,EAAE,OAAO;CACpB;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,OAAO,IAAI,CAChC,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,YAAY,KACf,OAAO,CAAA;AAEZ,MAAM,MAAM,IAAI,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,SAAS,CAAC,CAAC,CAAC,CAAA;AAE/D,eAAO,MAAM,WAAW,GAAI,CAAC,kBACrB,IAAI,CAAC,CAAC,CAAC,KACZ,IAAI,IAAI,OAAO,SAAS,CAAC,CAAC,CAGQ,CAAA;AAErC,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/esm/view.js

@@ -20,7 +20,7 @@ export class ViewClass {
     // run the command", for example to have the gui just open a web browser
     // to the page relevant to a given thing, rather than computing it twice
     start() { }
-    done(_result, _opts) {
+    async done(_result, _opts) {
         return;
     }
     error(_err) { }

package/dist/esm/view.js.map

@@ -1 +1 @@
-{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/view.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,SAAS;IACpB,OAAO,CAAa;IACpB,MAAM,CAAc;IAEpB,YAAY,OAAoB,EAAE,MAAoB;QACpD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,oEAAoE;IACpE,wEAAwE;IACxE,wEAAwE;IACxE,KAAK,KAAI,CAAC;IACV,IAAI,CAAC,OAAU,EAAE,KAAuB;QACtC,OAAM;IACR,CAAC;IACD,KAAK,CAAC,IAAa,IAAG,CAAC;CACxB;AAUD,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,IAAa,EACgB,EAAE,CAC/B,OAAO,IAAI,KAAK,UAAU;IAC1B,WAAW,IAAI,IAAI;IACnB,IAAI,CAAC,SAAS,YAAY,SAAS,CAAA","sourcesContent":["import type { LoadedConfig } from './config/index.ts'\n\nexport type ViewOptions = { colors?: boolean }\n\n/**\n * The base class for all View classes\n *\n * Do not override the constructor, just provide start/done/error methods.\n *\n * These classes should be used as one or more of the exported views for\n * commands that need to know when the processing starts, handle errors in\n * various ways, etc. Fancy stuff.\n *\n * For simple use cases, usually better to create a {@link ViewFn} instead.\n */\nexport class ViewClass<T = unknown> {\n  options: ViewOptions\n  config: LoadedConfig\n\n  constructor(options: ViewOptions, config: LoadedConfig) {\n    this.options = options\n    this.config = config\n  }\n\n  // TODO: maybe have start() return a flag to say \"i got this, do not\n  // run the command\", for example to have the gui just open a web browser\n  // to the page relevant to a given thing, rather than computing it twice\n  start() {}\n  done(_result: T, _opts: { time: number }): unknown {\n    return\n  }\n  error(_err: unknown) {}\n}\n\nexport type ViewFn<T = unknown> = (\n  result: T,\n  options: ViewOptions,\n  conf: LoadedConfig,\n) => unknown\n\nexport type View<T = unknown> = ViewFn<T> | typeof ViewClass<T>\n\nexport const isViewClass = <T = unknown>(\n  view: View<T>,\n): view is typeof ViewClass<T> =>\n  typeof view === 'function' &&\n  'prototype' in view &&\n  view.prototype instanceof ViewClass\n\nexport type Views<T = unknown> = View<T> | Record<string, View<T>>\n"]}
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/view.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,SAAS;IACpB,OAAO,CAAa;IACpB,MAAM,CAAc;IAEpB,YAAY,OAAoB,EAAE,MAAoB;QACpD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,oEAAoE;IACpE,wEAAwE;IACxE,wEAAwE;IACxE,KAAK,KAAI,CAAC;IACV,KAAK,CAAC,IAAI,CAAC,OAAU,EAAE,KAAuB;QAC5C,OAAM;IACR,CAAC;IACD,KAAK,CAAC,IAAa,IAAG,CAAC;CACxB;AAUD,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,IAAa,EACgB,EAAE,CAC/B,OAAO,IAAI,KAAK,UAAU;IAC1B,WAAW,IAAI,IAAI;IACnB,IAAI,CAAC,SAAS,YAAY,SAAS,CAAA","sourcesContent":["import type { LoadedConfig } from './config/index.ts'\n\nexport type ViewOptions = { colors?: boolean }\n\n/**\n * The base class for all View classes\n *\n * Do not override the constructor, just provide start/done/error methods.\n *\n * These classes should be used as one or more of the exported views for\n * commands that need to know when the processing starts, handle errors in\n * various ways, etc. Fancy stuff.\n *\n * For simple use cases, usually better to create a {@link ViewFn} instead.\n */\nexport class ViewClass<T = unknown> {\n  options: ViewOptions\n  config: LoadedConfig\n\n  constructor(options: ViewOptions, config: LoadedConfig) {\n    this.options = options\n    this.config = config\n  }\n\n  // TODO: maybe have start() return a flag to say \"i got this, do not\n  // run the command\", for example to have the gui just open a web browser\n  // to the page relevant to a given thing, rather than computing it twice\n  start() {}\n  async done(_result: T, _opts: { time: number }): Promise<unknown> {\n    return\n  }\n  error(_err: unknown) {}\n}\n\nexport type ViewFn<T = unknown> = (\n  result: T,\n  options: ViewOptions,\n  conf: LoadedConfig,\n) => unknown\n\nexport type View<T = unknown> = ViewFn<T> | typeof ViewClass<T>\n\nexport const isViewClass = <T = unknown>(\n  view: View<T>,\n): view is typeof ViewClass<T> =>\n  typeof view === 'function' &&\n  'prototype' in view &&\n  view.prototype instanceof ViewClass\n\nexport type Views<T = unknown> = View<T> | Record<string, View<T>>\n"]}