@vltpkg/cli-sdk 0.0.0-9 → 1.0.0-rc.1

package/dist/esm/custom-help.js

@@ -0,0 +1,400 @@
+import { loadPackageJson } from 'package-json-from-dist';
+import chalk from 'chalk';
+const { version } = loadPackageJson(import.meta.filename, process.env.__VLT_INTERNAL_CLI_PACKAGE_JSON);
+// Custom yellow color: #FFE15D
+const customYellow = chalk.hex('#FFE15D');
+const makeStyler = (colors) => {
+    if (!colors)
+        return (_, s) => s;
+    return (style, text) => {
+        const styles = Array.isArray(style) ? style : [style];
+        let styledText = text;
+        for (const s of styles) {
+            switch (s) {
+                case 'yellow':
+                case 'yellowBright':
+                    styledText = customYellow(styledText);
+                    break;
+                case 'bold':
+                    styledText = chalk.bold(styledText);
+                    break;
+                case 'dim':
+                    styledText = chalk.dim(styledText);
+                    break;
+                case 'dark':
+                    styledText = chalk.gray(styledText);
+                    break;
+                case 'cyan':
+                    styledText = chalk.cyan(styledText);
+                    break;
+                case 'green':
+                    styledText = chalk.green(styledText);
+                    break;
+                default:
+                    // Fallback to chalk's built-in colors
+                    if (s in chalk &&
+                        typeof chalk[s] === 'function') {
+                        styledText = chalk[s](styledText);
+                    }
+                    break;
+            }
+        }
+        return styledText;
+    };
+};
+// Single source of truth for all commands with metadata
+const allCommands = [
+    {
+        name: 'build',
+        aliases: ['b'],
+        args: '<selector>',
+        desc: 'Build packages with lifecycle scripts',
+        showByDefault: true,
+        defaultOrder: 4,
+    },
+    {
+        name: 'cache',
+        aliases: [],
+        args: '[add|ls|info|clean|delete|delete-before|delete-all]',
+        desc: 'Manage the package cache',
+        showByDefault: false,
+    },
+    {
+        name: 'ci',
+        aliases: [],
+        args: '',
+        desc: 'Clean install (frozen lockfile)',
+        showByDefault: false,
+    },
+    {
+        name: 'config',
+        aliases: [],
+        args: '[get|pick|list|set|delete|edit|location]',
+        desc: 'Get or set configuration',
+        showByDefault: false,
+    },
+    {
+        name: 'docs',
+        aliases: [],
+        args: '',
+        desc: 'Open the docs of the current project',
+        showByDefault: false,
+    },
+    {
+        name: 'exec',
+        aliases: ['x'],
+        args: '<executable>',
+        desc: 'Execute a package bin',
+        showByDefault: true,
+        defaultOrder: 6,
+    },
+    {
+        name: 'exec-cache',
+        aliases: ['xc'],
+        args: '[ls|delete|info|install]',
+        desc: 'Manage the exec cache',
+        showByDefault: false,
+    },
+    {
+        name: 'exec-local',
+        aliases: ['xl'],
+        args: '<command>',
+        desc: 'Execute a local package bin',
+        showByDefault: false,
+    },
+    {
+        name: 'help',
+        aliases: ['h', '?'],
+        args: '[<command>]',
+        desc: 'Show help for a command',
+        showByDefault: false,
+    },
+    {
+        name: 'init',
+        aliases: [],
+        args: '',
+        desc: 'Initialize a new project',
+        showByDefault: true,
+        defaultOrder: 1,
+    },
+    {
+        name: 'install',
+        aliases: ['i', 'add'],
+        args: '[<package>...]',
+        desc: 'Install dependencies',
+        showByDefault: true,
+        defaultOrder: 2,
+    },
+    {
+        name: 'list',
+        aliases: ['ls'],
+        args: '',
+        desc: 'List installed packages',
+        showByDefault: false,
+    },
+    {
+        name: 'login',
+        aliases: [],
+        args: '',
+        desc: 'Authenticate with a registry',
+        showByDefault: false,
+    },
+    {
+        name: 'logout',
+        aliases: [],
+        args: '',
+        desc: 'Log out from a registry',
+        showByDefault: false,
+    },
+    {
+        name: 'pack',
+        aliases: [],
+        args: '',
+        desc: 'Create a tarball from a package',
+        showByDefault: false,
+    },
+    {
+        name: 'pkg',
+        aliases: ['p'],
+        args: '<command>',
+        desc: 'Manage package metadata',
+        showByDefault: true,
+        defaultOrder: 7,
+    },
+    {
+        name: 'publish',
+        aliases: ['pub'],
+        args: '',
+        desc: 'Publish package to registry',
+        showByDefault: true,
+        defaultOrder: 8,
+    },
+    {
+        name: 'query',
+        aliases: ['q'],
+        args: '<selector>',
+        desc: 'Query for packages in the project',
+        showByDefault: true,
+        defaultOrder: 3,
+    },
+    {
+        name: 'run',
+        aliases: ['r'],
+        args: '<script>',
+        desc: 'Run a script defined in package.json',
+        showByDefault: true,
+        defaultOrder: 5,
+    },
+    {
+        name: 'run-exec',
+        aliases: ['rx'],
+        args: '<script>',
+        desc: 'Run a script &/or fallback to executing a binary',
+        showByDefault: false,
+    },
+    {
+        name: 'serve',
+        aliases: ['s'],
+        args: '',
+        desc: 'Start a local package registry server',
+        showByDefault: true,
+        defaultOrder: 9,
+    },
+    {
+        name: 'token',
+        aliases: [],
+        args: '[add|rm]',
+        desc: 'Manage authentication tokens',
+        showByDefault: false,
+    },
+    {
+        name: 'uninstall',
+        aliases: ['rm'],
+        args: '[<package>...]',
+        desc: 'Remove dependencies',
+        showByDefault: false,
+    },
+    {
+        name: 'update',
+        aliases: ['u'],
+        args: '',
+        desc: 'Update package versions to latest in-range',
+        showByDefault: false,
+    },
+    {
+        name: 'version',
+        aliases: [],
+        args: '<increment>',
+        desc: 'Bump package version',
+        showByDefault: false,
+    },
+    {
+        name: 'whoami',
+        aliases: [],
+        args: '',
+        desc: 'Display the current user',
+        showByDefault: false,
+    },
+];
+/**
+ * Generates the custom default help output for vlt
+ */
+export const generateDefaultHelp = (colors = false) => {
+    const s = makeStyler(colors);
+    // Get default commands and sort by defaultOrder
+    const defaultCommands = allCommands
+        .filter(cmd => cmd.showByDefault)
+        .sort((a, b) => (a.defaultOrder || 0) - (b.defaultOrder || 0));
+    // Generate commands with tighter alias spacing but proper table structure
+    const commandsSection = defaultCommands
+        .map(cmd => {
+        // Tighter alias column (5 chars to accommodate space after comma) - only show first alias
+        const firstAlias = cmd.aliases.length > 0 ? cmd.aliases[0] : '';
+        const aliasColumn = firstAlias ? (firstAlias + ', ').padEnd(5) : '     ';
+        // Consistent name column (10 chars)
+        const nameColumn = cmd.name.padEnd(10);
+        // Consistent args column (14 chars)
+        const argsColumn = cmd.args.padEnd(16);
+        return `  ${s('dim', aliasColumn)}${s(['yellow', 'bold'], nameColumn)}${s('dim', argsColumn)}${cmd.desc}`;
+    })
+        .join('\n');
+    return `${s(['bold'], '⚡️ vlt')} ${s('dim', '/vōlt/')} next-gen package management ${s('dim', `v${version}`)}
+
+${s('bold', 'USAGE')}
+
+  ${s('bold', 'vlt')} ${s('dim', '<command>')}
+
+${s('bold', 'COMMON COMMANDS')}
+
+${commandsSection}
+ 
+${s('bold', 'COMPANION BINS')}
+
+  ${s('bold', 'vlr')}            ${s('dim', 'eq. vlt run')}
+  ${s('bold', 'vlx')}            ${s('dim', 'eq. vlt exec')}
+  
+${s('bold', 'COMMON FLAGS')}
+
+  ${s('green', '-v, --version')}                  Log the cli version
+  ${s('green', '-a, --all')}                      List all commands, bins & flags
+
+Learn more: https://${s('bold', 'vlt.sh')}
+Get support: https://${s('bold', 'vlt.community')}
+
+${s('dim', `This is not the full usage information, run \`vlt -a\` for more.`)}
+`;
+};
+/**
+ * Generates the full help output with all commands when --all flag is used
+ */
+export const generateFullHelp = (colors = false) => {
+    const s = makeStyler(colors);
+    // Use all commands sorted alphabetically
+    const commands = [...allCommands].sort((a, b) => a.name.localeCompare(b.name));
+    // Define only globally applicable flags (alphabetically sorted by long name)
+    const flags = [
+        {
+            shorts: ['a'],
+            long: 'all',
+            args: '',
+            desc: 'Show all commands, bins, and flags',
+        },
+        {
+            shorts: ['c'],
+            long: 'color',
+            args: '',
+            desc: 'Enable color output',
+        },
+        {
+            shorts: ['h'],
+            long: 'help',
+            args: '',
+            desc: 'Print helpful information',
+        },
+        {
+            shorts: [],
+            long: 'no-color',
+            args: '',
+            desc: 'Disable color output',
+        },
+        {
+            shorts: [],
+            long: 'registry',
+            args: '<url>',
+            desc: 'Override default registry',
+        },
+        {
+            shorts: ['v'],
+            long: 'version',
+            args: '',
+            desc: 'Print the version',
+        },
+        {
+            shorts: ['y'],
+            long: 'yes',
+            args: '',
+            desc: 'Automatically accept prompts',
+        },
+    ];
+    // Generate commands section with letter grouping spacing
+    let commandsSection = '';
+    let lastFirstLetter = '';
+    commands.forEach((cmd, index) => {
+        const firstLetter = cmd.name[0]?.toLowerCase() || '';
+        // Add extra spacing between different letter groups
+        if (firstLetter !== lastFirstLetter && index > 0) {
+            commandsSection += '\n';
+        }
+        // Fixed width columns for proper alignment with space after comma
+        const aliasColumn = cmd.aliases.length > 0 ?
+            (cmd.aliases.join(', ') + ', ').padEnd(9)
+            : '         ';
+        const nameColumn = cmd.name.padEnd(12);
+        // Truncate args if longer than 16 chars and add ellipsis
+        const truncatedArgs = cmd.args.length > 16 ?
+            cmd.args.substring(0, 13) + '...'
+            : cmd.args;
+        const argsColumn = truncatedArgs.padEnd(16);
+        commandsSection += `${s('dim', aliasColumn)}${s(['yellow', 'bold'], nameColumn)}${s('dim', argsColumn)}${cmd.desc}`;
+        if (index < commands.length - 1) {
+            commandsSection += '\n';
+        }
+        lastFirstLetter = firstLetter;
+    });
+    // Generate flags section with same structure as commands
+    const flagsSection = flags
+        .map(f => {
+        // Match command structure: alias column, name column, args column, description
+        const aliasColumn = f.shorts.length > 0 ?
+            ('-' + f.shorts.join(', -') + ', ').padEnd(7)
+            : '       ';
+        const nameColumn = ('--' + f.long).padEnd(12);
+        const argsColumn = (f.args || '').padEnd(17);
+        return `  ${s('dim', aliasColumn)}${s('green', nameColumn)}${s('dim', argsColumn)}${f.desc}`;
+    })
+        .join('\n');
+    return `${s(['bold'], '⚡️ vlt')} ${s('dim', '/vōlt/')} ${s('dim', '- next-gen package management')} ${s('dim', `v${version}`)}
+
+${s('bold', 'USAGE')}
+
+  ${s('bold', 'vlt')} ${s('dim', '<command>')}
+
+${s('bold', 'COMMANDS')}
+
+${commandsSection}
+
+${s('bold', 'COMPANION BINS')}
+
+  vlr    ${s('dim', 'eq. vlt run')}
+  vlx    ${s('dim', 'eq. vlt exec')}
+
+${s('bold', 'FLAGS')}
+
+${flagsSection}
+
+Learn more: https://${s('bold', 'vlt.sh')}
+Get support: https://${s('bold', 'vlt.community')}
+
+${s('dim', `Run \`vlt help <command>\` for detailed information about a specific command.`)}`;
+};
+//# sourceMappingURL=custom-help.js.map

package/dist/esm/custom-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-help.js","sourceRoot":"","sources":["../../src/custom-help.ts"],"names":[],"mappings":"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","sourcesContent":["import { loadPackageJson } from 'package-json-from-dist'\nimport chalk from 'chalk'\n\nconst { version } = loadPackageJson(\n  import.meta.filename,\n  process.env.__VLT_INTERNAL_CLI_PACKAGE_JSON,\n) as {\n  version: string\n}\n\n// Custom yellow color: #FFE15D\nconst customYellow = chalk.hex('#FFE15D')\n\ntype StylerFn = (style: string | string[], text: string) => string\n\nconst makeStyler = (colors: boolean): StylerFn => {\n  if (!colors) return (_, s) => s\n\n  return (style: string | string[], text: string): string => {\n    const styles = Array.isArray(style) ? style : [style]\n    let styledText = text\n\n    for (const s of styles) {\n      switch (s) {\n        case 'yellow':\n        case 'yellowBright':\n          styledText = customYellow(styledText)\n          break\n        case 'bold':\n          styledText = chalk.bold(styledText)\n          break\n        case 'dim':\n          styledText = chalk.dim(styledText)\n          break\n        case 'dark':\n          styledText = chalk.gray(styledText)\n          break\n        case 'cyan':\n          styledText = chalk.cyan(styledText)\n          break\n        case 'green':\n          styledText = chalk.green(styledText)\n          break\n        default:\n          // Fallback to chalk's built-in colors\n          if (\n            s in chalk &&\n            typeof chalk[s as keyof typeof chalk] === 'function'\n          ) {\n            styledText = (\n              chalk[s as keyof typeof chalk] as (\n                text: string,\n              ) => string\n            )(styledText)\n          }\n          break\n      }\n    }\n\n    return styledText\n  }\n}\n\n// Single source of truth for all commands with metadata\nconst allCommands = [\n  {\n    name: 'build',\n    aliases: ['b'],\n    args: '<selector>',\n    desc: 'Build packages with lifecycle scripts',\n    showByDefault: true,\n    defaultOrder: 4,\n  },\n  {\n    name: 'cache',\n    aliases: [],\n    args: '[add|ls|info|clean|delete|delete-before|delete-all]',\n    desc: 'Manage the package cache',\n    showByDefault: false,\n  },\n  {\n    name: 'ci',\n    aliases: [],\n    args: '',\n    desc: 'Clean install (frozen lockfile)',\n    showByDefault: false,\n  },\n  {\n    name: 'config',\n    aliases: [],\n    args: '[get|pick|list|set|delete|edit|location]',\n    desc: 'Get or set configuration',\n    showByDefault: false,\n  },\n  {\n    name: 'docs',\n    aliases: [],\n    args: '',\n    desc: 'Open the docs of the current project',\n    showByDefault: false,\n  },\n  {\n    name: 'exec',\n    aliases: ['x'],\n    args: '<executable>',\n    desc: 'Execute a package bin',\n    showByDefault: true,\n    defaultOrder: 6,\n  },\n  {\n    name: 'exec-cache',\n    aliases: ['xc'],\n    args: '[ls|delete|info|install]',\n    desc: 'Manage the exec cache',\n    showByDefault: false,\n  },\n  {\n    name: 'exec-local',\n    aliases: ['xl'],\n    args: '<command>',\n    desc: 'Execute a local package bin',\n    showByDefault: false,\n  },\n  {\n    name: 'help',\n    aliases: ['h', '?'],\n    args: '[<command>]',\n    desc: 'Show help for a command',\n    showByDefault: false,\n  },\n  {\n    name: 'init',\n    aliases: [],\n    args: '',\n    desc: 'Initialize a new project',\n    showByDefault: true,\n    defaultOrder: 1,\n  },\n  {\n    name: 'install',\n    aliases: ['i', 'add'],\n    args: '[<package>...]',\n    desc: 'Install dependencies',\n    showByDefault: true,\n    defaultOrder: 2,\n  },\n  {\n    name: 'list',\n    aliases: ['ls'],\n    args: '',\n    desc: 'List installed packages',\n    showByDefault: false,\n  },\n  {\n    name: 'login',\n    aliases: [],\n    args: '',\n    desc: 'Authenticate with a registry',\n    showByDefault: false,\n  },\n  {\n    name: 'logout',\n    aliases: [],\n    args: '',\n    desc: 'Log out from a registry',\n    showByDefault: false,\n  },\n  {\n    name: 'pack',\n    aliases: [],\n    args: '',\n    desc: 'Create a tarball from a package',\n    showByDefault: false,\n  },\n  {\n    name: 'pkg',\n    aliases: ['p'],\n    args: '<command>',\n    desc: 'Manage package metadata',\n    showByDefault: true,\n    defaultOrder: 7,\n  },\n  {\n    name: 'publish',\n    aliases: ['pub'],\n    args: '',\n    desc: 'Publish package to registry',\n    showByDefault: true,\n    defaultOrder: 8,\n  },\n  {\n    name: 'query',\n    aliases: ['q'],\n    args: '<selector>',\n    desc: 'Query for packages in the project',\n    showByDefault: true,\n    defaultOrder: 3,\n  },\n  {\n    name: 'run',\n    aliases: ['r'],\n    args: '<script>',\n    desc: 'Run a script defined in package.json',\n    showByDefault: true,\n    defaultOrder: 5,\n  },\n  {\n    name: 'run-exec',\n    aliases: ['rx'],\n    args: '<script>',\n    desc: 'Run a script &/or fallback to executing a binary',\n    showByDefault: false,\n  },\n  {\n    name: 'serve',\n    aliases: ['s'],\n    args: '',\n    desc: 'Start a local package registry server',\n    showByDefault: true,\n    defaultOrder: 9,\n  },\n  {\n    name: 'token',\n    aliases: [],\n    args: '[add|rm]',\n    desc: 'Manage authentication tokens',\n    showByDefault: false,\n  },\n  {\n    name: 'uninstall',\n    aliases: ['rm'],\n    args: '[<package>...]',\n    desc: 'Remove dependencies',\n    showByDefault: false,\n  },\n  {\n    name: 'update',\n    aliases: ['u'],\n    args: '',\n    desc: 'Update package versions to latest in-range',\n    showByDefault: false,\n  },\n  {\n    name: 'version',\n    aliases: [],\n    args: '<increment>',\n    desc: 'Bump package version',\n    showByDefault: false,\n  },\n  {\n    name: 'whoami',\n    aliases: [],\n    args: '',\n    desc: 'Display the current user',\n    showByDefault: false,\n  },\n]\n\n/**\n * Generates the custom default help output for vlt\n */\nexport const generateDefaultHelp = (colors = false): string => {\n  const s = makeStyler(colors)\n\n  // Get default commands and sort by defaultOrder\n  const defaultCommands = allCommands\n    .filter(cmd => cmd.showByDefault)\n    .sort((a, b) => (a.defaultOrder || 0) - (b.defaultOrder || 0))\n\n  // Generate commands with tighter alias spacing but proper table structure\n  const commandsSection = defaultCommands\n    .map(cmd => {\n      // Tighter alias column (5 chars to accommodate space after comma) - only show first alias\n      const firstAlias = cmd.aliases.length > 0 ? cmd.aliases[0] : ''\n      const aliasColumn =\n        firstAlias ? (firstAlias + ', ').padEnd(5) : '     '\n      // Consistent name column (10 chars)\n      const nameColumn = cmd.name.padEnd(10)\n      // Consistent args column (14 chars)\n      const argsColumn = cmd.args.padEnd(16)\n\n      return `  ${s('dim', aliasColumn)}${s(['yellow', 'bold'], nameColumn)}${s('dim', argsColumn)}${cmd.desc}`\n    })\n    .join('\\n')\n\n  return `${s(['bold'], '⚡️ vlt')} ${s('dim', '/vōlt/')} next-gen package management ${s('dim', `v${version}`)}\n\n${s('bold', 'USAGE')}\n\n  ${s('bold', 'vlt')} ${s('dim', '<command>')}\n\n${s('bold', 'COMMON COMMANDS')}\n\n${commandsSection}\n \n${s('bold', 'COMPANION BINS')}\n\n  ${s('bold', 'vlr')}            ${s('dim', 'eq. vlt run')}\n  ${s('bold', 'vlx')}            ${s('dim', 'eq. vlt exec')}\n  \n${s('bold', 'COMMON FLAGS')}\n\n  ${s('green', '-v, --version')}                  Log the cli version\n  ${s('green', '-a, --all')}                      List all commands, bins & flags\n\nLearn more: https://${s('bold', 'vlt.sh')}\nGet support: https://${s('bold', 'vlt.community')}\n\n${s('dim', `This is not the full usage information, run \\`vlt -a\\` for more.`)}\n`\n}\n\n/**\n * Generates the full help output with all commands when --all flag is used\n */\nexport const generateFullHelp = (colors = false): string => {\n  const s = makeStyler(colors)\n\n  // Use all commands sorted alphabetically\n  const commands = [...allCommands].sort((a, b) =>\n    a.name.localeCompare(b.name),\n  )\n\n  // Define only globally applicable flags (alphabetically sorted by long name)\n  const flags = [\n    {\n      shorts: ['a'],\n      long: 'all',\n      args: '',\n      desc: 'Show all commands, bins, and flags',\n    },\n    {\n      shorts: ['c'],\n      long: 'color',\n      args: '',\n      desc: 'Enable color output',\n    },\n    {\n      shorts: ['h'],\n      long: 'help',\n      args: '',\n      desc: 'Print helpful information',\n    },\n    {\n      shorts: [],\n      long: 'no-color',\n      args: '',\n      desc: 'Disable color output',\n    },\n    {\n      shorts: [],\n      long: 'registry',\n      args: '<url>',\n      desc: 'Override default registry',\n    },\n    {\n      shorts: ['v'],\n      long: 'version',\n      args: '',\n      desc: 'Print the version',\n    },\n    {\n      shorts: ['y'],\n      long: 'yes',\n      args: '',\n      desc: 'Automatically accept prompts',\n    },\n  ]\n\n  // Generate commands section with letter grouping spacing\n  let commandsSection = ''\n  let lastFirstLetter = ''\n\n  commands.forEach((cmd, index) => {\n    const firstLetter = cmd.name[0]?.toLowerCase() || ''\n\n    // Add extra spacing between different letter groups\n    if (firstLetter !== lastFirstLetter && index > 0) {\n      commandsSection += '\\n'\n    }\n\n    // Fixed width columns for proper alignment with space after comma\n    const aliasColumn =\n      cmd.aliases.length > 0 ?\n        (cmd.aliases.join(', ') + ', ').padEnd(9)\n      : '         '\n    const nameColumn = cmd.name.padEnd(12)\n    // Truncate args if longer than 16 chars and add ellipsis\n    const truncatedArgs =\n      cmd.args.length > 16 ?\n        cmd.args.substring(0, 13) + '...'\n      : cmd.args\n    const argsColumn = truncatedArgs.padEnd(16)\n\n    commandsSection += `${s('dim', aliasColumn)}${s(['yellow', 'bold'], nameColumn)}${s('dim', argsColumn)}${cmd.desc}`\n\n    if (index < commands.length - 1) {\n      commandsSection += '\\n'\n    }\n\n    lastFirstLetter = firstLetter\n  })\n\n  // Generate flags section with same structure as commands\n  const flagsSection = flags\n    .map(f => {\n      // Match command structure: alias column, name column, args column, description\n      const aliasColumn =\n        f.shorts.length > 0 ?\n          ('-' + f.shorts.join(', -') + ', ').padEnd(7)\n        : '       '\n      const nameColumn = ('--' + f.long).padEnd(12)\n      const argsColumn = (f.args || '').padEnd(17)\n\n      return `  ${s('dim', aliasColumn)}${s('green', nameColumn)}${s('dim', argsColumn)}${f.desc}`\n    })\n    .join('\\n')\n\n  return `${s(['bold'], '⚡️ vlt')} ${s('dim', '/vōlt/')} ${s('dim', '- next-gen package management')} ${s('dim', `v${version}`)}\n\n${s('bold', 'USAGE')}\n\n  ${s('bold', 'vlt')} ${s('dim', '<command>')}\n\n${s('bold', 'COMMANDS')}\n\n${commandsSection}\n\n${s('bold', 'COMPANION BINS')}\n\n  vlr    ${s('dim', 'eq. vlt run')}\n  vlx    ${s('dim', 'eq. vlt exec')}\n\n${s('bold', 'FLAGS')}\n\n${flagsSection}\n\nLearn more: https://${s('bold', 'vlt.sh')}\nGet support: https://${s('bold', 'vlt.community')}\n\n${s('dim', `Run \\`vlt help <command>\\` for detailed information about a specific command.`)}`\n}\n"]}

