@decaf-ts/cli 0.3.5 → 0.3.7

package/lib/CliWrapper.cjs

@@ -10,11 +10,19 @@ const path_1 = __importDefault(require("path"));
 const constants_1 = require("./constants.cjs");
 const utils_1 = require("./utils.cjs");
 /**
- * @summary Util class to handle CLI functionality from all Decaf modules
- * @description CLI handler class
+ * @description Utility class to handle CLI functionality from all Decaf modules
+ * @summary This class provides a wrapper around Commander.js to handle CLI commands from different Decaf modules.
+ * It crawls the filesystem to find CLI modules, loads them, and registers their commands.
  *
- * @param {string} [basepath] the base path to look for modules in. defaults to `./`
- * @param {string} [crawlLevels] folders to crawl to find modules from the basePath. defaults to 4
+ * @param {string} [basePath] The base path to look for modules in. Defaults to `./`
+ * @param {number} [crawlLevels] Number of folder levels to crawl to find modules from the basePath. Defaults to 4
+ *
+ * @example
+ * // Create a new CLI wrapper and run it with custom options
+ * const cli = new CliWrapper('./src', 2);
+ * cli.run(process.argv).then(() => {
+ *   console.log('CLI commands executed successfully');
+ * });
  *
  * @class CliWrapper
  */
