@guanghechen/commander 4.1.0 → 4.3.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Change Log
 
+## 4.3.0
+
+### Minor Changes
+
+- feat: add fluent help examples and styled help renderer
+
+## 4.2.0
+
+### Minor Changes
+
+- feat(reporter): add setFlight API for flight tracking feat(commander): unify builtin config for
+  options and commands
+
+### Patch Changes
+
+- Updated dependencies:
+  - @guanghechen/reporter@3.3.0
+
 ## 4.1.0
 
 ### Minor Changes

package/README.md

@@ -202,6 +202,29 @@ new Command({ name: 'example', description: 'Option types demo' })
   })
 ```
 
+### Help Examples
+
+```typescript
+import { Command } from '@guanghechen/commander'
+
+const cli = new Command({ name: 'mycli', desc: 'My CLI tool' })
+
+cli
+  .example('Initialize Project', 'init my-app', 'Create project scaffold')
+  .example('Watch Build', 'build --watch', 'Rebuild on file changes')
+  .action(() => {})
+
+await cli.run({ argv: ['--help'], envs: process.env })
+```
+
+`usage` 是相对当前 command path 的片段，help 中会自动补齐前缀，例如 `mycli build --watch`。
+
+`--color` / `--no-color` 仅控制 help 文本的终端着色；
+`--log-colorful` / `--no-log-colorful` 控制 `Reporter` 的日志着色。
+
+当环境变量 `NO_COLOR` 存在时，help 渲染默认视为 `--no-color`；
+显式传入 `--color` 可以覆盖这个默认值。
+
 ## Reference
 
 - [homepage][homepage]

package/lib/cjs/index.cjs

@@ -24,6 +24,69 @@ function _interopNamespaceDefault(e) {
 var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
 var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
 
+const TERMINAL_STYLE = {
+    bold: '\x1b[1m',
+    italic: '\x1b[3m',
+    underline: '\x1b[4m',
+    cyan: '\x1b[36m',
+    dim: '\x1b[2m',
+    reset: '\x1b[0m',
+};
+function styleText(text, ...styles) {
+    return `${styles.join('')}${text}${TERMINAL_STYLE.reset}`;
+}
+
+const logLevelOption = {
+    long: 'logLevel',
+    type: 'string',
+    args: 'required',
+    desc: 'Set log level',
+    default: 'info',
+    choices: reporter.LOG_LEVELS,
+    coerce: (raw) => {
+        const level = reporter.resolveLogLevel(raw);
+        if (level === undefined) {
+            throw new Error(`Invalid log level: ${raw}`);
+        }
+        return level;
+    },
+    apply: (value, ctx) => {
+        ctx.reporter.setLevel(value);
+    },
+};
+const logDateOption = {
+    long: 'logDate',
+    type: 'boolean',
+    args: 'none',
+    desc: 'Enable log timestamp',
+    default: true,
+    apply: (value, ctx) => {
+        ctx.reporter.setFlight({ date: Boolean(value) });
+    },
+};
+const logColorfulOption = {
+    long: 'logColorful',
+    type: 'boolean',
+    args: 'none',
+    desc: 'Enable colorful log output',
+    default: true,
+    apply: (value, ctx) => {
+        ctx.reporter.setFlight({ color: Boolean(value) });
+    },
+};
+const silentOption = {
+    long: 'silent',
+    type: 'boolean',
+    args: 'none',
+    desc: 'Suppress non-error output',
+    default: false,
+    apply: (value, ctx) => {
+        if (value) {
+            ctx.reporter.setLevel('error');
+        }
+    },
+};
+
 class CommanderError extends Error {
     kind;
     commandPath;
@@ -139,15 +202,92 @@ const BUILTIN_VERSION_OPTION = {
     args: 'none',
     desc: 'Show version number',
 };
+const BUILTIN_COLOR_OPTION = {
+    long: 'color',
+    type: 'boolean',
+    args: 'none',
+    desc: 'Enable colored help output',
+    default: true,
+};
+function createBuiltinOptionState(enabled) {
+    return {
+        color: enabled,
+        logLevel: enabled,
+        silent: enabled,
+        logDate: enabled,
+        logColorful: enabled,
+    };
+}
+function isNoColorEnabled(envs) {
+    return envs['NO_COLOR'] !== undefined;
+}
+function normalizeBuiltinConfig(builtin) {
+    const resolved = {
+        option: createBuiltinOptionState(true),
+        command: {
+            help: false,
+        },
+    };
+    if (builtin === undefined) {
+        return resolved;
+    }
+    if (builtin === true) {
+        return {
+            option: createBuiltinOptionState(true),
+            command: { help: true },
+        };
+    }
+    if (builtin === false) {
+        return {
+            option: createBuiltinOptionState(false),
+            command: { help: false },
+        };
+    }
+    if (builtin.option !== undefined) {
+        if (builtin.option === false) {
+            resolved.option = createBuiltinOptionState(false);
+        }
+        else if (builtin.option === true) {
+            resolved.option = createBuiltinOptionState(true);
+        }
+        else {
+            if (builtin.option.color !== undefined)
+                resolved.option.color = builtin.option.color;
+            if (builtin.option.logLevel !== undefined) {
+                resolved.option.logLevel = builtin.option.logLevel;
+            }
+            if (builtin.option.silent !== undefined)
+                resolved.option.silent = builtin.option.silent;
+            if (builtin.option.logDate !== undefined)
+                resolved.option.logDate = builtin.option.logDate;
+            if (builtin.option.logColorful !== undefined) {
+                resolved.option.logColorful = builtin.option.logColorful;
+            }
+        }
+    }
+    if (builtin.command !== undefined) {
+        if (builtin.command === false) {
+            resolved.command = { help: false };
+        }
+        else if (builtin.command === true) {
+            resolved.command = { help: true };
+        }
+        else if (builtin.command.help !== undefined) {
+            resolved.command.help = builtin.command.help;
+        }
+    }
+    return resolved;
+}
 class Command {
     #name;
     #desc;
     #version;
-    #helpSubcommandEnabled;
+    #builtin;
     #reporter;
     #parent;
     #options = [];
     #arguments = [];
+    #examples = [];
     #subcommandsList = [];
     #subcommandsMap = new Map();
     #action = undefined;
@@ -155,7 +295,7 @@ class Command {
         this.#name = config.name ?? '';
         this.#desc = config.desc;
         this.#version = config.version;
-        this.#helpSubcommandEnabled = config.help ?? false;
+        this.#builtin = normalizeBuiltinConfig(config.builtin);
         this.#reporter = config.reporter;
     }
     get name() {
@@ -176,6 +316,9 @@ class Command {
     get arguments() {
         return [...this.#arguments];
     }
+    get examples() {
+        return this.#examples.map(example => ({ ...example }));
+    }
     get subcommands() {
         return new Map(this.#subcommandsMap);
     }
@@ -194,8 +337,12 @@ class Command {
         this.#action = fn;
         return this;
     }
+    example(title, usage, desc) {
+        this.#examples.push(this.#normalizeExample({ title, usage, desc }));
+        return this;
+    }
     subcommand(name, cmd) {
-        if (this.#helpSubcommandEnabled && name === 'help') {
+        if (this.#builtin.command.help && name === 'help') {
             throw new CommanderError('ConfigurationError', '"help" is a reserved subcommand name when help subcommand is enabled', this.#getCommandPath());
         }
         if (cmd.#parent && cmd.#parent !== this) {
@@ -227,7 +374,8 @@ class Command {
             const hasUserHelp = leafCommand.#options.some(o => o.long === 'help');
             const hasUserVersion = leafCommand.#options.some(o => o.long === 'version');
             if (!hasUserHelp && this.#hasFlag(optionTokens, 'help', 'h')) {
-                console.log(leafCommand.formatHelp());
+                const helpColor = leafCommand.#resolveHelpColorOption(optionTokens, envs);
+                console.log(leafCommand.#formatHelpForDisplay({ color: helpColor }));
                 return;
             }
             if (!hasUserVersion && leafCommand === rootCommand && leafCommand.#version) {
@@ -254,7 +402,8 @@ class Command {
                 await leafCommand.#runAction(actionParams);
             }
             else if (leafCommand.#subcommandsList.length > 0) {
-                console.log(leafCommand.formatHelp());
+                const helpColor = leafCommand.#resolveHelpColorOption(optionTokens, envs);
+                console.log(leafCommand.#formatHelpForDisplay({ color: helpColor }));
             }
             else {
                 throw new CommanderError('ConfigurationError', `no action defined for command "${leafCommand.#getCommandPath()}"`, leafCommand.#getCommandPath());
@@ -287,10 +436,21 @@ class Command {
         return this.#parse(chain, resolveResult, ctx, restArgs);
     }
     formatHelp() {
-        const lines = [];
+        return this.#renderHelpPlain(this.#buildHelpData());
+    }
+    #formatHelpForDisplay(params = {}) {
+        const { color = true } = params;
+        const helpData = this.#buildHelpData();
+        if (!this.#shouldRenderStyledHelp(color)) {
+            return this.#renderHelpPlain(helpData);
+        }
+        return this.#renderHelpTerminal(helpData);
+    }
+    #shouldRenderStyledHelp(color) {
+        return color && process.stdout.isTTY === true;
+    }
+    #buildHelpData() {
         const allOptions = this.#getMergedOptions();
-        lines.push(this.#desc);
-        lines.push('');
         const commandPath = this.#getCommandPath();
         let usage = `Usage: ${commandPath}`;
         if (allOptions.length > 0)
@@ -308,61 +468,122 @@ class Command {
                 usage += ` [${arg.name}...]`;
             }
         }
-        lines.push(usage);
+        const options = [];
+        for (const opt of allOptions) {
+            const kebabLong = camelToKebabCase$1(opt.long);
+            let sig = opt.short ? `-${opt.short}, ` : '    ';
+            sig += `--${kebabLong}`;
+            if (opt.args !== 'none') {
+                sig += ' <value>';
+            }
+            let desc = opt.desc;
+            if (opt.default !== undefined && opt.type !== 'boolean') {
+                desc += ` (default: ${JSON.stringify(opt.default)})`;
+            }
+            if (opt.choices) {
+                desc += ` [choices: ${opt.choices.join(', ')}]`;
+            }
+            options.push({ sig, desc });
+            if (opt.type === 'boolean' && opt.args === 'none') {
+                options.push({
+                    sig: `    --no-${kebabLong}`,
+                    desc: `Negate --${kebabLong}`,
+                });
+            }
+        }
+        const commands = [];
+        const showHelpSubcommand = this.#builtin.command.help && this.#subcommandsList.length > 0;
+        if (showHelpSubcommand) {
+            commands.push({ name: 'help', desc: 'Show help for a command' });
+        }
+        for (const entry of this.#subcommandsList) {
+            let name = entry.name;
+            if (entry.aliases.length > 0) {
+                name += `, ${entry.aliases.join(', ')}`;
+            }
+            commands.push({ name, desc: entry.command.#desc });
+        }
+        const examples = this.#examples.map(example => ({
+            title: example.title,
+            usage: commandPath ? `${commandPath} ${example.usage}` : example.usage,
+            desc: example.desc,
+        }));
+        return {
+            desc: this.#desc,
+            usage,
+            options,
+            commands,
+            examples,
+        };
+    }
+    #renderHelpPlain(helpData) {
+        const lines = [];
+        lines.push(helpData.desc);
         lines.push('');
-        if (allOptions.length > 0) {
+        lines.push(helpData.usage);
+        lines.push('');
+        if (helpData.options.length > 0) {
             lines.push('Options:');
-            const optLines = [];
-            for (const opt of allOptions) {
-                const kebabLong = camelToKebabCase$1(opt.long);
-                let sig = opt.short ? `-${opt.short}, ` : '    ';
-                sig += `--${kebabLong}`;
-                if (opt.args !== 'none') {
-                    sig += ' <value>';
-                }
-                let desc = opt.desc;
-                if (opt.default !== undefined && opt.type !== 'boolean') {
-                    desc += ` (default: ${JSON.stringify(opt.default)})`;
-                }
-                if (opt.choices) {
-                    desc += ` [choices: ${opt.choices.join(', ')}]`;
-                }
-                optLines.push({ sig, desc });
-                if (opt.type === 'boolean' && opt.args === 'none') {
-                    optLines.push({
-                        sig: `    --no-${kebabLong}`,
-                        desc: `Negate --${kebabLong}`,
-                    });
-                }
-            }
-            const maxSigLen = Math.max(...optLines.map(l => l.sig.length));
-            for (const { sig, desc } of optLines) {
+            const maxSigLen = Math.max(...helpData.options.map(line => line.sig.length));
+            for (const { sig, desc } of helpData.options) {
                 const padding = ' '.repeat(maxSigLen - sig.length + 2);
                 lines.push(`  ${sig}${padding}${desc}`);
             }
             lines.push('');
         }
-        const showHelpSubcommand = this.#helpSubcommandEnabled && this.#subcommandsList.length > 0;
-        if (this.#subcommandsList.length > 0) {
+        if (helpData.commands.length > 0) {
             lines.push('Commands:');
-            const cmdLines = [];
-            if (showHelpSubcommand) {
-                cmdLines.push({ name: 'help', desc: 'Show help for a command' });
-            }
-            for (const entry of this.#subcommandsList) {
-                let name = entry.name;
-                if (entry.aliases.length > 0) {
-                    name += `, ${entry.aliases.join(', ')}`;
-                }
-                cmdLines.push({ name, desc: entry.command.#desc });
-            }
-            const maxNameLen = Math.max(...cmdLines.map(l => l.name.length));
-            for (const { name, desc } of cmdLines) {
+            const maxNameLen = Math.max(...helpData.commands.map(line => line.name.length));
+            for (const { name, desc } of helpData.commands) {
                 const padding = ' '.repeat(maxNameLen - name.length + 2);
                 lines.push(`  ${name}${padding}${desc}`);
             }
             lines.push('');
         }
+        if (helpData.examples.length > 0) {
+            lines.push('Examples:');
+            for (const example of helpData.examples) {
+                lines.push(`  - ${example.title}`);
+                lines.push(`    ${example.usage}`);
+                lines.push(`    ${example.desc}`);
+                lines.push('');
+            }
+        }
+        return lines.join('\n');
+    }
+    #renderHelpTerminal(helpData) {
+        const lines = [];
+        lines.push(helpData.desc);
+        lines.push('');
+        lines.push(styleText(helpData.usage, TERMINAL_STYLE.bold));
+        lines.push('');
+        if (helpData.options.length > 0) {
+            lines.push(styleText('Options:', TERMINAL_STYLE.bold, TERMINAL_STYLE.underline));
+            const maxSigLen = Math.max(...helpData.options.map(line => line.sig.length));
+            for (const { sig, desc } of helpData.options) {
+                const padding = ' '.repeat(maxSigLen - sig.length + 2);
+                lines.push(`  ${styleText(sig, TERMINAL_STYLE.cyan)}${padding}${desc}`);
+            }
+            lines.push('');
+        }
+        if (helpData.commands.length > 0) {
+            lines.push(styleText('Commands:', TERMINAL_STYLE.bold, TERMINAL_STYLE.underline));
+            const maxNameLen = Math.max(...helpData.commands.map(line => line.name.length));
+            for (const { name, desc } of helpData.commands) {
+                const padding = ' '.repeat(maxNameLen - name.length + 2);
+                lines.push(`  ${styleText(name, TERMINAL_STYLE.cyan)}${padding}${desc}`);
+            }
+            lines.push('');
+        }
+        if (helpData.examples.length > 0) {
+            lines.push(styleText('Examples:', TERMINAL_STYLE.bold, TERMINAL_STYLE.underline));
+            for (const example of helpData.examples) {
+                lines.push(`  - ${styleText(example.title, TERMINAL_STYLE.bold)}`);
+                lines.push(`    ${styleText(example.usage, TERMINAL_STYLE.cyan)}`);
+                lines.push(`    ${styleText(example.desc, TERMINAL_STYLE.italic, TERMINAL_STYLE.dim)}`);
+                lines.push('');
+            }
+        }
         return lines.join('\n');
     }
     getCompletionMeta() {
@@ -393,7 +614,7 @@ class Command {
         };
     }
     #processHelpSubcommand(argv) {
-        if (!this.#helpSubcommandEnabled)
+        if (!this.#builtin.command.help)
             return argv;
         if (argv.length < 1 || argv[0] !== 'help')
             return argv;
@@ -526,7 +747,7 @@ class Command {
             const cmd = chain[i];
             const includeVersion = i === 0;
             const tokens = consumedTokens.get(cmd) ?? [];
-            const opts = cmd.#parseOptions(tokens, includeVersion);
+            const opts = cmd.#parseOptions(tokens, includeVersion, ctx.envs);
             optsMap.set(cmd, opts);
             for (const opt of cmd.#getMergedOptions(includeVersion)) {
                 if (opt.apply && opts[opt.long] !== undefined) {
@@ -542,9 +763,10 @@ class Command {
         const { args, rawArgs } = leafCommand.#parseArguments(rawArgStrings);
         return { ctx, opts: mergedOpts, args, rawArgs };
     }
-    #parseOptions(tokens, includeVersion) {
+    #parseOptions(tokens, includeVersion, envs) {
         const allOptions = this.#getMergedOptions(includeVersion);
         const opts = {};
+        let sawColorToken = false;
         for (const opt of allOptions) {
             if (opt.default !== undefined) {
                 opts[opt.long] = opt.default;
@@ -572,6 +794,9 @@ class Command {
                 i += 1;
                 continue;
             }
+            if (opt.long === 'color') {
+                sawColorToken = true;
+            }
             const isNegativeToken = token.original.toLowerCase().startsWith('--no-');
             if (isNegativeToken && !(opt.type === 'boolean' && opt.args === 'none')) {
                 throw new CommanderError('NegativeOptionType', `"--no-${camelToKebabCase$1(opt.long)}" can only be used with boolean options`, this.#getCommandPath());
@@ -648,6 +873,9 @@ class Command {
                 }
             }
         }
+        if (isNoColorEnabled(envs) && !sawColorToken && opts['color'] === true) {
+            opts['color'] = false;
+        }
         return opts;
     }
     #convertValue(opt, rawValue) {
@@ -720,14 +948,34 @@ class Command {
     }
     #getMergedOptions(includeVersion = !this.#parent) {
         const optionMap = new Map();
+        const hasUserColor = this.#options.some(o => o.long === 'color');
         const hasUserHelp = this.#options.some(o => o.long === 'help');
         const hasUserVersion = this.#options.some(o => o.long === 'version');
+        const hasUserLogLevel = this.#options.some(o => o.long === 'logLevel');
+        const hasUserSilent = this.#options.some(o => o.long === 'silent');
+        const hasUserLogDate = this.#options.some(o => o.long === 'logDate');
+        const hasUserLogColorful = this.#options.some(o => o.long === 'logColorful');
+        if (this.#builtin.option.color && !hasUserColor) {
+            optionMap.set('color', BUILTIN_COLOR_OPTION);
+        }
         if (!hasUserHelp) {
             optionMap.set('help', BUILTIN_HELP_OPTION);
         }
         if (!hasUserVersion && includeVersion) {
             optionMap.set('version', BUILTIN_VERSION_OPTION);
         }
+        if (this.#builtin.option.logLevel && !hasUserLogLevel) {
+            optionMap.set('logLevel', logLevelOption);
+        }
+        if (this.#builtin.option.silent && !hasUserSilent) {
+            optionMap.set('silent', silentOption);
+        }
+        if (this.#builtin.option.logDate && !hasUserLogDate) {
+            optionMap.set('logDate', logDateOption);
+        }
+        if (this.#builtin.option.logColorful && !hasUserLogColorful) {
+            optionMap.set('logColorful', logColorfulOption);
+        }
         for (const opt of this.#options) {
             optionMap.set(opt.long, opt);
         }
@@ -803,6 +1051,21 @@ class Command {
             }
         }
     }
+    #normalizeExample(example) {
+        const title = example.title.trim();
+        const usage = example.usage.trim();
+        const desc = example.desc.trim();
+        if (!title) {
+            throw new CommanderError('ConfigurationError', 'example title cannot be empty', this.#getCommandPath());
+        }
+        if (!usage) {
+            throw new CommanderError('ConfigurationError', 'example usage cannot be empty', this.#getCommandPath());
+        }
+        if (!desc) {
+            throw new CommanderError('ConfigurationError', 'example description cannot be empty', this.#getCommandPath());
+        }
+        return { title, usage, desc };
+    }
     async #runAction(params) {
         if (!this.#action)
             return;
@@ -819,6 +1082,34 @@ class Command {
             process.exit(1);
         }
     }
+    #resolveHelpColorOption(tokens, envs) {
+        const colorOption = this.#getMergedOptions().find(opt => opt.long === 'color');
+        let color = !isNoColorEnabled(envs);
+        if (!colorOption || colorOption.type !== 'boolean' || colorOption.args !== 'none') {
+            return color;
+        }
+        for (const token of tokens) {
+            if (token.type !== 'long' || token.name !== 'color') {
+                continue;
+            }
+            const eqIdx = token.resolved.indexOf('=');
+            if (eqIdx === -1) {
+                color = true;
+                continue;
+            }
+            const value = token.resolved.slice(eqIdx + 1);
+            if (value === 'true') {
+                color = true;
+            }
+            else if (value === 'false') {
+                color = false;
+            }
+            else {
+                throw new CommanderError('InvalidBooleanValue', `invalid value "${value}" for boolean option "--color". Use "true" or "false"`, this.#getCommandPath());
+            }
+        }
+        return color;
+    }
     #hasFlag(tokens, longName, shortName) {
         for (const token of tokens) {
             if (token.type === 'long' && token.name === longName) {
@@ -1201,37 +1492,13 @@ class PwshCompletion {
     }
 }
 
-const logLevelOption = {
-    long: 'logLevel',
-    type: 'string',
-    args: 'required',
-    desc: 'Set log level',
-    default: 'info',
-    choices: reporter.LOG_LEVELS,
-    coerce: (raw) => {
-        const level = reporter.resolveLogLevel(raw);
-        if (level === undefined) {
-            throw new Error(`Invalid log level: ${raw}`);
-        }
-        return level;
-    },
-    apply: (value, ctx) => {
-        ctx.reporter.setLevel(value);
-    },
-};
-const silentOption = {
-    long: 'silent',
-    type: 'boolean',
-    args: 'none',
-    desc: 'Suppress non-error output',
-    default: false,
-};
-
 exports.BashCompletion = BashCompletion;
 exports.Command = Command;
 exports.CommanderError = CommanderError;
 exports.CompletionCommand = CompletionCommand;
 exports.FishCompletion = FishCompletion;
 exports.PwshCompletion = PwshCompletion;
+exports.logColorfulOption = logColorfulOption;
+exports.logDateOption = logDateOption;
 exports.logLevelOption = logLevelOption;
 exports.silentOption = silentOption;

package/lib/esm/index.mjs

@@ -1,7 +1,70 @@
-import { Reporter, LOG_LEVELS, resolveLogLevel } from '@guanghechen/reporter';
+import { LOG_LEVELS, resolveLogLevel, Reporter } from '@guanghechen/reporter';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 
+const TERMINAL_STYLE = {
+    bold: '\x1b[1m',
+    italic: '\x1b[3m',
+    underline: '\x1b[4m',
+    cyan: '\x1b[36m',
+    dim: '\x1b[2m',
+    reset: '\x1b[0m',
+};
+function styleText(text, ...styles) {
+    return `${styles.join('')}${text}${TERMINAL_STYLE.reset}`;
+}
+
+const logLevelOption = {
+    long: 'logLevel',
+    type: 'string',
+    args: 'required',
+    desc: 'Set log level',
+    default: 'info',
+    choices: LOG_LEVELS,
+    coerce: (raw) => {
+        const level = resolveLogLevel(raw);
+        if (level === undefined) {
+            throw new Error(`Invalid log level: ${raw}`);
+        }
+        return level;
+    },
+    apply: (value, ctx) => {
+        ctx.reporter.setLevel(value);
+    },
+};
+const logDateOption = {
+    long: 'logDate',
+    type: 'boolean',
+    args: 'none',
+    desc: 'Enable log timestamp',
+    default: true,
+    apply: (value, ctx) => {
+        ctx.reporter.setFlight({ date: Boolean(value) });
+    },
+};
+const logColorfulOption = {
+    long: 'logColorful',
+    type: 'boolean',
+    args: 'none',
+    desc: 'Enable colorful log output',
+    default: true,
+    apply: (value, ctx) => {
+        ctx.reporter.setFlight({ color: Boolean(value) });
+    },
+};
+const silentOption = {
+    long: 'silent',
+    type: 'boolean',
+    args: 'none',
+    desc: 'Suppress non-error output',
+    default: false,
+    apply: (value, ctx) => {
+        if (value) {
+            ctx.reporter.setLevel('error');
+        }
+    },
+};
+
 class CommanderError extends Error {
     kind;
     commandPath;
@@ -117,15 +180,92 @@ const BUILTIN_VERSION_OPTION = {
     args: 'none',
     desc: 'Show version number',
 };
+const BUILTIN_COLOR_OPTION = {
+    long: 'color',
+    type: 'boolean',
+    args: 'none',
+    desc: 'Enable colored help output',
+    default: true,
+};
+function createBuiltinOptionState(enabled) {
+    return {
+        color: enabled,
+        logLevel: enabled,
+        silent: enabled,
+        logDate: enabled,
+        logColorful: enabled,
+    };
+}
+function isNoColorEnabled(envs) {
+    return envs['NO_COLOR'] !== undefined;
+}
+function normalizeBuiltinConfig(builtin) {
+    const resolved = {
+        option: createBuiltinOptionState(true),
+        command: {
+            help: false,
+        },
+    };
+    if (builtin === undefined) {
+        return resolved;
+    }
+    if (builtin === true) {
+        return {
+            option: createBuiltinOptionState(true),
+            command: { help: true },
+        };
+    }
+    if (builtin === false) {
+        return {
+            option: createBuiltinOptionState(false),
+            command: { help: false },
+        };
+    }
+    if (builtin.option !== undefined) {
+        if (builtin.option === false) {
+            resolved.option = createBuiltinOptionState(false);
+        }
+        else if (builtin.option === true) {
+            resolved.option = createBuiltinOptionState(true);
+        }
+        else {
+            if (builtin.option.color !== undefined)
+                resolved.option.color = builtin.option.color;
+            if (builtin.option.logLevel !== undefined) {
+                resolved.option.logLevel = builtin.option.logLevel;
+            }
+            if (builtin.option.silent !== undefined)
+                resolved.option.silent = builtin.option.silent;
+            if (builtin.option.logDate !== undefined)
+                resolved.option.logDate = builtin.option.logDate;
+            if (builtin.option.logColorful !== undefined) {
+                resolved.option.logColorful = builtin.option.logColorful;
+            }
+        }
+    }
+    if (builtin.command !== undefined) {
+        if (builtin.command === false) {
+            resolved.command = { help: false };
+        }
+        else if (builtin.command === true) {
+            resolved.command = { help: true };
+        }
+        else if (builtin.command.help !== undefined) {
+            resolved.command.help = builtin.command.help;
+        }
+    }
+    return resolved;
+}
 class Command {
     #name;
     #desc;
     #version;
-    #helpSubcommandEnabled;
+    #builtin;
     #reporter;
     #parent;
     #options = [];
     #arguments = [];
+    #examples = [];
     #subcommandsList = [];
     #subcommandsMap = new Map();
     #action = undefined;
@@ -133,7 +273,7 @@ class Command {
         this.#name = config.name ?? '';
         this.#desc = config.desc;
         this.#version = config.version;
-        this.#helpSubcommandEnabled = config.help ?? false;
+        this.#builtin = normalizeBuiltinConfig(config.builtin);
         this.#reporter = config.reporter;
     }
     get name() {
@@ -154,6 +294,9 @@ class Command {
     get arguments() {
         return [...this.#arguments];
     }
+    get examples() {
+        return this.#examples.map(example => ({ ...example }));
+    }
     get subcommands() {
         return new Map(this.#subcommandsMap);
     }
@@ -172,8 +315,12 @@ class Command {
         this.#action = fn;
         return this;
     }
+    example(title, usage, desc) {
+        this.#examples.push(this.#normalizeExample({ title, usage, desc }));
+        return this;
+    }
     subcommand(name, cmd) {
-        if (this.#helpSubcommandEnabled && name === 'help') {
+        if (this.#builtin.command.help && name === 'help') {
             throw new CommanderError('ConfigurationError', '"help" is a reserved subcommand name when help subcommand is enabled', this.#getCommandPath());
         }
         if (cmd.#parent && cmd.#parent !== this) {
@@ -205,7 +352,8 @@ class Command {
             const hasUserHelp = leafCommand.#options.some(o => o.long === 'help');
             const hasUserVersion = leafCommand.#options.some(o => o.long === 'version');
             if (!hasUserHelp && this.#hasFlag(optionTokens, 'help', 'h')) {
-                console.log(leafCommand.formatHelp());
+                const helpColor = leafCommand.#resolveHelpColorOption(optionTokens, envs);
+                console.log(leafCommand.#formatHelpForDisplay({ color: helpColor }));
                 return;
             }
             if (!hasUserVersion && leafCommand === rootCommand && leafCommand.#version) {
@@ -232,7 +380,8 @@ class Command {
                 await leafCommand.#runAction(actionParams);
             }
             else if (leafCommand.#subcommandsList.length > 0) {
-                console.log(leafCommand.formatHelp());
+                const helpColor = leafCommand.#resolveHelpColorOption(optionTokens, envs);
+                console.log(leafCommand.#formatHelpForDisplay({ color: helpColor }));
             }
             else {
                 throw new CommanderError('ConfigurationError', `no action defined for command "${leafCommand.#getCommandPath()}"`, leafCommand.#getCommandPath());
@@ -265,10 +414,21 @@ class Command {
         return this.#parse(chain, resolveResult, ctx, restArgs);
     }
     formatHelp() {
-        const lines = [];
+        return this.#renderHelpPlain(this.#buildHelpData());
+    }
+    #formatHelpForDisplay(params = {}) {
+        const { color = true } = params;
+        const helpData = this.#buildHelpData();
+        if (!this.#shouldRenderStyledHelp(color)) {
+            return this.#renderHelpPlain(helpData);
+        }
+        return this.#renderHelpTerminal(helpData);
+    }
+    #shouldRenderStyledHelp(color) {
+        return color && process.stdout.isTTY === true;
+    }
+    #buildHelpData() {
         const allOptions = this.#getMergedOptions();
-        lines.push(this.#desc);
-        lines.push('');
         const commandPath = this.#getCommandPath();
         let usage = `Usage: ${commandPath}`;
         if (allOptions.length > 0)
@@ -286,61 +446,122 @@ class Command {
                 usage += ` [${arg.name}...]`;
             }
         }
-        lines.push(usage);
+        const options = [];
+        for (const opt of allOptions) {
+            const kebabLong = camelToKebabCase$1(opt.long);
+            let sig = opt.short ? `-${opt.short}, ` : '    ';
+            sig += `--${kebabLong}`;
+            if (opt.args !== 'none') {
+                sig += ' <value>';
+            }
+            let desc = opt.desc;
+            if (opt.default !== undefined && opt.type !== 'boolean') {
+                desc += ` (default: ${JSON.stringify(opt.default)})`;
+            }
+            if (opt.choices) {
+                desc += ` [choices: ${opt.choices.join(', ')}]`;
+            }
+            options.push({ sig, desc });
+            if (opt.type === 'boolean' && opt.args === 'none') {
+                options.push({
+                    sig: `    --no-${kebabLong}`,
+                    desc: `Negate --${kebabLong}`,
+                });
+            }
+        }
+        const commands = [];
+        const showHelpSubcommand = this.#builtin.command.help && this.#subcommandsList.length > 0;
+        if (showHelpSubcommand) {
+            commands.push({ name: 'help', desc: 'Show help for a command' });
+        }
+        for (const entry of this.#subcommandsList) {
+            let name = entry.name;
+            if (entry.aliases.length > 0) {
+                name += `, ${entry.aliases.join(', ')}`;
+            }
+            commands.push({ name, desc: entry.command.#desc });
+        }
+        const examples = this.#examples.map(example => ({
+            title: example.title,
+            usage: commandPath ? `${commandPath} ${example.usage}` : example.usage,
+            desc: example.desc,
+        }));
+        return {
+            desc: this.#desc,
+            usage,
+            options,
+            commands,
+            examples,
+        };
+    }
+    #renderHelpPlain(helpData) {
+        const lines = [];
+        lines.push(helpData.desc);
         lines.push('');
-        if (allOptions.length > 0) {
+        lines.push(helpData.usage);
+        lines.push('');
+        if (helpData.options.length > 0) {
             lines.push('Options:');
-            const optLines = [];
-            for (const opt of allOptions) {
-                const kebabLong = camelToKebabCase$1(opt.long);
-                let sig = opt.short ? `-${opt.short}, ` : '    ';
-                sig += `--${kebabLong}`;
-                if (opt.args !== 'none') {
-                    sig += ' <value>';
-                }
-                let desc = opt.desc;
-                if (opt.default !== undefined && opt.type !== 'boolean') {
-                    desc += ` (default: ${JSON.stringify(opt.default)})`;
-                }
-                if (opt.choices) {
-                    desc += ` [choices: ${opt.choices.join(', ')}]`;
-                }
-                optLines.push({ sig, desc });
-                if (opt.type === 'boolean' && opt.args === 'none') {
-                    optLines.push({
-                        sig: `    --no-${kebabLong}`,
-                        desc: `Negate --${kebabLong}`,
-                    });
-                }
-            }
-            const maxSigLen = Math.max(...optLines.map(l => l.sig.length));
-            for (const { sig, desc } of optLines) {
+            const maxSigLen = Math.max(...helpData.options.map(line => line.sig.length));
+            for (const { sig, desc } of helpData.options) {
                 const padding = ' '.repeat(maxSigLen - sig.length + 2);
                 lines.push(`  ${sig}${padding}${desc}`);
             }
             lines.push('');
         }
-        const showHelpSubcommand = this.#helpSubcommandEnabled && this.#subcommandsList.length > 0;
-        if (this.#subcommandsList.length > 0) {
+        if (helpData.commands.length > 0) {
             lines.push('Commands:');
-            const cmdLines = [];
-            if (showHelpSubcommand) {
-                cmdLines.push({ name: 'help', desc: 'Show help for a command' });
-            }
-            for (const entry of this.#subcommandsList) {
-                let name = entry.name;
-                if (entry.aliases.length > 0) {
-                    name += `, ${entry.aliases.join(', ')}`;
-                }
-                cmdLines.push({ name, desc: entry.command.#desc });
-            }
-            const maxNameLen = Math.max(...cmdLines.map(l => l.name.length));
-            for (const { name, desc } of cmdLines) {
+            const maxNameLen = Math.max(...helpData.commands.map(line => line.name.length));
+            for (const { name, desc } of helpData.commands) {
                 const padding = ' '.repeat(maxNameLen - name.length + 2);
                 lines.push(`  ${name}${padding}${desc}`);
             }
             lines.push('');
         }
+        if (helpData.examples.length > 0) {
+            lines.push('Examples:');
+            for (const example of helpData.examples) {
+                lines.push(`  - ${example.title}`);
+                lines.push(`    ${example.usage}`);
+                lines.push(`    ${example.desc}`);
+                lines.push('');
+            }
+        }
+        return lines.join('\n');
+    }
+    #renderHelpTerminal(helpData) {
+        const lines = [];
+        lines.push(helpData.desc);
+        lines.push('');
+        lines.push(styleText(helpData.usage, TERMINAL_STYLE.bold));
+        lines.push('');
+        if (helpData.options.length > 0) {
+            lines.push(styleText('Options:', TERMINAL_STYLE.bold, TERMINAL_STYLE.underline));
+            const maxSigLen = Math.max(...helpData.options.map(line => line.sig.length));
+            for (const { sig, desc } of helpData.options) {
+                const padding = ' '.repeat(maxSigLen - sig.length + 2);
+                lines.push(`  ${styleText(sig, TERMINAL_STYLE.cyan)}${padding}${desc}`);
+            }
+            lines.push('');
+        }
+        if (helpData.commands.length > 0) {
+            lines.push(styleText('Commands:', TERMINAL_STYLE.bold, TERMINAL_STYLE.underline));
+            const maxNameLen = Math.max(...helpData.commands.map(line => line.name.length));
+            for (const { name, desc } of helpData.commands) {
+                const padding = ' '.repeat(maxNameLen - name.length + 2);
+                lines.push(`  ${styleText(name, TERMINAL_STYLE.cyan)}${padding}${desc}`);
+            }
+            lines.push('');
+        }
+        if (helpData.examples.length > 0) {
+            lines.push(styleText('Examples:', TERMINAL_STYLE.bold, TERMINAL_STYLE.underline));
+            for (const example of helpData.examples) {
+                lines.push(`  - ${styleText(example.title, TERMINAL_STYLE.bold)}`);
+                lines.push(`    ${styleText(example.usage, TERMINAL_STYLE.cyan)}`);
+                lines.push(`    ${styleText(example.desc, TERMINAL_STYLE.italic, TERMINAL_STYLE.dim)}`);
+                lines.push('');
+            }
+        }
         return lines.join('\n');
     }
     getCompletionMeta() {
@@ -371,7 +592,7 @@ class Command {
         };
     }
     #processHelpSubcommand(argv) {
-        if (!this.#helpSubcommandEnabled)
+        if (!this.#builtin.command.help)
             return argv;
         if (argv.length < 1 || argv[0] !== 'help')
             return argv;
@@ -504,7 +725,7 @@ class Command {
             const cmd = chain[i];
             const includeVersion = i === 0;
             const tokens = consumedTokens.get(cmd) ?? [];
-            const opts = cmd.#parseOptions(tokens, includeVersion);
+            const opts = cmd.#parseOptions(tokens, includeVersion, ctx.envs);
             optsMap.set(cmd, opts);
             for (const opt of cmd.#getMergedOptions(includeVersion)) {
                 if (opt.apply && opts[opt.long] !== undefined) {
@@ -520,9 +741,10 @@ class Command {
         const { args, rawArgs } = leafCommand.#parseArguments(rawArgStrings);
         return { ctx, opts: mergedOpts, args, rawArgs };
     }
-    #parseOptions(tokens, includeVersion) {
+    #parseOptions(tokens, includeVersion, envs) {
         const allOptions = this.#getMergedOptions(includeVersion);
         const opts = {};
+        let sawColorToken = false;
         for (const opt of allOptions) {
             if (opt.default !== undefined) {
                 opts[opt.long] = opt.default;
@@ -550,6 +772,9 @@ class Command {
                 i += 1;
                 continue;
             }
+            if (opt.long === 'color') {
+                sawColorToken = true;
+            }
             const isNegativeToken = token.original.toLowerCase().startsWith('--no-');
             if (isNegativeToken && !(opt.type === 'boolean' && opt.args === 'none')) {
                 throw new CommanderError('NegativeOptionType', `"--no-${camelToKebabCase$1(opt.long)}" can only be used with boolean options`, this.#getCommandPath());
@@ -626,6 +851,9 @@ class Command {
                 }
             }
         }
+        if (isNoColorEnabled(envs) && !sawColorToken && opts['color'] === true) {
+            opts['color'] = false;
+        }
         return opts;
     }
     #convertValue(opt, rawValue) {
@@ -698,14 +926,34 @@ class Command {
     }
     #getMergedOptions(includeVersion = !this.#parent) {
         const optionMap = new Map();
+        const hasUserColor = this.#options.some(o => o.long === 'color');
         const hasUserHelp = this.#options.some(o => o.long === 'help');
         const hasUserVersion = this.#options.some(o => o.long === 'version');
+        const hasUserLogLevel = this.#options.some(o => o.long === 'logLevel');
+        const hasUserSilent = this.#options.some(o => o.long === 'silent');
+        const hasUserLogDate = this.#options.some(o => o.long === 'logDate');
+        const hasUserLogColorful = this.#options.some(o => o.long === 'logColorful');
+        if (this.#builtin.option.color && !hasUserColor) {
+            optionMap.set('color', BUILTIN_COLOR_OPTION);
+        }
         if (!hasUserHelp) {
             optionMap.set('help', BUILTIN_HELP_OPTION);
         }
         if (!hasUserVersion && includeVersion) {
             optionMap.set('version', BUILTIN_VERSION_OPTION);
         }
+        if (this.#builtin.option.logLevel && !hasUserLogLevel) {
+            optionMap.set('logLevel', logLevelOption);
+        }
+        if (this.#builtin.option.silent && !hasUserSilent) {
+            optionMap.set('silent', silentOption);
+        }
+        if (this.#builtin.option.logDate && !hasUserLogDate) {
+            optionMap.set('logDate', logDateOption);
+        }
+        if (this.#builtin.option.logColorful && !hasUserLogColorful) {
+            optionMap.set('logColorful', logColorfulOption);
+        }
         for (const opt of this.#options) {
             optionMap.set(opt.long, opt);
         }
@@ -781,6 +1029,21 @@ class Command {
             }
         }
     }
+    #normalizeExample(example) {
+        const title = example.title.trim();
+        const usage = example.usage.trim();
+        const desc = example.desc.trim();
+        if (!title) {
+            throw new CommanderError('ConfigurationError', 'example title cannot be empty', this.#getCommandPath());
+        }
+        if (!usage) {
+            throw new CommanderError('ConfigurationError', 'example usage cannot be empty', this.#getCommandPath());
+        }
+        if (!desc) {
+            throw new CommanderError('ConfigurationError', 'example description cannot be empty', this.#getCommandPath());
+        }
+        return { title, usage, desc };
+    }
     async #runAction(params) {
         if (!this.#action)
             return;
@@ -797,6 +1060,34 @@ class Command {
             process.exit(1);
         }
     }
+    #resolveHelpColorOption(tokens, envs) {
+        const colorOption = this.#getMergedOptions().find(opt => opt.long === 'color');
+        let color = !isNoColorEnabled(envs);
+        if (!colorOption || colorOption.type !== 'boolean' || colorOption.args !== 'none') {
+            return color;
+        }
+        for (const token of tokens) {
+            if (token.type !== 'long' || token.name !== 'color') {
+                continue;
+            }
+            const eqIdx = token.resolved.indexOf('=');
+            if (eqIdx === -1) {
+                color = true;
+                continue;
+            }
+            const value = token.resolved.slice(eqIdx + 1);
+            if (value === 'true') {
+                color = true;
+            }
+            else if (value === 'false') {
+                color = false;
+            }
+            else {
+                throw new CommanderError('InvalidBooleanValue', `invalid value "${value}" for boolean option "--color". Use "true" or "false"`, this.#getCommandPath());
+            }
+        }
+        return color;
+    }
     #hasFlag(tokens, longName, shortName) {
         for (const token of tokens) {
             if (token.type === 'long' && token.name === longName) {
@@ -1179,30 +1470,4 @@ class PwshCompletion {
     }
 }
 
-const logLevelOption = {
-    long: 'logLevel',
-    type: 'string',
-    args: 'required',
-    desc: 'Set log level',
-    default: 'info',
-    choices: LOG_LEVELS,
-    coerce: (raw) => {
-        const level = resolveLogLevel(raw);
-        if (level === undefined) {
-            throw new Error(`Invalid log level: ${raw}`);
-        }
-        return level;
-    },
-    apply: (value, ctx) => {
-        ctx.reporter.setLevel(value);
-    },
-};
-const silentOption = {
-    long: 'silent',
-    type: 'boolean',
-    args: 'none',
-    desc: 'Suppress non-error output',
-    default: false,
-};
-
-export { BashCompletion, Command, CommanderError, CompletionCommand, FishCompletion, PwshCompletion, logLevelOption, silentOption };
+export { BashCompletion, Command, CommanderError, CompletionCommand, FishCompletion, PwshCompletion, logColorfulOption, logDateOption, logLevelOption, silentOption };

package/lib/types/index.d.ts

@@ -92,6 +92,37 @@ interface ICommandArgumentConfig<T = unknown> {
     /** Custom value transformation (takes precedence over type conversion) */
     coerce?: (rawValue: string) => T;
 }
+interface ICommandBuiltinOptionConfig {
+    /** Enable built-in --color/--no-color option for help rendering (defaults respect NO_COLOR) */
+    color?: boolean;
+    /** Enable built-in --log-level option */
+    logLevel?: boolean;
+    /** Enable built-in --silent option */
+    silent?: boolean;
+    /** Enable built-in --log-date/--no-log-date option */
+    logDate?: boolean;
+    /** Enable built-in --log-colorful/--no-log-colorful option */
+    logColorful?: boolean;
+}
+interface ICommandBuiltinCommandConfig {
+    /** Enable built-in help subcommand */
+    help?: boolean;
+}
+interface ICommandBuiltinConfig {
+    /** Built-in options configuration */
+    option?: boolean | ICommandBuiltinOptionConfig;
+    /** Built-in command configuration */
+    command?: boolean | ICommandBuiltinCommandConfig;
+}
+/** Command example configuration */
+interface ICommandExample {
+    /** Example title */
+    title: string;
+    /** Usage fragment relative to command path */
+    usage: string;
+    /** Example description */
+    desc: string;
+}
 /** Command configuration */
 interface ICommandConfig {
     /** Command name (only for root command) */
@@ -100,8 +131,8 @@ interface ICommandConfig {
     desc: string;
     /** Version (for root --version) */
     version?: string;
-    /** Enable built-in "help" subcommand */
-    help?: boolean;
+    /** Built-in features configuration */
+    builtin?: boolean | ICommandBuiltinConfig;
     /** Default reporter for this command */
     reporter?: IReporter;
 }
@@ -113,6 +144,7 @@ interface ICommand {
     readonly parent: ICommand | undefined;
     readonly options: ICommandOptionConfig[];
     readonly arguments: ICommandArgumentConfig[];
+    readonly examples: ICommandExample[];
     readonly subcommands: Map<string, ICommand>;
 }
 /** Execution context */
@@ -263,10 +295,12 @@ declare class Command implements ICommand {
     get parent(): Command | undefined;
     get options(): ICommandOptionConfig[];
     get arguments(): ICommandArgumentConfig[];
+    get examples(): ICommandExample[];
     get subcommands(): Map<string, ICommand>;
     option<T>(opt: ICommandOptionConfig<T>): this;
     argument<T>(arg: ICommandArgumentConfig<T>): this;
     action(fn: ICommandAction): this;
+    example(title: string, usage: string, desc: string): this;
     subcommand(name: string, cmd: Command): this;
     run(params: ICommandRunParams): Promise<void>;
     parse(params: ICommandRunParams): ICommandParseResult;
@@ -355,6 +389,28 @@ declare class PwshCompletion {
  * ```
  */
 declare const logLevelOption: ICommandOptionConfig<string>;