package/dist/esm/exec-command.d.ts

@@ -1,34 +1,53 @@
 /**
- * Implementation shared between `vlt run`, `vlt run-exec`, and `vlt exec`
+ * impl for `vlt run`, `vlt run-exec`, `vlt exec-local`, `vlt exec`
+ * @module
  */
-import type { exec, execFG, ExecOptions, run, runExec, runExecFG, RunExecOptions, runFG, RunOptions, RunResult } from '@vltpkg/run';
-import { Monorepo } from '@vltpkg/workspaces';
-import type { Workspace } from '@vltpkg/workspaces';
+import type { NormalizedManifest } from '@vltpkg/types';
+import type { exec, execFG, ExecOptions, run, runExec, runExecFG, RunExecOptions, runFG, RunFGResult, RunOptions, RunResult } from '@vltpkg/run';
 import type { LoadedConfig } from './config/index.ts';
-import type { SpawnResultNoStdio } from '@vltpkg/promise-spawn';
 export type RunnerBG = typeof exec | typeof run | typeof runExec;
 export type RunnerFG = typeof execFG | typeof runExecFG | typeof runFG;
 export type RunnerOptions = ExecOptions & RunExecOptions & RunOptions;
-export type ExecResult = undefined | SpawnResultNoStdio | Record<string, RunResult>;
+export type MultiRunResult = Record<string, RunResult>;
+export type ScriptSet = Record<string, string>;
+export type MultiScriptSet = Record<string, ScriptSet>;
+export type ExecResult = RunFGResult | MultiRunResult | ScriptSet | MultiScriptSet;
+export declare const views: {
+    readonly human: (result: ExecResult) => void;
+    readonly json: (result: ExecResult) => ExecResult | undefined;
+};
+type ViewValues = 'human' | 'json' | 'inspect' | 'silent';
 export declare class ExecCommand<B extends RunnerBG, F extends RunnerFG> {
+    #private;
     bg: B;
     fg: F;
     arg0?: string;
     args: string[];
-    monorepo?: Monorepo;
-    /** how many places are we doing things in? */
-    spaces: number;
+    env?: NodeJS.ProcessEnv;
     conf: LoadedConfig;
     projectRoot: string;
+    view: ViewValues;
+    validViewValues: Map<string, ViewValues>;
     constructor(conf: LoadedConfig, bg: B, fg: F);
+    hasArg0(): this is this & {
+        arg0: string;
+    };
     run(): Promise<ExecResult>;
-    printResult(ws: Workspace, result: RunResult): void;
-    setExitCode(result: RunResult): void;
+    printResult(path: string, result: RunResult): void;
     interactiveShell(): string;
     defaultArg0(): string | undefined;
+    getCwd(): string;
     fgArg(): RunnerOptions | undefined;
-    /** If this returns undefined, then nothing to do */
-    bgArg(ws: Workspace): RunnerOptions;
-    noArgsMulti(): void;
+    bgArg(this: this & {
+        arg0: string;
+    }, cwd: string): RunnerOptions;
+    noArgsSingle(): ScriptSet;
+    noArgsMulti(): MultiScriptSet;
+    getTargets(): {
+        label: string;
+        cwd: string;
+        manifest: NormalizedManifest;
+    }[];
 }
