@wooksjs/event-cli 0.4.9 → 0.4.11

package/dist/index.mjs

@@ -3,438 +3,411 @@ import { WooksAdapterBase } from 'wooks';
 import { CliHelpRenderer } from '@prostojs/cli-help';
 import minimist from 'minimist';
 
-function createCliContext(data, options) {
-    return createEventContext({
-        event: Object.assign(Object.assign({}, data), { type: 'CLI' }),
-        options,
-    });
-}
-/**
- * Wrapper on top of useEventContext that provides
- * proper context types for CLI event
- * @returns set of hooks { getCtx, restoreCtx, clearCtx, hookStore, getStore, setStore }
- */
-function useCliContext() {
-    return useEventContext('CLI');
+function createCliContext(data, options) {
+    return createEventContext({
+        event: {
+            ...data,
+            type: 'CLI',
+        },
+        options,
+    });
 }
-
-/******************************************************************************
-Copyright (c) Microsoft Corporation.
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-PERFORMANCE OF THIS SOFTWARE.
-***************************************************************************** */
-
-function __awaiter(thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
+/**
+ * Wrapper on top of useEventContext that provides
+ * proper context types for CLI event
+ * @returns set of hooks { getCtx, restoreCtx, clearCtx, hookStore, getStore, setStore }
+ */
+function useCliContext() {
+    return useEventContext('CLI');
 }
 
-const cliShortcuts = {
-    cli: 'CLI',
-};
-class WooksCli extends WooksAdapterBase {
-    constructor(opts, wooks) {
-        super(wooks, opts === null || opts === void 0 ? void 0 : opts.logger, opts === null || opts === void 0 ? void 0 : opts.router);
-        this.opts = opts;
-        this.alreadyComputedAliases = false;
-        this.logger = (opts === null || opts === void 0 ? void 0 : opts.logger) || this.getLogger('wooks-cli');
-        this.cliHelp =
-            (opts === null || opts === void 0 ? void 0 : opts.cliHelp) instanceof CliHelpRenderer
-                ? opts.cliHelp
-                : new CliHelpRenderer(opts === null || opts === void 0 ? void 0 : opts.cliHelp);
-    }
-    /**
-     * ### Register CLI Command
-     * Command path segments may be separated by / or space.
-     *
-     * For example the folowing path are interpreted the same:
-     * - "command test use:dev :name"
-     * - "command/test/use:dev/:name"
-     *
-     * Where name will become an argument
-     *
-     * ```js
-     * // example without options
-     * app.cli('command/:arg', () => 'arg = ' + useRouteParams().params.arg )
-     *
-     * // example with options
-     * app.cli('command/:arg', {
-     *   description: 'Description of the command',
-     *   options: [{ keys: ['project', 'p'], description: 'Description of the option', value: 'myProject' }],
-     *   args: { arg: 'Description of the arg' },
-     *   aliases: ['cmd'],  // alias "cmd/:arg" will be registered
-     *   examples: [{
-     *      description: 'Example of usage with someProject',
-     *      cmd: 'argValue -p=someProject',
-     *      // will result in help display:
-     *      // "# Example of usage with someProject\n" +
-     *      // "$ myCli command argValue -p=someProject\n"
-     *   }],
-     *   handler: () => 'arg = ' + useRouteParams().params.arg
-     * })
-     * ```
-     *
-     * @param path command path
-     * @param _options handler or options
-     *
-     * @returns
-     */
-    cli(path, _options) {
-        var _a;
-        const options = typeof _options === 'function' ? { handler: _options } : _options;
-        const handler = typeof _options === 'function' ? _options : _options.handler;
-        const makePath = (s) => '/' + s.replace(/\s+/g, '/');
-        // register handler
-        const targetPath = makePath(path);
-        const routed = this.on('CLI', targetPath, handler);
-        if (options.onRegister) {
-            options.onRegister(targetPath, 0, routed);
-        }
-        // register direct aliases
-        for (const alias of options.aliases || []) {
-            const vars = routed.getArgs().map((k) => ':' + k).join('/');
-            const targetPath = makePath(alias) + (vars ? '/' + vars : '');
-            this.on('CLI', targetPath, handler);
-            if (options.onRegister) {
-                options.onRegister(targetPath, 1, routed);
-            }
-        }
-        // register helpCli entry
-        const command = routed.getStaticPart().replace(/\//g, ' ').trim();
-        const args = Object.assign({}, (options.args || {}));
-        for (const arg of routed.getArgs()) {
-            if (!args[arg]) {
-                args[arg] = '';
-            }
-        }
-        this.cliHelp.addEntry({
-            command,
-            aliases: (_a = options.aliases) === null || _a === void 0 ? void 0 : _a.map(alias => alias.replace(/\\:/g, ':')),
-            args,
-            description: options.description,
-            examples: options.examples,
-            options: options.options,
-            custom: { handler: options.handler, cb: options.onRegister },
-        });
-        return routed;
-    }
-    computeAliases() {
-        if (!this.alreadyComputedAliases) {
-            this.alreadyComputedAliases = true;
-            const aliases = this.cliHelp.getComputedAliases();
-            for (const [alias, entry] of Object.entries(aliases)) {
-                if (entry.custom) {
-                    const vars = Object.keys(entry.args || {})
-                        .map((k) => ':' + k)
-                        .join('/');
-                    const path = '/' +
-                        alias.replace(/\s+/g, '/').replace(/:/g, '\\:') +
-                        (vars ? '/' + vars : '');
-                    this.on('CLI', path, entry.custom.handler);
-                    if (entry.custom.cb) {
-                        entry.custom.cb(path, 3);
-                    }
-                }
-            }
-        }
-    }
-    /**
-     * ## run
-     * ### Start command processing
-     * Triggers command processing
-     *
-     * By default takes `process.argv.slice(2)` as a command
-     *
-     * It's possible to replace the command by passing an argument
-     *
-     * @param _argv optionally overwrite `process.argv.slice(2)` with your `argv` array
-     */
-    run(_argv, _opts) {
-        var _a, _b;
-        return __awaiter(this, void 0, void 0, function* () {
-            const argv = _argv || process.argv.slice(2);
-            const parsedFlags = minimist(argv, _opts);
-            const pathParams = parsedFlags._;
-            const path = '/' +
-                pathParams.map((v) => encodeURI(v).replace(/\//g, '%2F')).join('/');
-            const { restoreCtx, clearCtx, store } = createCliContext({ opts: _opts, argv, pathParams, cliHelp: this.cliHelp, command: path.replace(/\//g, ' ').trim() }, this.mergeEventOptions((_a = this.opts) === null || _a === void 0 ? void 0 : _a.eventOptions));
-            store('flags').value = parsedFlags;
-            this.computeAliases();
-            const { handlers: foundHandlers, firstStatic } = this.wooks.lookup('CLI', path);
-            if (typeof firstStatic === 'string') {
-                // overwriting command with firstStatic to properly search for help
-                store('event').set('command', firstStatic.replace(/\//g, ' ').trim());
-            }
-            const handlers = foundHandlers ||
-                (((_b = this.opts) === null || _b === void 0 ? void 0 : _b.onNotFound) && [this.opts.onNotFound]) ||
-                null;
-            if (handlers) {
-                try {
-                    for (const handler of handlers) {
-                        restoreCtx();
-                        const response = yield handler();
-                        if (typeof response === 'string') {
-                            console.log(response);
-                        }
-                        else if (Array.isArray(response)) {
-                            response.forEach((r) => console.log(typeof r === 'string'
-                                ? r
-                                : JSON.stringify(r, null, '  ')));
-                        }
-                        else if (response instanceof Error) {
-                            this.onError(response);
-                        }
-                        else if (response) {
-                            if (response) {
-                                console.log(JSON.stringify(response, null, '  '));
-                            }
-                        }
-                    }
-                }
-                catch (e) {
-                    this.onError(e);
-                }
-                clearCtx();
-            }
-            else {
-                this.onUnknownCommand(pathParams);
-                clearCtx();
-            }
-        });
-    }
-    onError(e) {
-        var _a;
-        if ((_a = this.opts) === null || _a === void 0 ? void 0 : _a.onError) {
-            this.opts.onError(e);
-        }
-        else {
-            this.error(e.message);
-            process.exit(1);
-        }
-    }
-    /**
-     * Triggers `unknown command` processing and callbacks
-     * @param pathParams `string[]` containing command
-     */
-    onUnknownCommand(pathParams) {
-        var _a;
-        const raiseError = () => {
-            this.error('' + 'Unknown command: ' + pathParams.join(' '));
-            process.exit(1);
-        };
-        if ((_a = this.opts) === null || _a === void 0 ? void 0 : _a.onUnknownCommand) {
-            this.opts.onUnknownCommand(pathParams, raiseError);
-        }
-        else {
-            raiseError();
-        }
-    }
-    error(e) {
-        if (typeof e === 'string') {
-            console.error('' + 'ERROR: ' + '' + e);
-        }
-        else {
-            console.error('' + 'ERROR: ' + '' + e.message);
-        }
-    }
-}
-/**
- * Factory for WooksCli App
- * @param opts TWooksCliOptions
- * @param wooks Wooks | WooksAdapterBase
- * @returns WooksCli
- */
-function createCliApp(opts, wooks) {
-    return new WooksCli(opts, wooks);
+const cliShortcuts = {
+    cli: 'CLI',
+};
+class WooksCli extends WooksAdapterBase {
+    constructor(opts, wooks) {
+        super(wooks, opts?.logger, opts?.router);
+        this.opts = opts;
+        this.alreadyComputedAliases = false;
+        this.logger = opts?.logger || this.getLogger('wooks-cli');
+        this.cliHelp =
+            opts?.cliHelp instanceof CliHelpRenderer
+                ? opts.cliHelp
+                : new CliHelpRenderer(opts?.cliHelp);
+    }
+    /**
+     * ### Register CLI Command
+     * Command path segments may be separated by / or space.
+     *
+     * For example the folowing path are interpreted the same:
+     * - "command test use:dev :name"
+     * - "command/test/use:dev/:name"
+     *
+     * Where name will become an argument
+     *
+     * ```js
+     * // example without options
+     * app.cli('command/:arg', () => 'arg = ' + useRouteParams().params.arg )
+     *
+     * // example with options
+     * app.cli('command/:arg', {
+     *   description: 'Description of the command',
+     *   options: [{ keys: ['project', 'p'], description: 'Description of the option', value: 'myProject' }],
+     *   args: { arg: 'Description of the arg' },
+     *   aliases: ['cmd'],  // alias "cmd/:arg" will be registered
+     *   examples: [{
+     *      description: 'Example of usage with someProject',
+     *      cmd: 'argValue -p=someProject',
+     *      // will result in help display:
+     *      // "# Example of usage with someProject\n" +
+     *      // "$ myCli command argValue -p=someProject\n"
+     *   }],
+     *   handler: () => 'arg = ' + useRouteParams().params.arg
+     * })
+     * ```
+     *
+     * @param path command path
+     * @param _options handler or options
+     *
+     * @returns
+     */
+    cli(path, _options) {
+        const options = typeof _options === 'function' ? { handler: _options } : _options;
+        const handler = typeof _options === 'function' ? _options : _options.handler;
+        const makePath = (s) => '/' + s.replace(/\s+/g, '/');
+        // register handler
+        const targetPath = makePath(path);
+        const routed = this.on('CLI', targetPath, handler);
+        if (options.onRegister) {
+            options.onRegister(targetPath, 0, routed);
+        }
+        // register direct aliases
+        for (const alias of options.aliases || []) {
+            const vars = routed.getArgs().map((k) => ':' + k).join('/');
+            const targetPath = makePath(alias) + (vars ? '/' + vars : '');
+            this.on('CLI', targetPath, handler);
+            if (options.onRegister) {
+                options.onRegister(targetPath, 1, routed);
+            }
+        }
+        // register helpCli entry
+        const command = routed.getStaticPart().replace(/\//g, ' ').trim();
+        const args = {
+            ...(options.args || {}),
+        };
+        for (const arg of routed.getArgs()) {
+            if (!args[arg]) {
+                args[arg] = '';
+            }
+        }
+        this.cliHelp.addEntry({
+            command,
+            aliases: options.aliases?.map(alias => alias.replace(/\\:/g, ':')), // unescape ":" character
+            args,
+            description: options.description,
+            examples: options.examples,
+            options: options.options,
+            custom: { handler: options.handler, cb: options.onRegister },
+        });
+        return routed;
+    }
+    computeAliases() {
+        if (!this.alreadyComputedAliases) {
+            this.alreadyComputedAliases = true;
+            const aliases = this.cliHelp.getComputedAliases();
+            for (const [alias, entry] of Object.entries(aliases)) {
+                if (entry.custom) {
+                    const vars = Object.keys(entry.args || {})
+                        .map((k) => ':' + k)
+                        .join('/');
+                    const path = '/' +
+                        alias.replace(/\s+/g, '/').replace(/:/g, '\\:') +
+                        (vars ? '/' + vars : '');
+                    this.on('CLI', path, entry.custom.handler);
+                    if (entry.custom.cb) {
+                        entry.custom.cb(path, 3);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * ## run
+     * ### Start command processing
+     * Triggers command processing
+     *
+     * By default takes `process.argv.slice(2)` as a command
+     *
+     * It's possible to replace the command by passing an argument
+     *
+     * @param _argv optionally overwrite `process.argv.slice(2)` with your `argv` array
+     */
+    async run(_argv, _opts) {
+        const argv = _argv || process.argv.slice(2);
+        const parsedFlags = minimist(argv, _opts);
+        const pathParams = parsedFlags._;
+        const path = '/' +
+            pathParams.map((v) => encodeURI(v).replace(/\//g, '%2F')).join('/');
+        const { restoreCtx, clearCtx, store } = createCliContext({ opts: _opts, argv, pathParams, cliHelp: this.cliHelp, command: path.replace(/\//g, ' ').trim() }, this.mergeEventOptions(this.opts?.eventOptions));
+        store('flags').value = parsedFlags;
+        this.computeAliases();
+        const { handlers: foundHandlers, firstStatic } = this.wooks.lookup('CLI', path);
+        if (typeof firstStatic === 'string') {
+            // overwriting command with firstStatic to properly search for help
+            store('event').set('command', firstStatic.replace(/\//g, ' ').trim());
+        }
+        const handlers = foundHandlers ||
+            (this.opts?.onNotFound && [this.opts.onNotFound]) ||
+            null;
+        if (handlers) {
+            try {
+                for (const handler of handlers) {
+                    restoreCtx();
+                    const response = await handler();
+                    if (typeof response === 'string') {
+                        console.log(response);
+                    }
+                    else if (Array.isArray(response)) {
+                        response.forEach((r) => console.log(typeof r === 'string'
+                            ? r
+                            : JSON.stringify(r, null, '  ')));
+                    }
+                    else if (response instanceof Error) {
+                        this.onError(response);
+                    }
+                    else if (response) {
+                        if (response) {
+                            console.log(JSON.stringify(response, null, '  '));
+                        }
+                    }
+                }
+            }
+            catch (e) {
+                this.onError(e);
+            }
+            clearCtx();
+        }
+        else {
+            this.onUnknownCommand(pathParams);
+            clearCtx();
+        }
+    }
+    onError(e) {
+        if (this.opts?.onError) {
+            this.opts.onError(e);
+        }
+        else {
+            this.error(e.message);
+            process.exit(1);
+        }
+    }
+    /**
+     * Triggers `unknown command` processing and callbacks
+     * @param pathParams `string[]` containing command
+     */
+    onUnknownCommand(pathParams) {
+        const raiseError = () => {
+            this.error('' + 'Unknown command: ' + pathParams.join(' '));
+            process.exit(1);
+        };
+        if (this.opts?.onUnknownCommand) {
+            this.opts.onUnknownCommand(pathParams, raiseError);
+        }
+        else {
+            raiseError();
+        }
+    }
+    error(e) {
+        if (typeof e === 'string') {
+            console.error('' + 'ERROR: ' + '' + e);
+        }
+        else {
+            console.error('' + 'ERROR: ' + '' + e.message);
+        }
+    }
+}
+/**
+ * Factory for WooksCli App
+ * @param opts TWooksCliOptions
+ * @param wooks Wooks | WooksAdapterBase
+ * @returns WooksCli
+ */
+function createCliApp(opts, wooks) {
+    return new WooksCli(opts, wooks);
 }
 
-/**
- * ## useCliHelp
- * ### Composable
- * ```js
- * // example of printing cli instructions
- * const { print } = useCliHelp()
- * // print with colors
- * print(true)
- * // print with no colors
- * // print(false)
- * ```
- * @returns
- */
-function useCliHelp() {
-    const event = useCliContext().store('event');
-    const getCliHelp = () => event.get('cliHelp');
-    const getEntry = () => { var _a; return (_a = getCliHelp().match(event.get('command'))) === null || _a === void 0 ? void 0 : _a.main; };
-    return {
-        getCliHelp,
-        getEntry,
-        render: (width, withColors) => getCliHelp().render(event.get('command'), width, withColors),
-        print: (withColors) => getCliHelp().print(event.get('command'), withColors),
-    };
-}
-/**
- * ## useAutoHelp
- * ### Composable
- *
- * Prints help if `--help` option provided.
- *
- * ```js
- *  // example of use: print help and exit
- *  app.cli('test', () => {
- *      useAutoHelp() && process.exit(0)
- *      return 'hit test command'
- *  })
- *
- *  // add option -h to print help, no colors
- *  app.cli('test/nocolors', () => {
- *      useAutoHelp(['help', 'h'], false) && process.exit(0)
- *      return 'hit test nocolors command'
- *  })
- * ```
- * @param keys default `['help']` - list of options to trigger help render
- * @param colors default `true`, prints with colors when true
- * @returns true when --help was provided. Otherwise returns false
- */
-function useAutoHelp(keys = ['help'], colors = true) {
-    for (const option of keys) {
-        if (useCliOption(option) === true) {
-            // try {
-            useCliHelp().print(colors);
-            return true;
-            // } catch (e) {
-            //     throw new 
-            // }
-        }
-    }
-}
-/**
- * ##useCommandLookupHelp
- * ### Composable
- *
- * Tries to find valid command based on provided command.
- *
- * If manages to find a valid command, throws an error
- * suggesting a list of valid commands
- *
- * Best to use in `onUnknownCommand` callback:
- *
- * ```js
- *  const app = createCliApp({
- *      onUnknownCommand: (path, raiseError) => {
- *          // will throw an error suggesting a list
- *          // of valid commands if could find some
- *          useCommandLookupHelp()
- *          // fallback to a regular error handler
- *          raiseError()
- *      },
- *  })
- * ```
- *
- * @param lookupDepth depth of search in backwards
- * @example
- *
- * For provided command `run test:drive dir`
- *  - lookup1: `run test:drive dir`  (deep = 0)
- *  - lookup2: `run test:drive`      (deep = 1)
- *  - lookup3: `run test`            (deep = 2)
- *  - lookup4: `run`                 (deep = 3)
- * ...
- */
-function useCommandLookupHelp(lookupDepth = 3) {
-    const parts = useCliContext()
-        .store('event')
-        .get('pathParams')
-        .map((p) => (p + ' ').split(':').map((s, i) => (i ? ':' + s : s)))
-        .flat();
-    const cliHelp = useCliHelp().getCliHelp();
-    const cmd = cliHelp.getCliName();
-    let data;
-    for (let i = 0; i < Math.min(parts.length, lookupDepth + 1); i++) {
-        const pathParams = parts
-            .slice(0, i ? -i : parts.length)
-            .join('')
-            .trim();
-        try {
-            data = cliHelp.match(pathParams);
-            break;
-        }
-        catch (e) {
-            const variants = cliHelp.lookup(pathParams);
-            if (variants.length) {
-                throw new Error(`Wrong command, did you mean:\n${variants
-                    .slice(0, 7)
-                    .map((c) => `  $ ${cmd} ${c.main.command}`)
-                    .join('\n')}`);
-            }
-        }
-    }
-    if (data) {
-        const { main, children } = data;
-        if (main.args && Object.keys(main.args).length) {
-            throw new Error(`Arguments expected: ${Object.keys(main.args)
-                .map((l) => `<${l}>`)
-                .join(', ')}`);
-        }
-        else if (children && children.length) {
-            throw new Error(`Wrong command, did you mean:\n${children
-                .slice(0, 7)
-                .map((c) => `  $ ${cmd} ${c.command}`)
-                .join('\n')}`);
-        }
-    }
+/**
+ * ## useCliHelp
+ * ### Composable
+ * ```js
+ * // example of printing cli instructions
+ * const { print } = useCliHelp()
+ * // print with colors
+ * print(true)
+ * // print with no colors
+ * // print(false)
+ * ```
+ * @returns
+ */
+function useCliHelp() {
+    const event = useCliContext().store('event');
+    const getCliHelp = () => event.get('cliHelp');
+    const getEntry = () => getCliHelp().match(event.get('command'))?.main;
+    return {
+        getCliHelp,
+        getEntry,
+        render: (width, withColors) => getCliHelp().render(event.get('command'), width, withColors),
+        print: (withColors) => getCliHelp().print(event.get('command'), withColors),
+    };
+}
+/**
+ * ## useAutoHelp
+ * ### Composable
+ *
+ * Prints help if `--help` option provided.
+ *
+ * ```js
+ *  // example of use: print help and exit
+ *  app.cli('test', () => {
+ *      useAutoHelp() && process.exit(0)
+ *      return 'hit test command'
+ *  })
+ *
+ *  // add option -h to print help, no colors
+ *  app.cli('test/nocolors', () => {
+ *      useAutoHelp(['help', 'h'], false) && process.exit(0)
+ *      return 'hit test nocolors command'
+ *  })
+ * ```
+ * @param keys default `['help']` - list of options to trigger help render
+ * @param colors default `true`, prints with colors when true
+ * @returns true when --help was provided. Otherwise returns false
+ */
+function useAutoHelp(keys = ['help'], colors = true) {
+    for (const option of keys) {
+        if (useCliOption(option) === true) {
+            // try {
+            useCliHelp().print(colors);
+            return true;
+            // } catch (e) {
+            //     throw new 
+            // }
+        }
+    }
+}
+/**
+ * ##useCommandLookupHelp
+ * ### Composable
+ *
+ * Tries to find valid command based on provided command.
+ *
+ * If manages to find a valid command, throws an error
+ * suggesting a list of valid commands
+ *
+ * Best to use in `onUnknownCommand` callback:
+ *
+ * ```js
+ *  const app = createCliApp({
+ *      onUnknownCommand: (path, raiseError) => {
+ *          // will throw an error suggesting a list
+ *          // of valid commands if could find some
+ *          useCommandLookupHelp()
+ *          // fallback to a regular error handler
+ *          raiseError()
+ *      },
+ *  })
+ * ```
+ *
+ * @param lookupDepth depth of search in backwards
+ * @example
+ *
+ * For provided command `run test:drive dir`
+ *  - lookup1: `run test:drive dir`  (deep = 0)
+ *  - lookup2: `run test:drive`      (deep = 1)
+ *  - lookup3: `run test`            (deep = 2)
+ *  - lookup4: `run`                 (deep = 3)
+ * ...
+ */
+function useCommandLookupHelp(lookupDepth = 3) {
+    const parts = useCliContext()
+        .store('event')
+        .get('pathParams')
+        .map((p) => (p + ' ').split(':').map((s, i) => (i ? ':' + s : s)))
+        .flat();
+    const cliHelp = useCliHelp().getCliHelp();
+    const cmd = cliHelp.getCliName();
+    let data;
+    for (let i = 0; i < Math.min(parts.length, lookupDepth + 1); i++) {
+        const pathParams = parts
+            .slice(0, i ? -i : parts.length)
+            .join('')
+            .trim();
+        try {
+            data = cliHelp.match(pathParams);
+            break;
+        }
+        catch (e) {
+            const variants = cliHelp.lookup(pathParams);
+            if (variants.length) {
+                throw new Error(`Wrong command, did you mean:\n${variants
+                    .slice(0, 7)
+                    .map((c) => `  $ ${cmd} ${c.main.command}`)
+                    .join('\n')}`);
+            }
+        }
+    }
+    if (data) {
+        const { main, children } = data;
+        if (main.args && Object.keys(main.args).length) {
+            throw new Error(`Arguments expected: ${Object.keys(main.args)
+                .map((l) => `<${l}>`)
+                .join(', ')}`);
+        }
+        else if (children && children.length) {
+            throw new Error(`Wrong command, did you mean:\n${children
+                .slice(0, 7)
+                .map((c) => `  $ ${cmd} ${c.command}`)
+                .join('\n')}`);
+        }
+    }
 }
 
-/**
- * Get CLI Options
- *
- * @returns an object with CLI options
- */
-function useCliOptions() {
-    const { store } = useCliContext();
-    const flags = store('flags');
-    if (!flags.value) {
-        const event = store('event');
-        flags.value = minimist(event.value.argv, event.get('opts'));
-    }
-    return flags.value;
-}
-/**
- * Getter for Cli Option value
- *
- * @param name name of the option
- * @returns value of a CLI option
- */
-function useCliOption(name) {
-    var _a;
-    try {
-        const options = ((_a = useCliHelp().getEntry()) === null || _a === void 0 ? void 0 : _a.options) || [];
-        const opt = options.find(o => o.keys.includes(name));
-        if (opt) {
-            for (const key of opt.keys) {
-                if (useCliOptions()[key]) {
-                    return useCliOptions()[key];
-                }
-            }
-        }
-    }
-    catch (e) {
-        //
-    }
-    return useCliOptions()[name];
+/**
+ * Get CLI Options
+ *
+ * @returns an object with CLI options
+ */
+function useCliOptions() {
+    const { store } = useCliContext();
+    const flags = store('flags');
+    if (!flags.value) {
+        const event = store('event');
+        flags.value = minimist(event.value.argv, event.get('opts'));
+    }
+    return flags.value;
+}
+/**
+ * Getter for Cli Option value
+ *
+ * @param name name of the option
+ * @returns value of a CLI option
+ */
+function useCliOption(name) {
+    try {
+        const options = useCliHelp().getEntry()?.options || [];
+        const opt = options.find(o => o.keys.includes(name));
+        if (opt) {
+            for (const key of opt.keys) {
+                if (useCliOptions()[key]) {
+                    return useCliOptions()[key];
+                }
+            }
+        }
+    }
+    catch (e) {
+        //
+    }
+    return useCliOptions()[name];
 }
 
 export { WooksCli, cliShortcuts, createCliApp, createCliContext, useAutoHelp, useCliContext, useCliHelp, useCliOption, useCliOptions, useCommandLookupHelp };