@decaf-ts/utils 1.3.2 → 1.5.2

package/lib/cjs/cli/commands/tag-release-shell.cjs

@@ -0,0 +1,229 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TagReleaseCommand = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const command_js_1 = require("./../command.cjs");
+const input_js_1 = require("./../../input/input.cjs");
+const constants_js_1 = require("./../../utils/constants.cjs");
+const help_js_1 = require("./help.cjs");
+const options = {
+    public: {
+        type: "boolean",
+        default: false,
+    },
+    private: {
+        type: "boolean",
+        default: false,
+    },
+    gitToken: {
+        type: "string",
+        default: ".token",
+    },
+    npmToken: {
+        type: "string",
+        default: ".npmtoken",
+    },
+    gitUser: {
+        type: "string",
+        default: undefined,
+    },
+    allowFromBranch: {
+        type: "boolean",
+        default: false,
+    },
+    tag: {
+        type: "string",
+        default: undefined,
+    },
+    message: {
+        type: "string",
+        default: undefined,
+    },
+};
+class TagReleaseCommand extends command_js_1.Command {
+    constructor() {
+        super("TagReleaseCommand", options);
+    }
+    async ensureReleaseBranch(allowFromBranch = false) {
+        if (allowFromBranch)
+            return;
+        const currentBranch = (0, node_child_process_1.execSync)("git rev-parse --abbrev-ref HEAD", {
+            cwd: process.cwd(),
+            encoding: "utf8",
+        }).trim();
+        if (currentBranch !== "master" && currentBranch !== "main") {
+            throw new Error(`release must be run from 'master' or 'main' branch. Current branch: ${currentBranch}`);
+        }
+    }
+    async prepareTag(tag) {
+        tag = `${tag || ""}`.trim();
+        if (tag.length > 0) {
+            return tag;
+        }
+        (0, node_child_process_1.execSync)("git tag --sort=-taggerdate | head -n 5", {
+            cwd: process.cwd(),
+            stdio: "inherit",
+        });
+        return input_js_1.UserInput.insistForText("tag", "What should be the new tag? (accepts v*.*.*[-...])", (val) => !!val.toString().match(/^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9a-zA-Z-]+)?$/));
+    }
+    async prepareMessage(message) {
+        message = `${message || ""}`.trim();
+        if (message.length > 0) {
+            return message;
+        }
+        return input_js_1.UserInput.insistForText("message", "Tag Message", (val) => !!val && val.toString().length > 0);
+    }
+    hasToken(fileName) {
+        try {
+            return node_fs_1.default.statSync(node_path_1.default.join(process.cwd(), fileName)).size > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    readToken(fileName) {
+        return node_fs_1.default.readFileSync(node_path_1.default.join(process.cwd(), fileName), "utf8").trim();
+    }
+    help() {
+        (0, help_js_1.printCommandHelp)(this.log, "tag-release", "Prepare a release, create a git tag, push, and optionally publish to npm.", "tag-release [options] [tag] [message]", [
+            {
+                flag: "--public",
+                description: "Publish to the public npm registry",
+                defaultValue: "false",
+            },
+            {
+                flag: "--private",
+                description: "Publish to the restricted npm registry",
+                defaultValue: "false",
+            },
+            {
+                flag: "--git-token <file>",
+                description: "File containing the token used for authenticated git pushes",
+                defaultValue: ".token",
+            },
+            {
+                flag: "--npm-token <file>",
+                description: "File containing the token used for npm publish",
+                defaultValue: ".npmtoken",
+            },
+            {
+                flag: "--git-user <name>",
+                description: "Git user name embedded in authenticated pushes",
+            },
+            {
+                flag: "--allow-from-branch",
+                description: "Skip the master/main branch guard",
+                defaultValue: "false",
+            },
+            {
+                flag: "--tag <version>",
+                description: "Release tag to create",
+            },
+            {
+                flag: "--message <text>",
+                description: "Release message to use",
+            },
+            {
+                flag: "-h, --help",
+                description: "Show this help text and exit",
+            },
+        ], [
+            "If tag or message are omitted, the command prompts interactively.",
+            "The command uses .token for git pushes and .npmtoken for npm publish unless overridden.",
+        ], [
+            "tag-release --public --tag v1.2.3 --message \"Release 1.2.3\"",
+            "tag-release --private --allow-from-branch --tag v1.2.3",
+        ]);
+    }
+    async run(answers) {
+        await this.ensureReleaseBranch(answers.allowFromBranch === true);
+        const publishAccessFlag = answers.private === true ? "private" : "public";
+        const tag = await this.prepareTag(answers.tag);
+        const message = await this.prepareMessage(answers.message);
+        const gitTokenFile = `${answers.gitToken || ".token"}`;
+        const npmTokenFile = `${answers.npmToken || ".npmtoken"}`;
+        const gitUser = typeof answers.gitUser === "string" && answers.gitUser.trim().length > 0
+            ? answers.gitUser.trim()
+            : (0, node_child_process_1.execSync)("git config user.name", {
+                cwd: process.cwd(),
+                encoding: "utf8",
+            }).trim();
+        (0, node_child_process_1.execSync)("npm run prepare-release", {
+            cwd: process.cwd(),
+            stdio: "inherit",
+        });
+        const status = (0, node_child_process_1.execSync)("git status --porcelain", {
+            cwd: process.cwd(),
+            encoding: "utf8",
+        });
+        if (status.trim().length > 0) {
+            (0, node_child_process_1.execSync)("git add .", { cwd: process.cwd(), stdio: "inherit" });
+            (0, node_child_process_1.execSync)(`git commit -m "${tag} - ${message} - after release preparation"`, {
+                cwd: process.cwd(),
+                stdio: "inherit",
+            });
+        }
+        (0, node_child_process_1.execSync)(`npm version "${tag}" -m "${message}"`, {
+            cwd: process.cwd(),
+            stdio: "inherit",
+        });
+        const remoteUrl = (0, node_child_process_1.execSync)("git remote get-url origin", {
+            cwd: process.cwd(),
+            encoding: "utf8",
+        }).trim();
+        if (this.hasToken(gitTokenFile)) {
+            const currentBranch = (0, node_child_process_1.execSync)("git rev-parse --abbrev-ref HEAD", {
+                cwd: process.cwd(),
+                encoding: "utf8",
+            });
+            let upstream = "";
+            try {
+                upstream = (0, node_child_process_1.execSync)("git rev-parse --abbrev-ref --symbolic-full-name '@{u}'", {
+                    cwd: process.cwd(),
+                    encoding: "utf8",
+                });
+            }
+            catch {
+                upstream = "";
+            }
+            const token = this.readToken(gitTokenFile);
+            (0, node_child_process_1.execSync)(`git push "https://${gitUser}:${token}@${remoteUrl.replace(/^https:\/\//, "")}" --follow-tags`, {
+                cwd: process.cwd(),
+                stdio: "inherit",
+            });
+            if (upstream.trim().length > 0) {
+                try {
+                    (0, node_child_process_1.execSync)(`git branch --set-upstream-to="${upstream.trim()}" "${currentBranch.trim()}"`, {
+                        cwd: process.cwd(),
+                        stdio: "inherit",
+                    });
+                }
+                catch {
+                    // ignore restore failures
+                }
+            }
+        }
+        else {
+            (0, node_child_process_1.execSync)("git push --follow-tags", {
+                cwd: process.cwd(),
+                stdio: "inherit",
+            });
+        }
+        const npmAccessValue = publishAccessFlag === "public" ? "public" : "restricted";
+        if (message.endsWith(constants_js_1.NoCIFLag) && this.hasToken(npmTokenFile)) {
+            const npmToken = this.readToken(npmTokenFile);
+            (0, node_child_process_1.execSync)(`NPM_TOKEN="${npmToken}" npm publish --access "${npmAccessValue}"`, {
+                cwd: process.cwd(),
+                stdio: "inherit",
+            });
+        }
+    }
+}
+exports.TagReleaseCommand = TagReleaseCommand;
+//# sourceMappingURL=tag-release-shell.js.map
+//# sourceMappingURL=tag-release-shell.js.map

package/lib/cjs/cli/commands/tag-release-shell.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-release-shell.js","sourceRoot":"","sources":["tag-release-shell.js"],"names":[],"mappings":"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"}

package/lib/cjs/cli/commands/tag-release.cjs

@@ -6,6 +6,7 @@ const utils_js_1 = require("./../../utils/utils.cjs");
 const constants_js_1 = require("./../../utils/constants.cjs");
 const input_js_1 = require("./../../input/input.cjs");
 const command_js_1 = require("./../command.cjs");
+const help_js_1 = require("./help.cjs");
 const options = {
     ci: {
         type: "boolean",
@@ -64,10 +65,12 @@ class ReleaseScript extends command_js_1.Command {
         const log = this.log.for(this.prepareVersion);
         tag = this.testVersion(tag || "");
         if (!tag) {
-            log.verbose("No release message provided. Prompting for one:");
+            log.verbose("No release version provided. Prompting for one:");
             log.info(`Listing latest git tags:`);
             await (0, utils_js_1.runCommand)("git tag --sort=-taggerdate | head -n 5").promise;
-            return await input_js_1.UserInput.insistForText("tag", "Enter the new tag number (accepts v*.*.*[-...])", (val) => !!val.toString().match(/^v[0-9]+\.[0-9]+.[0-9]+(-[0-9a-zA-Z-]+)?$/));
+            return await input_js_1.UserInput.insistForText("tag", "Enter the new tag number (accepts v*.*.*[-...])", (val) => !!val
+                .toString()
+                .match(/^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9a-zA-Z-]+)?$/));
         }
         return tag;
     }
@@ -110,6 +113,34 @@ class ReleaseScript extends command_js_1.Command {
         }
         return message;
     }
