hereby 1.11.1 → 1.12.0

package/dist/cli/formatTasks.js

@@ -1,29 +1,57 @@
-import commandLineUsage from "command-line-usage";
 import pc from "picocolors";
+import Wordwrap from "wordwrapjs";
 import { compareTaskNames } from "./utils.js";
-export function formatTasks(format, tasks, defaultTask) {
+export function formatTasks(format, tasks, defaultTask, columns) {
     const visibleTasks = [...tasks].filter(isTaskVisible).sort(compareTaskNames);
     if (format === "simple") {
         return visibleTasks.map((task) => task.options.name).join("\n");
     }
-    return commandLineUsage({
-        header: "Available tasks",
-        content: visibleTasks.map((task) => {
-            var _a;
-            const name = task === defaultTask
-                ? `${pc.green(task.options.name)} (default)`
-                : pc.blue(task.options.name);
-            let descriptionParts = task.options.description ? [task.options.description] : undefined;
-            const deps = (_a = task.options.dependencies) === null || _a === void 0 ? void 0 : _a.filter(isTaskVisible).sort(compareTaskNames);
-            if (deps === null || deps === void 0 ? void 0 : deps.length) {
-                const depNames = deps.map((task) => pc.blue(task.options.name));
-                (descriptionParts !== null && descriptionParts !== void 0 ? descriptionParts : (descriptionParts = [])).push(`Depends on: ${depNames.join(", ")}`);
-            }
-            return { name, description: descriptionParts === null || descriptionParts === void 0 ? void 0 : descriptionParts.join("\n") };
-        }),
+    const names = visibleTasks.map((task) => task === defaultTask ? `${pc.green(task.options.name)} (default)` : pc.blue(task.options.name));
+    const descriptions = visibleTasks.map((task) => {
+        var _a, _b;
+        let parts = task.options.description ? [task.options.description] : undefined;
+        const deps = (_a = task.options.dependencies) === null || _a === void 0 ? void 0 : _a.filter(isTaskVisible).sort(compareTaskNames);
+        if (deps === null || deps === void 0 ? void 0 : deps.length) {
+            const depNames = deps.map((task) => pc.blue(task.options.name));
+            (parts !== null && parts !== void 0 ? parts : (parts = [])).push(`Depends on: ${depNames.join(", ")}`);
+        }
+        return (_b = parts === null || parts === void 0 ? void 0 : parts.join("\n")) !== null && _b !== void 0 ? _b : "";
     });
+    // There's a 2 space indent plus 3 spaces between columns, hence take away 5
+    // padding spaces from the available width
+    const maxTotalWidth = columns - 5;
+    const maxNameWidth = Math.max(...names.map(visibleLength));
+    // Check the name doesn't take up more than half the space
+    const nameWidth = Math.min(maxNameWidth, maxTotalWidth >> 1);
+    const descriptionWidth = maxTotalWidth - nameWidth;
+    const formatted = names.map((name, i) => formatAsColumns("  ", name, nameWidth, descriptions[i], descriptionWidth));
+    return `
+${pc.bold(pc.underline("Available tasks"))}
+
+${formatted.join("")}`;
 }
 function isTaskVisible(task) {
     return !task.options.hiddenFromTaskList;
 }
+function formatAsColumns(indent, leftText, leftWidth, rightText, rightWidth) {
+    const leftLines = wrapText(leftText, leftWidth);
+    const rightLines = wrapText(rightText, rightWidth);
+    const maxLines = Math.max(leftLines.length, rightLines.length);
+    let result = "";
+    for (let i = 0; i < maxLines; i++) {
+        const leftPart = leftLines[i] || "";
+        const rightPart = rightLines[i] || "";
+        const paddedLeft = leftPart.padEnd(leftWidth, " ");
+        result += `${indent}${paddedLeft}   ${rightPart}\n`;
+    }
+    return result;
+}
+// eslint-disable-next-line no-control-regex
+const ANSI_REGEX = /\u001B\[([0-9]{1,2})m/g;
+function visibleLength(str) {
+    return str.replace(ANSI_REGEX, "").length;
+}
+function wrapText(text, maxWidth) {
+    return Wordwrap.lines(text, { width: maxWidth, break: true });
+}
 //# sourceMappingURL=formatTasks.js.map

package/dist/cli/index.js

@@ -42,7 +42,7 @@ async function mainWorker(d) {
     d.chdir(path.dirname(herebyfilePath));
     const herebyfile = await loadHerebyfile(herebyfilePath);
     if (args.printTasks) {
-        d.log(formatTasks(args.printTasks, herebyfile.tasks.values(), herebyfile.defaultTask));
+        d.log(formatTasks(args.printTasks, herebyfile.tasks.values(), herebyfile.defaultTask, d.columns()));
         return;
     }
     const tasks = await selectTasks(d, herebyfile, herebyfilePath, args.run);

package/dist/cli/parseArgs.js

@@ -1,5 +1,5 @@
-import commandLineUsage from "command-line-usage";
 import minimist from "minimist";
+import pc from "picocolors";
 export function parseArgs(argv) {
     let parseUnknownAsTask = true;
     const options = minimist(argv, {
@@ -21,54 +21,29 @@ export function parseArgs(argv) {
     };
 }
 export function getUsage() {
-    const usage = commandLineUsage([
-        {
-            header: "hereby",
-            content: "A simple task runner.",
-        },
-        {
-            header: "Synopsis",
-            content: "$ hereby <task>",
-        },
-        {
-            header: "Options",
-            optionList: [
-                {
-                    name: "help",
-                    description: "Display this usage guide.",
-                    alias: "h",
-                    type: Boolean,
-                },
-                {
-                    name: "herebyfile",
-                    description: "A path to a Herebyfile. Optional.",
-                    type: String,
-                    defaultOption: true,
-                    typeLabel: "{underline path}",
-                },
-                {
-                    name: "tasks",
-                    description: "Print a listing of the available tasks.",
-                    alias: "T",
-                    type: Boolean,
-                },
-                {
-                    name: "version",
-                    description: "Print the current hereby version.",
-                    type: Boolean,
-                },
-            ],
-        },
-        {
-            header: "Example usage",
-            content: [
-                "$ hereby build",
-                "$ hereby build lint",
-                "$ hereby test --skip someTest --lint=false",
-                "$ hereby --tasks",
-            ],
-        },
-    ]);
-    return usage;
+    const header = (text) => pc.bold(pc.underline(text));
+    return `
+${header("hereby")}
+
+  A simple task runner.
+
+${header("Synopsis")}
+
+  $ hereby <task>
+
+${header("Options")}
+
+  ${pc.bold("-h, --help")}          Display this usage guide.
+  ${pc.bold("--herebyfile")} ${pc.underline("path")}   A path to a Herebyfile. Optional.
+  ${pc.bold("-T, --tasks")}         Print a listing of the available tasks.
+  ${pc.bold("--version")}           Print the current hereby version.
+
+${header("Example usage")}
+
+  $ hereby build
+  $ hereby build lint
+  $ hereby test --skip someTest --lint=false
+  $ hereby --tasks
+`;
 }
 //# sourceMappingURL=parseArgs.js.map

package/dist/cli/utils.js

@@ -38,6 +38,7 @@ export async function real() {
     const { default: prettyMilliseconds } = await import("pretty-ms");
     /* eslint-disable no-restricted-globals */
     return {
+        columns: () => process.stdout.isTTY && process.stdout.columns || 80,
         log: console.log,
         error: console.error,
         // eslint-disable-next-line @typescript-eslint/unbound-method

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "hereby",
-    "version": "1.11.1",
+    "version": "1.12.0",
     "description": "A simple task runner",
     "repository": "github:jakebailey/hereby",
     "type": "module",
@@ -39,38 +39,36 @@
         "./dist/index.d.ts"
     ],
     "dependencies": {
-        "command-line-usage": "^6.1.3",
         "fastest-levenshtein": "^1.0.16",
         "minimist": "^1.2.8",
         "picocolors": "^1.1.0",
-        "pretty-ms": "^8.0.0"
+        "pretty-ms": "^8.0.0",
+        "wordwrapjs": "^5.1.1"
     },
     "devDependencies": {
         "@ava/typescript": "^3.0.1",
-        "@changesets/cli": "^2.29.7",
-        "@codspeed/tinybench-plugin": "^4.0.1",
-        "@fast-check/ava": "2.0.1",
-        "@tsconfig/node12": "^12.1.5",
-        "@types/command-line-usage": "^5.0.4",
+        "@changesets/cli": "^2.29.8",
+        "@eslint/js": "^10.0.1",
+        "@tsconfig/node12": "^12.1.7",
         "@types/minimist": "^1.2.5",
-        "@types/node": "^24.7.2",
+        "@types/node": "^25.2.3",
         "@types/tmp": "^0.2.6",
+        "@types/wordwrapjs": "^5.1.2",
         "ava": "~5.0.1",
         "c8": "^10.1.3",
-        "dprint": "^0.50.2",
-        "eslint": "^9.37.0",
-        "eslint-plugin-ava": "^15.1.0",
+        "dprint": "^0.51.1",
+        "eslint": "^10.0.0",
+        "eslint-plugin-ava": "^16.0.0",
         "eslint-plugin-simple-import-sort": "^12.1.1",
-        "eslint-plugin-unicorn": "^61.0.2",
+        "eslint-plugin-unicorn": "^63.0.0",
         "execa": "^6.1.0",
-        "globals": "^16.4.0",
+        "globals": "^17.3.0",
         "monocart-coverage-reports": "^2.12.9",
         "moq.ts": "^10.1.0",
         "rimraf": "^5.0.10",
-        "tinybench": "~2.8.0",
         "tmp": "0.2.1",
         "typescript": "^5.9.3",
-        "typescript-eslint": "^8.46.0"
+        "typescript-eslint": "^8.56.0"
     },
     "overrides": {
         "ava": {