@oclif/core 3.0.0-beta.9 → 3.0.0

package/lib/errors/handle.js

@@ -1,40 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.handle = exports.Exit = void 0;
+const tslib_1 = require("tslib");
 /* eslint-disable no-process-exit */
-/* eslint-disable unicorn/no-process-exit */
+const clean_stack_1 = tslib_1.__importDefault(require("clean-stack"));
 const config_1 = require("./config");
-const pretty_print_1 = require("./errors/pretty-print");
-const _1 = require(".");
-const clean = require("clean-stack");
 const cli_1 = require("./errors/cli");
+const exit_1 = require("./errors/exit");
+const pretty_print_1 = tslib_1.__importDefault(require("./errors/pretty-print"));
+/**
+ * This is an odd abstraction for process.exit, but it allows us to stub it in tests.
+ *
+ * https://github.com/sinonjs/sinon/issues/562
+ */
+exports.Exit = {
+    exit(code = 0) {
+        process.exit(code);
+    },
+};
 async function handle(err) {
     try {
         if (!err)
             err = new cli_1.CLIError('no error?');
         if (err.message === 'SIGINT')
-            process.exit(1);
-        const shouldPrint = !(err instanceof _1.ExitError) && !err.skipOclifErrorHandling;
+            exports.Exit.exit(1);
+        const shouldPrint = !(err instanceof exit_1.ExitError) && !err.skipOclifErrorHandling;
         const pretty = (0, pretty_print_1.default)(err);
-        const stack = clean(err.stack || '', { pretty: true });
+        const stack = (0, clean_stack_1.default)(err.stack || '', { pretty: true });
         if (shouldPrint) {
-            console.error(pretty ? pretty : stack);
+            console.error(pretty ?? stack);
         }
-        const exitCode = err.oclif?.exit !== undefined && err.oclif?.exit !== false ? err.oclif?.exit : 1;
+        const exitCode = err.oclif?.exit ?? 1;
         if (config_1.config.errorLogger && err.code !== 'EEXIT') {
             if (stack) {
                 config_1.config.errorLogger.log(stack);
             }
-            await config_1.config.errorLogger.flush()
-                .then(() => process.exit(exitCode))
+            await config_1.config.errorLogger
+                .flush()
+                .then(() => exports.Exit.exit(exitCode))
                 .catch(console.error);
         }
         else
-            process.exit(exitCode);
+            exports.Exit.exit(exitCode);
     }
     catch (error) {
         console.error(err.stack);
         console.error(error.stack);
-        process.exit(1);
+        exports.Exit.exit(1);
     }
 }
-exports.default = handle;
+exports.handle = handle;

package/lib/errors/index.d.ts

@@ -1,17 +1,17 @@
-export { default as handle } from './handle';
+import { PrettyPrintableError } from '../interfaces';
+export { PrettyPrintableError } from '../interfaces';
+export { config } from './config';
+export { CLIError } from './errors/cli';
 export { ExitError } from './errors/exit';
 export { ModuleLoadError } from './errors/module-load';
-export { CLIError } from './errors/cli';
-export { Logger } from './logger';
-export { config } from './config';
-import { PrettyPrintableError } from '../interfaces';
-export { PrettyPrintableError };
+export { handle } from './handle';
 export declare function exit(code?: number): never;