+/**
+ * Pre-defined --log-date option for controlling timestamp output.
+ *
+ * | Property  | Value     |
+ * | --------- | --------- |
+ * | long      | 'logDate' |
+ * | type      | 'boolean' |
+ * | args      | 'none'    |
+ * | default   | true      |
+ */
+declare const logDateOption: ICommandOptionConfig<boolean>;
+/**
+ * Pre-defined --log-colorful option for controlling colorful output.
+ *
+ * | Property  | Value         |
+ * | --------- | ------------- |
+ * | long      | 'logColorful' |
+ * | type      | 'boolean'     |
+ * | args      | 'none'        |
+ * | default   | true          |
+ */
+declare const logColorfulOption: ICommandOptionConfig<boolean>;
 /**
  * Pre-defined --silent option for suppressing non-error output.
  *
@@ -380,5 +436,5 @@ declare const logLevelOption: ICommandOptionConfig<string>;
  */
 declare const silentOption: ICommandOptionConfig<boolean>;
 
-export { BashCompletion, Command, CommanderError, CompletionCommand, FishCompletion, PwshCompletion, logLevelOption, silentOption };
-export type { ICommand, ICommandAction, ICommandActionParams, ICommandArgumentConfig, ICommandArgumentKind, ICommandArgumentType, ICommandConfig, ICommandContext, ICommandOptionArgs, ICommandOptionConfig, ICommandOptionType, ICommandParseResult, ICommandParsedArgs, ICommandParsedOpts, ICommandResolveResult, ICommandRouteResult, ICommandRunParams, ICommandShiftResult, ICommandToken, ICommandTokenType, ICommandTokenizeResult, ICommanderErrorKind, ICompletionCommandConfig, ICompletionMeta, ICompletionOptionMeta, ICompletionPaths, ICompletionShellType };
+export { BashCompletion, Command, CommanderError, CompletionCommand, FishCompletion, PwshCompletion, logColorfulOption, logDateOption, logLevelOption, silentOption };
+export type { ICommand, ICommandAction, ICommandActionParams, ICommandArgumentConfig, ICommandArgumentKind, ICommandArgumentType, ICommandBuiltinCommandConfig, ICommandBuiltinConfig, ICommandBuiltinOptionConfig, ICommandConfig, ICommandContext, ICommandExample, ICommandOptionArgs, ICommandOptionConfig, ICommandOptionType, ICommandParseResult, ICommandParsedArgs, ICommandParsedOpts, ICommandResolveResult, ICommandRouteResult, ICommandRunParams, ICommandShiftResult, ICommandToken, ICommandTokenType, ICommandTokenizeResult, ICommanderErrorKind, ICompletionCommandConfig, ICompletionMeta, ICompletionOptionMeta, ICompletionPaths, ICompletionShellType };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guanghechen/commander",
-  "version": "4.1.0",
+  "version": "4.3.0",
   "description": "A minimal, type-safe command-line interface builder with fluent API",
   "author": {
     "name": "guanghechen",
@@ -41,7 +41,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@guanghechen/reporter": "^3.2.0"
+    "@guanghechen/reporter": "^3.3.0"
   },
   "scripts": {
     "build": "rollup -c ../../rollup.config.mjs",