@oclif/core 3.26.4 → 4.0.0-beta.2

package/lib/command.js

@@ -27,11 +27,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Command = void 0;
-const chalk_1 = __importDefault(require("chalk"));
+const ansis_1 = __importDefault(require("ansis"));
 const node_url_1 = require("node:url");
 const node_util_1 = require("node:util");
 const cache_1 = __importDefault(require("./cache"));
-const cli_ux_1 = require("./cli-ux");
 const config_1 = require("./config");
 const Errors = __importStar(require("./errors"));
 const util_1 = require("./help/util");
@@ -39,6 +38,7 @@ const Parser = __importStar(require("./parser"));
 const aggregate_flags_1 = require("./util/aggregate-flags");
 const ids_1 = require("./util/ids");
 const util_2 = require("./util/util");
+const ux_1 = __importDefault(require("./ux"));
 const pjson = cache_1.default.getInstance().get('@oclif/core');
 /**
  * swallows stdout epipe errors
@@ -167,7 +167,7 @@ class Command {
             if (!err.message)
                 throw err;
             try {
-                cli_ux_1.ux.action.stop(chalk_1.default.bold.red('!'));
+                ux_1.default.action.stop(ansis_1.default.bold.red('!'));
             }
             catch { }
             throw err;
@@ -223,16 +223,16 @@ class Command {
     log(message = '', ...args) {
         if (!this.jsonEnabled()) {
             message = typeof message === 'string' ? message : (0, node_util_1.inspect)(message);
-            cli_ux_1.ux.info(message, ...args);
+            ux_1.default.stdout(message, ...args);
         }
     }
     logJson(json) {
-        cli_ux_1.ux.styledJSON(json);
+        ux_1.default.stdout(ux_1.default.colorizeJson(json, { pretty: true, theme: this.config.theme?.json }));
     }
     logToStderr(message = '', ...args) {
         if (!this.jsonEnabled()) {
             message = typeof message === 'string' ? message : (0, node_util_1.inspect)(message);
-            cli_ux_1.ux.logToStderr(message, ...args);
+            ux_1.default.stderr(message, ...args);
         }
     }
     async parse(options, argv = this.argv) {

package/lib/config/config.d.ts

@@ -29,6 +29,7 @@ export declare class Config implements IConfig {
     shell: string;
     theme?: Theme;
     topicSeparator: ' ' | ':';
+    updateConfig: NonNullable<PJSON.CLI['oclif']['update']>;
     userAgent: string;
     userPJSON?: PJSON.User;
     valid: boolean;
@@ -93,10 +94,7 @@ export declare class Config implements IConfig {
     loadPluginsAndCommands(opts?: {
         force: boolean;
     }): Promise<void>;
-    loadThemes(): Promise<{
-        file: string | undefined;
-        theme: Theme | undefined;
-    }>;
+    loadTheme(): Promise<Theme | undefined>;
     protected macosCacheDir(): string | undefined;
     runCommand<T = unknown>(id: string, argv?: string[], cachedCommand?: Command.Loadable | null): Promise<T>;
     runHook<T extends keyof Hooks>(event: T, opts: Hooks[T]['options'], timeout?: number, captureErrors?: boolean): Promise<Hook.Result<Hooks[T]['return']>>;
@@ -125,6 +123,7 @@ export declare class Config implements IConfig {
     protected windowsUserprofileHome(): string | undefined;
     protected _debug(): number;
     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

package/lib/config/config.js

@@ -33,8 +33,6 @@ const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
 const node_url_1 = require("node:url");
 const cache_1 = __importDefault(require("../cache"));
-const cli_ux_1 = require("../cli-ux");
-const theme_1 = require("../cli-ux/theme");
 const errors_1 = require("../errors");
 const util_1 = require("../help/util");
 const module_loader_1 = require("../module-loader");
@@ -43,6 +41,8 @@ const settings_1 = require("../settings");
 const fs_1 = require("../util/fs");
 const os_1 = require("../util/os");
 const util_2 = require("../util/util");
+const ux_1 = __importDefault(require("../ux"));
+const theme_1 = require("../ux/theme");
 const plugin_loader_1 = __importDefault(require("./plugin-loader"));
 const ts_path_1 = require("./ts-path");
 const util_3 = require("./util");
@@ -110,6 +110,7 @@ class Config {
     shell;
     theme;
     topicSeparator = ':';
+    updateConfig;
     userAgent;
     userPJSON;
     valid;
@@ -302,33 +303,11 @@ class Config {
         this.errlog = (0, node_path_1.join)(this.cacheDir, 'error.log');
         this.binPath = this.scopedEnvVar('BINPATH');
         this.npmRegistry = this.scopedEnvVar('NPM_REGISTRY') || this.pjson.oclif.npmRegistry;
-        if (!this.scopedEnvVarTrue('DISABLE_THEME')) {
-            const { theme } = await this.loadThemes();
-            this.theme = theme;
-        }
-        this.pjson.oclif.update = this.pjson.oclif.update || {};
-        this.pjson.oclif.update.node = this.pjson.oclif.update.node || {};
-        const s3 = this.pjson.oclif.update.s3 || {};
-        this.pjson.oclif.update.s3 = s3;
-        s3.bucket = this.scopedEnvVar('S3_BUCKET') || s3.bucket;
-        if (s3.bucket && !s3.host)
-            s3.host = `https://${s3.bucket}.s3.amazonaws.com`;
-        s3.templates = {
-            ...s3.templates,
-            target: {
-                baseDir: '<%- bin %>',
-                manifest: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %><%- platform %>-<%- arch %>",
-                unversioned: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %><%- bin %>-<%- platform %>-<%- arch %><%- ext %>",
-                versioned: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %><%- bin %>-v<%- version %>/<%- bin %>-v<%- version %>-<%- platform %>-<%- arch %><%- ext %>",
-                ...(s3.templates && s3.templates.target),
-            },
-            vanilla: {
-                baseDir: '<%- bin %>',
-                manifest: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %>version",
-                unversioned: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %><%- bin %><%- ext %>",
-                versioned: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %><%- bin %>-v<%- version %>/<%- bin %>-v<%- version %><%- ext %>",
-                ...(s3.templates && s3.templates.vanilla),
-            },
+        this.theme = await this.loadTheme();
+        this.updateConfig = {
+            ...this.pjson.oclif.update,
+            node: this.pjson.oclif.update?.node ?? {},
+            s3: this.buildS3Config(),
         };
         this.isSingleCommandCLI = Boolean(this.pjson.oclif.default ||
             (typeof this.pjson.oclif.commands !== 'string' &&
@@ -366,7 +345,9 @@ class Config {
             this.warn(error);
         }
     }
-    async loadThemes() {
+    async loadTheme() {
+        if (this.scopedEnvVarTrue('DISABLE_THEME'))
+            return;
         const defaultThemeFile = this.pjson.oclif.theme
             ? (0, node_path_1.resolve)(this.root, this.pjson.oclif.theme)
             : this.pjson.oclif.theme;
@@ -377,12 +358,7 @@ class Config {
         ]);
         // Merge the default theme with the user theme, giving the user theme precedence.
         const merged = { ...defaultTheme, ...userTheme };
-        return {
-            // Point to the user file if it exists, otherwise use the default file.
-            // This doesn't really serve a purpose to anyone but removing it would be a breaking change.
-            file: userTheme ? userThemeFile : defaultThemeFile,
-            theme: Object.keys(merged).length > 0 ? (0, theme_1.parseTheme)(merged) : undefined,
-        };
+        return Object.keys(merged).length > 0 ? (0, theme_1.parseTheme)(merged) : undefined;
     }
     macosCacheDir() {
         return (this.platform === 'darwin' && (0, node_path_1.join)(this.home, 'Library', 'Caches', this.dirname)) || undefined;
@@ -482,7 +458,7 @@ class Config {
                     (0, errors_1.exit)(code);
                 },
                 log(message, ...args) {
-                    cli_ux_1.ux.info(message, ...args);
+                    ux_1.default.stdout(message, ...args);
                 },
                 warn(message) {
                     (0, errors_1.warn)(message);
@@ -542,11 +518,11 @@ class Config {
             options = ext;
         else if (ext)
             options.ext = ext;
-        const template = this.pjson.oclif.update.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) {
-        const { host } = this.pjson.oclif.update.s3;
+        const { host } = this.updateConfig.s3 ?? { host: undefined };
         if (!host)
             throw new Error('no s3 host is set');
         const url = new node_url_1.URL(host);
@@ -650,6 +626,33 @@ class Config {
         }
         return shellPath.at(-1) ?? 'unknown';
     }
+    buildS3Config() {
+        const s3 = this.pjson.oclif.update?.s3;
+        const bucket = this.scopedEnvVar('S3_BUCKET') ?? s3?.bucket;
+        const host = s3?.host ?? (bucket && `https://${bucket}.s3.amazonaws.com`);
+        const templates = {
+            ...s3?.templates,
+            target: {
+                baseDir: '<%- bin %>',
+                manifest: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %><%- platform %>-<%- arch %>",
+                unversioned: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %><%- bin %>-<%- platform %>-<%- arch %><%- ext %>",
+                versioned: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %><%- bin %>-v<%- version %>/<%- bin %>-v<%- version %>-<%- platform %>-<%- arch %><%- ext %>",
+                ...(s3?.templates && s3?.templates.target),
+            },
+            vanilla: {
+                baseDir: '<%- bin %>',
+                manifest: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %>version",
+                unversioned: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %><%- bin %><%- ext %>",
+                versioned: "<%- channel === 'stable' ? '' : 'channels/' + channel + '/' %><%- bin %>-v<%- version %>/<%- bin %>-v<%- version %><%- ext %>",
+                ...(s3?.templates && s3?.templates.vanilla),
+            },
+        };
+        return {
+            bucket,
+            host,
+            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

package/lib/config/ts-path.js

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

package/lib/errors/error.js

@@ -22,12 +22,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.error = void 0;
-const write_1 = __importDefault(require("../cli-ux/write"));
+const write_1 = require("../ux/write");
 const config_1 = require("./config");
 const cli_1 = require("./errors/cli");
 const pretty_print_1 = __importStar(require("./errors/pretty-print"));
@@ -46,7 +43,7 @@ function error(input, options = {}) {
     if (options.exit === false) {
         const message = (0, pretty_print_1.default)(err);
         if (message)
-            write_1.default.stderr(message + '\n');
+            (0, write_1.stderr)(message);
         if (config_1.config.errorLogger)
             config_1.config.errorLogger.log(err?.stack ?? '');
     }

package/lib/errors/errors/cli.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLIError = exports.addOclifExitCode = void 0;
-const chalk_1 = __importDefault(require("chalk"));
+const ansis_1 = __importDefault(require("ansis"));
 const clean_stack_1 = __importDefault(require("clean-stack"));
 const indent_string_1 = __importDefault(require("indent-string"));
 const wrap_ansi_1 = __importDefault(require("wrap-ansi"));
@@ -36,7 +36,7 @@ class CLIError extends Error {
     }
     get bang() {
         try {
-            return chalk_1.default.red(process.platform === 'win32' ? '»' : '›');
+            return ansis_1.default.red(process.platform === 'win32' ? '»' : '›');
         }
         catch { }
     }
@@ -68,7 +68,7 @@ exports.CLIError = CLIError;
         }
         get bang() {
             try {
-                return chalk_1.default.yellow(process.platform === 'win32' ? '»' : '›');
+                return ansis_1.default.yellow(process.platform === 'win32' ? '»' : '›');
             }
             catch { }
         }

package/lib/errors/exit.d.ts

@@ -0,0 +1 @@
+export declare function exit(code?: number): never;

package/lib/errors/exit.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exit = void 0;
+const exit_1 = require("./errors/exit");
+function exit(code = 0) {
+    throw new exit_1.ExitError(code);
+}
+exports.exit = exit;

package/lib/errors/index.d.ts

@@ -4,7 +4,7 @@ export { error } from './error';
 export { CLIError } from './errors/cli';
 export { ExitError } from './errors/exit';
 export { ModuleLoadError } from './errors/module-load';
+export { exit } from './exit';
 export { handle } from './handle';
 export { Logger } from './logger';
-export declare function exit(code?: number): never;
 export { warn } from './warn';

package/lib/errors/index.js

@@ -1,24 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.warn = exports.exit = exports.Logger = exports.handle = exports.ModuleLoadError = exports.ExitError = exports.CLIError = exports.error = exports.config = void 0;
-const exit_1 = require("./errors/exit");
+exports.warn = exports.Logger = exports.handle = exports.exit = exports.ModuleLoadError = exports.ExitError = exports.CLIError = exports.error = exports.config = void 0;
 var config_1 = require("./config");
 Object.defineProperty(exports, "config", { enumerable: true, get: function () { return config_1.config; } });
 var error_1 = require("./error");
 Object.defineProperty(exports, "error", { enumerable: true, get: function () { return error_1.error; } });
 var cli_1 = require("./errors/cli");
 Object.defineProperty(exports, "CLIError", { enumerable: true, get: function () { return cli_1.CLIError; } });
-var exit_2 = require("./errors/exit");
-Object.defineProperty(exports, "ExitError", { enumerable: true, get: function () { return exit_2.ExitError; } });
+var exit_1 = require("./errors/exit");
+Object.defineProperty(exports, "ExitError", { enumerable: true, get: function () { return exit_1.ExitError; } });
 var module_load_1 = require("./errors/module-load");
 Object.defineProperty(exports, "ModuleLoadError", { enumerable: true, get: function () { return module_load_1.ModuleLoadError; } });
+var exit_2 = require("./exit");
+Object.defineProperty(exports, "exit", { enumerable: true, get: function () { return exit_2.exit; } });
 var handle_1 = require("./handle");
 Object.defineProperty(exports, "handle", { enumerable: true, get: function () { return handle_1.handle; } });
 var logger_1 = require("./logger");
 Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
-function exit(code = 0) {
-    throw new exit_1.ExitError(code);
-}
-exports.exit = exit;
 var warn_1 = require("./warn");
 Object.defineProperty(exports, "warn", { enumerable: true, get: function () { return warn_1.warn; } });

package/lib/errors/logger.js

@@ -1,9 +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.Logger = void 0;
+const ansis_1 = __importDefault(require("ansis"));
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
-const stripAnsi = require("strip-ansi");
 const timestamp = () => new Date().toISOString();
 let timer;
 const wait = (ms) => new Promise((resolve) => {
@@ -36,7 +39,7 @@ class Logger {
         await this.flushing;
     }
     log(msg) {
-        msg = stripAnsi(chomp(msg));
+        msg = ansis_1.default.strip(chomp(msg));
         const lines = msg.split('\n').map((l) => `${timestamp()} ${l}`.trimEnd());
         this.buffer.push(...lines);
         this.flush(50).catch(console.error);

package/lib/errors/warn.d.ts

@@ -1,3 +1,14 @@
-export declare function warn(input: Error | string): void;
-export declare function memoizedWarn(input: Error | string): void;
+type Options = {
+    /**
+     * If true, will only print the same warning once.
+     */
+    ignoreDuplicates?: boolean;
+};
+/**
+ * Prints a pretty warning message to stderr.
+ *
+ * @param input The error or string to print.
+ * @param options.ignoreDuplicates If true, will only print the same warning once.
+ */
+export declare function warn(input: Error | string, options?: Options): void;
 export default warn;