+    help() {
+        (0, help_js_1.printCommandHelp)(this.log, "tag-release", "Prepare, tag, and publish a release from the current repository.", "tag-release [options]", [
+            { flag: "--tag <version>", description: "Release tag to use" },
+            {
+                flag: "--message <text>",
+                description: "Release message or ticket reference",
+            },
+            {
+                flag: "--ci <true|false>",
+                description: "Whether to treat the run as CI",
+                defaultValue: "true",
+            },
+            {
+                flag: "--version",
+                description: "Print the package version and exit",
+            },
+            {
+                flag: "-h, --help",
+                description: "Show this help text and exit",
+            },
+        ], [
+            "If tag or message are omitted, the command prompts interactively.",
+            "A successful run updates the package version, creates a git tag, pushes tags, and optionally publishes to npm.",
+        ], [
+            "tag-release --tag v1.2.3 --message \"Release 1.2.3\"",
+            "tag-release --tag patch --message \"Fix release\"",
+        ]);
+    }
     /**
      * @description Runs the release script.
      * @summary This method orchestrates the entire release process, including version preparation, message creation,

package/lib/cjs/cli/commands/tag-release.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tag-release.js","sourceRoot":"","sources":["tag-release.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"tag-release.js","sourceRoot":"","sources":["tag-release.js"],"names":[],"mappings":"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"}

package/lib/cjs/index.cjs

@@ -44,7 +44,7 @@ __exportStar(require("./release-chain/index.cjs"), exports);
  * @const VERSION
  * @memberOf module:utils
  */
