@oclif/core 3.25.3 → 3.26.0

package/lib/command.js

@@ -243,7 +243,14 @@ class Command {
             ...options,
             flags: (0, aggregate_flags_1.aggregateFlags)(options.flags, options.baseFlags, options.enableJsonFlag),
         };
-        const results = await Parser.parse(argv, opts);
+        const hookResult = await this.config.runHook('preparse', { argv: [...argv], options: opts });
+        // Since config.runHook will only run the hook for the root plugin, hookResult.successes will always have a length of 0 or 1
+        // But to be extra safe, we find the result that matches the root plugin.
+        const argvToParse = hookResult.successes?.length
+            ? hookResult.successes.find((s) => s.plugin.root === cache_1.default.getInstance().get('rootPlugin')?.root)?.result ?? argv
+            : argv;
+        this.argv = [...argvToParse];
+        const results = await Parser.parse(argvToParse, opts);
         this.warnIfFlagDeprecated(results.flags ?? {});
         return results;
     }

package/lib/config/config.js

@@ -50,6 +50,7 @@ const util_3 = require("./util");
 const debug = (0, util_3.Debug)();
 const _pjson = cache_1.default.getInstance().get('@oclif/core');
 const BASE = `${_pjson.name}@${_pjson.version}`;
+const ROOT_ONLY_HOOKS = new Set(['preparse']);
 function channelFromVersion(version) {
     const m = version.match(/[^-]+(?:-([^.]+))?/);
     return (m && m[1]) || 'stable';
@@ -468,7 +469,8 @@ class Config {
             failures: [],
             successes: [],
         };
-        const promises = [...this.plugins.values()].map(async (p) => {
+        const plugins = ROOT_ONLY_HOOKS.has(event) ? [this.rootPlugin] : [...this.plugins.values()];
+        const promises = plugins.map(async (p) => {
             const debug = require('debug')([this.bin, p.name, 'hooks', event].join(':'));
             const context = {
                 config: this,

package/lib/interfaces/hooks.d.ts

@@ -1,5 +1,6 @@
 import { Command } from '../command';
 import { Config } from './config';
+import { Input, OutputFlags } from './parser';
 import { Plugin } from './plugin';
 interface HookMeta {
     options: Record<string, unknown>;
@@ -70,6 +71,13 @@ export interface Hooks {
         };
         return: void;
     };
+    preparse: {
+        options: {
+            argv: string[];
+            options: Input<OutputFlags<any>, OutputFlags<any>, OutputFlags<any>>;
+        };
+        return: string[];
+    };
     prerun: {
         options: {
             Command: Command.Class;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oclif/core",
   "description": "base library for oclif CLIs",
-  "version": "3.25.3",
+  "version": "3.26.0",
   "author": "Salesforce",
   "bugs": "https://github.com/oclif/core/issues",
   "dependencies": {