@oclif/core 5.1.0 → 5.1.1

package/lib/constraints.d.ts

@@ -1,5 +1,5 @@
-import { Constraint, FlagGroup, FlagOutput, MultiFlagTester, SingleFlagTester } from './interfaces/parser';
-import { Validation } from './parser/errors';
+import { type Constraint, type FlagGroup, type FlagOutput, type MultiFlagTester, type SingleFlagTester } from './interfaces/parser';
+import { type Validation } from './parser/errors';
 /**
  * Establish a constraint on a single flag.
  *
@@ -43,7 +43,7 @@ declare class ConstraintImpl implements Constraint {
      */
     readonly is: ConstraintImpl;
     private readonly constrainedFlags;
-    private constraintApplicatorFunctionHolder;
+    private readonly constraintApplicatorFunctionHolder;
     private topLevelCondition;
     private underConstructionCondition;
     constructor(constrainedFlags: string[]);
@@ -61,7 +61,7 @@ declare class ConstraintImpl implements Constraint {
      * @example <caption>--foo requires --bar when fnA returns true AND (fnB returns true OR fnC returns true)</caption>
      * flag('foo').is.dependentOn('bar').when.thisIsTrue(fnA).and.when.thisIsTrue(fnB).or.thisIsTrue(fnC)
      */
-    get and(): ConstraintImpl;
+    get and(): this;
     /**
      * Chain property allowing constraint conditions to be combined with logical OR.
      *
@@ -77,21 +77,21 @@ declare class ConstraintImpl implements Constraint {
      * flag('foo').is.dependentOn('bar').when.thisIsTrue(fnA).and.when.thisIsTrue(fnB).or.thisIsTrue(fnC)
      *
      */
-    get or(): ConstraintImpl;
+    get or(): this;
     /**
      * Chain property allowing constraints to be conditional upon a certain criterion NOT being met.
      *
      * @example
      * flag('foo').is.dependentOn('bar').unless.thisIsTrue(someFn)
      */
-    get unless(): ConstraintImpl;
+    get unless(): this;
     /**
      * Chain property allowing constraints to be conditional upon a certain criterion being met.
      *
      * @example
      * flag('foo').is.dependentOn('bar').when.thisIsTrue(someFn)
      */
-    get when(): ConstraintImpl;
+    get when(): this;
     _evaluateAgainstFlags(flags: FlagOutput): Validation;
     /**
      * Chain method allowing constraint to be made conditional upon EVERY established criterion being true.
@@ -105,7 +105,7 @@ declare class ConstraintImpl implements Constraint {
      * @param criterionTester An object whose keys are flag names and whose values are functions that accept the
      * value of that flag and return a boolean.
      */
-    allFlagCriteriaSatisfied(criterionTester: SingleFlagTester): ConstraintImpl;
+    allFlagCriteriaSatisfied(criterionTester: SingleFlagTester): this;
     /**
      * Chain method allowing constraint to be made conditional upon ANY established criterion being true.
      *
@@ -118,7 +118,7 @@ declare class ConstraintImpl implements Constraint {
      * @param criterionTester An object whose keys are flag names and whose values are functions that accept the
      * value of that flag and return a boolean.
      */
-    anyFlagCriterionSatisfied(criterionTester: SingleFlagTester): ConstraintImpl;
+    anyFlagCriterionSatisfied(criterionTester: SingleFlagTester): this;
     /**
      * Chain method allowing the constrained flags to require the presence of at least one of the flags specified here.
      *
@@ -133,7 +133,7 @@ declare class ConstraintImpl implements Constraint {
      *
      * @param dependencyFlagGroups
      */
-    dependentOn(...dependencyFlagGroups: FlagGroup[]): ConstraintImpl;
+    dependentOn(...dependencyFlagGroups: FlagGroup[]): this;
     /**
      * Chain method allowing the constrained flags to be made exclusive with the flags provided here.
      *
@@ -148,35 +148,35 @@ declare class ConstraintImpl implements Constraint {
      *
      * @param exclusionFlagGroups
      */
-    exclusiveWith(...exclusionFlagGroups: FlagGroup[]): ConstraintImpl;
+    exclusiveWith(...exclusionFlagGroups: FlagGroup[]): this;
     /**
      * Establish a group of flags as mutually dependent, meaning that they must either be used together or not at all.
      *
      * @example <caption>--foo cannot be used without --bar, and vice versa</caption>
      * flags('foo', 'bar').are.mutuallyDependent()
      */
-    mutuallyDependent(): ConstraintImpl;
+    mutuallyDependent(): this;
     /**
      * Establish a group of flags as mutually exclusive, meaning that at most one of them can be used simultaneously.
      *
      * @example <caption>--foo and --bar cannot both be used at the same time</caption>
      * flags('foo', 'bar').are.mutuallyExclusive()
      */
-    mutuallyExclusive(): ConstraintImpl;
+    mutuallyExclusive(): this;
     /**
      * Establish a group of flags as being collectively required.
      *
      * @example <caption>--foo and --bar are both always required</caption>
      * flags('foo', 'bar').are.requiredAll()
      */
-    requiredAll(): ConstraintImpl;
+    requiredAll(): this;
     /**
      * Establish that at least one of the constrained flags must always be used.
      *
      * @example <caption>Must use at least one of --foo, --bar, or --baz</caption>
      * flags('foo', 'bar', 'baz').are.requiredAny()
      */
-    requiredAny(): ConstraintImpl;
+    requiredAny(): this;
     /**
      * Establish that at least N of the specified flags must be used.
      *
@@ -185,7 +185,7 @@ declare class ConstraintImpl implements Constraint {
      *
      * @param n
      */
-    requiredAtLeastN(n: number): ConstraintImpl;
+    requiredAtLeastN(n: number): this;
     /**
      * Establish that at most N of the specified flags must be used.
      *
@@ -194,7 +194,7 @@ declare class ConstraintImpl implements Constraint {
      *
      * @param n
      */
-    requiredAtMostN(n: number): ConstraintImpl;
+    requiredAtMostN(n: number): this;
     /**
      * Establish that exactly N of the specified flags must be used.
      *
@@ -203,7 +203,7 @@ declare class ConstraintImpl implements Constraint {
      *
      * @param n
      */
-    requiredExactlyN(n: number): ConstraintImpl;
+    requiredExactlyN(n: number): this;
     /**
      * Chain method allowing the constraint to be made contingent on the return of a method that accepts all flags.
      *
@@ -212,6 +212,6 @@ declare class ConstraintImpl implements Constraint {
      *
      * @param flagTester A method that accepts the flag values mapped by their name, and returns a boolean
      */
-    thisIsTrue(flagTester: MultiFlagTester): ConstraintImpl;
+    thisIsTrue(flagTester: MultiFlagTester): this;
 }
 export {};