-exports.VERSION = "1.3.1";
+exports.VERSION = "1.5.1";
 /**
  * @description Represents the current version of the module.
  * @summary Stores the version for the @decaf-ts/utils package. The build replaces

package/lib/esm/bin/modules.js

@@ -0,0 +1,10 @@
+/* istanbul ignore file */
+import { ModulesCommand } from "./../cli/commands/index.js";
+new ModulesCommand()
+    .execute()
+    .then(() => ModulesCommand.log.info("Module list collected successfully"))
+    .catch((error) => {
+    ModulesCommand.log.error(`Failed to retrieve modules`, error);
+    process.exit(1);
+});
+//# sourceMappingURL=modules.js.map

package/lib/esm/bin/modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../../src/bin/modules.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,EAAE,cAAc,EAAE,mCAAwB;AAEjD,IAAI,cAAc,EAAE;KACjB,OAAO,EAAE;KACT,IAAI,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;KACzE,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAc,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/lib/esm/bin/npm-link.js

@@ -0,0 +1,10 @@
+/* istanbul ignore file */
+import { NpmLinkCommand } from "./../cli/commands/index.js";
+new NpmLinkCommand()
+    .execute()
+    .then(() => NpmLinkCommand.log.info("NPM link operation completed successfully"))
+    .catch((error) => {
+    NpmLinkCommand.log.error(`Failed to link npm modules`, error);
+    process.exit(1);
+});
+//# sourceMappingURL=npm-link.js.map