+export {};
 //# sourceMappingURL=exec-command.d.ts.map

package/dist/esm/exec-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exec-command.d.ts","sourceRoot":"","sources":["../../src/exec-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACV,IAAI,EACJ,MAAM,EACN,WAAW,EACX,GAAG,EACH,OAAO,EACP,SAAS,EACT,cAAc,EACd,KAAK,EACL,UAAU,EACV,SAAS,EACV,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,MAAM,MAAM,QAAQ,GAAG,OAAO,IAAI,GAAG,OAAO,GAAG,GAAG,OAAO,OAAO,CAAA;AAChE,MAAM,MAAM,QAAQ,GAAG,OAAO,MAAM,GAAG,OAAO,SAAS,GAAG,OAAO,KAAK,CAAA;AACtE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,CAAA;AACrE,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,kBAAkB,GAClB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAE7B,qBAAa,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ;IAC7D,EAAE,EAAE,CAAC,CAAA;IACL,EAAE,EAAE,CAAC,CAAA;IACL,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;gBAEP,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAsBtC,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;IAmDhC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS;IAgB5C,WAAW,CAAC,MAAM,EAAE,SAAS;IAM7B,gBAAgB,IAAI,MAAM;IAU1B,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,KAAK,IAAI,aAAa,GAAG,SAAS;IAoBlC,oDAAoD;IACpD,KAAK,CAAC,EAAE,EAAE,SAAS,GAAG,aAAa;IAqBnC,WAAW;CAKZ"}
+{"version":3,"file":"exec-command.d.ts","sourceRoot":"","sources":["../../src/exec-command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EACV,IAAI,EACJ,MAAM,EACN,WAAW,EACX,GAAG,EACH,OAAO,EACP,SAAS,EACT,cAAc,EACd,KAAK,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACV,MAAM,aAAa,CAAA;AAMpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAQrD,MAAM,MAAM,QAAQ,GAAG,OAAO,IAAI,GAAG,OAAO,GAAG,GAAG,OAAO,OAAO,CAAA;AAChE,MAAM,MAAM,QAAQ,GAAG,OAAO,MAAM,GAAG,OAAO,SAAS,GAAG,OAAO,KAAK,CAAA;AACtE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,CAAA;AACrE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AACtD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAC9C,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AACtD,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,cAAc,GACd,SAAS,GACT,cAAc,CAAA;AA6BlB,eAAO,MAAM,KAAK;;;CAeoB,CAAA;AAEtC,KAAK,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEzD,qBAAa,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ;;IAC7D,EAAE,EAAE,CAAC,CAAA;IACL,EAAE,EAAE,CAAC,CAAA;IACL,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IAIvB,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,UAAU,CAAA;IAChB,eAAe,0BAKb;gBAEU,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAmB5C,OAAO,IAAI,IAAI,IAAI,IAAI,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAIpC,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;IA+HhC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS;IA0B3C,gBAAgB,IAAI,MAAM;IAU1B,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,MAAM,IAAI,MAAM;IAYhB,KAAK,IAAI,aAAa,GAAG,SAAS;IAmBlC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa;IAgBhE,YAAY,IAAI,SAAS;IAKzB,WAAW,IAAI,cAAc;IAM7B,UAAU,IAAI;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,EAAE,MAAM,CAAA;QACX,QAAQ,EAAE,kBAAkB,CAAA;KAC7B,EAAE;CAsBJ"}