@@ -23,26 +31,47 @@ class CliWrapper {
         this.basePath = basePath;
         this.crawlLevels = crawlLevels;
         this.modules = {};
+        this.rootPath = path_1.default.resolve(__dirname, "..");
     }
     /**
-     * @description Retrieves and initializes the {@link Command} object
+     * @description Retrieves and initializes the Commander Command object
+     * @summary Lazy-loads the Command object, initializing it with the package name, description, and version
+     * @return {Command} The initialized Command object
      * @private
      */
     get command() {
         if (!this._command) {
             this._command = new commander_1.Command();
-            utils_1.CLIUtils.initialize(this._command, this.basePath);
+            utils_1.CLIUtils.initialize(this._command, this.rootPath);
         }
         return this._command;
     }
     /**
-     * @description loads and registers module from a file
+     * @description Loads and registers a module from a file
+     * @summary Dynamically imports a CLI module from the specified file path, initializes it, and registers it in the modules collection
      *
-     * @param {string} filePath path to look for modules
-     * @param {string} rootPath repo root to find the package.json
-     * @return {string} the module name
+     * @param {string} filePath Path to the module file to load
+     * @param {string} rootPath Repository root path to find the package.json
+     * @return {Promise<string>} A promise that resolves to the module name
      *
      * @private
+     * @mermaid
+     * sequenceDiagram
+     *   participant CliWrapper
+     *   participant CLIUtils
+     *   participant Module
+     *
+     *   CliWrapper->>CLIUtils: loadFromFile(filePath)
+     *   CLIUtils-->>CliWrapper: module
+     *   CliWrapper->>CliWrapper: Get module name
+     *   CliWrapper->>Command: new Command()
+     *   Command-->>CliWrapper: cmd
+     *   CliWrapper->>CLIUtils: initialize(cmd, path.dirname(rootPath))
+     *   CliWrapper->>Module: module()
+     *   Note over CliWrapper,Module: Handle Promise if needed
+     *   Module-->>CliWrapper: Command instance
+     *   CliWrapper->>CliWrapper: Store in modules[name]
+     *   CliWrapper-->>CliWrapper: Return name
      */
     async load(filePath, rootPath) {
         let name;
@@ -50,7 +79,7 @@ class CliWrapper {
             const module = await utils_1.CLIUtils.loadFromFile(filePath);
             name = module.name;
             const cmd = new commander_1.Command();
-            utils_1.CLIUtils.initialize(cmd, path_1.default.dirname(rootPath));
+            utils_1.CLIUtils.initialize(cmd, rootPath);
             let m = module();
             if (m instanceof Promise)
                 m = await m;
@@ -62,12 +91,36 @@ class CliWrapper {
         return name;
     }
     /**
-     * @description finds all the cli modules in the basePath via {@link CliWrapper.crawl}
-     * and loads them
+     * @description Finds and loads all CLI modules in the basePath
+     * @summary Uses the crawl method to find all CLI modules in the specified base path,
+     * then loads and registers each module as a subcommand
+     *
+     * @return {Promise<void>} A promise that resolves when all modules are loaded
+     *
      * @private
+     * @mermaid
+     * sequenceDiagram
+     *   participant CliWrapper
+     *   participant Filesystem
+     *   participant Module
+     *
+     *   CliWrapper->>Filesystem: Join basePath with cwd
+     *   CliWrapper->>CliWrapper: crawl(basePath, crawlLevels)
+     *   CliWrapper-->>CliWrapper: modules[]
+     *   loop For each module
+     *     alt Not @decaf-ts/cli
+     *       CliWrapper->>CliWrapper: load(module, cwd)
+     *       CliWrapper-->>CliWrapper: name
+     *       CliWrapper->>CliWrapper: Check if command exists
+     *       alt Command doesn't exist
+     *         CliWrapper->>Command: command(name).addCommand(modules[name])
+     *       end
+     *     end
+     *   end
+     *   CliWrapper->>Console: Log loaded modules
      */
     async boot() {
-        const basePath = path_1.default.join(process.cwd(), this.basePath);
+        const basePath = path_1.default.resolve(this.rootPath, this.basePath);
         const modules = this.crawl(basePath, this.crawlLevels);
         for (const module of modules) {
             if (module.includes("@decaf-ts/cli")) {
@@ -75,7 +128,7 @@ class CliWrapper {
             }
             let name;
             try {
-                name = await this.load(module, process.cwd());
+                name = await this.load(module, this.rootPath);
             }
             catch (e) {
                 console.error(e);
@@ -94,9 +147,13 @@ class CliWrapper {
             .join("\n")}`);
     }
     /**
-     * @description crawls the basePath up for 'levels' folders to find a module,eg a {@link CLI_FILE_NAME} named file
-     * @param {string} basePath the relative base batch to start searching in
-     * @param {number} [levels] the max number of levels to crawl. defaults to 2
+     * @description Recursively searches for CLI module files in the directory structure
+     * @summary Crawls the basePath up to the specified number of folder levels to find files named according to CLI_FILE_NAME
+     *
+     * @param {string} basePath The absolute base path to start searching in
+     * @param {number} [levels=2] The maximum number of directory levels to crawl
+     * @return {string[]} An array of file paths to CLI modules
+     *
      * @private
      */
     crawl(basePath, levels = 2) {
@@ -114,9 +171,24 @@ class CliWrapper {
         }, []);
     }
     /**
-     * @description runs the given command
+     * @description Executes the CLI with the provided arguments
+     * @summary Boots the CLI by loading all modules, then parses and executes the command specified in the arguments
+     *
+     * @param {string[]} [args=process.argv] Command line arguments to parse and execute
+     * @return {Promise<void>} A promise that resolves when the command execution is complete
+     *
+     * @mermaid
+     * sequenceDiagram
+     *   participant Client
+     *   participant CliWrapper
+     *   participant Command
      *
-     * @param {string[]} [args] args to run. defaults to process.argv
+     *   Client->>CliWrapper: run(args)
+     *   CliWrapper->>CliWrapper: boot()
+     *   Note over CliWrapper: Loads all modules
+     *   CliWrapper->>Command: parseAsync(args)
+     *   Command-->>CliWrapper: result
+     *   CliWrapper-->>Client: result
      */
     async run(args = process.argv) {
         await this.boot();
@@ -124,4 +196,4 @@ class CliWrapper {
     }
 }
 exports.CliWrapper = CliWrapper;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ2xpV3JhcHBlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9DbGlXcmFwcGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUFBLHlDQUFvQztBQUNwQyw0Q0FBb0I7QUFDcEIsZ0RBQXdCO0FBQ3hCLCtDQUE0QztBQUM1Qyx1Q0FBbUM7QUFFbkM7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFhLFVBQVU7SUFJckIsWUFDVSxXQUFtQixJQUFJLEVBQ3ZCLGNBQWMsQ0FBQztRQURmLGFBQVEsR0FBUixRQUFRLENBQWU7UUFDdkIsZ0JBQVcsR0FBWCxXQUFXLENBQUk7UUFKakIsWUFBTyxHQUE0QixFQUFFLENBQUM7SUFLM0MsQ0FBQztJQUVKOzs7T0FHRztJQUNILElBQVksT0FBTztRQUNqQixJQUFJLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxDQUFDO1lBQ25CLElBQUksQ0FBQyxRQUFRLEdBQUcsSUFBSSxtQkFBTyxFQUFFLENBQUM7WUFDOUIsZ0JBQVEsQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxJQUFJLENBQUMsUUFBUSxDQUFDLENBQUM7UUFDcEQsQ0FBQztRQUNELE9BQU8sSUFBSSxDQUFDLFFBQVEsQ0FBQztJQUN2QixDQUFDO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDSyxLQUFLLENBQUMsSUFBSSxDQUFDLFFBQWdCLEVBQUUsUUFBZ0I7UUFDbkQsSUFBSSxJQUFJLENBQUM7UUFDVCxJQUFJLENBQUM7WUFDSCxNQUFNLE1BQU0sR0FBRyxNQUFNLGdCQUFRLENBQUMsWUFBWSxDQUFDLFFBQVEsQ0FBQyxDQUFDO1lBQ3JELElBQUksR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDO1lBQ25CLE1BQU0sR0FBRyxHQUFHLElBQUksbUJBQU8sRUFBRSxDQUFDO1lBQzFCLGdCQUFRLENBQUMsVUFBVSxDQUFDLEdBQUcsRUFBRSxjQUFJLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUM7WUFDakQsSUFB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Q0FBQyxDQUFDO1lBQzlDLENBQUM7aUJBQU0sSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksTUFBTSxDQUFDLEdBQUcseUJBQWEsV0FBVyxFQUFFLElBQUksQ0FBQyxDQUFDLEVBQUUsQ0FBQztnQkFDckUsS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUNuQixDQUFDO1lBQ0QsT0FBTyxLQUFLLENBQUM7UUFDZixDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDVCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILEtBQUssQ0FBQyxHQUFHLENBQUMsT0FBaUIsT0FBTyxDQUFDLElBQUk7UUFDckMsTUFBTSxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDbEIsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUN2QyxDQUFDO0NBQ0Y7QUFsSEQsZ0NBa0hDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgQ29tbWFuZCB9IGZyb20gXCJjb21tYW5kZXJcIjtcbmltcG9ydCBmcyBmcm9tIFwiZnNcIjtcbmltcG9ydCBwYXRoIGZyb20gXCJwYXRoXCI7XG5pbXBvcnQgeyBDTElfRklMRV9OQU1FIH0gZnJvbSBcIi4vY29uc3RhbnRzXCI7XG5pbXBvcnQgeyBDTElVdGlscyB9IGZyb20gXCIuL3V0aWxzXCI7XG5cbi8qKlxuICogQHN1bW1hcnkgVXRpbCBjbGFzcyB0byBoYW5kbGUgQ0xJIGZ1bmN0aW9uYWxpdHkgZnJvbSBhbGwgRGVjYWYgbW9kdWxlc1xuICogQGRlc2NyaXB0aW9uIENMSSBoYW5kbGVyIGNsYXNzXG4gKlxuICogQHBhcmFtIHtzdHJpbmd9IFtiYXNlcGF0aF0gdGhlIGJhc2UgcGF0aCB0byBsb29rIGZvciBtb2R1bGVzIGluLiBkZWZhdWx0cyB0byBgLi9gXG4gKiBAcGFyYW0ge3N0cmluZ30gW2NyYXdsTGV2ZWxzXSBmb2xkZXJzIHRvIGNyYXdsIHRvIGZpbmQgbW9kdWxlcyBmcm9tIHRoZSBiYXNlUGF0aC4gZGVmYXVsdHMgdG8gNFxuICpcbiAqIEBjbGFzcyBDbGlXcmFwcGVyXG4gKi9cbmV4cG9ydCBjbGFzcyBDbGlXcmFwcGVyIHtcbiAgcHJpdmF0ZSBfY29tbWFuZD86IENvbW1hbmQ7XG4gIHByaXZhdGUgbW9kdWxlczogUmVjb3JkPHN0cmluZywgQ29tbWFuZD4gPSB7fTtcblxuICBjb25zdHJ1Y3RvcihcbiAgICBwcml2YXRlIGJhc2VQYXRoOiBzdHJpbmcgPSBcIi4vXCIsXG4gICAgcHJpdmF0ZSBjcmF3bExldmVscyA9IDRcbiAgKSB7fVxuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gUmV0cmlldmVzIGFuZCBpbml0aWFsaXplcyB0aGUge0BsaW5rIENvbW1hbmR9IG9iamVjdFxuICAgKiBAcHJpdmF0ZVxuICAgKi9cbiAgcHJpdmF0ZSBnZXQgY29tbWFuZCgpIHtcbiAgICBpZiAoIXRoaXMuX2NvbW1hbmQpIHtcbiAgICAgIHRoaXMuX2NvbW1hbmQgPSBuZXcgQ29tbWFuZCgpO1xuICAgICAgQ0xJVXRpbHMuaW5pdGlhbGl6ZSh0aGlzLl9jb21tYW5kLCB0aGlzLmJhc2VQYXRoKTtcbiAgICB9XG4gICAgcmV0dXJuIHRoaXMuX2NvbW1hbmQ7XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIGxvYWRzIGFuZCByZWdpc3RlcnMgbW9kdWxlIGZyb20gYSBmaWxlXG4gICAqXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBmaWxlUGF0aCBwYXRoIHRvIGxvb2sgZm9yIG1vZHVsZXNcbiAgICogQHBhcmFtIHtzdHJpbmd9IHJvb3RQYXRoIHJlcG8gcm9vdCB0byBmaW5kIHRoZSBwYWNrYWdlLmpzb25cbiAgICogQHJldHVybiB7c3RyaW5nfSB0aGUgbW9kdWxlIG5hbWVcbiAgICpcbiAgICogQHByaXZhdGVcbiAgICovXG4gIHByaXZhdGUgYXN5bmMgbG9hZChmaWxlUGF0aDogc3RyaW5nLCByb290UGF0aDogc3RyaW5nKTogUHJvbWlzZTxzdHJpbmc+IHtcbiAgICBsZXQgbmFtZTtcbiAgICB0cnkge1xuICAgICAgY29uc3QgbW9kdWxlID0gYXdhaXQgQ0xJVXRpbHMubG9hZEZyb21GaWxlKGZpbGVQYXRoKTtcbiAgICAgIG5hbWUgPSBtb2R1bGUubmFtZTtcbiAgICAgIGNvbnN0IGNtZCA9IG5ldyBDb21tYW5kKCk7XG4gICAgICBDTElVdGlscy5pbml0aWFsaXplKGNtZCwgcGF0aC5kaXJuYW1lKHJvb3RQYXRoKSk7XG4gICAgICBsZXQgbSA9IG1vZHVsZSgpO1xuICAgICAgaWYgKG0gaW5zdGFuY2VvZiBQcm9taXNlKSBtID0gYXdhaXQgbTtcbiAgICAgIHRoaXMubW9kdWxlc1tuYW1lXSA9IG07XG4gICAgfSBjYXRjaCAoZTogdW5rbm93bikge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICBgZmFpbGVkIHRvIGxvYWQgbW9kdWxlICR7bmFtZSB8fCBcInVubmFtZWRcIn0gdW5kZXIgJHtmaWxlUGF0aH06ICR7ZSBpbnN0YW5jZW9mIEVycm9yID8gZS5tZXNzYWdlIDogZX1gXG4gICAgICApO1xuICAgIH1cbiAgICByZXR1cm4gbmFtZTtcbiAgfVxuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gZmluZHMgYWxsIHRoZSBjbGkgbW9kdWxlcyBpbiB0aGUgYmFzZVBhdGggdmlhIHtAbGluayBDbGlXcmFwcGVyLmNyYXdsfVxuICAgKiBhbmQgbG9hZHMgdGhlbVxuICAgKiBAcHJpdmF0ZVxuICAgKi9cbiAgcHJpdmF0ZSBhc3luYyBib290KCkge1xuICAgIGNvbnN0IGJhc2VQYXRoID0gcGF0aC5qb2luKHByb2Nlc3MuY3dkKCksIHRoaXMuYmFzZVBhdGgpO1xuICAgIGNvbnN0IG1vZHVsZXMgPSB0aGlzLmNyYXdsKGJhc2VQYXRoLCB0aGlzLmNyYXdsTGV2ZWxzKTtcbiAgICBmb3IgKGNvbnN0IG1vZHVsZSBvZiBtb2R1bGVzKSB7XG4gICAgICBpZiAobW9kdWxlLmluY2x1ZGVzKFwiQGRlY2FmLXRzL2NsaVwiKSkge1xuICAgICAgICBjb250aW51ZTtcbiAgICAgIH1cbiAgICAgIGxldCBuYW1lOiBzdHJpbmc7XG4gICAgICB0cnkge1xuICAgICAgICBuYW1lID0gYXdhaXQgdGhpcy5sb2FkKG1vZHVsZSwgcHJvY2Vzcy5jd2QoKSk7XG4gICAgICB9IGNhdGNoIChlOiB1bmtub3duKSB7XG4gICAgICAgIGNvbnNvbGUuZXJyb3IoZSk7XG4gICAgICAgIGNvbnRpbnVlO1xuICAgICAgfVxuXG4gICAgICBpZiAoXG4gICAgICAgICF0aGlzLmNvbW1hbmQuY29tbWFuZHMuZmluZChcbiAgICAgICAgICAoYykgPT4gKGMgYXMgdW5rbm93biBhcyBSZWNvcmQ8c3RyaW5nLCBzdHJpbmc+KVtcIl9uYW1lXCJdID09PSBuYW1lXG4gICAgICAgIClcbiAgICAgIClcbiAgICAgICAgdHJ5IHtcbiAgICAgICAgICB0aGlzLmNvbW1hbmQuY29tbWFuZChuYW1lKS5hZGRDb21tYW5kKHRoaXMubW9kdWxlc1tuYW1lXSk7XG4gICAgICAgIH0gY2F0Y2ggKGU6IHVua25vd24pIHtcbiAgICAgICAgICBjb25zb2xlLmVycm9yKGUpO1xuICAgICAgICB9XG4gICAgfVxuICAgIGNvbnNvbGUubG9nKFxuICAgICAgYGxvYWRlZCBtb2R1bGVzOlxcbiR7T2JqZWN0LmtleXModGhpcy5tb2R1bGVzKVxuICAgICAgICAubWFwKChrKSA9PiBgLSAke2t9YClcbiAgICAgICAgLmpvaW4oXCJcXG5cIil9YFxuICAgICk7XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIGNyYXdscyB0aGUgYmFzZVBhdGggdXAgZm9yICdsZXZlbHMnIGZvbGRlcnMgdG8gZmluZCBhIG1vZHVsZSxlZyBhIHtAbGluayBDTElfRklMRV9OQU1FfSBuYW1lZCBmaWxlXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBiYXNlUGF0aCB0aGUgcmVsYXRpdmUgYmFzZSBiYXRjaCB0byBzdGFydCBzZWFyY2hpbmcgaW5cbiAgICogQHBhcmFtIHtudW1iZXJ9IFtsZXZlbHNdIHRoZSBtYXggbnVtYmVyIG9mIGxldmVscyB0byBjcmF3bC4gZGVmYXVsdHMgdG8gMlxuICAgKiBAcHJpdmF0ZVxuICAgKi9cbiAgcHJpdmF0ZSBjcmF3bChiYXNlUGF0aDogc3RyaW5nLCBsZXZlbHM6IG51bWJlciA9IDIpIHtcbiAgICBpZiAobGV2ZWxzIDw9IDApIHJldHVybiBbXTtcbiAgICByZXR1cm4gZnMucmVhZGRpclN5bmMoYmFzZVBhdGgpLnJlZHVjZSgoYWNjdW06IHN0cmluZ1tdLCBmaWxlKSA9PiB7XG4gICAgICBmaWxlID0gcGF0aC5qb2luKGJhc2VQYXRoLCBmaWxlKTtcbiAgICAgIGlmIChmcy5zdGF0U3luYyhmaWxlKS5pc0RpcmVjdG9yeSgpKSB7XG4gICAgICAgIGFjY3VtLnB1c2goLi4udGhpcy5jcmF3bChmaWxlLCBsZXZlbHMgLSAxKSk7XG4gICAgICB9IGVsc2UgaWYgKGZpbGUubWF0Y2gobmV3IFJlZ0V4cChgJHtDTElfRklMRV9OQU1FfS5bY21dP2pzJGAsIFwiZ21cIikpKSB7XG4gICAgICAgIGFjY3VtLnB1c2goZmlsZSk7XG4gICAgICB9XG4gICAgICByZXR1cm4gYWNjdW07XG4gICAgfSwgW10pO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBydW5zIHRoZSBnaXZlbiBjb21tYW5kXG4gICAqXG4gICAqIEBwYXJhbSB7c3RyaW5nW119IFthcmdzXSBhcmdzIHRvIHJ1bi4gZGVmYXVsdHMgdG8gcHJvY2Vzcy5hcmd2XG4gICAqL1xuICBhc3luYyBydW4oYXJnczogc3RyaW5nW10gPSBwcm9jZXNzLmFyZ3YpIHtcbiAgICBhd2FpdCB0aGlzLmJvb3QoKTtcbiAgICByZXR1cm4gdGhpcy5jb21tYW5kLnBhcnNlQXN5bmMoYXJncyk7XG4gIH1cbn1cbiJdfQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ2xpV3JhcHBlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9DbGlXcmFwcGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUFBLHlDQUFvQztBQUNwQyw0Q0FBb0I7QUFDcEIsZ0RBQXdCO0FBQ3hCLCtDQUE0QztBQUM1Qyx1Q0FBbUM7QUFFbkM7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQkc7QUFDSCxNQUFhLFVBQVU7SUFLckIsWUFDVSxXQUFtQixJQUFJLEVBQ3ZCLGNBQWMsQ0FBQztRQURmLGFBQVEsR0FBUixRQUFRLENBQWU7UUFDdkIsZ0JBQVcsR0FBWCxXQUFXLENBQUk7UUFMakIsWUFBTyxHQUE0QixFQUFFLENBQUM7UUFPNUMsSUFBSSxDQUFDLFFBQVEsR0FBRyxjQUFJLENBQUMsT0FBTyxDQUFDLFNBQVMsRUFBRSxJQUFJLENBQUMsQ0FBQztJQUNoRCxDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxJQUFZLE9BQU87UUFDakIsSUFBSSxDQUFDLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUNuQixJQUFJLENBQUMsUUFBUSxHQUFHLElBQUksbUJBQU8sRUFBRSxDQUFDO1lBQzlCLGdCQUFRLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxRQUFRLEVBQUUsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDO1FBQ3BELENBQUM7UUFDRCxPQUFPLElBQUksQ0FBQyxRQUFRLENBQUM7SUFDdkIsQ0FBQztJQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztPQTBCRztJQUNLLEtBQUssQ0FBQyxJQUFJLENBQUMsUUFBZ0IsRUFBRSxRQUFnQjtRQUNuRCxJQUFJLElBQUksQ0FBQztRQUNULElBQUksQ0FBQztZQUNILE1BQU0sTUFBTSxHQUFHLE1BQU0sZ0JBQVEsQ0FBQyxZQUFZLENBQUMsUUFBUSxDQUFDLENBQUM7WUFDckQsSUFBSSxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUM7WUFDbkIsTUFBTSxHQUFHLEdBQUcsSUFBSSxt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QUUsRUFBRSxDQUFDO2dCQUNwQyxLQUFLLENBQUMsSUFBSSxDQUFDLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLEVBQUUsTUFBTSxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFDOUMsQ0FBQztpQkFBTSxJQUFJLElBQUksQ0FBQyxLQUFLLENBQUMsSUFBSSxNQUFNLENBQUMsR0FBRyx5QkFBYSxXQUFXLEVBQUUsSUFBSSxDQUFDLENBQUMsRUFBRSxDQUFDO2dCQUNyRSxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQ25CLENBQUM7WUFDRCxPQUFPLEtBQUssQ0FBQztRQUNmLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQztJQUNULENBQUM7SUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7OztPQW1CRztJQUNILEtBQUssQ0FBQyxHQUFHLENBQUMsT0FBaUIsT0FBTyxDQUFDLElBQUk7UUFDckMsTUFBTSxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDbEIsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUN2QyxDQUFDO0NBQ0Y7QUFwTEQsZ0NBb0xDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgQ29tbWFuZCB9IGZyb20gXCJjb21tYW5kZXJcIjtcbmltcG9ydCBmcyBmcm9tIFwiZnNcIjtcbmltcG9ydCBwYXRoIGZyb20gXCJwYXRoXCI7XG5pbXBvcnQgeyBDTElfRklMRV9OQU1FIH0gZnJvbSBcIi4vY29uc3RhbnRzXCI7XG5pbXBvcnQgeyBDTElVdGlscyB9IGZyb20gXCIuL3V0aWxzXCI7XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIFV0aWxpdHkgY2xhc3MgdG8gaGFuZGxlIENMSSBmdW5jdGlvbmFsaXR5IGZyb20gYWxsIERlY2FmIG1vZHVsZXNcbiAqIEBzdW1tYXJ5IFRoaXMgY2xhc3MgcHJvdmlkZXMgYSB3cmFwcGVyIGFyb3VuZCBDb21tYW5kZXIuanMgdG8gaGFuZGxlIENMSSBjb21tYW5kcyBmcm9tIGRpZmZlcmVudCBEZWNhZiBtb2R1bGVzLlxuICogSXQgY3Jhd2xzIHRoZSBmaWxlc3lzdGVtIHRvIGZpbmQgQ0xJIG1vZHVsZXMsIGxvYWRzIHRoZW0sIGFuZCByZWdpc3RlcnMgdGhlaXIgY29tbWFuZHMuXG4gKiBcbiAqIEBwYXJhbSB7c3RyaW5nfSBbYmFzZVBhdGhdIFRoZSBiYXNlIHBhdGggdG8gbG9vayBmb3IgbW9kdWxlcyBpbi4gRGVmYXVsdHMgdG8gYC4vYFxuICogQHBhcmFtIHtudW1iZXJ9IFtjcmF3bExldmVsc10gTnVtYmVyIG9mIGZvbGRlciBsZXZlbHMgdG8gY3Jhd2wgdG8gZmluZCBtb2R1bGVzIGZyb20gdGhlIGJhc2VQYXRoLiBEZWZhdWx0cyB0byA0XG4gKiBcbiAqIEBleGFtcGxlXG4gKiAvLyBDcmVhdGUgYSBuZXcgQ0xJIHdyYXBwZXIgYW5kIHJ1biBpdCB3aXRoIGN1c3RvbSBvcHRpb25zXG4gKiBjb25zdCBjbGkgPSBuZXcgQ2xpV3JhcHBlcignLi9zcmMnLCAyKTtcbiAqIGNsaS5ydW4ocHJvY2Vzcy5hcmd2KS50aGVuKCgpID0+IHtcbiAqICAgY29uc29sZS5sb2coJ0NMSSBjb21tYW5kcyBleGVjdXRlZCBzdWNjZXNzZnVsbHknKTtcbiAqIH0pO1xuICogXG4gKiBAY2xhc3MgQ2xpV3JhcHBlclxuICovXG5leHBvcnQgY2xhc3MgQ2xpV3JhcHBlciB7XG4gIHByaXZhdGUgX2NvbW1hbmQ/OiBDb21tYW5kO1xuICBwcml2YXRlIG1vZHVsZXM6IFJlY29yZDxzdHJpbmcsIENvbW1hbmQ+ID0ge307XG4gIHByaXZhdGUgcmVhZG9ubHkgcm9vdFBhdGg6IHN0cmluZztcblxuICBjb25zdHJ1Y3RvcihcbiAgICBwcml2YXRlIGJhc2VQYXRoOiBzdHJpbmcgPSBcIi4vXCIsXG4gICAgcHJpdmF0ZSBjcmF3bExldmVscyA9IDRcbiAgKSB7XG4gICAgdGhpcy5yb290UGF0aCA9IHBhdGgucmVzb2x2ZShfX2Rpcm5hbWUsIFwiLi5cIik7XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIFJldHJpZXZlcyBhbmQgaW5pdGlhbGl6ZXMgdGhlIENvbW1hbmRlciBDb21tYW5kIG9iamVjdFxuICAgKiBAc3VtbWFyeSBMYXp5LWxvYWRzIHRoZSBDb21tYW5kIG9iamVjdCwgaW5pdGlhbGl6aW5nIGl0IHdpdGggdGhlIHBhY2thZ2UgbmFtZSwgZGVzY3JpcHRpb24sIGFuZCB2ZXJzaW9uXG4gICAqIEByZXR1cm4ge0NvbW1hbmR9IFRoZSBpbml0aWFsaXplZCBDb21tYW5kIG9iamVjdFxuICAgKiBAcHJpdmF0ZVxuICAgKi9cbiAgcHJpdmF0ZSBnZXQgY29tbWFuZCgpIHtcbiAgICBpZiAoIXRoaXMuX2NvbW1hbmQpIHtcbiAgICAgIHRoaXMuX2NvbW1hbmQgPSBuZXcgQ29tbWFuZCgpO1xuICAgICAgQ0xJVXRpbHMuaW5pdGlhbGl6ZSh0aGlzLl9jb21tYW5kLCB0aGlzLnJvb3RQYXRoKTtcbiAgICB9XG4gICAgcmV0dXJuIHRoaXMuX2NvbW1hbmQ7XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIExvYWRzIGFuZCByZWdpc3RlcnMgYSBtb2R1bGUgZnJvbSBhIGZpbGVcbiAgICogQHN1bW1hcnkgRHluYW1pY2FsbHkgaW1wb3J0cyBhIENMSSBtb2R1bGUgZnJvbSB0aGUgc3BlY2lmaWVkIGZpbGUgcGF0aCwgaW5pdGlhbGl6ZXMgaXQsIGFuZCByZWdpc3RlcnMgaXQgaW4gdGhlIG1vZHVsZXMgY29sbGVjdGlvblxuICAgKlxuICAgKiBAcGFyYW0ge3N0cmluZ30gZmlsZVBhdGggUGF0aCB0byB0aGUgbW9kdWxlIGZpbGUgdG8gbG9hZFxuICAgKiBAcGFyYW0ge3N0cmluZ30gcm9vdFBhdGggUmVwb3NpdG9yeSByb290IHBhdGggdG8gZmluZCB0aGUgcGFja2FnZS5qc29uXG4gICAqIEByZXR1cm4ge1Byb21pc2U8c3RyaW5nPn0gQSBwcm9taXNlIHRoYXQgcmVzb2x2ZXMgdG8gdGhlIG1vZHVsZSBuYW1lXG4gICAqXG4gICAqIEBwcml2YXRlXG4gICAqIEBtZXJtYWlkXG4gICAqIHNlcXVlbmNlRGlhZ3JhbVxuICAgKiAgIHBhcnRpY2lwYW50IENsaVdyYXBwZXJcbiAgICogICBwYXJ0aWNpcGFudCBDTElVdGlsc1xuICAgKiAgIHBhcnRpY2lwYW50IE1vZHVsZVxuICAgKiAgIFxuICAgKiAgIENsaVdyYXBwZXItPj5DTElVdGlsczogbG9hZEZyb21GaWxlKGZpbGVQYXRoKVxuICAgKiAgIENMSVV0aWxzLS0+PkNsaVdyYXBwZXI6IG1vZHVsZVxuICAgKiAgIENsaVdyYXBwZXItPj5DbGlXcmFwcGVyOiBHZXQgbW9kdWxlIG5hbWVcbiAgICogICBDbGlXcmFwcGVyLT4+Q29tbWFuZDogbmV3IENvbW1hbmQoKVxuICAgKiAgIENvbW1hbmQtLT4+Q2xpV3JhcHBlcjogY21kXG4gICAqICAgQ2xpV3JhcHBlci0+PkNMSVV0aWxzOiBpbml0aWFsaXplKGNtZCwgcGF0aC5kaXJuYW1lKHJvb3RQYXRoKSlcbiAgICogICBDbGlXcmFwcGVyLT4+TW9kdWxlOiBtb2R1bGUoKVxuICAgKiAgIE5vdGUgb3ZlciBDbGlXcmFwcGVyLE1vZHVsZTogSGFuZGxlIFByb21pc2UgaWYgbmVlZGVkXG4gICAqICAgTW9kdWxlLS0+PkNsaVdyYXBwZXI6IENvbW1hbmQgaW5zdGFuY2VcbiAgICogICBDbGlXcmFwcGVyLT4+Q2xpV3JhcHBlcjogU3RvcmUgaW4gbW9kdWxlc1tuYW1lXVxuICAgKiAgIENsaVdyYXBwZXItLT4+Q2xpV3JhcHBlcjogUmV0dXJuIG5hbWVcbiAgICovXG4gIHByaXZhdGUgYXN5bmMgbG9hZChmaWxlUGF0aDogc3RyaW5nLCByb290UGF0aDogc3RyaW5nKTogUHJvbWlzZTxzdHJpbmc+IHtcbiAgICBsZXQgbmFtZTtcbiAgICB0cnkge1xuICAgICAgY29uc3QgbW9kdWxlID0gYXdhaXQgQ0xJVXRpbHMubG9hZEZyb21GaWxlKGZpbGVQYXRoKTtcbiAgICAgIG5hbWUgPSBtb2R1bGUubmFtZTtcbiAgICAgIGNvbnN0IGNtZCA9IG5ldyBDb21tYW5kKCk7XG4gICAgICBDTElVdGlscy5pbml0aWFsaXplKGNtZCwgcm9vdFBhdGgpO1xuICAgICAgbGV0IG0gPSBtb2R1bGUoKTtcbiAgICAgIGlmIChtIGluc3RhbmNlb2YgUHJvbWlzZSkgbSA9IGF3YWl0IG07XG4gICAgICB0aGlzLm1vZHVsZXNbbmFtZV0gPSBtO1xuICAgIH0gY2F0Y2ggKGU6IHVua25vd24pIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgYGZhaWxlZCB0byBsb2FkIG1vZHVsZSAke25hbWUgfHwgXCJ1bm5hbWVkXCJ9IHVuZGVyICR7ZmlsZVBhdGh9OiAke2UgaW5zdGFuY2VvZiBFcnJvciA/IGUubWVzc2FnZSA6IGV9YFxuICAgICAgKTtcbiAgICB9XG4gICAgcmV0dXJuIG5hbWU7XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIEZpbmRzIGFuZCBsb2FkcyBhbGwgQ0xJIG1vZHVsZXMgaW4gdGhlIGJhc2VQYXRoXG4gICAqIEBzdW1tYXJ5IFVzZXMgdGhlIGNyYXdsIG1ldGhvZCB0byBmaW5kIGFsbCBDTEkgbW9kdWxlcyBpbiB0aGUgc3BlY2lmaWVkIGJhc2UgcGF0aCwgXG4gICAqIHRoZW4gbG9hZHMgYW5kIHJlZ2lzdGVycyBlYWNoIG1vZHVsZSBhcyBhIHN1YmNvbW1hbmRcbiAgICogXG4gICAqIEByZXR1cm4ge1Byb21pc2U8dm9pZD59IEEgcHJvbWlzZSB0aGF0IHJlc29sdmVzIHdoZW4gYWxsIG1vZHVsZXMgYXJlIGxvYWRlZFxuICAgKiBcbiAgICogQHByaXZhdGVcbiAgICogQG1lcm1haWRcbiAgICogc2VxdWVuY2VEaWFncmFtXG4gICAqICAgcGFydGljaXBhbnQgQ2xpV3JhcHBlclxuICAgKiAgIHBhcnRpY2lwYW50IEZpbGVzeXN0ZW1cbiAgICogICBwYXJ0aWNpcGFudCBNb2R1bGVcbiAgICogICBcbiAgICogICBDbGlXcmFwcGVyLT4+RmlsZXN5c3RlbTogSm9pbiBiYXNlUGF0aCB3aXRoIGN3ZFxuICAgKiAgIENsaVdyYXBwZXItPj5DbGlXcmFwcGVyOiBjcmF3bChiYXNlUGF0aCwgY3Jhd2xMZXZlbHMpXG4gICAqICAgQ2xpV3JhcHBlci0tPj5DbGlXcmFwcGVyOiBtb2R1bGVzW11cbiAgICogICBsb29wIEZvciBlYWNoIG1vZHVsZVxuICAgKiAgICAgYWx0IE5vdCBAZGVjYWYtdHMvY2xpXG4gICAqICAgICAgIENsaVdyYXBwZXItPj5DbGlXcmFwcGVyOiBsb2FkKG1vZHVsZSwgY3dkKVxuICAgKiAgICAgICBDbGlXcmFwcGVyLS0+PkNsaVdyYXBwZXI6IG5hbWVcbiAgICogICAgICAgQ2xpV3JhcHBlci0+PkNsaVdyYXBwZXI6IENoZWNrIGlmIGNvbW1hbmQgZXhpc3RzXG4gICAqICAgICAgIGFsdCBDb21tYW5kIGRvZXNuJ3QgZXhpc3RcbiAgICogICAgICAgICBDbGlXcmFwcGVyLT4+Q29tbWFuZDogY29tbWFuZChuYW1lKS5hZGRDb21tYW5kKG1vZHVsZXNbbmFtZV0pXG4gICAqICAgICAgIGVuZFxuICAgKiAgICAgZW5kXG4gICAqICAgZW5kXG4gICAqICAgQ2xpV3JhcHBlci0+PkNvbnNvbGU6IExvZyBsb2FkZWQgbW9kdWxlc1xuICAgKi9cbiAgcHJpdmF0ZSBhc3luYyBib290KCkge1xuICAgIGNvbnN0IGJhc2VQYXRoID0gcGF0aC5yZXNvbHZlKHRoaXMucm9vdFBhdGgsIHRoaXMuYmFzZVBhdGgpO1xuICAgIGNvbnN0IG1vZHVsZXMgPSB0aGlzLmNyYXdsKGJhc2VQYXRoLCB0aGlzLmNyYXdsTGV2ZWxzKTtcbiAgICBmb3IgKGNvbnN0IG1vZHVsZSBvZiBtb2R1bGVzKSB7XG4gICAgICBpZiAobW9kdWxlLmluY2x1ZGVzKFwiQGRlY2FmLXRzL2NsaVwiKSkge1xuICAgICAgICBjb250aW51ZTtcbiAgICAgIH1cbiAgICAgIGxldCBuYW1lOiBzdHJpbmc7XG4gICAgICB0cnkge1xuICAgICAgICBuYW1lID0gYXdhaXQgdGhpcy5sb2FkKG1vZHVsZSwgdGhpcy5yb290UGF0aCk7XG4gICAgICB9IGNhdGNoIChlOiB1bmtub3duKSB7XG4gICAgICAgIGNvbnNvbGUuZXJyb3IoZSk7XG4gICAgICAgIGNvbnRpbnVlO1xuICAgICAgfVxuXG4gICAgICBpZiAoXG4gICAgICAgICF0aGlzLmNvbW1hbmQuY29tbWFuZHMuZmluZChcbiAgICAgICAgICAoYykgPT4gKGMgYXMgdW5rbm93biBhcyBSZWNvcmQ8c3RyaW5nLCBzdHJpbmc+KVtcIl9uYW1lXCJdID09PSBuYW1lXG4gICAgICAgIClcbiAgICAgIClcbiAgICAgICAgdHJ5IHtcbiAgICAgICAgICB0aGlzLmNvbW1hbmQuY29tbWFuZChuYW1lKS5hZGRDb21tYW5kKHRoaXMubW9kdWxlc1tuYW1lXSk7XG4gICAgICAgIH0gY2F0Y2ggKGU6IHVua25vd24pIHtcbiAgICAgICAgICBjb25zb2xlLmVycm9yKGUpO1xuICAgICAgICB9XG4gICAgfVxuICAgIGNvbnNvbGUubG9nKFxuICAgICAgYGxvYWRlZCBtb2R1bGVzOlxcbiR7T2JqZWN0LmtleXModGhpcy5tb2R1bGVzKVxuICAgICAgICAubWFwKChrKSA9PiBgLSAke2t9YClcbiAgICAgICAgLmpvaW4oXCJcXG5cIil9YFxuICAgICk7XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIFJlY3Vyc2l2ZWx5IHNlYXJjaGVzIGZvciBDTEkgbW9kdWxlIGZpbGVzIGluIHRoZSBkaXJlY3Rvcnkgc3RydWN0dXJlXG4gICAqIEBzdW1tYXJ5IENyYXdscyB0aGUgYmFzZVBhdGggdXAgdG8gdGhlIHNwZWNpZmllZCBudW1iZXIgb2YgZm9sZGVyIGxldmVscyB0byBmaW5kIGZpbGVzIG5hbWVkIGFjY29yZGluZyB0byBDTElfRklMRV9OQU1FXG4gICAqIFxuICAgKiBAcGFyYW0ge3N0cmluZ30gYmFzZVBhdGggVGhlIGFic29sdXRlIGJhc2UgcGF0aCB0byBzdGFydCBzZWFyY2hpbmcgaW5cbiAgICogQHBhcmFtIHtudW1iZXJ9IFtsZXZlbHM9Ml0gVGhlIG1heGltdW0gbnVtYmVyIG9mIGRpcmVjdG9yeSBsZXZlbHMgdG8gY3Jhd2xcbiAgICogQHJldHVybiB7c3RyaW5nW119IEFuIGFycmF5IG9mIGZpbGUgcGF0aHMgdG8gQ0xJIG1vZHVsZXNcbiAgICogXG4gICAqIEBwcml2YXRlXG4gICAqL1xuICBwcml2YXRlIGNyYXdsKGJhc2VQYXRoOiBzdHJpbmcsIGxldmVsczogbnVtYmVyID0gMikge1xuICAgIGlmIChsZXZlbHMgPD0gMCkgcmV0dXJuIFtdO1xuICAgIHJldHVybiBmcy5yZWFkZGlyU3luYyhiYXNlUGF0aCkucmVkdWNlKChhY2N1bTogc3RyaW5nW10sIGZpbGUpID0+IHtcbiAgICAgIGZpbGUgPSBwYXRoLmpvaW4oYmFzZVBhdGgsIGZpbGUpO1xuICAgICAgaWYgKGZzLnN0YXRTeW5jKGZpbGUpLmlzRGlyZWN0b3J5KCkpIHtcbiAgICAgICAgYWNjdW0ucHVzaCguLi50aGlzLmNyYXdsKGZpbGUsIGxldmVscyAtIDEpKTtcbiAgICAgIH0gZWxzZSBpZiAoZmlsZS5tYXRjaChuZXcgUmVnRXhwKGAke0NMSV9GSUxFX05BTUV9LltjbV0/anMkYCwgXCJnbVwiKSkpIHtcbiAgICAgICAgYWNjdW0ucHVzaChmaWxlKTtcbiAgICAgIH1cbiAgICAgIHJldHVybiBhY2N1bTtcbiAgICB9LCBbXSk7XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIEV4ZWN1dGVzIHRoZSBDTEkgd2l0aCB0aGUgcHJvdmlkZWQgYXJndW1lbnRzXG4gICAqIEBzdW1tYXJ5IEJvb3RzIHRoZSBDTEkgYnkgbG9hZGluZyBhbGwgbW9kdWxlcywgdGhlbiBwYXJzZXMgYW5kIGV4ZWN1dGVzIHRoZSBjb21tYW5kIHNwZWNpZmllZCBpbiB0aGUgYXJndW1lbnRzXG4gICAqXG4gICAqIEBwYXJhbSB7c3RyaW5nW119IFthcmdzPXByb2Nlc3MuYXJndl0gQ29tbWFuZCBsaW5lIGFyZ3VtZW50cyB0byBwYXJzZSBhbmQgZXhlY3V0ZVxuICAgKiBAcmV0dXJuIHtQcm9taXNlPHZvaWQ+fSBBIHByb21pc2UgdGhhdCByZXNvbHZlcyB3aGVuIHRoZSBjb21tYW5kIGV4ZWN1dGlvbiBpcyBjb21wbGV0ZVxuICAgKiBcbiAgICogQG1lcm1haWRcbiAgICogc2VxdWVuY2VEaWFncmFtXG4gICAqICAgcGFydGljaXBhbnQgQ2xpZW50XG4gICAqICAgcGFydGljaXBhbnQgQ2xpV3JhcHBlclxuICAgKiAgIHBhcnRpY2lwYW50IENvbW1hbmRcbiAgICogICBcbiAgICogICBDbGllbnQtPj5DbGlXcmFwcGVyOiBydW4oYXJncylcbiAgICogICBDbGlXcmFwcGVyLT4+Q2xpV3JhcHBlcjogYm9vdCgpXG4gICAqICAgTm90ZSBvdmVyIENsaVdyYXBwZXI6IExvYWRzIGFsbCBtb2R1bGVzXG4gICAqICAgQ2xpV3JhcHBlci0+PkNvbW1hbmQ6IHBhcnNlQXN5bmMoYXJncylcbiAgICogICBDb21tYW5kLS0+PkNsaVdyYXBwZXI6IHJlc3VsdFxuICAgKiAgIENsaVdyYXBwZXItLT4+Q2xpZW50OiByZXN1bHRcbiAgICovXG4gIGFzeW5jIHJ1bihhcmdzOiBzdHJpbmdbXSA9IHByb2Nlc3MuYXJndikge1xuICAgIGF3YWl0IHRoaXMuYm9vdCgpO1xuICAgIHJldHVybiB0aGlzLmNvbW1hbmQucGFyc2VBc3luYyhhcmdzKTtcbiAgfVxufVxuIl19

package/lib/CliWrapper.d.ts

@@ -1,10 +1,18 @@
 import { Command } from "commander";
 /**
- * @summary Util class to handle CLI functionality from all Decaf modules
- * @description CLI handler class
+ * @description Utility class to handle CLI functionality from all Decaf modules
+ * @summary This class provides a wrapper around Commander.js to handle CLI commands from different Decaf modules.
+ * It crawls the filesystem to find CLI modules, loads them, and registers their commands.
  *
- * @param {string} [basepath] the base path to look for modules in. defaults to `./`
- * @param {string} [crawlLevels] folders to crawl to find modules from the basePath. defaults to 4
+ * @param {string} [basePath] The base path to look for modules in. Defaults to `./`
+ * @param {number} [crawlLevels] Number of folder levels to crawl to find modules from the basePath. Defaults to 4
+ *
+ * @example
+ * // Create a new CLI wrapper and run it with custom options
+ * const cli = new CliWrapper('./src', 2);
+ * cli.run(process.argv).then(() => {
+ *   console.log('CLI commands executed successfully');
+ * });
  *
  * @class CliWrapper
  */
@@ -13,39 +21,103 @@ export declare class CliWrapper {
     private crawlLevels;
     private _command?;
     private modules;
+    private readonly rootPath;
     constructor(basePath?: string, crawlLevels?: number);
     /**
-     * @description Retrieves and initializes the {@link Command} object
+     * @description Retrieves and initializes the Commander Command object
+     * @summary Lazy-loads the Command object, initializing it with the package name, description, and version
+     * @return {Command} The initialized Command object
      * @private
      */
     private get command();
     /**
-     * @description loads and registers module from a file
+     * @description Loads and registers a module from a file
+     * @summary Dynamically imports a CLI module from the specified file path, initializes it, and registers it in the modules collection
      *
-     * @param {string} filePath path to look for modules
-     * @param {string} rootPath repo root to find the package.json
-     * @return {string} the module name
+     * @param {string} filePath Path to the module file to load
+     * @param {string} rootPath Repository root path to find the package.json
+     * @return {Promise<string>} A promise that resolves to the module name
      *
      * @private
+     * @mermaid
+     * sequenceDiagram
+     *   participant CliWrapper
+     *   participant CLIUtils
+     *   participant Module
+     *
+     *   CliWrapper->>CLIUtils: loadFromFile(filePath)
+     *   CLIUtils-->>CliWrapper: module
+     *   CliWrapper->>CliWrapper: Get module name
+     *   CliWrapper->>Command: new Command()
+     *   Command-->>CliWrapper: cmd
+     *   CliWrapper->>CLIUtils: initialize(cmd, path.dirname(rootPath))
+     *   CliWrapper->>Module: module()
+     *   Note over CliWrapper,Module: Handle Promise if needed
+     *   Module-->>CliWrapper: Command instance
+     *   CliWrapper->>CliWrapper: Store in modules[name]
+     *   CliWrapper-->>CliWrapper: Return name
      */
     private load;
     /**
-     * @description finds all the cli modules in the basePath via {@link CliWrapper.crawl}
-     * and loads them
+     * @description Finds and loads all CLI modules in the basePath
+     * @summary Uses the crawl method to find all CLI modules in the specified base path,
+     * then loads and registers each module as a subcommand
+     *
+     * @return {Promise<void>} A promise that resolves when all modules are loaded
+     *
      * @private
+     * @mermaid
+     * sequenceDiagram
+     *   participant CliWrapper
+     *   participant Filesystem
+     *   participant Module
+     *
+     *   CliWrapper->>Filesystem: Join basePath with cwd
+     *   CliWrapper->>CliWrapper: crawl(basePath, crawlLevels)
+     *   CliWrapper-->>CliWrapper: modules[]
+     *   loop For each module
+     *     alt Not @decaf-ts/cli
+     *       CliWrapper->>CliWrapper: load(module, cwd)
+     *       CliWrapper-->>CliWrapper: name
+     *       CliWrapper->>CliWrapper: Check if command exists
+     *       alt Command doesn't exist
+     *         CliWrapper->>Command: command(name).addCommand(modules[name])
+     *       end
+     *     end
+     *   end
+     *   CliWrapper->>Console: Log loaded modules
      */
     private boot;
     /**
-     * @description crawls the basePath up for 'levels' folders to find a module,eg a {@link CLI_FILE_NAME} named file
-     * @param {string} basePath the relative base batch to start searching in
-     * @param {number} [levels] the max number of levels to crawl. defaults to 2
+     * @description Recursively searches for CLI module files in the directory structure
+     * @summary Crawls the basePath up to the specified number of folder levels to find files named according to CLI_FILE_NAME
+     *
+     * @param {string} basePath The absolute base path to start searching in
+     * @param {number} [levels=2] The maximum number of directory levels to crawl
+     * @return {string[]} An array of file paths to CLI modules
+     *
      * @private
      */
     private crawl;
     /**
-     * @description runs the given command
+     * @description Executes the CLI with the provided arguments
+     * @summary Boots the CLI by loading all modules, then parses and executes the command specified in the arguments
+     *
+     * @param {string[]} [args=process.argv] Command line arguments to parse and execute
+     * @return {Promise<void>} A promise that resolves when the command execution is complete
+     *
+     * @mermaid
+     * sequenceDiagram
+     *   participant Client
+     *   participant CliWrapper
+     *   participant Command
      *
-     * @param {string[]} [args] args to run. defaults to process.argv
+     *   Client->>CliWrapper: run(args)
+     *   CliWrapper->>CliWrapper: boot()
+     *   Note over CliWrapper: Loads all modules
+     *   CliWrapper->>Command: parseAsync(args)
+     *   Command-->>CliWrapper: result
+     *   CliWrapper-->>Client: result
      */
     run(args?: string[]): Promise<Command>;
 }

package/lib/bin/cli.cjs

@@ -4,15 +4,23 @@
  * BIN_CALL_PLACEHOLDER - DO NOT REMOVE
  */
 /**
- * @description Decaf-ts' CLI entry file
- * @summary This file will crawl the current working directory for files called {@link CLI_FILE_NAME}
- * within the @decaf-ts namespace and load then as subcommands
+ * @description Decaf-ts' CLI entry point
+ * @summary This file serves as the main executable entry point for the Decaf CLI. It creates a CliWrapper instance
+ * and runs it with the process arguments. The CLI will crawl the current working directory for files called
+ * CLI_FILE_NAME within the @decaf-ts namespace and load them as subcommands.
  *
  * @example
- * run module command     - $ npx decaf <module name> <module command> ...<module command options>
- * get module help        - $ npx decaf help <module name>;
- * list imported modules  - $ npx decaf list;
- * get cli help           - $ npx decaf help;
+ * // Run a module command
+ * $ npx decaf <module name> <module command> ...<module command options>
+ *
+ * // Get help for a specific module
+ * $ npx decaf help <module name>
+ *
+ * // List all imported modules
+ * $ npx decaf list
+ *
+ * // Get general CLI help
+ * $ npx decaf help
  *
  * @memberOf module:CLI
  */
@@ -27,4 +35,4 @@ new CliWrapper_1.CliWrapper()
     console.error(`${e instanceof Error ? e.message : e}`);
     process.exit(1);
 });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2Jpbi9jbGkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOztHQUVHO0FBQ0g7Ozs7Ozs7Ozs7OztHQVlHOztBQUVILG9EQUEyQztBQUMzQyxJQUFJLHVCQUFVLEVBQUU7S0FDYixHQUFHLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQztLQUNqQixJQUFJLENBQUMsR0FBRyxFQUFFO0lBQ1QsT0FBTyxDQUFDLEdBQUcsQ0FBQyxzREFBc0QsQ0FBQyxDQUFDO0FBQ3RFLENBQUMsQ0FBQztLQUNELEtBQUssQ0FBQyxDQUFDLENBQVUsRUFBRSxFQUFFO0lBQ3BCLE9BQU8sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBQ3ZELE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7QUFDbEIsQ0FBQyxDQUFDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEJJTl9DQUxMX1BMQUNFSE9MREVSIC0gRE8gTk9UIFJFTU9WRVxuICovXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBEZWNhZi10cycgQ0xJIGVudHJ5IGZpbGVcbiAqIEBzdW1tYXJ5IFRoaXMgZmlsZSB3aWxsIGNyYXdsIHRoZSBjdXJyZW50IHdvcmtpbmcgZGlyZWN0b3J5IGZvciBmaWxlcyBjYWxsZWQge0BsaW5rIENMSV9GSUxFX05BTUV9XG4gKiB3aXRoaW4gdGhlIEBkZWNhZi10cyBuYW1lc3BhY2UgYW5kIGxvYWQgdGhlbiBhcyBzdWJjb21tYW5kc1xuICpcbiAqIEBleGFtcGxlXG4gKiBydW4gbW9kdWxlIGNvbW1hbmQgICAgIC0gJCBucHggZGVjYWYgPG1vZHVsZSBuYW1lPiA8bW9kdWxlIGNvbW1hbmQ+IC4uLjxtb2R1bGUgY29tbWFuZCBvcHRpb25zPlxuICogZ2V0IG1vZHVsZSBoZWxwICAgICAgICAtICQgbnB4IGRlY2FmIGhlbHAgPG1vZHVsZSBuYW1lPjtcbiAqIGxpc3QgaW1wb3J0ZWQgbW9kdWxlcyAgLSAkIG5weCBkZWNhZiBsaXN0O1xuICogZ2V0IGNsaSBoZWxwICAgICAgICAgICAtICQgbnB4IGRlY2FmIGhlbHA7XG4gKlxuICogQG1lbWJlck9mIG1vZHVsZTpDTElcbiAqL1xuXG5pbXBvcnQgeyBDbGlXcmFwcGVyIH0gZnJvbSBcIi4uL0NsaVdyYXBwZXJcIjtcbm5ldyBDbGlXcmFwcGVyKClcbiAgLnJ1bihwcm9jZXNzLmFyZ3YpXG4gIC50aGVuKCgpID0+IHtcbiAgICBjb25zb2xlLmxvZyhcIlRoYW5rIHlvdSBmb3IgdXNpbmcgZGVjYWYtdHMnIGNvbW1hbmQgbGluZSBpbnRlcmZhY2VcIik7XG4gIH0pXG4gIC5jYXRjaCgoZTogdW5rbm93bikgPT4ge1xuICAgIGNvbnNvbGUuZXJyb3IoYCR7ZSBpbnN0YW5jZW9mIEVycm9yID8gZS5tZXNzYWdlIDogZX1gKTtcbiAgICBwcm9jZXNzLmV4aXQoMSk7XG4gIH0pO1xuIl19
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2Jpbi9jbGkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOztHQUVHO0FBQ0g7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBb0JHOztBQUVILG9EQUEyQztBQUMzQyxJQUFJLHVCQUFVLEVBQUU7S0FDYixHQUFHLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQztLQUNqQixJQUFJLENBQUMsR0FBRyxFQUFFO0lBQ1QsT0FBTyxDQUFDLEdBQUcsQ0FBQyxzREFBc0QsQ0FBQyxDQUFDO0FBQ3RFLENBQUMsQ0FBQztLQUNELEtBQUssQ0FBQyxDQUFDLENBQVUsRUFBRSxFQUFFO0lBQ3BCLE9BQU8sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBQ3ZELE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7QUFDbEIsQ0FBQyxDQUFDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEJJTl9DQUxMX1BMQUNFSE9MREVSIC0gRE8gTk9UIFJFTU9WRVxuICovXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBEZWNhZi10cycgQ0xJIGVudHJ5IHBvaW50XG4gKiBAc3VtbWFyeSBUaGlzIGZpbGUgc2VydmVzIGFzIHRoZSBtYWluIGV4ZWN1dGFibGUgZW50cnkgcG9pbnQgZm9yIHRoZSBEZWNhZiBDTEkuIEl0IGNyZWF0ZXMgYSBDbGlXcmFwcGVyIGluc3RhbmNlXG4gKiBhbmQgcnVucyBpdCB3aXRoIHRoZSBwcm9jZXNzIGFyZ3VtZW50cy4gVGhlIENMSSB3aWxsIGNyYXdsIHRoZSBjdXJyZW50IHdvcmtpbmcgZGlyZWN0b3J5IGZvciBmaWxlcyBjYWxsZWRcbiAqIENMSV9GSUxFX05BTUUgd2l0aGluIHRoZSBAZGVjYWYtdHMgbmFtZXNwYWNlIGFuZCBsb2FkIHRoZW0gYXMgc3ViY29tbWFuZHMuXG4gKlxuICogQGV4YW1wbGVcbiAqIC8vIFJ1biBhIG1vZHVsZSBjb21tYW5kXG4gKiAkIG5weCBkZWNhZiA8bW9kdWxlIG5hbWU+IDxtb2R1bGUgY29tbWFuZD4gLi4uPG1vZHVsZSBjb21tYW5kIG9wdGlvbnM+XG4gKiBcbiAqIC8vIEdldCBoZWxwIGZvciBhIHNwZWNpZmljIG1vZHVsZVxuICogJCBucHggZGVjYWYgaGVscCA8bW9kdWxlIG5hbWU+XG4gKiBcbiAqIC8vIExpc3QgYWxsIGltcG9ydGVkIG1vZHVsZXNcbiAqICQgbnB4IGRlY2FmIGxpc3RcbiAqIFxuICogLy8gR2V0IGdlbmVyYWwgQ0xJIGhlbHBcbiAqICQgbnB4IGRlY2FmIGhlbHBcbiAqXG4gKiBAbWVtYmVyT2YgbW9kdWxlOkNMSVxuICovXG5cbmltcG9ydCB7IENsaVdyYXBwZXIgfSBmcm9tIFwiLi4vQ2xpV3JhcHBlclwiO1xubmV3IENsaVdyYXBwZXIoKVxuICAucnVuKHByb2Nlc3MuYXJndilcbiAgLnRoZW4oKCkgPT4ge1xuICAgIGNvbnNvbGUubG9nKFwiVGhhbmsgeW91IGZvciB1c2luZyBkZWNhZi10cycgY29tbWFuZCBsaW5lIGludGVyZmFjZVwiKTtcbiAgfSlcbiAgLmNhdGNoKChlOiB1bmtub3duKSA9PiB7XG4gICAgY29uc29sZS5lcnJvcihgJHtlIGluc3RhbmNlb2YgRXJyb3IgPyBlLm1lc3NhZ2UgOiBlfWApO1xuICAgIHByb2Nlc3MuZXhpdCgxKTtcbiAgfSk7XG4iXX0=

package/lib/bin/cli.d.ts

@@ -2,15 +2,23 @@
  * BIN_CALL_PLACEHOLDER - DO NOT REMOVE
  */
 /**
- * @description Decaf-ts' CLI entry file
- * @summary This file will crawl the current working directory for files called {@link CLI_FILE_NAME}
- * within the @decaf-ts namespace and load then as subcommands
+ * @description Decaf-ts' CLI entry point
+ * @summary This file serves as the main executable entry point for the Decaf CLI. It creates a CliWrapper instance
+ * and runs it with the process arguments. The CLI will crawl the current working directory for files called
+ * CLI_FILE_NAME within the @decaf-ts namespace and load them as subcommands.
  *
  * @example
- * run module command     - $ npx decaf <module name> <module command> ...<module command options>
- * get module help        - $ npx decaf help <module name>;
- * list imported modules  - $ npx decaf list;
- * get cli help           - $ npx decaf help;
+ * // Run a module command
+ * $ npx decaf <module name> <module command> ...<module command options>
+ *
+ * // Get help for a specific module
+ * $ npx decaf help <module name>
+ *
+ * // List all imported modules
+ * $ npx decaf list
+ *
+ * // Get general CLI help
+ * $ npx decaf help
  *
  * @memberOf module:CLI
  */

package/lib/constants.cjs

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLI_FILE_NAME = void 0;
 /**
- * @description The name for decaf cli modules where each library must export
- * a single {@link CliModule}
+ * @description The filename that identifies Decaf CLI modules
+ * @summary The standard filename for CLI module files where each library must export a single CliModule function
  *
- * @constant
- * @memberOf module:CLI.cli
+ * @const CLI_FILE_NAME
+ * @memberOf module:CLI
  */
 exports.CLI_FILE_NAME = "cli-module";
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbnN0YW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFHQTs7Ozs7O0dBTUc7QUFDVSxRQUFBLGFBQWEsR0FBRyxZQUFZLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLXVudXNlZC12YXJzXG5pbXBvcnQgeyBDbGlNb2R1bGUgfSBmcm9tIFwiLi90eXBlc1wiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBUaGUgbmFtZSBmb3IgZGVjYWYgY2xpIG1vZHVsZXMgd2hlcmUgZWFjaCBsaWJyYXJ5IG11c3QgZXhwb3J0XG4gKiBhIHNpbmdsZSB7QGxpbmsgQ2xpTW9kdWxlfVxuICpcbiAqIEBjb25zdGFudFxuICogQG1lbWJlck9mIG1vZHVsZTpDTEkuY2xpXG4gKi9cbmV4cG9ydCBjb25zdCBDTElfRklMRV9OQU1FID0gXCJjbGktbW9kdWxlXCI7XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbnN0YW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFHQTs7Ozs7O0dBTUc7QUFDVSxRQUFBLGFBQWEsR0FBRyxZQUFZLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLXVudXNlZC12YXJzXG5pbXBvcnQgeyBDbGlNb2R1bGUgfSBmcm9tIFwiLi90eXBlc1wiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBUaGUgZmlsZW5hbWUgdGhhdCBpZGVudGlmaWVzIERlY2FmIENMSSBtb2R1bGVzXG4gKiBAc3VtbWFyeSBUaGUgc3RhbmRhcmQgZmlsZW5hbWUgZm9yIENMSSBtb2R1bGUgZmlsZXMgd2hlcmUgZWFjaCBsaWJyYXJ5IG11c3QgZXhwb3J0IGEgc2luZ2xlIENsaU1vZHVsZSBmdW5jdGlvblxuICpcbiAqIEBjb25zdCBDTElfRklMRV9OQU1FXG4gKiBAbWVtYmVyT2YgbW9kdWxlOkNMSVxuICovXG5leHBvcnQgY29uc3QgQ0xJX0ZJTEVfTkFNRSA9IFwiY2xpLW1vZHVsZVwiO1xuIl19

package/lib/constants.d.ts

@@ -1,8 +1,8 @@
 /**
- * @description The name for decaf cli modules where each library must export
- * a single {@link CliModule}
+ * @description The filename that identifies Decaf CLI modules
+ * @summary The standard filename for CLI module files where each library must export a single CliModule function
  *
- * @constant
- * @memberOf module:CLI.cli
+ * @const CLI_FILE_NAME
+ * @memberOf module:CLI
  */
 export declare const CLI_FILE_NAME = "cli-module";

package/lib/demo/cli-module.cjs

@@ -3,29 +3,37 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = demo;
 const commander_1 = require("commander");
 /**
- * @description demo CLI module for libraries
- * @summary minimal implementation on how to extend the decaf-ts cli
+ * @description Demo CLI module for Decaf libraries
+ * @summary A minimal implementation showing how to extend the Decaf CLI with custom commands.
+ * This module demonstrates the pattern for creating CLI modules that can be discovered and loaded by the Decaf CLI.
  *
- * - the function must be ***exported by default***!;
- * - The name of the returned function will be considered to be the base command;
- * - the command you return will be considered as a subCommand and will not be called directly
- * - Commands must be transpiled under the same ts-configuration as this module
- * (so copy the ts-config of this module to your project. we propose `tsconfig.cli.json`)
- * - Following your build pipeline include `tsc --project tsconfig.cli.json --outDir <dist folder>/cli`
- *
- * Note the extra use of `cli` on the outDir param. this is meant to completely separate
- * the cli code from your source, in case they are transpiled under different ts-configurations
- *
- * @returns {Command} the subCommand to be added to the main decaf CLI
+ * @return {Command} The Command object to be added to the main Decaf CLI
  *
  * @function demo
- *
- * @category Command Line Interface
+ * @memberOf module:CLI
  *
  * @example
- * `npx decaf demo command "something something" `
+ * // Run the demo command with an argument
+ * npx decaf demo command "something something"
+ *
+ * // Output:
+ * // executed demo command with type variable: something something
+ *
+ * @mermaid
+ * sequenceDiagram
+ *   participant User
+ *   participant CLI
+ *   participant DemoModule
+ *   participant Command
  *
- * will output `executed demo command with type variable: something something`
+ *   User->>CLI: npx decaf demo command "arg"
+ *   CLI->>DemoModule: Load module
+ *   DemoModule->>Command: Create command
+ *   Command->>Command: Configure action
+ *   Command-->>DemoModule: Return command
+ *   DemoModule-->>CLI: Return command
+ *   CLI->>Command: Execute with args
+ *   Command->>Console: Log output
  */
 function demo() {
     return new commander_1.Command()
@@ -35,4 +43,4 @@ function demo() {
         console.log(`executed demo command with type variable: ${args}`);
     });
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLW1vZHVsZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kZW1vL2NsaS1tb2R1bGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUEyQkEsdUJBT0M7QUFsQ0QseUNBQW9DO0FBRXBDOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0F3Qkc7QUFDSCxTQUF3QixJQUFJO0lBQzFCLE9BQU8sSUFBSSxtQkFBTyxFQUFFO1NBQ2pCLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQztTQUN6QixXQUFXLENBQUMsZ0JBQWdCLENBQUM7U0FDN0IsTUFBTSxDQUFDLENBQUMsSUFBWSxFQUFFLEVBQUU7UUFDdkIsT0FBTyxDQUFDLEdBQUcsQ0FBQyw2Q0FBNkMsSUFBSSxFQUFFLENBQUMsQ0FBQztJQUNuRSxDQUFDLENBQUMsQ0FBQztBQUNQLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBDb21tYW5kIH0gZnJvbSBcImNvbW1hbmRlclwiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBkZW1vIENMSSBtb2R1bGUgZm9yIGxpYnJhcmllc1xuICogQHN1bW1hcnkgbWluaW1hbCBpbXBsZW1lbnRhdGlvbiBvbiBob3cgdG8gZXh0ZW5kIHRoZSBkZWNhZi10cyBjbGlcbiAqXG4gKiAtIHRoZSBmdW5jdGlvbiBtdXN0IGJlICoqKmV4cG9ydGVkIGJ5IGRlZmF1bHQqKiohO1xuICogLSBUaGUgbmFtZSBvZiB0aGUgcmV0dXJuZWQgZnVuY3Rpb24gd2lsbCBiZSBjb25zaWRlcmVkIHRvIGJlIHRoZSBiYXNlIGNvbW1hbmQ7XG4gKiAtIHRoZSBjb21tYW5kIHlvdSByZXR1cm4gd2lsbCBiZSBjb25zaWRlcmVkIGFzIGEgc3ViQ29tbWFuZCBhbmQgd2lsbCBub3QgYmUgY2FsbGVkIGRpcmVjdGx5XG4gKiAtIENvbW1hbmRzIG11c3QgYmUgdHJhbnNwaWxlZCB1bmRlciB0aGUgc2FtZSB0cy1jb25maWd1cmF0aW9uIGFzIHRoaXMgbW9kdWxlXG4gKiAoc28gY29weSB0aGUgdHMtY29uZmlnIG9mIHRoaXMgbW9kdWxlIHRvIHlvdXIgcHJvamVjdC4gd2UgcHJvcG9zZSBgdHNjb25maWcuY2xpLmpzb25gKVxuICogLSBGb2xsb3dpbmcgeW91ciBidWlsZCBwaXBlbGluZSBpbmNsdWRlIGB0c2MgLS1wcm9qZWN0IHRzY29uZmlnLmNsaS5qc29uIC0tb3V0RGlyIDxkaXN0IGZvbGRlcj4vY2xpYFxuICpcbiAqIE5vdGUgdGhlIGV4dHJhIHVzZSBvZiBgY2xpYCBvbiB0aGUgb3V0RGlyIHBhcmFtLiB0aGlzIGlzIG1lYW50IHRvIGNvbXBsZXRlbHkgc2VwYXJhdGVcbiAqIHRoZSBjbGkgY29kZSBmcm9tIHlvdXIgc291cmNlLCBpbiBjYXNlIHRoZXkgYXJlIHRyYW5zcGlsZWQgdW5kZXIgZGlmZmVyZW50IHRzLWNvbmZpZ3VyYXRpb25zXG4gKlxuICogQHJldHVybnMge0NvbW1hbmR9IHRoZSBzdWJDb21tYW5kIHRvIGJlIGFkZGVkIHRvIHRoZSBtYWluIGRlY2FmIENMSVxuICpcbiAqIEBmdW5jdGlvbiBkZW1vXG4gKlxuICogQGNhdGVnb3J5IENvbW1hbmQgTGluZSBJbnRlcmZhY2VcbiAqXG4gKiBAZXhhbXBsZVxuICogYG5weCBkZWNhZiBkZW1vIGNvbW1hbmQgXCJzb21ldGhpbmcgc29tZXRoaW5nXCIgYFxuICpcbiAqIHdpbGwgb3V0cHV0IGBleGVjdXRlZCBkZW1vIGNvbW1hbmQgd2l0aCB0eXBlIHZhcmlhYmxlOiBzb21ldGhpbmcgc29tZXRoaW5nYFxuICovXG5leHBvcnQgZGVmYXVsdCBmdW5jdGlvbiBkZW1vKCk6IENvbW1hbmQge1xuICByZXR1cm4gbmV3IENvbW1hbmQoKVxuICAgIC5jb21tYW5kKFwiY29tbWFuZCA8dHlwZT5cIilcbiAgICAuZGVzY3JpcHRpb24oXCJBIGRlbW8gY29tbWFuZFwiKVxuICAgIC5hY3Rpb24oKGFyZ3M6IHN0cmluZykgPT4ge1xuICAgICAgY29uc29sZS5sb2coYGV4ZWN1dGVkIGRlbW8gY29tbWFuZCB3aXRoIHR5cGUgdmFyaWFibGU6ICR7YXJnc31gKTtcbiAgICB9KTtcbn1cbiJdfQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLW1vZHVsZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kZW1vL2NsaS1tb2R1bGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFtQ0EsdUJBT0M7QUExQ0QseUNBQW9DO0FBRXBDOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQWdDRztBQUNILFNBQXdCLElBQUk7SUFDMUIsT0FBTyxJQUFJLG1CQUFPLEVBQUU7U0FDakIsT0FBTyxDQUFDLGdCQUFnQixDQUFDO1NBQ3pCLFdBQVcsQ0FBQyxnQkFBZ0IsQ0FBQztTQUM3QixNQUFNLENBQUMsQ0FBQyxJQUFZLEVBQUUsRUFBRTtRQUN2QixPQUFPLENBQUMsR0FBRyxDQUFDLDZDQUE2QyxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQ25FLENBQUMsQ0FBQyxDQUFDO0FBQ1AsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IENvbW1hbmQgfSBmcm9tIFwiY29tbWFuZGVyXCI7XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIERlbW8gQ0xJIG1vZHVsZSBmb3IgRGVjYWYgbGlicmFyaWVzXG4gKiBAc3VtbWFyeSBBIG1pbmltYWwgaW1wbGVtZW50YXRpb24gc2hvd2luZyBob3cgdG8gZXh0ZW5kIHRoZSBEZWNhZiBDTEkgd2l0aCBjdXN0b20gY29tbWFuZHMuXG4gKiBUaGlzIG1vZHVsZSBkZW1vbnN0cmF0ZXMgdGhlIHBhdHRlcm4gZm9yIGNyZWF0aW5nIENMSSBtb2R1bGVzIHRoYXQgY2FuIGJlIGRpc2NvdmVyZWQgYW5kIGxvYWRlZCBieSB0aGUgRGVjYWYgQ0xJLlxuICpcbiAqIEByZXR1cm4ge0NvbW1hbmR9IFRoZSBDb21tYW5kIG9iamVjdCB0byBiZSBhZGRlZCB0byB0aGUgbWFpbiBEZWNhZiBDTElcbiAqXG4gKiBAZnVuY3Rpb24gZGVtb1xuICogQG1lbWJlck9mIG1vZHVsZTpDTElcbiAqXG4gKiBAZXhhbXBsZVxuICogLy8gUnVuIHRoZSBkZW1vIGNvbW1hbmQgd2l0aCBhbiBhcmd1bWVudFxuICogbnB4IGRlY2FmIGRlbW8gY29tbWFuZCBcInNvbWV0aGluZyBzb21ldGhpbmdcIlxuICpcbiAqIC8vIE91dHB1dDpcbiAqIC8vIGV4ZWN1dGVkIGRlbW8gY29tbWFuZCB3aXRoIHR5cGUgdmFyaWFibGU6IHNvbWV0aGluZyBzb21ldGhpbmdcbiAqXG4gKiBAbWVybWFpZFxuICogc2VxdWVuY2VEaWFncmFtXG4gKiAgIHBhcnRpY2lwYW50IFVzZXJcbiAqICAgcGFydGljaXBhbnQgQ0xJXG4gKiAgIHBhcnRpY2lwYW50IERlbW9Nb2R1bGVcbiAqICAgcGFydGljaXBhbnQgQ29tbWFuZFxuICpcbiAqICAgVXNlci0+PkNMSTogbnB4IGRlY2FmIGRlbW8gY29tbWFuZCBcImFyZ1wiXG4gKiAgIENMSS0+PkRlbW9Nb2R1bGU6IExvYWQgbW9kdWxlXG4gKiAgIERlbW9Nb2R1bGUtPj5Db21tYW5kOiBDcmVhdGUgY29tbWFuZFxuICogICBDb21tYW5kLT4+Q29tbWFuZDogQ29uZmlndXJlIGFjdGlvblxuICogICBDb21tYW5kLS0+PkRlbW9Nb2R1bGU6IFJldHVybiBjb21tYW5kXG4gKiAgIERlbW9Nb2R1bGUtLT4+Q0xJOiBSZXR1cm4gY29tbWFuZFxuICogICBDTEktPj5Db21tYW5kOiBFeGVjdXRlIHdpdGggYXJnc1xuICogICBDb21tYW5kLT4+Q29uc29sZTogTG9nIG91dHB1dFxuICovXG5leHBvcnQgZGVmYXVsdCBmdW5jdGlvbiBkZW1vKCk6IENvbW1hbmQge1xuICByZXR1cm4gbmV3IENvbW1hbmQoKVxuICAgIC5jb21tYW5kKFwiY29tbWFuZCA8dHlwZT5cIilcbiAgICAuZGVzY3JpcHRpb24oXCJBIGRlbW8gY29tbWFuZFwiKVxuICAgIC5hY3Rpb24oKGFyZ3M6IHN0cmluZykgPT4ge1xuICAgICAgY29uc29sZS5sb2coYGV4ZWN1dGVkIGRlbW8gY29tbWFuZCB3aXRoIHR5cGUgdmFyaWFibGU6ICR7YXJnc31gKTtcbiAgICB9KTtcbn1cbiJdfQ==

package/lib/demo/cli-module.d.ts

@@ -1,27 +1,35 @@
 import { Command } from "commander";
 /**
- * @description demo CLI module for libraries
- * @summary minimal implementation on how to extend the decaf-ts cli
+ * @description Demo CLI module for Decaf libraries
+ * @summary A minimal implementation showing how to extend the Decaf CLI with custom commands.
+ * This module demonstrates the pattern for creating CLI modules that can be discovered and loaded by the Decaf CLI.
  *
- * - the function must be ***exported by default***!;
- * - The name of the returned function will be considered to be the base command;
- * - the command you return will be considered as a subCommand and will not be called directly
- * - Commands must be transpiled under the same ts-configuration as this module
- * (so copy the ts-config of this module to your project. we propose `tsconfig.cli.json`)
- * - Following your build pipeline include `tsc --project tsconfig.cli.json --outDir <dist folder>/cli`
- *
- * Note the extra use of `cli` on the outDir param. this is meant to completely separate
- * the cli code from your source, in case they are transpiled under different ts-configurations
- *
- * @returns {Command} the subCommand to be added to the main decaf CLI
+ * @return {Command} The Command object to be added to the main Decaf CLI
  *
  * @function demo
- *
- * @category Command Line Interface
+ * @memberOf module:CLI
  *
  * @example
- * `npx decaf demo command "something something" `
+ * // Run the demo command with an argument
+ * npx decaf demo command "something something"
+ *
+ * // Output:
+ * // executed demo command with type variable: something something
+ *
+ * @mermaid
+ * sequenceDiagram
+ *   participant User
+ *   participant CLI
+ *   participant DemoModule
+ *   participant Command
  *
- * will output `executed demo command with type variable: something something`
+ *   User->>CLI: npx decaf demo command "arg"
+ *   CLI->>DemoModule: Load module
+ *   DemoModule->>Command: Create command
+ *   Command->>Command: Configure action
+ *   Command-->>DemoModule: Return command
+ *   DemoModule-->>CLI: Return command
+ *   CLI->>Command: Execute with args
+ *   Command->>Console: Log output
  */
 export default function demo(): Command;