@oclif/core 3.0.8 → 3.1.0

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

@@ -1,13 +1,38 @@
 "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 });
-const tslib_1 = require("tslib");
-const ansi_styles_1 = tslib_1.__importDefault(require("ansi-styles"));
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
-const strip_ansi_1 = tslib_1.__importDefault(require("strip-ansi"));
-const supportsColor = tslib_1.__importStar(require("supports-color"));
+const ansi_styles_1 = __importDefault(require("ansi-styles"));
+const chalk_1 = __importDefault(require("chalk"));
+const strip_ansi_1 = __importDefault(require("strip-ansi"));
+const supportsColor = __importStar(require("supports-color"));
 const screen_1 = require("../../screen");
 const base_1 = require("./base");
-const spinners_1 = tslib_1.__importDefault(require("./spinners"));
+const spinners_1 = __importDefault(require("./spinners"));
 const ansiEscapes = require('ansi-escapes');
 function color(s) {
     if (!supportsColor)

package/lib/cli-ux/config.js

@@ -1,10 +1,12 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.config = exports.Config = void 0;
-const tslib_1 = require("tslib");
 const fs_1 = require("../util/fs");
-const simple_1 = tslib_1.__importDefault(require("./action/simple"));
-const spinner_1 = tslib_1.__importDefault(require("./action/spinner"));
+const simple_1 = __importDefault(require("./action/simple"));
+const spinner_1 = __importDefault(require("./action/spinner"));
 const g = global;
 const globals = g.ux || (g.ux = {});
 const actionType = (Boolean(process.stderr.isTTY) &&

package/lib/cli-ux/index.js

@@ -1,16 +1,41 @@
 "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.Table = exports.ExitError = exports.config = exports.Config = exports.ActionBase = exports.warn = exports.wait = exports.url = exports.tree = exports.trace = exports.table = exports.styledObject = exports.styledJSON = exports.styledHeader = exports.prompt = exports.progress = exports.log = exports.info = exports.flush = exports.exit = exports.error = exports.done = exports.debug = exports.confirm = exports.anykey = exports.annotation = exports.action = exports.ux = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const chalk_1 = __importDefault(require("chalk"));
 const node_util_1 = require("node:util");
-const Errors = tslib_1.__importStar(require("../errors"));
+const Errors = __importStar(require("../errors"));
 const config_1 = require("./config");
 const flush_1 = require("./flush");
-const uxPrompt = tslib_1.__importStar(require("./prompt"));
+const uxPrompt = __importStar(require("./prompt"));
 const stream_1 = require("./stream");
-const styled = tslib_1.__importStar(require("./styled"));
-const wait_1 = tslib_1.__importDefault(require("./wait"));
+const styled = __importStar(require("./styled"));
+const wait_1 = __importDefault(require("./wait"));
 const hyperlinker = require('hyperlinker');
 class ux {
     static config = config_1.config;

package/lib/cli-ux/prompt.js

@@ -1,9 +1,34 @@
 "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.anykey = exports.confirm = exports.prompt = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
-const Errors = tslib_1.__importStar(require("../errors"));
+const chalk_1 = __importDefault(require("chalk"));
+const Errors = __importStar(require("../errors"));
 const config_1 = require("./config");
 const stream_1 = require("./stream");
 function normal(options, retries = 100) {

package/lib/cli-ux/styled/index.js

@@ -1,11 +1,36 @@
 "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.tree = exports.Table = exports.progress = exports.styledObject = void 0;
-const tslib_1 = require("tslib");
 var object_1 = require("./object");
-Object.defineProperty(exports, "styledObject", { enumerable: true, get: function () { return tslib_1.__importDefault(object_1).default; } });
+Object.defineProperty(exports, "styledObject", { enumerable: true, get: function () { return __importDefault(object_1).default; } });
 var progress_1 = require("./progress");
-Object.defineProperty(exports, "progress", { enumerable: true, get: function () { return tslib_1.__importDefault(progress_1).default; } });
-exports.Table = tslib_1.__importStar(require("./table"));
+Object.defineProperty(exports, "progress", { enumerable: true, get: function () { return __importDefault(progress_1).default; } });
+exports.Table = __importStar(require("./table"));
 var tree_1 = require("./tree");
-Object.defineProperty(exports, "tree", { enumerable: true, get: function () { return tslib_1.__importDefault(tree_1).default; } });
+Object.defineProperty(exports, "tree", { enumerable: true, get: function () { return __importDefault(tree_1).default; } });

package/lib/cli-ux/styled/object.js

@@ -1,7 +1,9 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const chalk_1 = __importDefault(require("chalk"));
 const node_util_1 = require("node:util");
 function styledObject(obj, keys) {
     const output = [];

package/lib/cli-ux/styled/table.js

@@ -1,14 +1,39 @@
 "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.table = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const chalk_1 = __importDefault(require("chalk"));
 const js_yaml_1 = require("js-yaml");
 const natural_orderby_1 = require("natural-orderby");
 const node_util_1 = require("node:util");
-const slice_ansi_1 = tslib_1.__importDefault(require("slice-ansi"));
-const string_width_1 = tslib_1.__importDefault(require("string-width"));
-const F = tslib_1.__importStar(require("../../flags"));
+const slice_ansi_1 = __importDefault(require("slice-ansi"));
+const string_width_1 = __importDefault(require("string-width"));
+const F = __importStar(require("../../flags"));
 const screen_1 = require("../../screen");
 const util_1 = require("../../util/util");
 const stream_1 = require("../stream");

package/lib/command.d.ts

@@ -49,6 +49,8 @@ export declare abstract class Command {
     static help: string | undefined;
     /** Hide the command from help */
     static hidden: boolean;
+    /** An array of aliases for this command that are hidden from help. */
+    static hiddenAliases: string[];
     /** A command ID, used mostly in error or verbose reporting. */
     static id: string;
     static plugin: Plugin | undefined;
@@ -155,6 +157,7 @@ export declare namespace Command {
         };
         hasDynamicHelp?: boolean;
         hidden: boolean;
+        hiddenAliases: string[];
         id: string;
         isESM?: boolean;
         permutations?: string[];

package/lib/command.js

@@ -1,16 +1,41 @@
 "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.Command = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const chalk_1 = __importDefault(require("chalk"));
 const node_url_1 = require("node:url");
 const node_util_1 = require("node:util");
 const cli_ux_1 = require("./cli-ux");
 const stream_1 = require("./cli-ux/stream");
 const config_1 = require("./config");
-const Errors = tslib_1.__importStar(require("./errors"));
+const Errors = __importStar(require("./errors"));
 const util_1 = require("./help/util");
-const Parser = tslib_1.__importStar(require("./parser"));
+const Parser = __importStar(require("./parser"));
 const aggregate_flags_1 = require("./util/aggregate-flags");
 const fs_1 = require("./util/fs");
 const util_2 = require("./util/util");
@@ -69,6 +94,8 @@ class Command {
     static help;
     /** Hide the command from help */
     static hidden;
+    /** An array of aliases for this command that are hidden from help. */
+    static hiddenAliases = [];
     /** A command ID, used mostly in error or verbose reporting. */
     static id;
     static plugin;

package/lib/config/config.js

@@ -1,9 +1,34 @@
 "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.Config = void 0;
-const tslib_1 = require("tslib");
-const ejs = tslib_1.__importStar(require("ejs"));
-const is_wsl_1 = tslib_1.__importDefault(require("is-wsl"));
+const ejs = __importStar(require("ejs"));
+const is_wsl_1 = __importDefault(require("is-wsl"));
 const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
 const node_url_1 = require("node:url");
@@ -17,7 +42,7 @@ const settings_1 = require("../settings");
 const fs_1 = require("../util/fs");
 const os_1 = require("../util/os");
 const util_2 = require("../util/util");
-const plugin_loader_1 = tslib_1.__importDefault(require("./plugin-loader"));
+const plugin_loader_1 = __importDefault(require("./plugin-loader"));
 const util_3 = require("./util");
 // eslint-disable-next-line new-cap
 const debug = (0, util_3.Debug)();
@@ -679,14 +704,13 @@ class Config {
             for (const permutation of permutations) {
                 this.commandPermutations.add(permutation, command.id);
             }
-            // set command aliases
-            for (const alias of command.aliases ?? []) {
+            const handleAlias = (alias, hidden = false) => {
                 if (this._commands.has(alias)) {
                     const prioritizedCommand = this.determinePriority([this._commands.get(alias), command]);
                     this._commands.set(alias, { ...prioritizedCommand, id: alias });
                 }
                 else {
-                    this._commands.set(alias, { ...command, id: alias });
+                    this._commands.set(alias, { ...command, hidden, id: alias });
                 }
                 // set every permutation of the aliases
                 // v3 moved command alias permutations to the manifest, but some plugins may not have
@@ -698,6 +722,14 @@ class Config {
                 for (const permutation of aliasPermutations) {
                     this.commandPermutations.add(permutation, command.id);
                 }
+            };
+            // set command aliases
+            for (const alias of command.aliases ?? []) {
+                handleAlias(alias);
+            }
+            // set hidden command aliases
+            for (const alias of command.hiddenAliases ?? []) {
+                handleAlias(alias, true);
             }
         }
         marker?.addDetails({ commandCount: plugin.commands.length });

package/lib/config/plugin-loader.js

@@ -1,11 +1,33 @@
 "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 tslib_1 = require("tslib");
 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 = tslib_1.__importStar(require("./plugin"));
+const Plugin = __importStar(require("./plugin"));
 const util_2 = require("./util");
 // eslint-disable-next-line new-cap
 const debug = (0, util_2.Debug)();

package/lib/errors/errors/cli.js

@@ -1,11 +1,13 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLIError = exports.addOclifExitCode = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
-const clean_stack_1 = tslib_1.__importDefault(require("clean-stack"));
-const indent_string_1 = tslib_1.__importDefault(require("indent-string"));
-const wrap_ansi_1 = tslib_1.__importDefault(require("wrap-ansi"));
+const chalk_1 = __importDefault(require("chalk"));
+const clean_stack_1 = __importDefault(require("clean-stack"));
+const indent_string_1 = __importDefault(require("indent-string"));
+const wrap_ansi_1 = __importDefault(require("wrap-ansi"));
 const screen_1 = require("../../screen");
 const config_1 = require("../config");
 /**

package/lib/errors/errors/pretty-print.js

@@ -1,9 +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.applyPrettyPrintOptions = void 0;
-const tslib_1 = require("tslib");
-const indent_string_1 = tslib_1.__importDefault(require("indent-string"));
-const wrap_ansi_1 = tslib_1.__importDefault(require("wrap-ansi"));
+const indent_string_1 = __importDefault(require("indent-string"));
+const wrap_ansi_1 = __importDefault(require("wrap-ansi"));
 const screen_1 = require("../../screen");
 const config_1 = require("../config");
 function applyPrettyPrintOptions(error, options) {

package/lib/errors/handle.js

@@ -1,13 +1,15 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handle = exports.Exit = void 0;
-const tslib_1 = require("tslib");
 /* eslint-disable no-process-exit */
-const clean_stack_1 = tslib_1.__importDefault(require("clean-stack"));
+const clean_stack_1 = __importDefault(require("clean-stack"));
 const config_1 = require("./config");
 const cli_1 = require("./errors/cli");
 const exit_1 = require("./errors/exit");
-const pretty_print_1 = tslib_1.__importDefault(require("./errors/pretty-print"));
+const pretty_print_1 = __importDefault(require("./errors/pretty-print"));
 /**
  * This is an odd abstraction for process.exit, but it allows us to stub it in tests.
  *

package/lib/errors/index.js

@@ -1,11 +1,33 @@
 "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 });
 exports.Logger = exports.memoizedWarn = exports.warn = exports.error = exports.exit = exports.handle = exports.ModuleLoadError = exports.ExitError = exports.CLIError = exports.config = void 0;
-const tslib_1 = require("tslib");
 const config_1 = require("./config");
 const cli_1 = require("./errors/cli");
 const exit_1 = require("./errors/exit");
-const pretty_print_1 = tslib_1.__importStar(require("./errors/pretty-print"));
+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");

package/lib/flags.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.option = exports.help = exports.version = exports.string = exports.url = exports.file = exports.directory = exports.integer = exports.boolean = exports.custom = void 0;
-/* eslint-disable valid-jsdoc */
 const node_url_1 = require("node:url");
 const errors_1 = require("./errors");
 const help_1 = require("./help");
@@ -98,7 +97,7 @@ const help = (opts = {}) => boolean({
     ...opts,
     async parse(_, 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);
+        await new Help(cmd.config, cmd.config.pjson.oclif.helpOptions ?? cmd.config.pjson.helpOptions).showHelp(cmd.id ? [cmd.id, ...cmd.argv] : cmd.argv);
         cmd.exit(0);
     },
 });

package/lib/help/command.js

@@ -1,9 +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.CommandHelp = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
-const strip_ansi_1 = tslib_1.__importDefault(require("strip-ansi"));
+const chalk_1 = __importDefault(require("chalk"));
+const strip_ansi_1 = __importDefault(require("strip-ansi"));
 const ensure_arg_object_1 = require("../util/ensure-arg-object");
 const util_1 = require("../util/util");
 const docopts_1 = require("./docopts");

package/lib/help/formatter.js

@@ -1,13 +1,15 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HelpFormatter = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
-const indent_string_1 = tslib_1.__importDefault(require("indent-string"));
-const string_width_1 = tslib_1.__importDefault(require("string-width"));
-const strip_ansi_1 = tslib_1.__importDefault(require("strip-ansi"));
-const widest_line_1 = tslib_1.__importDefault(require("widest-line"));
-const wrap_ansi_1 = tslib_1.__importDefault(require("wrap-ansi"));
+const chalk_1 = __importDefault(require("chalk"));
+const indent_string_1 = __importDefault(require("indent-string"));
+const string_width_1 = __importDefault(require("string-width"));
+const strip_ansi_1 = __importDefault(require("strip-ansi"));
+const widest_line_1 = __importDefault(require("widest-line"));
+const wrap_ansi_1 = __importDefault(require("wrap-ansi"));
 const screen_1 = require("../screen");
 const util_1 = require("./util");
 class HelpFormatter {

package/lib/help/index.js

@@ -1,9 +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.loadHelpClass = exports.Help = exports.HelpBase = exports.standardizeIDFromArgv = exports.normalizeArgv = exports.getHelpFlagAdditions = exports.CommandHelp = void 0;
-const tslib_1 = require("tslib");
 const node_util_1 = require("node:util");
-const strip_ansi_1 = tslib_1.__importDefault(require("strip-ansi"));
+const strip_ansi_1 = __importDefault(require("strip-ansi"));
 const stream_1 = require("../cli-ux/stream");
 const errors_1 = require("../errors");
 const module_loader_1 = require("../module-loader");
@@ -11,7 +13,7 @@ const cache_default_value_1 = require("../util/cache-default-value");
 const util_1 = require("../util/util");
 const command_1 = require("./command");
 const formatter_1 = require("./formatter");
-const root_1 = tslib_1.__importDefault(require("./root"));
+const root_1 = __importDefault(require("./root"));
 const util_2 = require("./util");
 var command_2 = require("./command");
 Object.defineProperty(exports, "CommandHelp", { enumerable: true, get: function () { return command_2.CommandHelp; } });
@@ -80,7 +82,9 @@ class Help extends HelpBase {
     formatCommands(commands) {
         if (commands.length === 0)
             return '';
-        const body = this.renderList(commands.map((c) => {
+        const body = this.renderList(commands
+            .filter((c) => (this.opts.hideAliasesFromRoot ? !c.aliases?.includes(c.id) : true))
+            .map((c) => {
             if (this.config.topicSeparator !== ':')
                 c.id = c.id.replaceAll(':', this.config.topicSeparator);
             return [c.id, this.summary(c)];

package/lib/help/root.js

@@ -1,7 +1,9 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const strip_ansi_1 = tslib_1.__importDefault(require("strip-ansi"));
+const strip_ansi_1 = __importDefault(require("strip-ansi"));
 const util_1 = require("../util/util");
 const formatter_1 = require("./formatter");
 class RootHelp extends formatter_1.HelpFormatter {

package/lib/help/util.js

@@ -1,8 +1,30 @@
 "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 });
 exports.normalizeArgv = exports.formatCommandDeprecationWarning = exports.formatFlagDeprecationWarning = exports.getHelpFlagAdditions = exports.standardizeIDFromArgv = exports.toConfiguredId = exports.toStandardizedId = exports.template = void 0;
-const tslib_1 = require("tslib");
-const ejs = tslib_1.__importStar(require("ejs"));
+const ejs = __importStar(require("ejs"));
 const util_1 = require("../config/util");
 function template(context) {
     function render(t) {

package/lib/index.js

@@ -1,7 +1,29 @@
 "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 });
 exports.settings = exports.Performance = exports.Parser = exports.run = exports.Interfaces = exports.toStandardizedId = exports.toConfiguredId = exports.loadHelpClass = exports.HelpBase = exports.Help = exports.CommandHelp = exports.Flags = exports.execute = exports.handle = exports.Errors = exports.Plugin = exports.Config = exports.Command = exports.stdout = exports.stderr = exports.flush = exports.ux = exports.Args = void 0;
-const tslib_1 = require("tslib");
 const stream_1 = require("./cli-ux/stream");
 function checkCWD() {
     try {
@@ -14,8 +36,8 @@ function checkCWD() {
     }
 }
 checkCWD();
-exports.Args = tslib_1.__importStar(require("./args"));
-exports.ux = tslib_1.__importStar(require("./cli-ux"));
+exports.Args = __importStar(require("./args"));
+exports.ux = __importStar(require("./cli-ux"));
 var flush_1 = require("./cli-ux/flush");
 Object.defineProperty(exports, "flush", { enumerable: true, get: function () { return flush_1.flush; } });
 var stream_2 = require("./cli-ux/stream");
@@ -26,12 +48,12 @@ Object.defineProperty(exports, "Command", { enumerable: true, get: function () {
 var config_1 = require("./config");
 Object.defineProperty(exports, "Config", { enumerable: true, get: function () { return config_1.Config; } });
 Object.defineProperty(exports, "Plugin", { enumerable: true, get: function () { return config_1.Plugin; } });
-exports.Errors = tslib_1.__importStar(require("./errors"));
+exports.Errors = __importStar(require("./errors"));
 var handle_1 = require("./errors/handle");
 Object.defineProperty(exports, "handle", { enumerable: true, get: function () { return handle_1.handle; } });
 var execute_1 = require("./execute");
 Object.defineProperty(exports, "execute", { enumerable: true, get: function () { return execute_1.execute; } });
-exports.Flags = tslib_1.__importStar(require("./flags"));
+exports.Flags = __importStar(require("./flags"));
 var help_1 = require("./help");
 Object.defineProperty(exports, "CommandHelp", { enumerable: true, get: function () { return help_1.CommandHelp; } });
 Object.defineProperty(exports, "Help", { enumerable: true, get: function () { return help_1.Help; } });
@@ -40,10 +62,10 @@ Object.defineProperty(exports, "loadHelpClass", { enumerable: true, get: functio
 var util_1 = require("./help/util");
 Object.defineProperty(exports, "toConfiguredId", { enumerable: true, get: function () { return util_1.toConfiguredId; } });
 Object.defineProperty(exports, "toStandardizedId", { enumerable: true, get: function () { return util_1.toStandardizedId; } });
-exports.Interfaces = tslib_1.__importStar(require("./interfaces"));
+exports.Interfaces = __importStar(require("./interfaces"));
 var main_1 = require("./main");
 Object.defineProperty(exports, "run", { enumerable: true, get: function () { return main_1.run; } });
-exports.Parser = tslib_1.__importStar(require("./parser"));
+exports.Parser = __importStar(require("./parser"));
 var performance_1 = require("./performance");
 Object.defineProperty(exports, "Performance", { enumerable: true, get: function () { return performance_1.Performance; } });
 var settings_1 = require("./settings");

package/lib/interfaces/help.d.ts

@@ -4,6 +4,10 @@ export interface HelpOptions {
      * Use docopts as the usage. Defaults to true.
      */
     docopts?: boolean;
+    /**
+     * If true, hide command aliases from the root help output. Defaults to false.
+     */
+    hideAliasesFromRoot?: boolean;
     /**
      * By default, the command summary is show at the top of the help and as the first line in
      * the command description. Repeating the summary in the command description improves readability

package/lib/main.js

@@ -64,7 +64,7 @@ async function run(argv, options) {
     // display help version if applicable
     if ((0, exports.helpAddition)(argv, config)) {
         const Help = await (0, help_1.loadHelpClass)(config);
-        const help = new Help(config, config.pjson.helpOptions);
+        const help = new Help(config, config.pjson.oclif.helpOptions ?? config.pjson.helpOptions);
         await help.showHelp(argv);
         await collectPerf();
         return;

package/lib/parser/errors.js

@@ -1,8 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FailedFlagValidationError = exports.ArgInvalidOptionError = exports.FlagInvalidOptionError = exports.NonExistentFlagsError = exports.UnexpectedArgsError = exports.RequiredFlagError = exports.RequiredArgsError = exports.InvalidArgsSpecError = exports.CLIParseError = exports.CLIError = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const chalk_1 = __importDefault(require("chalk"));
 const list_1 = require("../cli-ux/list");
 const errors_1 = require("../errors");
 const util_1 = require("../util/util");

package/lib/parser/help.js

@@ -1,8 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.flagUsages = exports.flagUsage = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const chalk_1 = __importDefault(require("chalk"));
 const util_1 = require("../util/util");
 function flagUsage(flag, options = {}) {
     const label = [];

package/lib/util/cache-command.js

@@ -75,15 +75,17 @@ async function cacheCommand(uncachedCmd, plugin, respectNoCacheDefault = false)
     const flags = await cacheFlags((0, aggregate_flags_1.aggregateFlags)(uncachedFlags, uncachedBaseFlags, cmd.enableJsonFlag), respectNoCacheDefault);
     const args = await cacheArgs((0, ensure_arg_object_1.ensureArgObject)(cmd.args), respectNoCacheDefault);
     const stdProperties = {
-        aliases: cmd.aliases || [],
+        aliases: cmd.aliases ?? [],
         args,
         deprecateAliases: cmd.deprecateAliases,
         deprecationOptions: cmd.deprecationOptions,
         description: cmd.description,
-        examples: cmd.examples || cmd.example,
+        // Support both `examples` and `example` for backwards compatibility.
+        examples: cmd.examples ?? cmd.example,
         flags,
         hasDynamicHelp: Object.values(flags).some((f) => f.hasDynamicHelp),
         hidden: cmd.hidden,
+        hiddenAliases: cmd.hiddenAliases ?? [],
         id: cmd.id,
         pluginAlias: plugin && plugin.alias,
         pluginName: plugin && plugin.name,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oclif/core",
   "description": "base library for oclif CLIs",
-  "version": "3.0.8",
+  "version": "3.1.0",
   "author": "Salesforce",
   "bugs": "https://github.com/oclif/core/issues",
   "dependencies": {
@@ -75,7 +75,6 @@
     "sinon": "^11.1.2",
     "ts-node": "^10.9.1",
     "tsd": "^0.29.0",
-    "tslib": "^2.5.0",
     "typescript": "^5"
   },
   "engines": {