-export declare function error(input: string | Error, options: {
+export declare function error(input: Error | string, options: {
     exit: false;
 } & PrettyPrintableError): void;
-export declare function error(input: string | Error, options?: {
+export declare function error(input: Error | string, options?: {
     exit?: number;
 } & PrettyPrintableError): never;
-export declare function warn(input: string | Error): void;
-export declare function memoizedWarn(input: string | Error): void;
+export declare function warn(input: Error | string): void;
+export declare function memoizedWarn(input: Error | string): void;
+export { Logger } from './logger';

package/lib/errors/index.js

@@ -1,33 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.memoizedWarn = exports.warn = exports.error = exports.exit = exports.config = exports.Logger = exports.CLIError = exports.ModuleLoadError = exports.ExitError = exports.handle = void 0;
-var handle_1 = require("./handle");
-Object.defineProperty(exports, "handle", { enumerable: true, get: function () { return handle_1.default; } });
-var exit_1 = require("./errors/exit");
-Object.defineProperty(exports, "ExitError", { enumerable: true, get: function () { return exit_1.ExitError; } });
+exports.Logger = exports.memoizedWarn = exports.warn = exports.error = exports.exit = exports.handle = exports.ModuleLoadError = exports.ExitError = exports.CLIError = exports.config = void 0;
+const tslib_1 = require("tslib");
+const config_1 = require("./config");
+const cli_1 = require("./errors/cli");
+const exit_1 = require("./errors/exit");
+const pretty_print_1 = tslib_1.__importStar(require("./errors/pretty-print"));
+var config_2 = require("./config");
+Object.defineProperty(exports, "config", { enumerable: true, get: function () { return config_2.config; } });
+var cli_2 = require("./errors/cli");
+Object.defineProperty(exports, "CLIError", { enumerable: true, get: function () { return cli_2.CLIError; } });
+var exit_2 = require("./errors/exit");
+Object.defineProperty(exports, "ExitError", { enumerable: true, get: function () { return exit_2.ExitError; } });
 var module_load_1 = require("./errors/module-load");
 Object.defineProperty(exports, "ModuleLoadError", { enumerable: true, get: function () { return module_load_1.ModuleLoadError; } });
-var cli_1 = require("./errors/cli");
-Object.defineProperty(exports, "CLIError", { enumerable: true, get: function () { return cli_1.CLIError; } });
-var logger_1 = require("./logger");
-Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
-var config_1 = require("./config");
-Object.defineProperty(exports, "config", { enumerable: true, get: function () { return config_1.config; } });
-const config_2 = require("./config");
-const cli_2 = require("./errors/cli");
-const exit_2 = require("./errors/exit");
-const pretty_print_1 = require("./errors/pretty-print");
+var handle_1 = require("./handle");
+Object.defineProperty(exports, "handle", { enumerable: true, get: function () { return handle_1.handle; } });
 function exit(code = 0) {
-    throw new exit_2.ExitError(code);
+    throw new exit_1.ExitError(code);
 }
 exports.exit = exit;
 function error(input, options = {}) {
     let err;
     if (typeof input === 'string') {
-        err = new cli_2.CLIError(input, options);
+        err = new cli_1.CLIError(input, options);
     }
     else if (input instanceof Error) {
-        err = (0, cli_2.addOclifExitCode)(input, options);
+        err = (0, cli_1.addOclifExitCode)(input, options);
     }
     else {
         throw new TypeError('first argument must be a string or instance of Error');
@@ -36,8 +35,8 @@ function error(input, options = {}) {
     if (options.exit === false) {
         const message = (0, pretty_print_1.default)(err);
         console.error(message);
-        if (config_2.config.errorLogger)
-            config_2.config.errorLogger.log(err?.stack ?? '');
+        if (config_1.config.errorLogger)
+            config_1.config.errorLogger.log(err?.stack ?? '');
     }
     else
         throw err;
@@ -46,18 +45,18 @@ exports.error = error;
 function warn(input) {
     let err;
     if (typeof input === 'string') {
-        err = new cli_2.CLIError.Warn(input);
+        err = new cli_1.CLIError.Warn(input);
     }
     else if (input instanceof Error) {
-        err = (0, cli_2.addOclifExitCode)(input);
+        err = (0, cli_1.addOclifExitCode)(input);
     }
     else {
         throw new TypeError('first argument must be a string or instance of Error');
     }
     const message = (0, pretty_print_1.default)(err);
     console.error(message);
-    if (config_2.config.errorLogger)
-        config_2.config.errorLogger.log(err?.stack ?? '');
+    if (config_1.config.errorLogger)
+        config_1.config.errorLogger.log(err?.stack ?? '');
 }
 exports.warn = warn;
 const WARNINGS = new Set();
@@ -67,3 +66,5 @@ function memoizedWarn(input) {
     WARNINGS.add(input);
 }
 exports.memoizedWarn = memoizedWarn;
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });

package/lib/errors/logger.d.ts

@@ -1,8 +1,8 @@
 export declare class Logger {
     file: string;
-    protected flushing: Promise<void>;
     protected buffer: string[];
+    protected flushing: Promise<void>;
     constructor(file: string);
-    log(msg: string): void;
     flush(waitForMs?: number): Promise<void>;
+    log(msg: string): void;
 }

package/lib/errors/logger.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = void 0;
-const fs = require("fs/promises");
-const path_1 = require("path");
+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 => {
+const wait = (ms) => new Promise((resolve) => {
     if (timer)
         timer.unref();
     timer = setTimeout(() => resolve(null), ms);
@@ -17,16 +17,11 @@ function chomp(s) {
     return s;
 }
 class Logger {
+    file;
+    buffer = [];
+    flushing = Promise.resolve();
     constructor(file) {
         this.file = file;
-        this.flushing = Promise.resolve();
-        this.buffer = [];
-    }
-    log(msg) {
-        msg = stripAnsi(chomp(msg));
-        const lines = msg.split('\n').map(l => `${timestamp()} ${l}`.trimEnd());
-        this.buffer.push(...lines);
-        this.flush(50).catch(console.error);
     }
     async flush(waitForMs = 0) {
         await wait(waitForMs);
@@ -35,10 +30,16 @@ class Logger {
                 return;
             const mylines = this.buffer;
             this.buffer = [];
-            await fs.mkdir((0, path_1.dirname)(this.file), { recursive: true });
-            await fs.appendFile(this.file, mylines.join('\n') + '\n');
+            await (0, promises_1.mkdir)((0, node_path_1.dirname)(this.file), { recursive: true });
+            await (0, promises_1.appendFile)(this.file, mylines.join('\n') + '\n');
         });
         await this.flushing;
     }
+    log(msg) {
+        msg = stripAnsi(chomp(msg));
+        const lines = msg.split('\n').map((l) => `${timestamp()} ${l}`.trimEnd());
+        this.buffer.push(...lines);
+        this.flush(50).catch(console.error);
+    }
 }
 exports.Logger = Logger;

package/lib/execute.d.ts

@@ -1,4 +1,4 @@
-import * as Interfaces from './interfaces';
+import { LoadOptions } from './interfaces';
 /**
  * Load and run oclif CLI
  *
@@ -7,7 +7,7 @@ import * as Interfaces from './interfaces';
  *
  * @example For ESM dev.js
  * ```
- * #!/usr/bin/env node
+ * #!/usr/bin/env ts-node
  * void (async () => {
  *   const oclif = await import('@oclif/core')
  *   await oclif.execute({development: true, dir: import.meta.url})
@@ -25,7 +25,7 @@ import * as Interfaces from './interfaces';
  *
  * @example For CJS dev.js
  * ```
- * #!/usr/bin/env node
+ * #!/usr/bin/env ts-node
  * void (async () => {
  *   const oclif = await import('@oclif/core')
  *   await oclif.execute({development: true, dir: __dirname})
@@ -41,9 +41,9 @@ import * as Interfaces from './interfaces';
  * })()
  * ```
  */
-export default function execute(options: {
-    dir: string;
+export declare function execute(options: {
     args?: string[];
-    loadOptions?: Interfaces.LoadOptions;
     development?: boolean;
+    dir: string;
+    loadOptions?: LoadOptions;
 }): Promise<unknown>;

package/lib/execute.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const settings_1 = require("./settings");
-const flush_1 = require("./ux/flush");
+exports.execute = void 0;
+const flush_1 = require("./cli-ux/flush");
 const handle_1 = require("./errors/handle");
 const main_1 = require("./main");
+const settings_1 = require("./settings");
 /**
  * Load and run oclif CLI
  *
@@ -12,7 +13,7 @@ const main_1 = require("./main");
  *
  * @example For ESM dev.js
  * ```
- * #!/usr/bin/env node
+ * #!/usr/bin/env ts-node
  * void (async () => {
  *   const oclif = await import('@oclif/core')
  *   await oclif.execute({development: true, dir: import.meta.url})
@@ -30,7 +31,7 @@ const main_1 = require("./main");
  *
  * @example For CJS dev.js
  * ```
- * #!/usr/bin/env node
+ * #!/usr/bin/env ts-node
  * void (async () => {
  *   const oclif = await import('@oclif/core')
  *   await oclif.execute({development: true, dir: __dirname})
@@ -50,13 +51,13 @@ async function execute(options) {
     if (options.development) {
         // In dev mode -> use ts-node and dev plugins
         process.env.NODE_ENV = 'development';
-        settings_1.default.debug = true;
+        settings_1.settings.debug = true;
     }
-    return (0, main_1.default)(options.args ?? process.argv.slice(2), options.loadOptions ?? options.dir)
+    return (0, main_1.run)(options.args ?? process.argv.slice(2), options.loadOptions ?? options.dir)
         .then(async (result) => {
-        (0, flush_1.default)();
+        (0, flush_1.flush)();
         return result;
     })
-        .catch(async (error) => (0, handle_1.default)(error));
+        .catch(async (error) => (0, handle_1.handle)(error));
 }
-exports.default = execute;
+exports.execute = execute;

package/lib/flags.d.ts

@@ -1,49 +1,120 @@
 /// <reference types="node" />
-import { URL } from 'url';
-import { BooleanFlag } from './interfaces';
-import { FlagDefinition, OptionFlagDefaults, FlagParser } from './interfaces/parser';
-/**
- * Create a custom flag.
- *
- * @example
- * type Id = string
- * type IdOpts = { startsWith: string; length: number };
- *
- * export const myFlag = custom<Id, IdOpts>({
- *   parse: async (input, opts) => {
- *     if (input.startsWith(opts.startsWith) && input.length === opts.length) {
- *       return input
- *     }
- *
- *     throw new Error('Invalid id')
- *   },
- * })
- */
-export declare function custom<T, P = Record<string, unknown>>(defaults: {
-    parse: FlagParser<T, string, P>;
-    multiple: true;
-} & Partial<OptionFlagDefaults<T, P, true>>): FlagDefinition<T, P>;
-export declare function custom<T, P = Record<string, unknown>>(defaults: {
-    parse: FlagParser<T, string, P>;
-} & Partial<OptionFlagDefaults<T, P>>): FlagDefinition<T, P>;
-export declare function custom<T = string, P = Record<string, unknown>>(defaults: Partial<OptionFlagDefaults<T, P>>): FlagDefinition<T, P>;
+import { URL } from 'node:url';
+import { BooleanFlag, CustomOptions, FlagDefinition, OptionFlag } from './interfaces';
+type NotArray<T> = T extends Array<any> ? never : T;
+export declare function custom<T = string, P extends CustomOptions = CustomOptions>(defaults: Partial<OptionFlag<T[], P>> & {
+    multiple: true;
+} & ({
+    default: OptionFlag<T[], P>['default'];
+} | {
+    required: true;
+})): FlagDefinition<T, P, {
+    multiple: true;
+    requiredOrDefaulted: true;
+}>;
+export declare function custom<T = string, P extends CustomOptions = CustomOptions>(defaults: Partial<OptionFlag<NotArray<T>, P>> & {
+    multiple?: false | undefined;
+} & ({
+    default: OptionFlag<NotArray<T>, P>['default'];
+} | {
+    required: true;
+})): FlagDefinition<T, P, {
+    multiple: false;
+    requiredOrDefaulted: true;
+}>;
+export declare function custom<T = string, P extends CustomOptions = CustomOptions>(defaults: Partial<OptionFlag<NotArray<T>, P>> & {
+    default?: OptionFlag<NotArray<T>, P>['default'] | undefined;
+    multiple?: false | undefined;
+    required?: false | undefined;
+}): FlagDefinition<T, P, {
+    multiple: false;
+    requiredOrDefaulted: false;
+}>;
+export declare function custom<T = string, P extends CustomOptions = CustomOptions>(defaults: Partial<OptionFlag<T[], P>> & {
+    default?: OptionFlag<T[], P>['default'] | undefined;
+    multiple: true;
+    required?: false | undefined;
+}): FlagDefinition<T, P, {
+    multiple: true;
+    requiredOrDefaulted: false;
+}>;
+export declare function custom<T = string, P extends CustomOptions = CustomOptions>(): FlagDefinition<T, P, {
+    multiple: false;
+    requiredOrDefaulted: false;
+}>;
 export declare function boolean<T = boolean>(options?: Partial<BooleanFlag<T>>): BooleanFlag<T>;
 export declare const integer: FlagDefinition<number, {
-    min?: number | undefined;
     max?: number | undefined;
+    min?: number | undefined;
+}, {
+    multiple: false;
+    requiredOrDefaulted: false;
 }>;
 export declare const directory: FlagDefinition<string, {
     exists?: boolean | undefined;
+}, {
+    multiple: false;
+    requiredOrDefaulted: false;
 }>;
 export declare const file: FlagDefinition<string, {
     exists?: boolean | undefined;
+}, {
+    multiple: false;
+    requiredOrDefaulted: false;
 }>;
 /**
  * Initializes a string as a URL. Throws an error
  * if the string is not a valid URL.
  */
-export declare const url: FlagDefinition<URL, Record<string, unknown>>;
-declare const stringFlag: FlagDefinition<string, Record<string, unknown>>;
-export { stringFlag as string };
+export declare const url: FlagDefinition<URL, CustomOptions, {
+    multiple: false;
+    requiredOrDefaulted: false;
+}>;
+export declare const string: FlagDefinition<string, CustomOptions, {
+    multiple: false;
+    requiredOrDefaulted: false;
+}>;
 export declare const version: (opts?: Partial<BooleanFlag<boolean>>) => BooleanFlag<void>;
 export declare const help: (opts?: Partial<BooleanFlag<boolean>>) => BooleanFlag<void>;
+type ElementType<T extends ReadonlyArray<unknown>> = T[number];
+export declare function option<T extends readonly string[], P extends CustomOptions>(defaults: Partial<OptionFlag<ElementType<T>[], P>> & {
+    multiple: true;
+    options: T;
+} & ({
+    default: OptionFlag<ElementType<T>[], P>['default'] | undefined;
+} | {
+    required: true;
+})): FlagDefinition<(typeof defaults.options)[number], P, {
+    multiple: true;
+    requiredOrDefaulted: true;
+}>;
+export declare function option<T extends readonly string[], P extends CustomOptions>(defaults: Partial<OptionFlag<ElementType<T>, P>> & {
+    multiple?: false | undefined;
+    options: T;
+} & ({
+    default: OptionFlag<ElementType<T>, P>['default'];
+} | {
+    required: true;
+})): FlagDefinition<(typeof defaults.options)[number], P, {
+    multiple: false;
+    requiredOrDefaulted: true;
+}>;
+export declare function option<T extends readonly string[], P extends CustomOptions>(defaults: Partial<OptionFlag<ElementType<T>, P>> & {
+    default?: OptionFlag<ElementType<T>, P>['default'] | undefined;
+    multiple?: false | undefined;
+    options: T;
+    required?: false | undefined;
+}): FlagDefinition<(typeof defaults.options)[number], P, {
+    multiple: false;
+    requiredOrDefaulted: false;
+}>;
+export declare function option<T extends readonly string[], P extends CustomOptions>(defaults: Partial<OptionFlag<ElementType<T>[], P>> & {
+    default?: OptionFlag<ElementType<T>[], P>['default'] | undefined;
+    multiple: true;
+    options: T;
+    required?: false | undefined;
+}): FlagDefinition<(typeof defaults.options)[number], P, {
+    multiple: true;
+    requiredOrDefaulted: false;
+}>;
+export {};

package/lib/flags.js

@@ -1,21 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.help = exports.version = exports.string = exports.url = exports.file = exports.directory = exports.integer = exports.boolean = exports.custom = void 0;
-const url_1 = require("url");
-const help_1 = require("./help");
-const util_1 = require("./util");
+exports.option = exports.help = exports.version = exports.string = exports.url = exports.file = exports.directory = exports.integer = exports.boolean = exports.custom = void 0;
+/* eslint-disable valid-jsdoc */
+const node_url_1 = require("node:url");
 const errors_1 = require("./errors");
+const help_1 = require("./help");
+const fs_1 = require("./util/fs");
+/**
+ * Create a custom flag.
+ *
+ * @example
+ * type Id = string
+ * type IdOpts = { startsWith: string; length: number };
+ *
+ * export const myFlag = custom<Id, IdOpts>({
+ *   parse: async (input, opts) => {
+ *     if (input.startsWith(opts.startsWith) && input.length === opts.length) {
+ *       return input
+ *     }
+ *
+ *     throw new Error('Invalid id')
+ *   },
+ * })
+ */
 function custom(defaults) {
-    return (options = {}) => {
-        return {
-            parse: async (input, _ctx, _opts) => input,
-            ...defaults,
-            ...options,
-            input: [],
-            multiple: Boolean(options.multiple === undefined ? defaults.multiple : options.multiple),
-            type: 'option',
-        };
-    };
+    return (options = {}) => ({
+        parse: async (input, _ctx, _opts) => input,
+        ...defaults,
+        ...options,
+        input: [],
+        multiple: Boolean(options.multiple === undefined ? defaults?.multiple ?? false : options.multiple),
+        type: 'option',
+    });
 }
 exports.custom = custom;
 function boolean(options = {}) {
@@ -28,7 +44,7 @@ function boolean(options = {}) {
 }
 exports.boolean = boolean;
 exports.integer = custom({
-    parse: async (input, _, opts) => {
+    async parse(input, _, opts) {
         if (!/^-?\d+$/.test(input))
             throw new errors_1.CLIError(`Expected an integer but received: ${input}`);
         const num = Number.parseInt(input, 10);
@@ -40,16 +56,16 @@ exports.integer = custom({
     },
 });
 exports.directory = custom({
-    parse: async (input, _, opts) => {
+    async parse(input, _, opts) {
         if (opts.exists)
-            return (0, util_1.dirExists)(input);
+            return (0, fs_1.dirExists)(input);
         return input;
     },
 });
 exports.file = custom({
-    parse: async (input, _, opts) => {
+    async parse(input, _, opts) {
         if (opts.exists)
-            return (0, util_1.fileExists)(input);
+            return (0, fs_1.fileExists)(input);
         return input;
     },
 });
@@ -58,37 +74,55 @@ exports.file = custom({
  * if the string is not a valid URL.
  */
 exports.url = custom({
-    parse: async (input) => {
+    async parse(input) {
         try {
-            return new url_1.URL(input);
+            return new node_url_1.URL(input);
         }
         catch {
-            throw new Error(`Expected a valid url but received: ${input}`);
+            throw new errors_1.CLIError(`Expected a valid url but received: ${input}`);
         }
     },
 });
-const stringFlag = custom({});
-exports.string = stringFlag;
-const version = (opts = {}) => {
-    return boolean({
-        description: 'Show CLI version.',
-        ...opts,
-        parse: async (_, ctx) => {
-            ctx.log(ctx.config.userAgent);
-            ctx.exit(0);
-        },
-    });
-};
+exports.string = custom();
+const version = (opts = {}) => boolean({
+    description: 'Show CLI version.',
+    ...opts,
+    async parse(_, ctx) {
+        ctx.log(ctx.config.userAgent);
+        ctx.exit(0);
+    },
+});
 exports.version = version;
-const help = (opts = {}) => {
-    return boolean({
-        description: 'Show CLI help.',
-        ...opts,
-        parse: async (_, cmd) => {
-            const Help = await (0, help_1.loadHelpClass)(cmd.config);
-            await new Help(cmd.config, cmd.config.pjson.helpOptions).showHelp(cmd.id ? [cmd.id, ...cmd.argv] : cmd.argv);
-            cmd.exit(0);
-        },
-    });
-};
+const help = (opts = {}) => boolean({
+    description: 'Show CLI help.',
+    ...opts,
+    async parse(_, cmd) {
+        const Help = await (0, help_1.loadHelpClass)(cmd.config);
+        await new Help(cmd.config, cmd.config.pjson.helpOptions).showHelp(cmd.id ? [cmd.id, ...cmd.argv] : cmd.argv);
+        cmd.exit(0);
+    },
+});
 exports.help = help;
+/**
+ * Create a custom flag that infers the flag type from the provided options.
+ *
+ * @example
+ * export default class MyCommand extends Command {
+ *   static flags = {
+ *     name: Flags.option({
+ *       options: ['foo', 'bar'] as const,
+ *     })(),
+ *   }
+ * }
+ */
+function option(defaults) {
+    return (options = {}) => ({
+        parse: async (input, _ctx, _opts) => input,
+        ...defaults,
+        ...options,
+        input: [],
+        multiple: Boolean(options.multiple === undefined ? defaults.multiple : options.multiple),
+        type: 'option',
+    });
+}
+exports.option = option;