package/lib/errors/warn.js

@@ -3,12 +3,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.memoizedWarn = exports.warn = void 0;
-const write_1 = __importDefault(require("../cli-ux/write"));
+exports.warn = void 0;
+const write_1 = require("../ux/write");
 const config_1 = require("./config");
 const cli_1 = require("./errors/cli");
 const pretty_print_1 = __importDefault(require("./errors/pretty-print"));
-function warn(input) {
+const WARNINGS = new Set();
+/**
+ * Prints a pretty warning message to stderr.
+ *
+ * @param input The error or string to print.
+ * @param options.ignoreDuplicates If true, will only print the same warning once.
+ */
+function warn(input, options) {
+    const ignoreDuplicates = options?.ignoreDuplicates ?? true;
+    if (ignoreDuplicates && WARNINGS.has(input))
+        return;
+    WARNINGS.add(input);
     let err;
     if (typeof input === 'string') {
         err = new cli_1.CLIError.Warn(input);
@@ -21,16 +32,9 @@ function warn(input) {
     }
     const message = (0, pretty_print_1.default)(err);
     if (message)
-        write_1.default.stderr(message + '\n');
+        (0, write_1.stderr)(message);
     if (config_1.config.errorLogger)
         config_1.config.errorLogger.log(err?.stack ?? '');
 }
 exports.warn = warn;
-const WARNINGS = new Set();
-function memoizedWarn(input) {
-    if (!WARNINGS.has(input))
-        warn(input);
-    WARNINGS.add(input);
-}
-exports.memoizedWarn = memoizedWarn;
 exports.default = warn;

package/lib/execute.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.execute = void 0;
-const flush_1 = require("./cli-ux/flush");
 const errors_1 = require("./errors");
 const handle_1 = require("./errors/handle");
+const flush_1 = require("./flush");
 const main_1 = require("./main");
 const settings_1 = require("./settings");
 /**

package/lib/{cli-ux/flush.js → flush.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.flush = void 0;
-const errors_1 = require("../errors");
+const errors_1 = require("./errors");
 function timeout(p, ms) {
     function wait(ms, unref = false) {
         return new Promise((resolve) => {

package/lib/help/command.js

@@ -4,12 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CommandHelp = void 0;
-const chalk_1 = __importDefault(require("chalk"));
-const strip_ansi_1 = __importDefault(require("strip-ansi"));
-const theme_1 = require("../cli-ux/theme");
+const ansis_1 = __importDefault(require("ansis"));
 const ensure_arg_object_1 = require("../util/ensure-arg-object");
 const ids_1 = require("../util/ids");
 const util_1 = require("../util/util");
+const theme_1 = require("../ux/theme");
 const docopts_1 = require("./docopts");
 const formatter_1 = require("./formatter");
 // Don't use os.EOL because we need to ensure that a string
@@ -161,7 +160,7 @@ class CommandHelp extends formatter_1.HelpFormatter {
             if (flag.multiple)
                 value += '...';
             if (!value.includes('|'))
-                value = chalk_1.default.underline(value);
+                value = ansis_1.default.underline(value);
             label += `=${value}`;
         }
         return (0, theme_1.colorize)(this.config.theme?.flag, label);
@@ -328,7 +327,9 @@ class CommandHelp extends formatter_1.HelpFormatter {
         return example;
     }
     isCommand(example) {
-        return (0, strip_ansi_1.default)(this.formatIfCommand(example)).startsWith(`${(0, theme_1.colorize)(this.config?.theme?.dollarSign, '$')} ${this.config.bin}`);
+        return ansis_1.default
+            .strip(this.formatIfCommand(example))
+            .startsWith(`${(0, theme_1.colorize)(this.config?.theme?.dollarSign, '$')} ${this.config.bin}`);
     }
 }
 exports.CommandHelp = CommandHelp;

package/lib/help/formatter.js

@@ -4,14 +4,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HelpFormatter = void 0;
-const chalk_1 = __importDefault(require("chalk"));
+const ansis_1 = __importDefault(require("ansis"));
 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 theme_1 = require("../cli-ux/theme");
 const screen_1 = require("../screen");
+const theme_1 = require("../ux/theme");
 const util_1 = require("./util");
 class HelpFormatter {
     config;
@@ -74,12 +73,12 @@ class HelpFormatter {
                     continue;
                 if (left) {
                     if (opts.stripAnsi)
-                        left = (0, strip_ansi_1.default)(left);
+                        left = ansis_1.default.strip(left);
                     output += this.wrap(left.trim(), opts.indentation);
                 }
                 if (right) {
                     if (opts.stripAnsi)
-                        right = (0, strip_ansi_1.default)(right);
+                        right = ansis_1.default.strip(right);
                     output += '\n';
                     output += this.indent(this.wrap(right.trim(), opts.indentation + 2), 4);
                 }
@@ -101,13 +100,13 @@ class HelpFormatter {
             }
             cur = left || '';
             if (opts.stripAnsi)
-                cur = (0, strip_ansi_1.default)(cur);
+                cur = ansis_1.default.strip(cur);
             if (!right) {
                 cur = cur.trim();
                 continue;
             }
             if (opts.stripAnsi)
-                right = (0, strip_ansi_1.default)(right);
+                right = ansis_1.default.strip(right);
             right = this.wrap(right.trim(), opts.indentation + maxLength + 2);
             const [first, ...lines] = right.split('\n').map((s) => s.trim());
             cur += ' '.repeat(maxLength - (0, string_width_1.default)(cur) + 2);
@@ -155,10 +154,10 @@ class HelpFormatter {
                 .map(([left, right]) => [this.render(left), right && this.render(right)]);
         }
         const output = [
-            (0, theme_1.colorize)(this.config?.theme?.sectionHeader, chalk_1.default.bold(header)),
+            (0, theme_1.colorize)(this.config?.theme?.sectionHeader, ansis_1.default.bold(header)),
             (0, theme_1.colorize)(this.config?.theme?.sectionDescription, this.indent(Array.isArray(newBody) ? this.renderList(newBody, { indentation: 2, stripAnsi: this.opts.stripAnsi }) : newBody)),
         ].join('\n');
-        return this.opts.stripAnsi ? (0, strip_ansi_1.default)(output) : output;
+        return this.opts.stripAnsi ? ansis_1.default.strip(output) : output;
     }
     /**
      * Wrap text according to `opts.maxWidth` which is typically set to the terminal width. All text

package/lib/help/index.js

@@ -4,10 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadHelpClass = exports.Help = exports.HelpBase = exports.standardizeIDFromArgv = exports.normalizeArgv = exports.getHelpFlagAdditions = exports.CommandHelp = void 0;
-const node_util_1 = require("node:util");
-const strip_ansi_1 = __importDefault(require("strip-ansi"));
-const theme_1 = require("../cli-ux/theme");
-const write_1 = __importDefault(require("../cli-ux/write"));
+const ansis_1 = __importDefault(require("ansis"));
 const ts_path_1 = require("../config/ts-path");
 const error_1 = require("../errors/error");
 const module_loader_1 = require("../module-loader");
@@ -15,6 +12,8 @@ const symbols_1 = require("../symbols");
 const cache_default_value_1 = require("../util/cache-default-value");
 const ids_1 = require("../util/ids");
 const util_1 = require("../util/util");
+const ux_1 = __importDefault(require("../ux"));
+const theme_1 = require("../ux/theme");
 const command_1 = require("./command");
 const formatter_1 = require("./formatter");
 const root_1 = __importDefault(require("./root"));
@@ -94,7 +93,7 @@ class Help extends HelpBase {
             const summary = this.summary(c);
             return [
                 (0, theme_1.colorize)(this.config?.theme?.command, c.id),
-                summary && (0, theme_1.colorize)(this.config?.theme?.sectionDescription, (0, strip_ansi_1.default)(summary)),
+                summary && (0, theme_1.colorize)(this.config?.theme?.sectionDescription, ansis_1.default.strip(summary)),
             ];
         }), {
             indentation: 2,
@@ -121,7 +120,7 @@ class Help extends HelpBase {
                 this.section('DESCRIPTION', this.wrap((0, theme_1.colorize)(this.config?.theme?.sectionDescription, description))),
         ]).join('\n\n');
         if (this.opts.stripAnsi)
-            output = (0, strip_ansi_1.default)(output);
+            output = ansis_1.default.strip(output);
         return output + '\n';
     }
     formatTopics(topics) {
@@ -145,9 +144,7 @@ class Help extends HelpBase {
         return new this.CommandHelpClass(command, this.config, this.opts);
     }
     log(...args) {
-        this.opts.sendToStderr
-            ? write_1.default.stderr(node_util_1.format.apply(this, args) + '\n')
-            : write_1.default.stdout(node_util_1.format.apply(this, args) + '\n');
+        this.opts.sendToStderr ? ux_1.default.stderr(args) : ux_1.default.stdout(args);
     }
     async showCommandHelp(command) {
         const name = command.id;

package/lib/help/root.js

@@ -3,9 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const strip_ansi_1 = __importDefault(require("strip-ansi"));
-const theme_1 = require("../cli-ux/theme");
+const ansis_1 = __importDefault(require("ansis"));
 const util_1 = require("../util/util");
+const theme_1 = require("../ux/theme");
 const formatter_1 = require("./formatter");
 class RootHelp extends formatter_1.HelpFormatter {
     config;
@@ -34,7 +34,7 @@ class RootHelp extends formatter_1.HelpFormatter {
             this.description(),
         ]).join('\n\n');
         if (this.opts.stripAnsi)
-            output = (0, strip_ansi_1.default)(output);
+            output = ansis_1.default.strip(output);
         return output;
     }
     usage() {