package/lib/esm/bin/npm-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-link.js","sourceRoot":"","sources":["../../../src/bin/npm-link.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,EAAE,cAAc,EAAE,mCAAwB;AAEjD,IAAI,cAAc,EAAE;KACjB,OAAO,EAAE;KACT,IAAI,CAAC,GAAG,EAAE,CACT,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,2CAA2C,CAAC,CACrE;KACA,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAc,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/lib/esm/bin/npm-token.js

@@ -0,0 +1,10 @@
+/* istanbul ignore file */
+import { NpmTokenCommand } from "./../cli/commands/index.js";
+new NpmTokenCommand()
+    .execute()
+    .then(() => NpmTokenCommand.log.info("token links updated successfully"))
+    .catch((error) => {
+    NpmTokenCommand.log.error(`Failed to link tokens`, error);
+    process.exit(1);
+});
+//# sourceMappingURL=npm-token.js.map

package/lib/esm/bin/npm-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-token.js","sourceRoot":"","sources":["../../../src/bin/npm-token.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,EAAE,eAAe,EAAE,mCAAwB;AAElD,IAAI,eAAe,EAAE;KAClB,OAAO,EAAE;KACT,IAAI,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;KACxE,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAc,CAAC,CAAC;IACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/lib/esm/bin/run-all.js

@@ -0,0 +1,10 @@
+/* istanbul ignore file */
+import { RunAllCommand } from "./../cli/commands/index.js";
+new RunAllCommand()
+    .execute()
+    .then(() => RunAllCommand.log.info("Run-all command completed successfully"))
+    .catch((error) => {
+    RunAllCommand.log.error(`Failed to run command across modules`, error);
+    process.exit(1);
+});
+//# sourceMappingURL=run-all.js.map

package/lib/esm/bin/run-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-all.js","sourceRoot":"","sources":["../../../src/bin/run-all.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,EAAE,aAAa,EAAE,mCAAwB;AAEhD,IAAI,aAAa,EAAE;KAChB,OAAO,EAAE;KACT,IAAI,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;KAC5E,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAc,CAAC,CAAC;IAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/lib/esm/cli/commands/help.js

@@ -0,0 +1,25 @@
+export function printCommandHelp(log, commandName, summary, usage, options, notes = [], examples = []) {
+    log.info(`${commandName}`);
+    log.info(summary);
+    log.info(`Usage: ${usage}`);
+    log.info("Options:");
+    for (const option of options) {
+        const suffix = option.defaultValue
+            ? ` (default: ${option.defaultValue})`
+            : "";
+        log.info(`  ${option.flag}  ${option.description}${suffix}`);
+    }
+    if (notes.length > 0) {
+        log.info("Notes:");
+        for (const note of notes) {
+            log.info(`  ${note}`);
+        }
+    }
+    if (examples.length > 0) {
+        log.info("Examples:");
+        for (const example of examples) {
+            log.info(`  ${example}`);
+        }
+    }
+}
+//# sourceMappingURL=help.js.map

