@oclif/core 4.0.0-beta.8 → 4.0.0-beta.9

package/lib/cache.d.ts

@@ -1,5 +1,5 @@
 import { Config } from './config/config';
-import { Configuration, Plugin } from './interfaces';
+import { OclifConfiguration, Plugin } from './interfaces';
 type OclifCoreInfo = {
     name: string;
     version: string;
@@ -7,7 +7,7 @@ type OclifCoreInfo = {
 type CacheContents = {
     rootPlugin: Plugin;
     config: Config;
-    exitCodes: Configuration['exitCodes'];
+    exitCodes: OclifConfiguration['exitCodes'];
     '@oclif/core': OclifCoreInfo;
 };
 type ValueOf<T> = T[keyof T];
@@ -21,7 +21,7 @@ export default class Cache extends Map<keyof CacheContents, ValueOf<CacheContent
     get(key: 'config'): Config | undefined;
     get(key: '@oclif/core'): OclifCoreInfo;
     get(key: 'rootPlugin'): Plugin | undefined;
-    get(key: 'exitCodes'): Configuration['exitCodes'] | undefined;
+    get(key: 'exitCodes'): OclifConfiguration['exitCodes'] | undefined;
     private getOclifCoreMeta;
 }
 export {};

package/lib/cache.js

@@ -28,7 +28,7 @@ class Cache extends Map {
             try {
                 return {
                     name: '@oclif/core',
-                    version: JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, '..', 'package.json'), 'utf8')),
+                    version: JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, '..', 'package.json'), 'utf8')).version,
                 };
             }
             catch {

package/lib/command.d.ts

@@ -15,7 +15,6 @@ export declare abstract class Command {
     static aliases: string[];
     /** An order-dependent object of arguments for the command */
     static args: ArgInput;
-    static baseFlags: FlagInput;
     /**
      * Emit deprecation warning when a command alias is used
      */
@@ -109,7 +108,7 @@ export declare abstract class Command {
     log(message?: string, ...args: any[]): void;
     protected logJson(json: unknown): void;
     logToStderr(message?: string, ...args: any[]): void;
-    protected parse<F extends FlagOutput, B extends FlagOutput, A extends ArgOutput>(options?: Input<F, B, A>, argv?: string[]): Promise<ParserOutput<F, B, A>>;
+    protected parse<F extends FlagOutput, A extends ArgOutput>(options?: Input<F, A>, argv?: string[]): Promise<ParserOutput<F, A>>;
     protected toErrorJson(err: unknown): any;
     protected toSuccessJson(result: unknown): any;
     warn(input: Error | string): Error | string;

package/lib/command.js

@@ -61,7 +61,6 @@ class Command {
     static aliases = [];
     /** An order-dependent object of arguments for the command */
     static args = {};
-    static baseFlags;
     /**
      * Emit deprecation warning when a command alias is used
      */
@@ -148,6 +147,9 @@ class Command {
             opts = (0, node_url_1.fileURLToPath)(opts);
         }
         const config = await config_1.Config.load(opts || require.main?.filename || __dirname);
+        const cache = cache_1.default.getInstance();
+        if (!cache.has('config'))
+            cache.set('config', config);
         const cmd = new this(argv, config);
         if (!cmd.id) {
             const id = cmd.constructor.name.toLowerCase();
@@ -229,7 +231,7 @@ class Command {
         const opts = {
             context: this,
             ...options,
-            flags: (0, aggregate_flags_1.aggregateFlags)(options.flags, options.baseFlags, options.enableJsonFlag),
+            flags: (0, aggregate_flags_1.aggregateFlags)(options.flags, options.enableJsonFlag),
         };
         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
@@ -266,7 +268,7 @@ class Command {
         }
     }
     warnIfFlagDeprecated(flags) {
-        const allFlags = (0, aggregate_flags_1.aggregateFlags)(this.ctor.flags, this.ctor.baseFlags, this.ctor.enableJsonFlag);
+        const allFlags = (0, aggregate_flags_1.aggregateFlags)(this.ctor.flags, this.ctor.enableJsonFlag);
         for (const flag of Object.keys(flags)) {
             const flagDef = allFlags[flag];
             const deprecated = flagDef?.deprecated;

package/lib/config/config.d.ts

@@ -1,5 +1,5 @@
 import { Command } from '../command';
-import { Configuration, Hook, Hooks, PJSON, S3Templates, Topic, UserPJSON } from '../interfaces';
+import { Hook, Hooks, OclifConfiguration, PJSON, S3Templates, Topic, UserPJSON } from '../interfaces';
 import { ArchTypes, Config as IConfig, LoadOptions, PlatformTypes, VersionDetails } from '../interfaces/config';
 import { Plugin as IPlugin, Options } from '../interfaces/plugin';
 import { Theme } from '../interfaces/theme';
@@ -27,7 +27,7 @@ export declare class Config implements IConfig {
     shell: string;
     theme?: Theme | undefined;
     topicSeparator: ' ' | ':';
-    updateConfig: NonNullable<Configuration['update']>;
+    updateConfig: NonNullable<OclifConfiguration['update']>;
     userAgent: string;
     userPJSON?: UserPJSON | undefined;
     valid: boolean;
@@ -117,26 +117,6 @@ export declare class Config implements IConfig {
     protected windowsUserprofileHome(): string | undefined;
     protected _shell(): string;
     private buildS3Config;
-    /**
-     * This method is responsible for locating the correct plugin to use for a named command id
-     * It searches the {Config} registered commands to match either the raw command id or the command alias
-     * It is possible that more than one command will be found. This is due the ability of two distinct plugins to
-     * create the same command or command alias.
-     *
-     * In the case of more than one found command, the function will select the command based on the order in which
-     * the plugin is included in the package.json `oclif.plugins` list. The command that occurs first in the list
-     * is selected as the command to run.
-     *
-     * Commands can also be present from either an install or a link. When a command is one of these and a core plugin
-     * is present, this function defers to the core plugin.
-     *
-     * If there is not a core plugin command present, this function will return the first
-     * plugin as discovered (will not change the order)
-     *
-     * @param commands commands to determine the priority of
-     * @returns command instance {Command.Loadable} or undefined
-     */
-    private determinePriority;
     private getCmdLookupId;
     private getTopicLookupId;
     /**

package/lib/config/config.js

@@ -39,6 +39,7 @@ const logger_1 = require("../logger");
 const module_loader_1 = require("../module-loader");
 const performance_1 = require("../performance");
 const settings_1 = require("../settings");
+const determine_priority_1 = require("../util/determine-priority");
 const fs_1 = require("../util/fs");
 const os_1 = require("../util/os");
 const util_2 = require("../util/util");
@@ -532,7 +533,7 @@ class Config {
             options = ext;
         else if (ext)
             options.ext = ext;
-        const template = this.updateConfig.s3.templates?.[options.platform ? 'target' : 'vanilla'][type] ?? '';
+        const template = this.updateConfig.s3?.templates?.[options.platform ? 'target' : 'vanilla'][type] ?? '';
         return ejs.render(template, { ...this, ...options });
     }
     s3Url(key) {
@@ -622,58 +623,6 @@ class Config {
             templates,
         };
     }
-    /**
-     * This method is responsible for locating the correct plugin to use for a named command id
-     * It searches the {Config} registered commands to match either the raw command id or the command alias
-     * It is possible that more than one command will be found. This is due the ability of two distinct plugins to
-     * create the same command or command alias.
-     *
-     * In the case of more than one found command, the function will select the command based on the order in which
-     * the plugin is included in the package.json `oclif.plugins` list. The command that occurs first in the list
-     * is selected as the command to run.
-     *
-     * Commands can also be present from either an install or a link. When a command is one of these and a core plugin
-     * is present, this function defers to the core plugin.
-     *
-     * If there is not a core plugin command present, this function will return the first
-     * plugin as discovered (will not change the order)
-     *
-     * @param commands commands to determine the priority of
-     * @returns command instance {Command.Loadable} or undefined
-     */
-    determinePriority(commands) {
-        const oclifPlugins = this.pjson.oclif?.plugins ?? [];
-        const commandPlugins = commands.sort((a, b) => {
-            const pluginAliasA = a.pluginAlias ?? 'A-Cannot-Find-This';
-            const pluginAliasB = b.pluginAlias ?? 'B-Cannot-Find-This';
-            const aIndex = oclifPlugins.indexOf(pluginAliasA);
-            const bIndex = oclifPlugins.indexOf(pluginAliasB);
-            // When both plugin types are 'core' plugins sort based on index
-            if (a.pluginType === 'core' && b.pluginType === 'core') {
-                // If b appears first in the pjson.plugins sort it first
-                return aIndex - bIndex;
-            }
-            // if b is a core plugin and a is not sort b first
-            if (b.pluginType === 'core' && a.pluginType !== 'core') {
-                return 1;
-            }
-            // if a is a core plugin and b is not sort a first
-            if (a.pluginType === 'core' && b.pluginType !== 'core') {
-                return -1;
-            }
-            // if a is a jit plugin and b is not sort b first
-            if (a.pluginType === 'jit' && b.pluginType !== 'jit') {
-                return 1;
-            }
-            // if b is a jit plugin and a is not sort a first
-            if (b.pluginType === 'jit' && a.pluginType !== 'jit') {
-                return -1;
-            }
-            // neither plugin is core, so do not change the order
-            return 0;
-        });
-        return commandPlugins[0];
-    }
     getCmdLookupId(id) {
         if (this._commands.has(id))
             return id;
@@ -701,7 +650,7 @@ class Config {
         for (const plugin of plugins) {
             this.plugins.set(plugin.name, plugin);
             // Delete all commands from the legacy plugin so that we can re-add them.
-            // This is necessary because this.determinePriority will pick the initial
+            // This is necessary because determinePriority will pick the initial
             // command that was added, which won't have been converted by PluginLegacy yet.
             for (const cmd of plugin.commands ?? []) {
                 this._commands.delete(cmd.id);
@@ -722,7 +671,10 @@ class Config {
         for (const command of plugin.commands) {
             // set canonical command id
             if (this._commands.has(command.id)) {
-                const prioritizedCommand = this.determinePriority([this._commands.get(command.id), command]);
+                const prioritizedCommand = (0, determine_priority_1.determinePriority)(this.pjson.oclif.plugins ?? [], [
+                    this._commands.get(command.id),
+                    command,
+                ]);
                 this._commands.set(prioritizedCommand.id, prioritizedCommand);
             }
             else {
@@ -739,7 +691,10 @@ class Config {
             }
             const handleAlias = (alias, hidden = false) => {
                 if (this._commands.has(alias)) {
-                    const prioritizedCommand = this.determinePriority([this._commands.get(alias), command]);
+                    const prioritizedCommand = (0, determine_priority_1.determinePriority)(this.pjson.oclif.plugins ?? [], [
+                        this._commands.get(alias),
+                        command,
+                    ]);
                     this._commands.set(alias, { ...prioritizedCommand, id: alias });
                 }
                 else {

package/lib/config/plugin-loader.js

@@ -1,34 +1,11 @@
 "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;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 const minimatch_1 = require("minimatch");
 const node_path_1 = require("node:path");
 const performance_1 = require("../performance");
 const fs_1 = require("../util/fs");
 const util_1 = require("../util/util");
-const Plugin = __importStar(require("./plugin"));
+const plugin_1 = require("./plugin");
 const util_2 = require("./util");
 const debug = (0, util_2.makeDebug)();
 function findMatchingDependencies(dependencies, patterns) {
@@ -62,7 +39,7 @@ class PluginLoader {
         }
         else {
             const marker = performance_1.Performance.mark(performance_1.OCLIF_MARKER_OWNER, 'plugin.load#root');
-            rootPlugin = new Plugin.Plugin({ isRoot: true, pjson, root: this.options.root });
+            rootPlugin = new plugin_1.Plugin({ isRoot: true, pjson, root: this.options.root });
             await rootPlugin.load();
             marker?.addDetails({
                 commandCount: rootPlugin.commands.length,
@@ -154,7 +131,7 @@ class PluginLoader {
                 if (this.plugins.has(name))
                     return;
                 const pluginMarker = performance_1.Performance.mark(performance_1.OCLIF_MARKER_OWNER, `plugin.load#${name}`);
-                const instance = new Plugin.Plugin(opts);
+                const instance = new plugin_1.Plugin(opts);
                 await instance.load();
                 pluginMarker?.addDetails({
                     commandCount: instance.commands.length,

package/lib/interfaces/config.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 import { Command } from '../command';
 import { Hook, Hooks } from './hooks';
-import { Configuration, PJSON, S3Templates } from './pjson';
+import { OclifConfiguration, PJSON, S3Templates } from './pjson';
 import { Options, Plugin } from './plugin';
 import { Theme } from './theme';
 import { Topic } from './topic';
@@ -114,7 +114,7 @@ export interface Config {
     readonly theme?: Theme | undefined;
     topicSeparator: ' ' | ':';
     readonly topics: Topic[];
-    readonly updateConfig: NonNullable<Configuration['update']>;
+    readonly updateConfig: NonNullable<OclifConfiguration['update']>;
     /**
      * user agent to use for http calls
      *

package/lib/interfaces/flags.d.ts

@@ -3,12 +3,12 @@ import { FlagInput } from './parser';
  * Infer the flags that are returned by Command.parse. This is useful for when you want to assign the flags as a class property.
  *
  * @example
- * export type StatusFlags = Interfaces.InferredFlags<typeof Status.flags & typeof Status.baseFlags>
+ * export type StatusFlags = Interfaces.InferredFlags<typeof Status.flags>
  *
  * export abstract class BaseCommand extends Command {
  *   static enableJsonFlag = true
  *
- *   static baseFlags = {
+ *   static flags = {
  *     config: Flags.string({
  *       description: 'specify config file',
  *     }),
@@ -17,6 +17,7 @@ import { FlagInput } from './parser';
  *
  * export default class Status extends BaseCommand {
  *   static flags = {
+ *    ...BaseCommand.flags,
  *     force: Flags.boolean({char: 'f', description: 'a flag'}),
  *   }
  *

package/lib/interfaces/hooks.d.ts

@@ -74,7 +74,7 @@ export interface Hooks {
     preparse: {
         options: {
             argv: string[];
-            options: Input<OutputFlags<any>, OutputFlags<any>, OutputFlags<any>>;
+            options: Input<OutputFlags<any>, OutputFlags<any>>;
         };
         return: string[];
     };

package/lib/interfaces/index.d.ts

@@ -8,7 +8,7 @@ export type { Hook, Hooks } from './hooks';
 export type { Logger } from './logger';
 export type { Manifest } from './manifest';
 export type { Arg, BooleanFlag, CustomOptions, Deprecation, Flag, FlagDefinition, OptionFlag } from './parser';
-export type { Configuration, PJSON, S3, S3Templates, UserPJSON } from './pjson';
+export type { OclifConfiguration, PJSON, S3, S3Templates, UserPJSON } from './pjson';
 export type { Options, Plugin, PluginOptions } from './plugin';
 export type { S3Manifest } from './s3-manifest';
 export type { Theme } from './theme';

package/lib/interfaces/parser.d.ts

@@ -426,9 +426,8 @@ export type FlagDefinition<T, P = CustomOptions, R extends ReturnTypeSwitches =
     }>>;
 };
 export type Flag<T> = BooleanFlag<T> | OptionFlag<T>;
-export type Input<TFlags extends FlagOutput, BFlags extends FlagOutput, AFlags extends ArgOutput> = {
+export type Input<TFlags extends FlagOutput, AFlags extends ArgOutput> = {
     flags?: FlagInput<TFlags>;
-    baseFlags?: FlagInput<BFlags>;
     enableJsonFlag?: true | false;
     args?: ArgInput<AFlags>;
     strict?: boolean | undefined;

package/lib/interfaces/pjson.d.ts

@@ -102,13 +102,14 @@ export type S3 = {
     folder?: string | undefined;
     gz?: boolean | undefined;
     host?: string | undefined;
+    indexVersionLimit?: number | undefined;
     templates?: {
         target: S3Templates;
         vanilla: S3Templates;
     } | undefined;
     xz?: boolean | undefined;
 };
-export type Configuration = {
+export type OclifConfiguration = {
     /**
      * Flags in addition to --help that should trigger help output.
      */
@@ -237,7 +238,7 @@ export type Configuration = {
         [k: string]: {
             description?: string;
             hidden?: boolean;
-            subtopics?: Configuration['topics'];
+            subtopics?: OclifConfiguration['topics'];
         };
     };
     update?: {
@@ -246,12 +247,12 @@ export type Configuration = {
             rollout?: number;
         };
         disableNpmLookup?: boolean;
-        node: {
+        node?: {
             targets?: string[];
             version?: string;
             options?: string | string[];
         };
-        s3: S3;
+        s3?: S3;
     };
     'warn-if-update-available'?: {
         authorization?: string;
@@ -296,6 +297,6 @@ export type PJSON = {
         [name: string]: string;
     };
     name: string;
-    oclif: Configuration;
+    oclif: OclifConfiguration;
     version: string;
 };

package/lib/parser/index.d.ts

@@ -1,3 +1,3 @@
 import { Input, OutputArgs, OutputFlags, ParserOutput } from '../interfaces/parser';
 export { flagUsages } from './help';
-export declare function parse<TFlags extends OutputFlags<any>, BFlags extends OutputFlags<any>, TArgs extends OutputArgs<any>>(argv: string[], options: Input<TFlags, BFlags, TArgs>): Promise<ParserOutput<TFlags, BFlags, TArgs>>;
+export declare function parse<TFlags extends OutputFlags<any>, TArgs extends OutputArgs<any>>(argv: string[], options: Input<TFlags, TArgs>): Promise<ParserOutput<TFlags, TArgs>>;

package/lib/util/aggregate-flags.d.ts

@@ -1,2 +1,2 @@
 import { FlagInput, FlagOutput } from '../interfaces/parser';
-export declare function aggregateFlags<F extends FlagOutput, B extends FlagOutput>(flags: FlagInput<F> | undefined, baseFlags: FlagInput<B> | undefined, enableJsonFlag: boolean | undefined): FlagInput<F>;
+export declare function aggregateFlags<F extends FlagOutput>(flags: FlagInput<F> | undefined, enableJsonFlag: boolean | undefined): FlagInput<F>;

package/lib/util/aggregate-flags.js

@@ -6,8 +6,7 @@ const json = (0, flags_1.boolean)({
     description: 'Format output as json.',
     helpGroup: 'GLOBAL',
 });
-function aggregateFlags(flags, baseFlags, enableJsonFlag) {
-    const combinedFlags = { ...baseFlags, ...flags };
-    return (enableJsonFlag ? { json, ...combinedFlags } : combinedFlags);
+function aggregateFlags(flags, enableJsonFlag) {
+    return (enableJsonFlag ? { json, ...flags } : flags);
 }
 exports.aggregateFlags = aggregateFlags;

package/lib/util/cache-command.js

@@ -6,8 +6,7 @@ const cache_default_value_1 = require("./cache-default-value");
 const ensure_arg_object_1 = require("./ensure-arg-object");
 const util_1 = require("./util");
 // In order to collect static properties up the inheritance chain, we need to recursively
-// access the prototypes until there's nothing left. This allows us to combine baseFlags
-// and flags as well as add in the json flag if enableJsonFlag is enabled.
+// access the prototypes until there's nothing left.
 function mergePrototype(result, cmd) {
     const proto = Object.getPrototypeOf(cmd);
     const filteredProto = (0, util_1.pickBy)(proto, (v) => v !== undefined);
@@ -71,10 +70,10 @@ async function cacheCommand(uncachedCmd, plugin, respectNoCacheDefault = false)
     const cmd = mergePrototype(uncachedCmd, uncachedCmd);
     // @ts-expect-error because v2 commands have flags stored in _flags
     const uncachedFlags = cmd.flags ?? cmd._flags;
-    // @ts-expect-error because v2 commands have base flags stored in _baseFlags
+    // @ts-expect-error because v2 commands have base flags stored in `_baseFlags` and v4 commands never have `baseFlags`
     const uncachedBaseFlags = cmd.baseFlags ?? cmd._baseFlags;
     const [flags, args] = await Promise.all([
-        await cacheFlags((0, aggregate_flags_1.aggregateFlags)(uncachedFlags, uncachedBaseFlags, cmd.enableJsonFlag), respectNoCacheDefault),
+        await cacheFlags((0, aggregate_flags_1.aggregateFlags)({ ...uncachedFlags, ...uncachedBaseFlags }, cmd.enableJsonFlag), respectNoCacheDefault),
         await cacheArgs((0, ensure_arg_object_1.ensureArgObject)(cmd.args), respectNoCacheDefault),
     ]);
     const stdProperties = {

package/lib/util/determine-priority.d.ts

@@ -0,0 +1,21 @@
+import { Command } from '../command';
+/**
+ * This function is responsible for locating the correct plugin to use for a named command id
+ * It searches the {Config} registered commands to match either the raw command id or the command alias
+ * It is possible that more than one command will be found. This is due the ability of two distinct plugins to
+ * create the same command or command alias.
+ *
+ * In the case of more than one found command, the function will select the command based on the order in which
+ * the plugin is included in the package.json `oclif.plugins` list. The command that occurs first in the list
+ * is selected as the command to run.
+ *
+ * Commands can also be present from either an install or a link. When a command is one of these and a core plugin
+ * is present, this function defers to the core plugin.
+ *
+ * If there is not a core plugin command present, this function will return the first
+ * plugin as discovered (will not change the order)
+ *
+ * @param commands commands to determine the priority of
+ * @returns command instance {Command.Loadable} or undefined
+ */
+export declare function determinePriority(plugins: string[], commands: Command.Loadable[]): Command.Loadable;

package/lib/util/determine-priority.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.determinePriority = void 0;
+/**
+ * This function is responsible for locating the correct plugin to use for a named command id
+ * It searches the {Config} registered commands to match either the raw command id or the command alias
+ * It is possible that more than one command will be found. This is due the ability of two distinct plugins to
+ * create the same command or command alias.
+ *
+ * In the case of more than one found command, the function will select the command based on the order in which
+ * the plugin is included in the package.json `oclif.plugins` list. The command that occurs first in the list
+ * is selected as the command to run.
+ *
+ * Commands can also be present from either an install or a link. When a command is one of these and a core plugin
+ * is present, this function defers to the core plugin.
+ *
+ * If there is not a core plugin command present, this function will return the first
+ * plugin as discovered (will not change the order)
+ *
+ * @param commands commands to determine the priority of
+ * @returns command instance {Command.Loadable} or undefined
+ */
+function determinePriority(plugins, commands) {
+    const commandPlugins = commands.sort((a, b) => {
+        const pluginAliasA = a.pluginAlias ?? 'A-Cannot-Find-This';
+        const pluginAliasB = b.pluginAlias ?? 'B-Cannot-Find-This';
+        const aIndex = plugins.indexOf(pluginAliasA);
+        const bIndex = plugins.indexOf(pluginAliasB);
+        // When both plugin types are 'core' plugins sort based on index
+        if (a.pluginType === 'core' && b.pluginType === 'core') {
+            // If b appears first in the pjson.plugins sort it first
+            return aIndex - bIndex;
+        }
+        // if b is a core plugin and a is not sort b first
+        if (b.pluginType === 'core' && a.pluginType !== 'core') {
+            return 1;
+        }
+        // if a is a core plugin and b is not sort a first
+        if (a.pluginType === 'core' && b.pluginType !== 'core') {
+            return -1;
+        }
+        // if a is a jit plugin and b is not sort b first
+        if (a.pluginType === 'jit' && b.pluginType !== 'jit') {
+            return 1;
+        }
+        // if b is a jit plugin and a is not sort a first
+        if (b.pluginType === 'jit' && a.pluginType !== 'jit') {
+            return -1;
+        }
+        // neither plugin is core, so do not change the order
+        return 0;
+    });
+    return commandPlugins[0];
+}
+exports.determinePriority = determinePriority;

package/lib/ux/theme.d.ts

@@ -6,4 +6,4 @@ import { StandardAnsi, Theme } from '../interfaces/theme';
  * @returns colorized string
  */
 export declare function colorize(color: string | StandardAnsi | undefined, text: string): string;
-export declare function parseTheme(theme: Record<string, string>): Theme;
+export declare function parseTheme(theme: Record<string, string | Record<string, string>>): Theme;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oclif/core",
   "description": "base library for oclif CLIs",
-  "version": "4.0.0-beta.8",
+  "version": "4.0.0-beta.9",
   "author": "Salesforce",
   "bugs": "https://github.com/oclif/core/issues",
   "dependencies": {
@@ -28,6 +28,7 @@
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-plugins": "^5",
     "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^4",
     "@types/benchmark": "^2.1.5",
     "@types/chai": "^4.3.11",
     "@types/chai-as-promised": "^7.1.8",
@@ -57,7 +58,7 @@
     "nyc": "^15.1.0",
     "prettier": "^3.2.5",
     "shx": "^0.3.4",
-    "sinon": "^17",
+    "sinon": "^18",
     "ts-node": "^10.9.2",
     "tsd": "^0.31.0",
     "typescript": "^5"
@@ -112,20 +113,18 @@
   },
   "scripts": {
     "build": "shx rm -rf lib && tsc",
-    "commitlint": "commitlint",
     "compile": "tsc",
     "format": "prettier --write \"+(src|test)/**/*.+(ts|js|json)\"",
     "lint": "eslint . --ext .ts",
     "posttest": "yarn lint && yarn test:circular-deps",
     "prepack": "yarn run build",
     "prepare": "husky",
-    "pretest": "yarn build && tsc -p test --noEmit --skipLibCheck",
-    "test:circular-deps": "madge lib/ -c",
+    "test:circular-deps": "yarn build && madge lib/ -c",
     "test:debug": "nyc mocha --debug-brk --inspect \"test/**/*.test.ts\"",
     "test:integration": "mocha --forbid-only \"test/**/*.integration.ts\" --parallel --timeout 1200000",
     "test:interoperability": "cross-env DEBUG=integration:* ts-node test/integration/interop.ts",
     "test:perf": "ts-node test/perf/parser.perf.ts",
-    "test": "nyc mocha --forbid-only \"test/**/*.test.ts\""
+    "test": "nyc mocha --forbid-only \"test/**/*.test.ts\" --parallel"
   },
   "types": "lib/index.d.ts"
 }