@oclif/core 2.14.0 → 3.0.0-beta.2

package/lib/cli-ux/action/spinner.js

@@ -4,6 +4,7 @@ const chalk = require("chalk");
 const supportsColor = require("supports-color");
 const stripAnsi = require('strip-ansi');
 const ansiStyles = require('ansi-styles');
+const ansiEscapes = require('ansi-escapes');
 const screen_1 = require("../../screen");
 const spinners_1 = require("./spinners");
 const base_1 = require("./base");
@@ -64,7 +65,6 @@ class SpinnerAction extends base_1.ActionBase {
     _reset() {
         if (!this.output)
             return;
-        const ansiEscapes = require('ansi-escapes');
         const lines = this._lines(this.output);
         this._write(this.std, ansiEscapes.cursorLeft + ansiEscapes.cursorUp(lines) + ansiEscapes.eraseDown);
         this.output = undefined;

package/lib/cli-ux/config.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.config = exports.Config = void 0;
+const semver = require("semver");
 const util_1 = require("../util");
 const spinner_1 = require("./action/spinner");
 const spinner_2 = require("./action/spinner");
 const pride_spinner_1 = require("./action/pride-spinner");
+const version = semver.parse((0, util_1.requireJson)(__dirname, '..', '..', 'package.json').version);
 const g = global;
 const globals = g['cli-ux'] || (g['cli-ux'] = {});
 const actionType = (Boolean(process.stderr.isTTY) &&
@@ -36,11 +38,10 @@ class Config {
 }
 exports.Config = Config;
 function fetch() {
-    const major = (0, util_1.requireJson)(__dirname, '..', '..', 'package.json').version.split('.')[0];
-    if (globals[major])
-        return globals[major];
-    globals[major] = new Config();
-    return globals[major];
+    if (globals[version.major])
+        return globals[version.major];
+    globals[version.major] = new Config();
+    return globals[version.major];
 }
 exports.config = fetch();
 exports.default = exports.config;

package/lib/cli-ux/prompt.js

@@ -5,6 +5,8 @@ const Errors = require("../errors");
 const config_1 = require("./config");
 const chalk = require("chalk");
 const stream_1 = require("./stream");
+const ansiEscapes = require('ansi-escapes');
+const passwordPrompt = require('password-prompt');
 function normal(options, retries = 100) {
     if (retries < 0)
         throw new Error('no input');
@@ -56,7 +58,6 @@ async function single(options) {
     return response;
 }
 function replacePrompt(prompt) {
-    const ansiEscapes = require('ansi-escapes');
     stream_1.stderr.write(ansiEscapes.cursorHide + ansiEscapes.cursorUp(1) + ansiEscapes.cursorLeft + prompt +
         ansiEscapes.cursorDown(1) + ansiEscapes.cursorLeft + ansiEscapes.cursorShow);
 }
@@ -71,7 +72,6 @@ async function _prompt(name, inputOptions = {}) {
         default: '',
         ...inputOptions,
     };
-    const passwordPrompt = require('password-prompt');
     switch (options.type) {
         case 'normal':
             return normal(options);

package/lib/config/config.d.ts

@@ -39,8 +39,10 @@ export declare class Config implements IConfig {
     private _commands;
     private _topics;
     private _commandIDs;
+    private static _rootPlugin;
     constructor(options: Options);
     static load(opts?: LoadOptions): Promise<Config>;
+    static get rootPlugin(): Plugin.Plugin | undefined;
     load(): Promise<void>;
     loadPluginsAndCommands(): Promise<void>;
     loadCorePlugins(): Promise<void>;

package/lib/config/config.js

@@ -15,12 +15,11 @@ const help_1 = require("../help");
 const stream_1 = require("../cli-ux/stream");
 const performance_1 = require("../performance");
 const settings_1 = require("../settings");
-const os_1 = require("os");
-const path_1 = require("path");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
 // eslint-disable-next-line new-cap
 const debug = (0, util_2.Debug)();
 const _pjson = (0, util_3.requireJson)(__dirname, '..', '..', 'package.json');
-const BASE = `${_pjson.name}@${_pjson.version}`;
 function channelFromVersion(version) {
     const m = version.match(/[^-]+(?:-([^.]+))?/);
     return (m && m[1]) || 'stable';
@@ -61,7 +60,7 @@ class Permutations extends Map {
 class Config {
     constructor(options) {
         this.options = options;
-        this._base = BASE;
+        this._base = `${_pjson.name}@${_pjson.version}`;
         this.debug = 0;
         this.plugins = [];
         this.topicSeparator = ':';
@@ -70,24 +69,6 @@ class Config {
         this.topicPermutations = new Permutations();
         this._commands = new Map();
         this._topics = new Map();
-        if (options.config) {
-            if (Array.isArray(options.config.plugins) && Array.isArray(this.plugins)) {
-                // incoming config is v2 with plugins array and this config is v2 with plugins array
-                Object.assign(this, options.config);
-            }
-            else if (Array.isArray(options.config.plugins) && !Array.isArray(this.plugins)) {
-                // incoming config is v2 with plugins array and this config is v3 with plugin Map
-                Object.assign(this, options.config, { plugins: new Map(options.config.plugins.map(p => [p.name, p])) });
-            }
-            else if (!Array.isArray(options.config.plugins) && Array.isArray(this.plugins)) {
-                // incoming config is v3 with plugin Map and this config is v2 with plugins array
-                Object.assign(this, options.config, { plugins: options.config.getPluginsList() });
-            }
-            else {
-                // incoming config is v3 with plugin Map and this config is v3 with plugin Map
-                Object.assign(this, options.config);
-            }
-        }
     }
     static async load(opts = module.filename || __dirname) {
         // Handle the case when a file URL string is passed in such as 'import.meta.url'; covert to file path.
@@ -96,37 +77,21 @@ class Config {
         }
         if (typeof opts === 'string')
             opts = { root: opts };
-        if (isConfig(opts)) {
-            const { lt } = await import('semver');
-            const currentConfigBase = BASE.replace('@oclif/core@', '');
-            const incomingConfigBase = opts._base.replace('@oclif/core@', '');
-            /**
-             * Reload the Config based on the version required by the command.
-             * This is needed because the command is given the Config instantiated
-             * by the root plugin, which may be a different version than the one
-             * required by the command.
-             *
-             * Doing this ensures that the command can freely use any method on Config that
-             * exists in the version of Config required by the command but may not exist on the
-             * root's instance of Config.
-             */
-            if (lt(incomingConfigBase, currentConfigBase)) {
-                debug(`reloading config from ${opts._base} to ${BASE}`);
-                return new Config({ ...opts.options, config: opts });
-            }
+        if (isConfig(opts))
             return opts;
-        }
         const config = new Config(opts);
         await config.load();
         return config;
     }
+    static get rootPlugin() {
+        return Config._rootPlugin;
+    }
     // eslint-disable-next-line complexity
     async load() {
-        if (this.options.config)
-            return;
         settings_1.settings.performanceEnabled = (settings_1.settings.performanceEnabled === undefined ? this.options.enablePerf : settings_1.settings.performanceEnabled) ?? false;
         const plugin = new Plugin.Plugin({ root: this.options.root });
         await plugin.load();
+        Config._rootPlugin = plugin;
         this.plugins.push(plugin);
         this.root = plugin.root;
         this.pjson = plugin.pjson;
@@ -523,7 +488,7 @@ class Config {
     _shell() {
         let shellPath;
         const COMSPEC = process.env.COMSPEC;
-        const SHELL = process.env.SHELL ?? (0, os_1.userInfo)().shell?.split(path_1.sep)?.pop();
+        const SHELL = process.env.SHELL ?? (0, node_os_1.userInfo)().shell?.split(node_path_1.sep)?.pop();
         if (SHELL) {
             shellPath = SHELL.split('/');
         }

package/lib/config/plugin.d.ts

@@ -11,6 +11,7 @@ export declare class Plugin implements IPlugin {
     version: string;
     pjson: PJSON.Plugin;
     type: string;
+    moduleType: 'module' | 'commonjs';
     root: string;
     alias: string;
     tag?: string;

package/lib/config/plugin.js

@@ -115,6 +115,7 @@ class Plugin {
         this.root = root;
         this._debug('reading %s plugin %s', this.type, root);
         this.pjson = await (0, util_3.loadJSON)(path.join(root, 'package.json'));
+        this.moduleType = this.pjson.type === 'module' ? 'module' : 'commonjs';
         this.name = this.pjson.name;
         this.alias = this.options.name ?? this.pjson.name;
         const pjsonPath = path.join(root, 'package.json');
@@ -149,7 +150,7 @@ class Plugin {
     get commandsDir() {
         if (this._commandsDir)
             return this._commandsDir;
-        this._commandsDir = (0, ts_node_1.tsPath)(this.root, this.pjson.oclif.commands, this.type);
+        this._commandsDir = (0, ts_node_1.tsPath)(this.root, this.pjson.oclif.commands, this);
         return this._commandsDir;
     }
     get commandIDs() {

package/lib/config/ts-node.d.ts

@@ -1,7 +1,8 @@
+import { Plugin } from '../interfaces';
 /**
  * Convert a path from the compiled ./lib files to the ./src typescript source
  * this is for developing typescript plugins/CLIs
  * if there is a tsconfig and the original sources exist, it attempts to require ts-node
  */
-export declare function tsPath(root: string, orig: string, type?: string): string;
-export declare function tsPath(root: string, orig: string | undefined, type?: string): string | undefined;
+export declare function tsPath(root: string, orig: string, plugin: Plugin): string;
+export declare function tsPath(root: string, orig: string | undefined, plugin?: Plugin): string | undefined;

package/lib/config/ts-node.js

@@ -6,11 +6,15 @@ const path = require("path");
 const settings_1 = require("../settings");
 const util_1 = require("../util");
 const util_2 = require("./util");
+const config_1 = require("./config");
+const errors_1 = require("../errors");
 // eslint-disable-next-line new-cap
 const debug = (0, util_2.Debug)('ts-node');
-const TYPE_ROOTS = [`${__dirname}/../node_modules/@types`];
-const ROOT_DIRS = [];
+const TS_CONFIGS = {};
+const REGISTERED = new Set();
 function loadTSConfig(root) {
+    if (TS_CONFIGS[root])
+        return TS_CONFIGS[root];
     const tsconfigPath = path.join(root, 'tsconfig.json');
     let typescript;
     try {
@@ -18,7 +22,7 @@ function loadTSConfig(root) {
     }
     catch {
         try {
-            typescript = require(root + '/node_modules/typescript');
+            typescript = require(path.join(root, 'node_modules', 'typescript'));
         }
         catch { }
     }
@@ -28,6 +32,7 @@ function loadTSConfig(root) {
             throw new Error(`Could not read and parse tsconfig.json at ${tsconfigPath}, or it ` +
                 'did not contain a "compilerOptions" section.');
         }
+        TS_CONFIGS[root] = tsconfig;
         return tsconfig;
     }
 }
@@ -35,54 +40,96 @@ function registerTSNode(root) {
     const tsconfig = loadTSConfig(root);
     if (!tsconfig)
         return;
+    if (REGISTERED.has(root))
+        return tsconfig;
     debug('registering ts-node at', root);
     const tsNodePath = require.resolve('ts-node', { paths: [root, __dirname] });
+    debug('ts-node path:', tsNodePath);
     const tsNode = require(tsNodePath);
-    TYPE_ROOTS.push(`${root}/node_modules/@types`);
+    const typeRoots = [
+        path.join(root, 'node_modules', '@types'),
+    ];
+    const rootDirs = [];
     if (tsconfig.compilerOptions.rootDirs) {
-        ROOT_DIRS.push(...tsconfig.compilerOptions.rootDirs.map(r => path.join(root, r)));
+        for (const r of tsconfig.compilerOptions.rootDirs) {
+            rootDirs.push(path.join(root, r));
+        }
+    }
+    else if (tsconfig.compilerOptions.rootDir) {
+        rootDirs.push(path.join(root, tsconfig.compilerOptions.rootDir));
     }
     else {
-        ROOT_DIRS.push(`${root}/src`);
+        rootDirs.push(path.join(root, 'src'));
     }
-    const cwd = process.cwd();
-    try {
-        process.chdir(root);
-        tsNode.register({
-            skipProject: true,
-            transpileOnly: true,
-            compilerOptions: {
-                esModuleInterop: tsconfig.compilerOptions.esModuleInterop,
-                target: tsconfig.compilerOptions.target || 'es2017',
-                experimentalDecorators: tsconfig.compilerOptions.experimentalDecorators || false,
-                emitDecoratorMetadata: tsconfig.compilerOptions.emitDecoratorMetadata || false,
-                module: 'commonjs',
-                sourceMap: true,
-                rootDirs: ROOT_DIRS,
-                typeRoots: TYPE_ROOTS,
-                jsx: 'react',
-            },
-        });
-        return tsconfig;
+    const conf = {
+        compilerOptions: {
+            esModuleInterop: tsconfig.compilerOptions.esModuleInterop,
+            target: tsconfig.compilerOptions.target ?? 'es2019',
+            experimentalDecorators: tsconfig.compilerOptions.experimentalDecorators ?? false,
+            emitDecoratorMetadata: tsconfig.compilerOptions.emitDecoratorMetadata ?? false,
+            module: tsconfig.compilerOptions.module ?? 'commonjs',
+            sourceMap: tsconfig.compilerOptions.sourceMap ?? true,
+            rootDirs,
+            typeRoots,
+        },
+        skipProject: true,
+        transpileOnly: true,
+        esm: tsconfig['ts-node']?.esm ?? true,
+        scope: true,
+        scopeDir: root,
+        cwd: root,
+        experimentalSpecifierResolution: tsconfig['ts-node']?.experimentalSpecifierResolution ?? 'explicit',
+    };
+    if (tsconfig.compilerOptions.moduleResolution) {
+        // @ts-expect-error TSNode.RegisterOptions.compilerOptions is typed as a plain object
+        conf.compilerOptions.moduleResolution = tsconfig.compilerOptions.moduleResolution;
     }
-    finally {
-        process.chdir(cwd);
+    if (tsconfig.compilerOptions.jsx) {
+        // @ts-expect-error TSNode.RegisterOptions.compilerOptions is typed as a plain object
+        conf.compilerOptions.jsx = tsconfig.compilerOptions.jsx;
     }
+    tsNode.register(conf);
+    REGISTERED.add(root);
+    return tsconfig;
 }
-function tsPath(root, orig, type) {
+// eslint-disable-next-line complexity
+function tsPath(root, orig, plugin) {
     if (!orig)
         return orig;
     orig = orig.startsWith(root) ? orig : path.join(root, orig);
-    const skipTSNode = 
-    // the CLI specifically turned it off
-    (settings_1.settings.tsnodeEnabled === false) ||
-        // the CLI didn't specify ts-node and it is production
-        (settings_1.settings.tsnodeEnabled === undefined && (0, util_1.isProd)());
-    // We always want to load the tsconfig for linked plugins.
-    if (skipTSNode && type !== 'link')
+    // NOTE: The order of these checks matter!
+    if (settings_1.settings.tsnodeEnabled === false) {
+        debug(`Skipping ts-node registration for ${root} because tsNodeEnabled is explicitly set to false`);
+        return orig;
+    }
+    // Skip ts-node registration if plugin is an ESM plugin executing from a CJS plugin
+    if (plugin?.moduleType === 'module' && config_1.Config.rootPlugin?.moduleType === 'commonjs') {
+        debug(`Skipping ts-node registration for ${root} because it's an ESM module but the root plugin is CommonJS`);
+        if (plugin.type === 'link')
+            (0, errors_1.memoizedWarn)(`${plugin.name} is a linked ESM module and cannot be auto-compiled from a CommonJS root plugin. Existing compiled source will be used instead.`);
         return orig;
+    }
+    // If plugin is an ESM plugin being executed from an ESM root plugin, check to see if ts-node/esm loader has been set
+    // either in the NODE_OPTIONS env var or from the exec args. If the ts-node/esm loader has NOT been loaded then we want
+    // to skip ts-node registration so that it falls back on the compiled source.
+    if (plugin?.moduleType === 'module') {
+        const tsNodeEsmLoaderInExecArgv = process.execArgv.includes('--loader') && process.execArgv.includes('ts-node/esm');
+        const tsNodeEsmLoaderInNodeOptions = process.env.NODE_OPTIONS?.includes('--loader=ts-node/esm') ?? false;
+        if (!tsNodeEsmLoaderInExecArgv && !tsNodeEsmLoaderInNodeOptions) {
+            debug(`Skipping ts-node registration for ${root} because it's an ESM module but the ts-node/esm loader hasn't been run`);
+            debug('try setting NODE_OPTIONS="--loader ts-node/esm" in your environment.');
+            if (plugin.type === 'link') {
+                (0, errors_1.memoizedWarn)(`${plugin.name} is a linked ESM module and cannot be auto-compiled without setting NODE_OPTIONS="--loader=ts-node/esm" in the environment. Existing compiled source will be used instead.`);
+            }
+            return orig;
+        }
+    }
+    if (settings_1.settings.tsnodeEnabled === undefined && (0, util_1.isProd)() && plugin?.type !== 'link') {
+        debug(`Skipping ts-node registration for ${root} because NODE_ENV is NOT "test" or "development"`);
+        return orig;
+    }
     try {
-        const tsconfig = type === 'link' ? registerTSNode(root) : loadTSConfig(root);
+        const tsconfig = registerTSNode(root);
         if (!tsconfig)
             return orig;
         const { rootDir, rootDirs, outDir } = tsconfig.compilerOptions;

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 {
     oclif: OclifError['oclif'];
     code?: string;
+    suggestions?: string[];
     constructor(error: string | Error, options?: {
         exit?: number | false;
     } & PrettyPrintableError);

package/lib/errors/errors/cli.js

@@ -24,6 +24,7 @@ class CLIError extends Error {
         this.oclif = {};
         addOclifExitCode(this, options);
         this.code = options.code;
+        this.suggestions = options.suggestions;
     }
     get stack() {
         return cs(super.stack, { pretty: true });

package/lib/errors/index.d.ts

@@ -14,3 +14,4 @@ export declare function error(input: string | Error, options?: {
     exit?: number;
 } & PrettyPrintableError): never;
 export declare function warn(input: string | Error): void;
+export declare function memoizedWarn(input: string | Error): void;

package/lib/errors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.warn = exports.error = exports.exit = exports.config = exports.Logger = exports.CLIError = exports.ModuleLoadError = exports.ExitError = exports.handle = void 0;
+exports.memoizedWarn = exports.warn = exports.error = exports.exit = exports.config = exports.Logger = exports.CLIError = exports.ModuleLoadError = exports.ExitError = exports.handle = void 0;
 var handle_1 = require("./handle");
 Object.defineProperty(exports, "handle", { enumerable: true, get: function () { return handle_1.handle; } });
 var exit_1 = require("./errors/exit");
@@ -60,3 +60,10 @@ function warn(input) {
         config_2.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;

package/lib/errors/logger.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = void 0;
-const fs = require("fs/promises");
-const path_1 = require("path");
+const fs = require("fs-extra");
+const path = require("path");
 const stripAnsi = require("strip-ansi");
 const timestamp = () => new Date().toISOString();
 let timer;
@@ -35,7 +35,7 @@ class Logger {
                 return;
             const mylines = this.buffer;
             this.buffer = [];
-            await fs.mkdir((0, path_1.dirname)(this.file), { recursive: true });
+            await fs.mkdirp(path.dirname(this.file));
             await fs.appendFile(this.file, mylines.join('\n') + '\n');
         });
         await this.flushing;

package/lib/flags.js

@@ -84,8 +84,7 @@ const help = (opts = {}) => {
         description: 'Show CLI help.',
         ...opts,
         parse: async (_, cmd) => {
-            const Help = await (0, help_1.loadHelpClass)(cmd.config);
-            await new Help(cmd.config, cmd.config.pjson.helpOptions).showHelp(cmd.id ? [cmd.id, ...cmd.argv] : cmd.argv);
+            new help_1.Help(cmd.config).showHelp(cmd.id ? [cmd.id, ...cmd.argv] : cmd.argv);
             cmd.exit(0);
         },
     });

package/lib/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stdout = exports.stderr = exports.execute = exports.ux = exports.flush = exports.settings = exports.toConfiguredId = exports.toStandardizedId = exports.tsPath = exports.toCached = exports.run = exports.Performance = exports.Plugin = exports.Parser = exports.Interfaces = exports.HelpBase = exports.Help = exports.loadHelpClass = exports.Flags = exports.Errors = exports.Config = exports.CommandHelp = exports.Command = exports.Args = void 0;
+const semver = require("semver");
 const command_1 = require("./command");
 Object.defineProperty(exports, "Command", { enumerable: true, get: function () { return command_1.Command; } });
 const main_1 = require("./main");
@@ -33,6 +34,7 @@ const settings_1 = require("./settings");
 Object.defineProperty(exports, "settings", { enumerable: true, get: function () { return settings_1.settings; } });
 const ux = require("./cli-ux");
 exports.ux = ux;
+const util_2 = require("./util");
 const stream_1 = require("./cli-ux/stream");
 Object.defineProperty(exports, "stderr", { enumerable: true, get: function () { return stream_1.stderr; } });
 Object.defineProperty(exports, "stdout", { enumerable: true, get: function () { return stream_1.stdout; } });
@@ -50,4 +52,11 @@ function checkCWD() {
         }
     }
 }
+function checkNodeVersion() {
+    const pjson = (0, util_2.requireJson)(__dirname, '..', 'package.json');
+    if (!semver.satisfies(process.versions.node, pjson.engines.node)) {
+        stream_1.stderr.write(`WARNING\nWARNING Node version must be ${pjson.engines.node} to use this CLI\nWARNING Current node version: ${process.versions.node}\nWARNING\n`);
+    }
+}
 checkCWD();
+checkNodeVersion();

package/lib/interfaces/pjson.d.ts

@@ -12,6 +12,7 @@ export interface PJSON {
         bin?: string;
         dirname?: string;
         hooks?: Record<string, string | string[]>;
+        plugins?: string[];
     };
 }
 export declare namespace PJSON {

package/lib/interfaces/plugin.d.ts

@@ -1,4 +1,3 @@
-import { Config } from './config';
 import { Command } from '../command';
 import { PJSON } from './pjson';
 import { Topic } from './topic';
@@ -19,7 +18,6 @@ export interface Options extends PluginOptions {
     channel?: string;
     version?: string;
     enablePerf?: boolean;
-    config?: Config;
 }
 export interface Plugin {
     /**
@@ -51,6 +49,10 @@ export interface Plugin {
      * examples: core, link, user, dev
      */
     type: string;
+    /**
+     * Plugin is written in ESM or CommonJS
+     */
+    moduleType: 'module' | 'commonjs';
     /**
      * base path of plugin
      */

package/lib/interfaces/ts-config.d.ts

@@ -7,5 +7,14 @@ export interface TSConfig {
         esModuleInterop?: boolean;
         experimentalDecorators?: boolean;
         emitDecoratorMetadata?: boolean;
+        module?: string;
+        moduleResolution?: string;
+        sourceMap?: boolean;
+        jsx?: boolean;
+    };
+    'ts-node'?: {
+        esm?: boolean;
+        experimentalSpecifierResolution?: 'node' | 'explicit';
+        scope?: boolean;
     };
 }

package/lib/main.d.ts

@@ -11,46 +11,41 @@ export declare function run(argv?: string[], options?: Interfaces.LoadOptions):
  *
  * @example For ESM dev.js
  * ```
- * #!/usr/bin/env ts-node
- * // eslint-disable-next-line node/shebang
+ * #!/usr/bin/env node
  * (async () => {
  *   const oclif = await import('@oclif/core')
- *   await oclif.execute({type: 'esm', development: true, dir: import.meta.url})
+ *   await oclif.execute({development: true, dir: import.meta.url})
  * })()
  * ```
  *
  * @example For ESM run.js
  * ```
  * #!/usr/bin/env node
- * // eslint-disable-next-line node/shebang
  * (async () => {
  *   const oclif = await import('@oclif/core')
- *   await oclif.execute({type: 'esm', dir: import.meta.url})
+ *   await oclif.execute({dir: import.meta.url})
  * })()
  * ```
  *
  * @example For CJS dev.js
  * ```
  * #!/usr/bin/env node
- * // eslint-disable-next-line node/shebang
  * (async () => {
  *   const oclif = await import('@oclif/core')
- *   await oclif.execute({type: 'cjs', development: true, dir: __dirname})
+ *   await oclif.execute({development: true, dir: __dirname})
  * })()
  * ```
  *
  * @example For CJS run.js
  * ```
  * #!/usr/bin/env node
- * // eslint-disable-next-line node/shebang
  * (async () => {
  *   const oclif = await import('@oclif/core')
- *   await oclif.execute({type: 'cjs', dir: import.meta.url})
+ *   await oclif.execute({dir: __dirname})
  * })()
  * ```
  */
 export declare function execute(options: {
-    type: 'cjs' | 'esm';
     dir: string;
     args?: string[];
     loadOptions?: Interfaces.LoadOptions;

package/lib/main.js

@@ -8,9 +8,9 @@ const config_1 = require("./config");
 const help_1 = require("./help");
 const settings_1 = require("./settings");
 const _1 = require(".");
-const path_1 = require("path");
 const stream_1 = require("./cli-ux/stream");
 const performance_1 = require("./performance");
+const debug = require('debug')('oclif:main');
 const log = (message = '', ...args) => {
     message = typeof message === 'string' ? message : (0, util_1.inspect)(message);
     stream_1.stdout.write((0, util_1.format)(message, ...args) + '\n');
@@ -45,6 +45,9 @@ async function run(argv, options) {
         await performance_1.Performance.collect();
         performance_1.Performance.debug();
     };
+    debug(`process.execPath: ${process.execPath}`);
+    debug(`process.execArgv: ${process.execArgv}`);
+    debug('process.argv: %O', process.argv);
     argv = argv ?? process.argv.slice(2);
     // Handle the case when a file URL string or URL is passed in such as 'import.meta.url'; covert to file path.
     if (options && ((typeof options === 'string' && options.startsWith('file://')) || options instanceof url_2.URL)) {
@@ -93,9 +96,6 @@ async function run(argv, options) {
     }
 }
 exports.run = run;
-function getTsConfigPath(dir, type) {
-    return type === 'cjs' ? (0, path_1.join)(dir, '..', 'tsconfig.json') : (0, path_1.join)((0, path_1.dirname)((0, url_1.fileURLToPath)(dir)), '..', 'tsconfig.json');
-}
 /**
  * Load and run oclif CLI
  *
@@ -104,41 +104,37 @@ function getTsConfigPath(dir, type) {
  *
  * @example For ESM dev.js
  * ```
- * #!/usr/bin/env ts-node
- * // eslint-disable-next-line node/shebang
+ * #!/usr/bin/env node
  * (async () => {
  *   const oclif = await import('@oclif/core')
- *   await oclif.execute({type: 'esm', development: true, dir: import.meta.url})
+ *   await oclif.execute({development: true, dir: import.meta.url})
  * })()
  * ```
  *
  * @example For ESM run.js
  * ```
  * #!/usr/bin/env node
- * // eslint-disable-next-line node/shebang
  * (async () => {
  *   const oclif = await import('@oclif/core')
- *   await oclif.execute({type: 'esm', dir: import.meta.url})
+ *   await oclif.execute({dir: import.meta.url})
  * })()
  * ```
  *
  * @example For CJS dev.js
  * ```
  * #!/usr/bin/env node
- * // eslint-disable-next-line node/shebang
  * (async () => {
  *   const oclif = await import('@oclif/core')
- *   await oclif.execute({type: 'cjs', development: true, dir: __dirname})
+ *   await oclif.execute({development: true, dir: __dirname})
  * })()
  * ```
  *
  * @example For CJS run.js
  * ```
  * #!/usr/bin/env node
- * // eslint-disable-next-line node/shebang
  * (async () => {
  *   const oclif = await import('@oclif/core')
- *   await oclif.execute({type: 'cjs', dir: import.meta.url})
+ *   await oclif.execute({dir: __dirname})
  * })()
  * ```
  */
@@ -146,9 +142,6 @@ async function execute(options) {
     if (options.development) {
         // In dev mode -> use ts-node and dev plugins
         process.env.NODE_ENV = 'development';
-        require('ts-node').register({
-            project: getTsConfigPath(options.dir, options.type),
-        });
         settings_1.settings.debug = true;
     }
     await run(options.args ?? process.argv.slice(2), options.loadOptions ?? options.dir)

package/lib/module-loader.js

@@ -2,15 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const path = require("path");
 const url = require("url");
-const fs_1 = require("fs");
+const fs = require("fs-extra");
 const errors_1 = require("./errors");
-const Config = require("./config");
+const config_1 = require("./config");
 const getPackageType = require('get-package-type');
 /**
  * Defines file extension resolution when source files do not have an extension.
  */
 // eslint-disable-next-line camelcase
 const s_EXTENSIONS = ['.ts', '.js', '.mjs', '.cjs'];
+const isPlugin = (config) => {
+    return config.type !== undefined;
+};
 /**
  * Provides a static class with several utility methods to work with Oclif config / plugin to load ESM or CJS Node
  * modules and source files.
@@ -120,21 +123,18 @@ class ModuleLoader {
     static resolvePath(config, modulePath) {
         let isESM;
         let filePath;
-        const isPlugin = (config) => {
-            return config.type !== undefined;
-        };
         try {
             filePath = require.resolve(modulePath);
             isESM = ModuleLoader.isPathModule(filePath);
         }
         catch {
-            filePath = isPlugin(config) ? Config.tsPath(config.root, modulePath, config.type) : Config.tsPath(config.root, modulePath);
+            filePath = (isPlugin(config) ? (0, config_1.tsPath)(config.root, modulePath, config) : (0, config_1.tsPath)(config.root, modulePath)) ?? modulePath;
             let fileExists = false;
             let isDirectory = false;
-            if ((0, fs_1.existsSync)(filePath)) {
+            if (fs.existsSync(filePath)) {
                 fileExists = true;
                 try {
-                    if ((0, fs_1.lstatSync)(filePath)?.isDirectory?.()) {
+                    if (fs.lstatSync(filePath)?.isDirectory?.()) {
                         fileExists = false;
                         isDirectory = true;
                     }
@@ -167,7 +167,7 @@ class ModuleLoader {
         // eslint-disable-next-line camelcase
         for (const extension of s_EXTENSIONS) {
             const testPath = `${filePath}${extension}`;
-            if ((0, fs_1.existsSync)(testPath)) {
+            if (fs.existsSync(testPath)) {
                 return testPath;
             }
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oclif/core",
   "description": "base library for oclif CLIs",
-  "version": "2.14.0",
+  "version": "3.0.0-beta.2",
   "author": "Salesforce",
   "bugs": "https://github.com/oclif/core/issues",
   "dependencies": {
@@ -14,6 +14,7 @@
     "cli-progress": "^3.12.0",
     "debug": "^4.3.4",
     "ejs": "^3.1.8",
+    "fs-extra": "^9.1.0",
     "get-package-type": "^0.1.0",
     "globby": "^11.1.0",
     "hyperlinker": "^1.0.0",
@@ -23,7 +24,7 @@
     "natural-orderby": "^2.0.3",
     "object-treeify": "^1.1.33",
     "password-prompt": "^1.1.2",
-    "semver": "^7.5.4",
+    "semver": "^7.5.3",
     "slice-ansi": "^4.0.0",
     "string-width": "^4.2.3",
     "strip-ansi": "^6.0.1",
@@ -46,6 +47,7 @@
     "@types/chai-as-promised": "^7.1.5",
     "@types/clean-stack": "^2.1.1",
     "@types/ejs": "^3.1.2",
+    "@types/fs-extra": "^9.0.13",
     "@types/indent-string": "^4.0.1",
     "@types/js-yaml": "^3.12.7",
     "@types/mocha": "^8.2.3",
@@ -53,7 +55,7 @@
     "@types/node": "^16",
     "@types/node-notifier": "^8.0.2",
     "@types/proxyquire": "^1.3.28",
-    "@types/semver": "^7.5.1",
+    "@types/semver": "^7.5.0",
     "@types/shelljs": "^0.8.11",
     "@types/slice-ansi": "^4.0.0",
     "@types/strip-ansi": "^5.2.1",
@@ -64,13 +66,14 @@
     "chai": "^4.3.7",
     "chai-as-promised": "^7.1.1",
     "commitlint": "^12.1.4",
+    "cross-env": "^7.0.3",
     "eslint": "^7.32.0",
     "eslint-config-oclif": "^4.0.0",
     "eslint-config-oclif-typescript": "^1.0.3",
     "fancy-test": "^2.0.16",
     "globby": "^11.1.0",
     "husky": "6",
-    "mocha": "^8.4.0",
+    "mocha": "^10.2.0",
     "nock": "^13.3.0",
     "proxyquire": "^2.1.3",
     "shelljs": "^0.8.5",
@@ -108,14 +111,15 @@
   "scripts": {
     "build": "shx rm -rf lib && tsc",
     "commitlint": "commitlint",
+    "compile": "tsc",
     "lint": "eslint . --ext .ts --config .eslintrc",
     "posttest": "yarn lint",
-    "compile": "tsc",
     "prepack": "yarn run build",
-    "test": "mocha --forbid-only \"test/**/*.test.ts\"",
-    "test:e2e": "mocha --forbid-only \"test/**/*.e2e.ts\" --timeout 1200000",
     "pretest": "yarn build --noEmit && tsc -p test --noEmit --skipLibCheck",
-    "test:perf": "ts-node test/perf/parser.perf.ts"
+    "test:e2e": "mocha --forbid-only \"test/**/*.e2e.ts\" --parallel --timeout 1200000",
+    "test:esm-cjs": "cross-env DEBUG=e2e:* ts-node test/integration/esm-cjs.ts",
+    "test:perf": "ts-node test/perf/parser.perf.ts",
+    "test": "mocha --forbid-only \"test/**/*.test.ts\""
   },
   "types": "lib/index.d.ts"
 }