@oclif/core 3.23.1 → 3.25.0

package/lib/cache.d.ts

@@ -1,3 +1,4 @@
+import { Config } from './config/config';
 import { PJSON, Plugin } from './interfaces';
 type OclifCoreInfo = {
     name: string;
@@ -5,6 +6,7 @@ type OclifCoreInfo = {
 };
 type CacheContents = {
     rootPlugin: Plugin;
+    config: Config;
     exitCodes: PJSON.Plugin['oclif']['exitCodes'];
     '@oclif/core': OclifCoreInfo;
 };
@@ -16,6 +18,7 @@ export default class Cache extends Map<keyof CacheContents, ValueOf<CacheContent
     static instance: Cache;
     constructor();
     static getInstance(): Cache;
+    get(key: 'config'): Config | undefined;
     get(key: '@oclif/core'): OclifCoreInfo;
     get(key: 'rootPlugin'): Plugin | undefined;
     get(key: 'exitCodes'): PJSON.Plugin['oclif']['exitCodes'] | undefined;

package/lib/config/ts-path.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.tsPath = exports.TS_CONFIGS = void 0;
 const node_path_1 = require("node:path");
 const cache_1 = __importDefault(require("../cache"));
-const errors_1 = require("../errors");
+const warn_1 = require("../errors/warn");
 const settings_1 = require("../settings");
 const fs_1 = require("../util/fs");
 const read_tsconfig_1 = require("../util/read-tsconfig");
@@ -75,7 +75,7 @@ async function loadTSConfig(root) {
         if (isErrno(error))
             return;
         debug(`Could not parse tsconfig.json. Skipping typescript path lookup for ${root}.`);
-        (0, errors_1.memoizedWarn)(`Could not parse tsconfig.json for ${root}. Falling back to compiled source.`);
+        (0, warn_1.memoizedWarn)(`Could not parse tsconfig.json for ${root}. Falling back to compiled source.`);
     }
 }
 async function registerTSNode(root, tsconfig) {
@@ -90,7 +90,7 @@ async function registerTSNode(root, tsconfig) {
     }
     catch {
         debug(`Could not find ts-node at ${tsNodePath}. Skipping ts-node registration for ${root}.`);
-        (0, errors_1.memoizedWarn)(`Could not find ts-node at ${tsNodePath}. Please ensure that ts-node is a devDependency. Falling back to compiled source.`);
+        (0, warn_1.memoizedWarn)(`Could not find ts-node at ${tsNodePath}. Please ensure that ts-node is a devDependency. Falling back to compiled source.`);
         return;
     }
     const typeRoots = [(0, node_path_1.join)(root, 'node_modules', '@types')];
@@ -207,7 +207,7 @@ async function determinePath(root, orig) {
     }
     debug(`No source file found. Returning default path ${orig}`);
     if (!(0, util_1.isProd)())
-        (0, errors_1.memoizedWarn)(`Could not find source for ${orig} based on tsconfig. Defaulting to compiled source.`);
+        (0, warn_1.memoizedWarn)(`Could not find source for ${orig} based on tsconfig. Defaulting to compiled source.`);
     return orig;
 }
 async function tsPath(root, orig, plugin) {
@@ -230,12 +230,12 @@ async function tsPath(root, orig, plugin) {
     if (cannotTranspileEsm(rootPlugin, plugin, isProduction)) {
         debug(`Skipping typescript path lookup for ${root} because it's an ESM module (NODE_ENV: ${process.env.NODE_ENV}, root plugin module type: ${rootPlugin?.moduleType})`);
         if (plugin?.type === 'link')
-            (0, errors_1.memoizedWarn)(`${plugin?.name} is a linked ESM module and cannot be auto-transpiled. Existing compiled source will be used instead.`);
+            (0, warn_1.memoizedWarn)(`${plugin?.name} is a linked ESM module and cannot be auto-transpiled. Existing compiled source will be used instead.`);
         return orig;
     }
     if (cannotUseTsNode(root, plugin, isProduction)) {
         debug(`Skipping typescript path lookup for ${root} because ts-node is run in node version ${process.version}"`);
-        (0, errors_1.memoizedWarn)(`ts-node executable cannot transpile ESM in Node 20. Existing compiled source will be used instead. See https://github.com/oclif/core/issues/817.`);
+        (0, warn_1.memoizedWarn)(`ts-node executable cannot transpile ESM in Node 20. Existing compiled source will be used instead. See https://github.com/oclif/core/issues/817.`);
         return orig;
     }
     try {

package/lib/errors/error.d.ts

@@ -0,0 +1,8 @@
+import { PrettyPrintableError } from '../interfaces';
+export declare function error(input: Error | string, options: {
+    exit: false;
+} & PrettyPrintableError): void;
+export declare function error(input: Error | string, options?: {
+    exit?: number;
+} & PrettyPrintableError): never;
+export default error;

package/lib/errors/error.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.error = void 0;
+const write_1 = __importDefault(require("../cli-ux/write"));
+const config_1 = require("./config");
+const cli_1 = require("./errors/cli");
+const pretty_print_1 = __importStar(require("./errors/pretty-print"));
+function error(input, options = {}) {
+    let err;
+    if (typeof input === 'string') {
+        err = new cli_1.CLIError(input, options);
+    }
+    else if (input instanceof Error) {
+        err = (0, cli_1.addOclifExitCode)(input, options);
+    }
+    else {
+        throw new TypeError('first argument must be a string or instance of Error');
+    }
+    err = (0, pretty_print_1.applyPrettyPrintOptions)(err, options);
+    if (options.exit === false) {
+        const message = (0, pretty_print_1.default)(err);
+        if (message)
+            write_1.default.stderr(message + '\n');
+        if (config_1.config.errorLogger)
+            config_1.config.errorLogger.log(err?.stack ?? '');
+    }
+    else
+        throw err;
+}
+exports.error = error;
+exports.default = error;

package/lib/errors/errors/cli.d.ts

@@ -8,6 +8,7 @@ export declare function addOclifExitCode(error: Record<string, any>, options?: {
 export declare class CLIError extends Error implements OclifError {
     code?: string;
     oclif: OclifError['oclif'];
+    skipOclifErrorHandling?: boolean;
     suggestions?: string[];
     constructor(error: Error | string, options?: {
         exit?: false | number;

package/lib/errors/errors/cli.js

@@ -26,6 +26,7 @@ exports.addOclifExitCode = addOclifExitCode;
 class CLIError extends Error {
     code;
     oclif = {};
+    skipOclifErrorHandling;
     suggestions;
     constructor(error, options = {}) {
         super(error instanceof Error ? error.message : error);

package/lib/errors/handle.d.ts

@@ -1,4 +1,6 @@
 import { OclifError, PrettyPrintableError } from '../interfaces';
+import { CLIParseError } from '../parser/errors';
+import { CLIError } from './errors/cli';
 /**
  * This is an odd abstraction for process.exit, but it allows us to stub it in tests.
  *
@@ -7,8 +9,6 @@ import { OclifError, PrettyPrintableError } from '../interfaces';
 export declare const Exit: {
     exit(code?: number): never;
 };
-type ErrorToHandle = Error & Partial<PrettyPrintableError> & Partial<OclifError> & {
-    skipOclifErrorHandling?: boolean;
-};
+type ErrorToHandle = Error & Partial<PrettyPrintableError> & Partial<OclifError> & Partial<CLIError> & Partial<CLIParseError>;
 export declare function handle(err: ErrorToHandle): Promise<void>;
 export {};

package/lib/errors/handle.js

@@ -5,6 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handle = exports.Exit = void 0;
 const clean_stack_1 = __importDefault(require("clean-stack"));
+const cache_1 = __importDefault(require("../cache"));
+const index_1 = require("../help/index");
 const config_1 = require("./config");
 const cli_1 = require("./errors/cli");
 const exit_1 = require("./errors/exit");
@@ -31,6 +33,17 @@ async function handle(err) {
         const stack = (0, clean_stack_1.default)(err.stack || '', { pretty: true });
         if (shouldPrint) {
             console.error(pretty ?? stack);
+            const config = cache_1.default.getInstance().get('config');
+            if (err.showHelp && err.parse?.input?.argv && config) {
+                const options = {
+                    ...(config.pjson.oclif.helpOptions ?? config.pjson.helpOptions),
+                    sections: ['flags', 'usage', 'arguments'],
+                    sendToStderr: true,
+                };
+                const help = new index_1.Help(config, options);
+                console.error();
+                await help.showHelp(process.argv.slice(2));
+            }
         }
         const exitCode = err.oclif?.exit ?? 1;
         if (config_1.config.errorLogger && err.code !== 'EEXIT') {

package/lib/errors/index.d.ts

@@ -1,17 +1,10 @@
-import { PrettyPrintableError } from '../interfaces';
 export { PrettyPrintableError } from '../interfaces';
 export { config } from './config';
+export { error } from './error';
 export { CLIError } from './errors/cli';
 export { ExitError } from './errors/exit';
 export { ModuleLoadError } from './errors/module-load';
 export { handle } from './handle';
-export declare function exit(code?: number): never;
-export declare function error(input: Error | string, options: {
-    exit: false;
-} & PrettyPrintableError): void;
-export declare function error(input: Error | string, options?: {
-    exit?: number;
-} & PrettyPrintableError): never;
-export declare function warn(input: Error | string): void;
-export declare function memoizedWarn(input: Error | string): void;
 export { Logger } from './logger';
+export declare function exit(code?: number): never;
+export { warn } from './warn';

package/lib/errors/index.js

@@ -1,98 +1,24 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Logger = exports.memoizedWarn = exports.warn = exports.error = exports.exit = exports.handle = exports.ModuleLoadError = exports.ExitError = exports.CLIError = exports.config = void 0;
-const write_1 = __importDefault(require("../cli-ux/write"));
-const config_1 = require("./config");
-const cli_1 = require("./errors/cli");
+exports.warn = exports.exit = exports.Logger = exports.handle = exports.ModuleLoadError = exports.ExitError = exports.CLIError = exports.error = exports.config = void 0;
 const exit_1 = require("./errors/exit");
-const pretty_print_1 = __importStar(require("./errors/pretty-print"));
-var config_2 = require("./config");
-Object.defineProperty(exports, "config", { enumerable: true, get: function () { return config_2.config; } });
-var cli_2 = require("./errors/cli");
-Object.defineProperty(exports, "CLIError", { enumerable: true, get: function () { return cli_2.CLIError; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "config", { enumerable: true, get: function () { return config_1.config; } });
+var error_1 = require("./error");
+Object.defineProperty(exports, "error", { enumerable: true, get: function () { return error_1.error; } });
+var cli_1 = require("./errors/cli");
+Object.defineProperty(exports, "CLIError", { enumerable: true, get: function () { return cli_1.CLIError; } });
 var exit_2 = require("./errors/exit");
 Object.defineProperty(exports, "ExitError", { enumerable: true, get: function () { return exit_2.ExitError; } });
 var module_load_1 = require("./errors/module-load");
 Object.defineProperty(exports, "ModuleLoadError", { enumerable: true, get: function () { return module_load_1.ModuleLoadError; } });
 var handle_1 = require("./handle");
 Object.defineProperty(exports, "handle", { enumerable: true, get: function () { return handle_1.handle; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
 function exit(code = 0) {
     throw new exit_1.ExitError(code);
 }
 exports.exit = exit;
-function error(input, options = {}) {
-    let err;
-    if (typeof input === 'string') {
-        err = new cli_1.CLIError(input, options);
-    }
-    else if (input instanceof Error) {
-        err = (0, cli_1.addOclifExitCode)(input, options);
-    }
-    else {
-        throw new TypeError('first argument must be a string or instance of Error');
-    }
-    err = (0, pretty_print_1.applyPrettyPrintOptions)(err, options);
-    if (options.exit === false) {
-        const message = (0, pretty_print_1.default)(err);
-        if (message)
-            write_1.default.stderr(message + '\n');
-        if (config_1.config.errorLogger)
-            config_1.config.errorLogger.log(err?.stack ?? '');
-    }
-    else
-        throw err;
-}
-exports.error = error;
-function warn(input) {
-    let err;
-    if (typeof input === 'string') {
-        err = new cli_1.CLIError.Warn(input);
-    }
-    else if (input instanceof Error) {
-        err = (0, cli_1.addOclifExitCode)(input);
-    }
-    else {
-        throw new TypeError('first argument must be a string or instance of Error');
-    }
-    const message = (0, pretty_print_1.default)(err);
-    if (message)
-        write_1.default.stderr(message + '\n');
-    if (config_1.config.errorLogger)
-        config_1.config.errorLogger.log(err?.stack ?? '');
-}
-exports.warn = warn;
-const WARNINGS = new Set();
-function memoizedWarn(input) {
-    if (!WARNINGS.has(input))
-        warn(input);
-    WARNINGS.add(input);
-}
-exports.memoizedWarn = memoizedWarn;
-var logger_1 = require("./logger");
-Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
+var warn_1 = require("./warn");
+Object.defineProperty(exports, "warn", { enumerable: true, get: function () { return warn_1.warn; } });

package/lib/errors/warn.d.ts

@@ -0,0 +1,3 @@
+export declare function warn(input: Error | string): void;
+export declare function memoizedWarn(input: Error | string): void;
+export default warn;

package/lib/errors/warn.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoizedWarn = exports.warn = void 0;
+const write_1 = __importDefault(require("../cli-ux/write"));
+const config_1 = require("./config");
+const cli_1 = require("./errors/cli");
+const pretty_print_1 = __importDefault(require("./errors/pretty-print"));
+function warn(input) {
+    let err;
+    if (typeof input === 'string') {
+        err = new cli_1.CLIError.Warn(input);
+    }
+    else if (input instanceof Error) {
+        err = (0, cli_1.addOclifExitCode)(input);
+    }
+    else {
+        throw new TypeError('first argument must be a string or instance of Error');
+    }
+    const message = (0, pretty_print_1.default)(err);
+    if (message)
+        write_1.default.stderr(message + '\n');
+    if (config_1.config.errorLogger)
+        config_1.config.errorLogger.log(err?.stack ?? '');
+}
+exports.warn = warn;
+const WARNINGS = new Set();
+function memoizedWarn(input) {
+    if (!WARNINGS.has(input))
+        warn(input);
+    WARNINGS.add(input);
+}
+exports.memoizedWarn = memoizedWarn;
+exports.default = warn;

package/lib/help/command.js

@@ -58,7 +58,8 @@ class CommandHelp extends formatter_1.HelpFormatter {
         if (args.filter((a) => a.description).length === 0)
             return;
         return args.map((a) => {
-            const name = a.name.toUpperCase();
+            // Add ellipsis to indicate that the argument takes multiple values if strict is false
+            const name = this.command.strict === false ? `${a.name.toUpperCase()}...` : a.name.toUpperCase();
             let description = a.description || '';
             if (a.default)
                 description = `${(0, theme_1.colorize)(this.config?.theme?.flagDefaultValue, `[default: ${a.default}]`)} ${description}`;
@@ -246,7 +247,7 @@ class CommandHelp extends formatter_1.HelpFormatter {
         return { flagGroups, mainFlags };
     }
     sections() {
-        return [
+        const sections = [
             {
                 generate: () => this.usage(),
                 header: this.opts.usageHeader || 'USAGE',
@@ -291,6 +292,8 @@ class CommandHelp extends formatter_1.HelpFormatter {
                 header: 'FLAG DESCRIPTIONS',
             },
         ];
+        const allowedSections = this.opts.sections?.map((s) => s.toLowerCase());
+        return sections.filter(({ header }) => !allowedSections || allowedSections.includes(header.toLowerCase()));
     }
     usage() {
         const { id, usage } = this.command;

package/lib/help/docopts.d.ts

@@ -59,8 +59,8 @@ export declare class DocOpts {
     private cmd;
     private flagList;
     private flagMap;
-    constructor(cmd: Command.Cached | Command.Class | Command.Loadable);
-    static generate(cmd: Command.Cached | Command.Class | Command.Loadable): string;
+    constructor(cmd: Command.Loadable);
+    static generate(cmd: Command.Loadable): string;
     toString(): string;
     private combineElementsToFlag;
     private generateElements;

package/lib/help/docopts.js

@@ -79,7 +79,9 @@ class DocOpts {
     toString() {
         const opts = ['<%= command.id %>'];
         if (this.cmd.args) {
-            const a = Object.values((0, ensure_arg_object_1.ensureArgObject)(this.cmd.args)).map((arg) => arg.required ? arg.name.toUpperCase() : `[${arg.name.toUpperCase()}]`) || [];
+            // If strict is false, add ellipsis to indicate that the argument takes multiple values
+            const suffix = this.cmd.strict === false ? '...' : '';
+            const a = Object.values((0, ensure_arg_object_1.ensureArgObject)(this.cmd.args)).map((arg) => arg.required ? `${arg.name.toUpperCase()}${suffix}` : `[${arg.name.toUpperCase()}${suffix}]`) || [];
             opts.push(...a);
         }
         try {

package/lib/help/index.js

@@ -8,7 +8,7 @@ const node_util_1 = require("node:util");
 const strip_ansi_1 = __importDefault(require("strip-ansi"));
 const theme_1 = require("../cli-ux/theme");
 const write_1 = __importDefault(require("../cli-ux/write"));
-const errors_1 = require("../errors");
+const error_1 = require("../errors/error");
 const module_loader_1 = require("../module-loader");
 const symbols_1 = require("../symbols");
 const cache_default_value_1 = require("../util/cache-default-value");
@@ -144,7 +144,9 @@ class Help extends HelpBase {
         return new this.CommandHelpClass(command, this.config, this.opts);
     }
     log(...args) {
-        write_1.default.stdout(node_util_1.format.apply(this, args) + '\n');
+        this.opts.sendToStderr
+            ? write_1.default.stderr(node_util_1.format.apply(this, args) + '\n')
+            : write_1.default.stdout(node_util_1.format.apply(this, args) + '\n');
     }
     async showCommandHelp(command) {
         const name = command.id;
@@ -246,7 +248,7 @@ class Help extends HelpBase {
                     return;
             }
         }
-        (0, errors_1.error)(`Command ${subject} not found.`);
+        (0, error_1.error)(`Command ${subject} not found.`);
     }
     async showRootHelp() {
         let rootTopics = this.sortedTopics;
@@ -290,6 +292,8 @@ class Help extends HelpBase {
         }
     }
     summary(c) {
+        if (this.opts.sections && !this.opts.sections.map((s) => s.toLowerCase()).includes('summary'))
+            return;
         if (c.summary)
             return (0, theme_1.colorize)(this.config?.theme?.commandSummary, this.render(c.summary.split('\n')[0]));
         return c.description && (0, theme_1.colorize)(this.config?.theme?.commandSummary, this.render(c.description).split('\n')[0]);

package/lib/interfaces/help.d.ts

@@ -24,6 +24,14 @@ export interface HelpOptions {
      */
     hideCommandSummaryInDescription?: boolean;
     maxWidth: number;
+    /**
+     * Only show the help for the specified sections. Defaults to all sections.
+     */
+    sections?: string[];
+    /**
+     * By default, the help output is sent to stdout. If this is true, it will be sent to stderr.
+     */
+    sendToStderr?: boolean;
     /**
      * By default, titles show flag values as `<value>`. Some CLI developers may prefer titles
      * to show the flag name as the value. i.e. `--myflag=myflag` instead of `--myflag=<value>`.

package/lib/main.js

@@ -1,7 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.run = exports.versionAddition = exports.helpAddition = void 0;
 const node_url_1 = require("node:url");
+const cache_1 = __importDefault(require("./cache"));
 const cli_ux_1 = require("./cli-ux");
 const config_1 = require("./config");
 const help_1 = require("./help");
@@ -53,6 +57,7 @@ async function run(argv, options) {
         options = (0, node_url_1.fileURLToPath)(options);
     }
     const config = await config_1.Config.load(options ?? require.main?.filename ?? __dirname);
+    cache_1.default.getInstance().set('config', config);
     // If this is a single command CLI, then insert the SINGLE_COMMAND_CLI_SYMBOL into the argv array to serve as the command id.
     if (config.isSingleCommandCLI) {
         argv = [symbols_1.SINGLE_COMMAND_CLI_SYMBOL, ...argv];

package/lib/module-loader.js

@@ -5,7 +5,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_url_1 = require("node:url");
 const ts_path_1 = require("./config/ts-path");
-const errors_1 = require("./errors");
+const module_load_1 = require("./errors/errors/module-load");
 const fs_1 = require("./util/fs");
 const getPackageType = require('get-package-type');
 /**
@@ -16,7 +16,7 @@ const s_EXTENSIONS = ['.ts', '.js', '.mjs', '.cjs', '.mts', '.cts'];
 const isPlugin = (config) => config.type !== undefined;
 function handleError(error, isESM, path) {
     if (error.code === 'MODULE_NOT_FOUND' || error.code === 'ERR_MODULE_NOT_FOUND') {
-        throw new errors_1.ModuleLoadError(`${isESM ? 'import()' : 'require'} failed to load ${path}: ${error.message}`);
+        throw new module_load_1.ModuleLoadError(`${isESM ? 'import()' : 'require'} failed to load ${path}: ${error.message}`);
     }
     throw error;
 }
@@ -98,10 +98,10 @@ exports.loadWithData = loadWithData;
 async function loadWithDataFromManifest(cached, modulePath) {
     const { id, isESM, relativePath } = cached;
     if (!relativePath) {
-        throw new errors_1.ModuleLoadError(`Cached command ${id} does not have a relative path`);
+        throw new module_load_1.ModuleLoadError(`Cached command ${id} does not have a relative path`);
     }
     if (isESM === undefined) {
-        throw new errors_1.ModuleLoadError(`Cached command ${id} does not have the isESM property set`);
+        throw new module_load_1.ModuleLoadError(`Cached command ${id} does not have the isESM property set`);
     }
     const filePath = (0, node_path_1.join)(modulePath, relativePath.join(node_path_1.sep));
     try {

package/lib/parser/errors.d.ts

@@ -9,6 +9,7 @@ export type Validation = {
 };
 export declare class CLIParseError extends CLIError {
     parse: CLIParseErrorOptions['parse'];
+    showHelp: boolean;
     constructor(options: CLIParseErrorOptions & {
         message: string;
     });

package/lib/parser/errors.js

@@ -13,6 +13,7 @@ var errors_2 = require("../errors");
 Object.defineProperty(exports, "CLIError", { enumerable: true, get: function () { return errors_2.CLIError; } });
 class CLIParseError extends errors_1.CLIError {
     parse;
+    showHelp = false;
     constructor(options) {
         options.message += '\nSee more help with --help';
         super(options.message, { exit: options.exit });
@@ -50,6 +51,7 @@ class RequiredArgsError extends CLIParseError {
         }
         super({ exit: cache_1.default.getInstance().get('exitCodes')?.requiredArgs ?? exit, message, parse });
         this.args = args;
+        this.showHelp = true;
     }
 }
 exports.RequiredArgsError = RequiredArgsError;
@@ -59,6 +61,7 @@ class UnexpectedArgsError extends CLIParseError {
         const message = `Unexpected argument${args.length === 1 ? '' : 's'}: ${args.join(', ')}`;
         super({ exit: cache_1.default.getInstance().get('exitCodes')?.unexpectedArgs ?? exit, message, parse });
         this.args = args;
+        this.showHelp = true;
     }
 }
 exports.UnexpectedArgsError = UnexpectedArgsError;
@@ -68,6 +71,7 @@ class NonExistentFlagsError extends CLIParseError {
         const message = `Nonexistent flag${flags.length === 1 ? '' : 's'}: ${flags.join(', ')}`;
         super({ exit: cache_1.default.getInstance().get('exitCodes')?.nonExistentFlag ?? exit, message, parse });
         this.flags = flags;
+        this.showHelp = true;
     }
 }
 exports.NonExistentFlagsError = NonExistentFlagsError;

package/lib/util/read-tsconfig.js

@@ -7,7 +7,7 @@ exports.readTSConfig = void 0;
 const debug_1 = __importDefault(require("debug"));
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
-const errors_1 = require("../errors");
+const warn_1 = require("../errors/warn");
 const util_1 = require("./util");
 const debug = (0, debug_1.default)('read-tsconfig');
 function resolve(root, name) {
@@ -46,7 +46,7 @@ async function readTSConfig(root, tsconfigName = 'tsconfig.json') {
         catch { }
     }
     if (!typescript) {
-        (0, errors_1.memoizedWarn)('Could not find typescript. Please ensure that typescript is a devDependency. Falling back to compiled source.');
+        (0, warn_1.memoizedWarn)('Could not find typescript. Please ensure that typescript is a devDependency. Falling back to compiled source.');
         return;
     }
     const read = async (path) => {

package/package.json

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