package/lib/constraints.js

@@ -169,9 +169,9 @@ class ConstraintImpl {
         return this;
     }
     _evaluateAgainstFlags(flags) {
-        let conditionSatisfied = false;
+        let isConditionSatisfied = false;
         try {
-            conditionSatisfied = this.topLevelCondition ? this.topLevelCondition.isSatisfied(flags) : true;
+            isConditionSatisfied = this.topLevelCondition ? this.topLevelCondition.isSatisfied(flags) : true;
         }
         catch (error) {
             return {
@@ -186,7 +186,7 @@ class ConstraintImpl {
             return {
                 name: this.constrainedFlags.join(','),
                 reason: applicationResult,
-                status: conditionSatisfied && applicationResult !== '' ? 'failed' : 'success',
+                status: isConditionSatisfied && applicationResult !== '' ? 'failed' : 'success',
                 validationFn: this.constraintApplicatorFunctionHolder.constraintType ?? '',
             };
         }
@@ -217,7 +217,7 @@ class ConstraintImpl {
         if (this.underConstructionCondition === undefined) {
             throw new Error(`Misconfigured constraint condition on ${createFlagString(this.constrainedFlags)}: allFlagCriteriaSatisfied must immediately follow a when/unless/and/or`);
         }
-        else if (this.underConstructionCondition instanceof UnaryOpCondition) {
+        if (this.underConstructionCondition instanceof UnaryOpCondition) {
             this.underConstructionCondition.setCondition(new AllFlagCriteriaSatisfiedCondition(criterionTester));
             this.underConstructionCondition = undefined;
         }
@@ -247,7 +247,7 @@ class ConstraintImpl {
         if (this.underConstructionCondition === undefined) {
             throw new Error(`Misconfigured constraint condition on ${createFlagString(this.constrainedFlags)}: anyFlagCriterionSatisfied must immediately follow a when/unless/and/or`);
         }
-        else if (this.underConstructionCondition instanceof UnaryOpCondition) {
+        if (this.underConstructionCondition instanceof UnaryOpCondition) {
             this.underConstructionCondition.setCondition(new AnyFlagCriterionSatisfiedCondition(criterionTester));
             this.underConstructionCondition = undefined;
         }
@@ -293,8 +293,8 @@ class ConstraintImpl {
                     }
                 }
             }
-            const multipleConstrainedFlags = this.constrainedFlags.length > 1;
-            const header = multipleConstrainedFlags
+            const isMultipleConstrainedFlags = this.constrainedFlags.length > 1;
+            const header = isMultipleConstrainedFlags
                 ? `Flags ${createFlagString(this.constrainedFlags)} require`
                 : `Flag ${createFlagString(this.constrainedFlags)} requires`;
             return `${header} at least one of the following${this.topLevelCondition ? ' under current circumstances:' : ':'} ${createFlagString(dependencyFlagGroups)}.`;
@@ -321,27 +321,27 @@ class ConstraintImpl {
             if (foundConstraintFlags.length === 0) {
                 return '';
             }
-            let exclusionGroupFound = false;
+            let isExclusionGroupFound = false;
             for (const exclusionFlagGroup of exclusionFlagGroups) {
                 if (typeof exclusionFlagGroup === 'string') {
                     if (exclusionFlagGroup in flags && flags[exclusionFlagGroup] !== undefined) {
-                        exclusionGroupFound = true;
+                        isExclusionGroupFound = true;
                         break;
                     }
                 }
                 else {
                     const foundFlagsInExclusionGroup = filterFlagsPresentInInput(exclusionFlagGroup.flags, flags);
                     if (foundFlagsInExclusionGroup.length === exclusionFlagGroup.flags.length) {
-                        exclusionGroupFound = true;
+                        isExclusionGroupFound = true;
                         break;
                     }
                 }
             }
-            if (!exclusionGroupFound) {
+            if (!isExclusionGroupFound) {
                 return '';
             }
-            const multipleConstrainedFlags = this.constrainedFlags.length > 1;
-            const header = multipleConstrainedFlags ? 'Flags' : 'Flag';
+            const isMultipleConstrainedFlags = this.constrainedFlags.length > 1;
+            const header = isMultipleConstrainedFlags ? 'Flags' : 'Flag';
             return `${header} ${createFlagString(this.constrainedFlags)} cannot be used with any of the following${this.topLevelCondition ? ' under current circumstances:' : ':'} ${createFlagString(exclusionFlagGroups)}.`;
         });
         return this;
@@ -461,7 +461,7 @@ class ConstraintImpl {
         if (this.underConstructionCondition === undefined) {
             throw new Error(`Misconfigured constraint condition on ${createFlagString(this.constrainedFlags)}: thisIsTrue must immediately follow a when/unless/and/or`);
         }
-        else if (this.underConstructionCondition instanceof UnaryOpCondition) {
+        if (this.underConstructionCondition instanceof UnaryOpCondition) {
             this.underConstructionCondition.setCondition(new ThisIsTrueCondition(flagTester));
             this.underConstructionCondition = undefined;
         }

package/lib/errors/error.d.ts

@@ -1,4 +1,4 @@
-import { PrettyPrintableError } from '../interfaces';
+import { type PrettyPrintableError } from '../interfaces';
 export declare function error(input: Error | string, options: {
     exit: false;
 } & PrettyPrintableError): void;

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

@@ -1,4 +1,4 @@
-import { OclifError, PrettyPrintableError } from '../../interfaces/errors';
+import { type OclifError, type PrettyPrintableError } from '../../interfaces/errors';
 /**
  * properties specific to internal oclif error handling
  */

package/lib/errors/errors/exit.d.ts

@@ -1,4 +1,4 @@
-import { OclifError } from '../../interfaces';
+import { type OclifError } from '../../interfaces';
 import { CLIError } from './cli';
 export declare class ExitError extends CLIError implements OclifError {
     code: string;

package/lib/errors/errors/module-load.d.ts

@@ -1,4 +1,4 @@
-import { OclifError } from '../../interfaces';
+import { type OclifError } from '../../interfaces';
 import { CLIError } from './cli';
 export declare class ModuleLoadError extends CLIError implements OclifError {
     code: string;

package/lib/errors/errors/pretty-print.d.ts

@@ -1,4 +1,4 @@
-import { PrettyPrintableError } from '../../interfaces/errors';
+import { type PrettyPrintableError } from '../../interfaces/errors';
 type CLIErrorDisplayOptions = {
     bang?: string | undefined;
     name?: string | undefined;

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

@@ -21,9 +21,9 @@ function applyPrettyPrintOptions(error, options) {
     return error;
 }
 const formatSuggestions = (suggestions) => {
-    const label = 'Try this:';
     if (!suggestions || suggestions.length === 0)
         return undefined;
+    const label = 'Try this:';
     if (suggestions.length === 1)
         return `${label} ${suggestions[0]}`;
     const multiple = suggestions.map((suggestion) => `* ${suggestion}`).join('\n');

package/lib/errors/handle.d.ts

@@ -1,5 +1,5 @@
-import { OclifError, PrettyPrintableError } from '../interfaces';
-import { CLIParseError } from '../parser/errors';
+import { type OclifError, type PrettyPrintableError } from '../interfaces';
+import { type CLIParseError } from '../parser/errors';
 import { CLIError } from './errors/cli';
 /**
  * This is an odd abstraction for process.exit, but it allows us to stub it in tests.

package/lib/errors/index.d.ts

@@ -1,4 +1,4 @@
-export { PrettyPrintableError } from '../interfaces';
+export type { PrettyPrintableError } from '../interfaces';
 export { error } from './error';
 export { CLIError } from './errors/cli';
 export { ExitError } from './errors/exit';

package/lib/execute.d.ts

@@ -1,4 +1,4 @@
-import { LoadOptions } from './interfaces';
+import { type LoadOptions } from './interfaces';
 /**
  * Load and run oclif CLI
  *

package/lib/flags.d.ts

@@ -1,6 +1,6 @@
 import { URL } from 'node:url';
-import { BooleanFlag, CustomOptions, FlagDefinition, OptionFlag } from './interfaces';
-type NotArray<T> = T extends Array<any> ? never : T;
+import { type BooleanFlag, type CustomOptions, type FlagDefinition, type OptionFlag } from './interfaces';
+type NotArray<T> = T extends any[] ? never : T;
 /**
  * Create a custom flag.
  *
@@ -123,7 +123,7 @@ export declare const version: (opts?: Partial<BooleanFlag<boolean>>) => BooleanF
  * A help flag that will print the CLI help and exit.
  */
 export declare const help: (opts?: Partial<BooleanFlag<boolean>>) => BooleanFlag<void>;
-type ReadonlyElementOf<T extends ReadonlyArray<unknown>> = T[number];
+type ReadonlyElementOf<T extends readonly unknown[]> = T[number];
 /**
  * Create a custom flag that infers the flag type from the provided options.
  *
@@ -138,11 +138,11 @@ type ReadonlyElementOf<T extends ReadonlyArray<unknown>> = T[number];
  *   }
  * }
  */
-export declare function option<T extends readonly string[], P extends CustomOptions>(defaults: Partial<OptionFlag<ReadonlyElementOf<T>[], P>> & {
+export declare function option<T extends readonly string[], P extends CustomOptions>(defaults: Partial<OptionFlag<Array<ReadonlyElementOf<T>>, P>> & {
     multiple: true;
     options: T;
 } & ({
-    default: OptionFlag<ReadonlyElementOf<T>[], P>['default'] | undefined;
+    default: OptionFlag<Array<ReadonlyElementOf<T>>, P>['default'] | undefined;
 } | {
     required: true;
 })): FlagDefinition<(typeof defaults.options)[number], P, {
@@ -169,8 +169,8 @@ export declare function option<T extends readonly string[], P extends CustomOpti
     multiple: false;
     requiredOrDefaulted: false;
 }>;
-export declare function option<T extends readonly string[], P extends CustomOptions>(defaults: Partial<OptionFlag<ReadonlyElementOf<T>[], P>> & {
-    default?: OptionFlag<ReadonlyElementOf<T>[], P>['default'] | undefined;
+export declare function option<T extends readonly string[], P extends CustomOptions>(defaults: Partial<OptionFlag<Array<ReadonlyElementOf<T>>, P>> & {
+    default?: OptionFlag<Array<ReadonlyElementOf<T>>, P>['default'] | undefined;
     multiple: true;
     options: T;
     required?: false | undefined;

package/lib/flush.js

@@ -2,10 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.flush = flush;
 const error_1 = require("./errors/error");
-function timeout(p, ms) {
-    function wait(ms, unref = false) {
+async function timeout(p, ms) {
+    async function wait(ms, unref = false) {
         return new Promise((resolve) => {
-            const t = setTimeout(() => resolve(null), ms);
+            const t = setTimeout(() => {
+                resolve(null);
+            }, ms);
             if (unref)
                 t.unref();
         });
@@ -14,10 +16,12 @@ function timeout(p, ms) {
 }
 async function _flush() {
     const p = new Promise((resolve) => {
-        process.stdout.once('drain', () => resolve(null));
+        process.stdout.once('drain', () => {
+            resolve(null);
+        });
     });
-    const flushed = process.stdout.write('');
-    if (flushed)
+    const isFlushed = process.stdout.write('');
+    if (isFlushed)
         return;
     return p;
 }

package/lib/help/command.d.ts

@@ -1,6 +1,6 @@
-import { Command } from '../command';
-import * as Interfaces from '../interfaces';
-import { HelpFormatter, HelpSectionRenderer } from './formatter';
+import type * as Interfaces from '../interfaces';
+import { type Command } from '../command';
+import { HelpFormatter, type HelpSectionRenderer } from './formatter';
 export declare class CommandHelp extends HelpFormatter {
     command: Command.Loadable;
     config: Interfaces.Config;
@@ -8,19 +8,17 @@ export declare class CommandHelp extends HelpFormatter {
     constructor(command: Command.Loadable, config: Interfaces.Config, opts: Interfaces.HelpOptions);
     protected aliases(aliases: string[] | undefined): string | undefined;
     protected arg(arg: Command.Arg.Any): string;
-    protected args(args: Command.Arg.Any[]): [string, string | undefined][] | undefined;
+    protected args(args: Command.Arg.Any[]): Array<[string, string | undefined]> | undefined;
     protected defaultUsage(): string;
     protected description(): string | undefined;
     protected examples(examples: Command.Example[] | string | undefined): string | undefined;
     protected flagHelpLabel(flag: Command.Flag.Any, showOptions?: boolean): string;
-    protected flags(flags: Array<Command.Flag.Any>): [string, string | undefined][] | undefined;
-    protected flagsDescriptions(flags: Array<Command.Flag.Any>): string | undefined;
+    protected flags(flags: Command.Flag.Any[]): Array<[string, string | undefined]> | undefined;
+    protected flagsDescriptions(flags: Command.Flag.Any[]): string | undefined;
     generate(): string;
-    protected groupFlags(flags: Array<Command.Flag.Any>): {
-        flagGroups: {
-            [name: string]: Array<Command.Flag.Any>;
-        };
-        mainFlags: Array<Command.Flag.Any>;
+    protected groupFlags(flags: Command.Flag.Any[]): {
+        flagGroups: Record<string, Command.Flag.Any[]>;
+        mainFlags: Command.Flag.Any[];
     };
     protected sections(): Array<{
         generate: HelpSectionRenderer;

package/lib/help/command.js

@@ -50,7 +50,7 @@ class CommandHelp extends formatter_1.HelpFormatter {
     arg(arg) {
         const name = arg.name.toUpperCase();
         if (arg.required)
-            return `${name}`;
+            return name;
         return `[${name}]`;
     }
     args(args) {
@@ -58,9 +58,9 @@ class CommandHelp extends formatter_1.HelpFormatter {
             return;
         return args.map((a) => {
             // Add ellipsis for variadic args, or for all args when strict is false (backward compat)
-            const suffix = a.multiple ? '...' : this.command.strict === false ? '...' : '';
+            const suffix = a.multiple || this.command.strict === false ? '...' : '';
             let name = `${a.name.toUpperCase()}${suffix}`;
-            name = a.required ? `${name}` : `[${name}]`;
+            name = a.required ? name : `[${name}]`;
             let description = a.description || '';
             if (a.default)
                 description = `${(0, theme_1.colorize)(this.config?.theme?.flagDefaultValue, `[default: ${a.default}]`)} ${description}`;
@@ -142,8 +142,7 @@ class CommandHelp extends formatter_1.HelpFormatter {
     flagHelpLabel(flag, showOptions = false) {
         let label = flag.helpLabel;
         if (!label) {
-            const labels = [];
-            labels.push(flag.char ? `-${flag.char[0]}` : '  ');
+            const labels = [flag.char ? `-${flag.char[0]}` : '  '];
             if (flag.name) {
                 if (flag.type === 'boolean' && flag.allowNo) {
                     labels.push(`--[no-]${flag.name.trim()}`);
@@ -165,12 +164,12 @@ class CommandHelp extends formatter_1.HelpFormatter {
     flags(flags) {
         if (flags.length === 0)
             return;
-        const noChar = flags.reduce((previous, current) => previous && current.char === undefined, true);
+        const isNoChar = flags.reduce((previous, current) => previous && current.char === undefined, true);
         // eslint-disable-next-line complexity
         return flags.map((flag) => {
             let left = this.flagHelpLabel(flag);
-            if (noChar)
-                left = left.replace('    ', '');
+            if (isNoChar)
+                left = left.replace(' '.repeat(4), '');
             let right = flag.summary || flag.description || '';
             // Build metadata string (default, env, or both)
             const metadata = [];
@@ -207,7 +206,7 @@ class CommandHelp extends formatter_1.HelpFormatter {
             const summary = flag.summary || '';
             let flagHelp = this.flagHelpLabel(flag, true);
             if (!flag.char)
-                flagHelp = flagHelp.replace('    ', '');
+                flagHelp = flagHelp.replace(' '.repeat(4), '');
             flagHelp +=
                 flagHelp.length + summary.length + 2 < this.opts.maxWidth
                     ? '  ' + summary
@@ -234,7 +233,7 @@ class CommandHelp extends formatter_1.HelpFormatter {
             // Generate can return a list of sections
             if (Array.isArray(body)) {
                 return body
-                    .map((helpSection) => helpSection && helpSection.body && this.section(helpSection.header, helpSection.body))
+                    .map((helpSection) => helpSection?.body && this.section(helpSection.header, helpSection.body))
                     .join('\n\n');
             }
             return body && this.section(header, body);

package/lib/help/docopts.d.ts

@@ -1,6 +1,6 @@
-import { Command } from '../command';
+import { type Command } from '../command';
 /**
- * DocOpts - See http://docopt.org/.
+ * DocOpts - See https://docopt.org/.
  *
  * flag.exclusive: groups elements when one of the mutually exclusive cases is a required flag: (--apple | --orange)
  * flag.exclusive: groups elements when none of the mutually exclusive cases is required (optional flags): [--apple | --orange]
@@ -56,8 +56,8 @@ import { Command } from '../command';
  *
  */
 export declare class DocOpts {
-    private cmd;
-    private flagList;
+    private readonly cmd;
+    private readonly flagList;
     private flagMap;
     constructor(cmd: Command.Loadable);
     static formatUsageType(flag: Command.Flag.Any, showFlagName: boolean, showOptions: boolean): string;

package/lib/help/docopts.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocOpts = void 0;
 const ensure_arg_object_1 = require("../util/ensure-arg-object");
 /**
- * DocOpts - See http://docopt.org/.
+ * DocOpts - See https://docopt.org/.
  *
  * flag.exclusive: groups elements when one of the mutually exclusive cases is a required flag: (--apple | --orange)
  * flag.exclusive: groups elements when none of the mutually exclusive cases is required (optional flags): [--apple | --orange]
@@ -103,7 +103,7 @@ class DocOpts {
             const a = Object.values((0, ensure_arg_object_1.ensureArgObject)(this.cmd.args))
                 .filter((arg) => !arg.hidden)
                 .map((arg) => {
-                const suffix = arg.multiple ? '...' : this.cmd.strict === false ? '...' : '';
+                const suffix = arg.multiple || this.cmd.strict === false ? '...' : '';
                 return arg.required ? `${arg.name.toUpperCase()}${suffix}` : `[${arg.name.toUpperCase()}${suffix}]`;
             }) || [];
             opts.push(...a);

package/lib/help/formatter.d.ts

@@ -1,11 +1,11 @@
-import { Command } from '../command';
-import * as Interfaces from '../interfaces';
-export type HelpSectionKeyValueTable = {
+import type * as Interfaces from '../interfaces';
+import { type Command } from '../command';
+export type HelpSectionKeyValueTable = Array<{
     description: string;
     name: string;
-}[];
+}>;
 export type HelpSection = {
-    body: [string, string | undefined][] | HelpSectionKeyValueTable | string | undefined;
+    body: Array<[string, string | undefined]> | HelpSectionKeyValueTable | string | undefined;
     header: string;
 } | undefined;
 export type HelpSectionRenderer = (data: {
@@ -57,13 +57,13 @@ export declare class HelpFormatter {
      * @returns the formatted indented text
      */
     indent(body: string, spacing?: number): string;
-    renderList(input: (string | undefined)[][], opts: {
+    renderList(input: Array<Array<string | undefined>>, opts: {
         indentation: number;
         multiline?: boolean | undefined;
         spacer?: string | undefined;
         stripAnsi?: boolean | undefined;
     }): string;
-    section(header: string, body: [string, string | undefined][] | HelpSection | HelpSectionKeyValueTable | string): string;
+    section(header: string, body: Array<[string, string | undefined]> | HelpSection | HelpSectionKeyValueTable | string): string;
     /**
      * Wrap text according to `opts.maxWidth` which is typically set to the terminal width. All text
      * will be rendered before bring wrapped, otherwise it could mess up the lengths.

package/lib/help/index.d.ts

@@ -1,5 +1,5 @@
-import { Command } from '../command';
-import * as Interfaces from '../interfaces';
+import type * as Interfaces from '../interfaces';
+import { type Command } from '../command';
 import { CommandHelp } from './command';
 import { HelpFormatter } from './formatter';
 export { CommandHelp } from './command';
@@ -28,7 +28,7 @@ export declare class Help extends HelpBase {
     protected command(command: Command.Loadable): string;
     protected description(c: Command.Loadable): string;
     protected formatCommand(command: Command.Loadable): string;
-    protected formatCommands(commands: Array<Command.Loadable>): string;
+    protected formatCommands(commands: Command.Loadable[]): string;
     formatRoot(): string;
     protected formatTopic(topic: Interfaces.Topic): string;
     protected formatTopics(topics: Interfaces.Topic[]): string;
@@ -40,7 +40,5 @@ export declare class Help extends HelpBase {
     protected showTopicHelp(topic: Interfaces.Topic): Promise<void>;
     protected summary(c: Command.Loadable): string | undefined;
 }
-interface HelpBaseDerived {
-    new (config: Interfaces.Config, opts?: Partial<Interfaces.HelpOptions>): HelpBase;
-}
+type HelpBaseDerived = new (config: Interfaces.Config, opts?: Partial<Interfaces.HelpOptions>) => HelpBase;
 export declare function loadHelpClass(config: Interfaces.Config): Promise<HelpBaseDerived>;

package/lib/help/index.js

@@ -125,7 +125,7 @@ class Help extends HelpBase {
     }
     formatTopic(topic) {
         let description = this.render(topic.description || '');
-        const summary = description.split('\n')[0];
+        const summary = description.split('\n', 1)[0];
         description = description.split('\n').slice(1).join('\n');
         let topicID = `${topic.name}:COMMAND`;
         if (this.config.topicSeparator !== ':')
@@ -148,7 +148,8 @@ class Help extends HelpBase {
                 c.name = c.name.replaceAll(':', this.config.topicSeparator);
             return [
                 (0, theme_1.colorize)(this.config?.theme?.topic, c.name),
-                c.description && this.render((0, theme_1.colorize)(this.config?.theme?.sectionDescription, c.description.split('\n')[0])),
+                c.description &&
+                    this.render((0, theme_1.colorize)(this.config?.theme?.sectionDescription, c.description.split('\n', 1)[0])),
             ];
         }), {
             indentation: 2,
@@ -161,7 +162,7 @@ class Help extends HelpBase {
         return new this.CommandHelpClass(command, this.config, this.opts);
     }
     log(...args) {
-        return this.opts.sendToStderr ? ux_1.ux.stderr(args) : ux_1.ux.stdout(args);
+        this.opts.sendToStderr ? ux_1.ux.stderr(args) : ux_1.ux.stdout(args);
     }
     async showCommandHelp(command) {
         const name = command.id;
@@ -178,7 +179,7 @@ class Help extends HelpBase {
         if (command.deprecateAliases && [...(command.aliases ?? []), ...(command.hiddenAliases ?? [])].includes(name)) {
             const actualCmd = this.config.commands.find((c) => [...(c.aliases ?? []), ...(c.hiddenAliases ?? [])].includes(name));
             const actualCmdName = actualCmd ? (0, ids_1.toConfiguredId)(actualCmd.id, this.config) : '';
-            const opts = { ...command.deprecationOptions, ...(actualCmd ? { to: actualCmdName } : {}) };
+            const opts = { ...command.deprecationOptions, ...(actualCmd && { to: actualCmdName }) };
             this.log(`${(0, util_2.formatCommandDeprecationWarning)((0, ids_1.toConfiguredId)(name, this.config), opts)}\n`);
         }
         const summary = this.summary(command);
@@ -314,13 +315,13 @@ class Help extends HelpBase {
         if (this.opts.sections && !this.opts.sections.map((s) => s.toLowerCase()).includes('summary'))
             return;
         if (c.summary)
-            return (0, theme_1.colorize)(this.config?.theme?.commandSummary, this.render(c.summary.split('\n')[0]));
-        return c.description && (0, theme_1.colorize)(this.config?.theme?.commandSummary, this.render(c.description).split('\n')[0]);
+            return (0, theme_1.colorize)(this.config?.theme?.commandSummary, this.render(c.summary.split('\n', 1)[0]));
+        return c.description && (0, theme_1.colorize)(this.config?.theme?.commandSummary, this.render(c.description).split('\n', 1)[0]);
     }
 }
 exports.Help = Help;
 function extractClass(exported) {
-    return exported && exported.default ? exported.default : exported;
+    return exported?.default ? exported.default : exported;
 }
 function determineLocation(helpClass) {
     if (typeof helpClass === 'string')