package/lib/esm/cli/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../../src/cli/commands/help.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,WAAmB,EACnB,OAAe,EACf,KAAa,EACb,OAAqB,EACrB,QAAkB,EAAE,EACpB,WAAqB,EAAE;IAEvB,GAAG,CAAC,IAAI,CAAC,GAAG,WAAW,EAAE,CAAC,CAAC;IAC3B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClB,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;IAC5B,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAErB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY;YAChC,CAAC,CAAC,cAAc,MAAM,CAAC,YAAY,GAAG;YACtC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,WAAW,GAAG,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/esm/cli/commands/index.js

@@ -1,4 +1,9 @@
 export * from "./build-scripts.js";
 export * from "./tag-release.js";
 export * from "./release-chain.js";
+export * from "./modules.js";
+export * from "./npm-link.js";
+export * from "./npm-token.js";
+export * from "./run-all.js";
+export * from "./tag-release-shell.js";
 //# sourceMappingURL=index.js.map

package/lib/esm/cli/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,mCAAgC;AAChC,iCAA8B;AAC9B,mCAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,mCAAgC;AAChC,iCAA8B;AAC9B,mCAAgC;AAChC,6BAA0B;AAC1B,8BAA2B;AAC3B,+BAA4B;AAC5B,6BAA0B;AAC1B,uCAAoC"}

package/lib/esm/cli/commands/modules.js

@@ -0,0 +1,70 @@
+import fs from "node:fs";
+import path from "node:path";
+import { Command } from "./../command.js";
+import { printCommandHelp } from "./help.js";
+export function readGitModules(basePath = process.cwd()) {
+    const gitmodulesPath = path.join(basePath, ".gitmodules");
+    const data = fs.readFileSync(gitmodulesPath, "utf8");
+    return data.toString().match(/(?<=").*?(?="])/g) || [];
+}
+export function readGitModulesDeep(basePath = process.cwd(), maxTraversal = 2) {
+    const modules = new Set();
+    const visited = new Set();
+    const walk = (currentBasePath, depth, relativePrefix = "") => {
+        const normalizedBase = path.resolve(currentBasePath);
+        if (visited.has(normalizedBase))
+            return;
+        visited.add(normalizedBase);
+        let entries = [];
+        try {
+            entries = readGitModules(currentBasePath);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const modulePath = relativePrefix
+                ? path.join(relativePrefix, entry)
+                : entry;
+            modules.add(modulePath);
+            if (depth <= 0)
+                continue;
+            const nestedBase = path.join(currentBasePath, entry);
+            const nestedGitmodules = path.join(nestedBase, ".gitmodules");
+            if (fs.existsSync(nestedGitmodules)) {
+                walk(nestedBase, depth - 1, modulePath);
+            }
+        }
+    };
+    walk(basePath, maxTraversal);
+    return Array.from(modules);
+}
+const options = {
+    basePath: {
+        type: "string",
+        default: process.cwd(),
+    },
+};
+export class ModulesCommand extends Command {
+    constructor() {
+        super("ModulesCommand", options);
+    }
+    help() {
+        printCommandHelp(this.log, "modules", "List modules discovered from .gitmodules.", "modules [options]", [
+            {
+                flag: "--base-path <path>",
+                description: "Directory to read .gitmodules from",
+                defaultValue: "current working directory",
+            },
+            {
+                flag: "-h, --help",
+                description: "Show this help text and exit",
+            },
+        ], ["Each discovered module path is printed on its own line."], ["modules", "modules --base-path ../repo"]);
+    }
+    async run(answers) {
+        const modules = readGitModules(answers.basePath);
+        modules.forEach((module) => this.log.info(module));
+    }
+}
+//# sourceMappingURL=modules.js.map

package/lib/esm/cli/commands/modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../../../src/cli/commands/modules.ts"],"names":[],"mappings":"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"}