@visulima/cerebro 3.0.0-alpha.12 → 3.0.0-alpha.13

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+## @visulima/cerebro [3.0.0-alpha.13](https://github.com/visulima/visulima/compare/@visulima/cerebro@3.0.0-alpha.12...@visulima/cerebro@3.0.0-alpha.13) (2026-04-30)
+
+### Features
+
+* **cerebro:** longest-prefix parser with option-stop and parent help ([ef1d244](https://github.com/visulima/visulima/commit/ef1d24446462cd5b34598f70715d4987c31b4eff))
+
+
+### Dependencies
+
+* **@visulima/error:** upgraded to 6.0.0-alpha.14
+
 ## @visulima/cerebro [3.0.0-alpha.12](https://github.com/visulima/visulima/compare/@visulima/cerebro@3.0.0-alpha.11...@visulima/cerebro@3.0.0-alpha.12) (2026-04-28)
 
 ### Features

package/LICENSE.md

@@ -145,7 +145,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > > # Bundled types:
 > > ## ai
 > > License: Apache-2.0
-> > Repository: git+https://github.com/vercel/ai.git
+> > Repository: https://github.com/vercel/ai
 > >
 > > > Copyright 2023 Vercel, Inc.
 > > >
@@ -230,7 +230,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > > # Bundled types:
 > > ## ai
 > > License: Apache-2.0
-> > Repository: git+https://github.com/vercel/ai.git
+> > Repository: https://github.com/vercel/ai
 > >
 > > > Copyright 2023 Vercel, Inc.
 > > >
@@ -308,7 +308,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > # Bundled types:
 > ## ai
 > License: Apache-2.0
-> Repository: git+https://github.com/vercel/ai.git
+> Repository: https://github.com/vercel/ai
 >
 > > Copyright 2023 Vercel, Inc.
 > >
@@ -1243,7 +1243,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > > # Bundled types:
 > > ## ai
 > > License: Apache-2.0
-> > Repository: git+https://github.com/vercel/ai.git
+> > Repository: https://github.com/vercel/ai
 > >
 > > > Copyright 2023 Vercel, Inc.
 > > >
@@ -1328,7 +1328,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > > # Bundled types:
 > > ## ai
 > > License: Apache-2.0
-> > Repository: git+https://github.com/vercel/ai.git
+> > Repository: https://github.com/vercel/ai
 > >
 > > > Copyright 2023 Vercel, Inc.
 > > >
@@ -1406,7 +1406,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > # Bundled types:
 > ## ai
 > License: Apache-2.0
-> Repository: git+https://github.com/vercel/ai.git
+> Repository: https://github.com/vercel/ai
 >
 > > Copyright 2023 Vercel, Inc.
 > >
@@ -1518,7 +1518,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > > # Bundled types:
 > > ## ai
 > > License: Apache-2.0
-> > Repository: git+https://github.com/vercel/ai.git
+> > Repository: https://github.com/vercel/ai
 > >
 > > > Copyright 2023 Vercel, Inc.
 > > >

package/dist/commands/help-command.js

@@ -98,6 +98,51 @@ const printGeneralHelp = (logger, runtime, commands, groupOption) => {
     )
   );
 };
+const findChildren = (commands, parentPath) => {
+  const matches = [];
+  for (const cmd of commands.values()) {
+    if (cmd.hidden) {
+      continue;
+    }
+    const commandPath = cmd.commandPath ?? [];
+    if (commandPath.length !== parentPath.length) {
+      continue;
+    }
+    let isMatch = true;
+    for (let index = 0; index < parentPath.length; index += 1) {
+      if (commandPath[index] !== parentPath[index]) {
+        isMatch = false;
+        break;
+      }
+    }
+    if (isMatch) {
+      matches.push(cmd);
+    }
+  }
+  return matches;
+};
+const printParentHelp = (logger, runtime, parentPath, children) => {
+  const parentDisplay = parentPath.join(" ");
+  const usageGroups = [
+    {
+      content: `${cyan(runtime.getCliName())} ${green(parentDisplay)} ${green("<subcommand>")} [positional arguments] ${yellow("[options]")}`,
+      header: inverse.cyan(" Usage ")
+    },
+    {
+      content: children.map((child) => {
+        const fullPath = [...child.commandPath ?? [], child.name].join(" ");
+        return [green(fullPath), child.description ?? ""];
+      }),
+      header: inverse.green(" Subcommands ")
+    },
+    { header: inverse.yellow(" Global Options "), optionList: runtime.getGlobalOptions() },
+    {
+      content: `Run "${cyan(runtime.getCliName())} ${green(`${parentDisplay} <subcommand>`)} ${yellow("--help")}" for help with a specific subcommand.`,
+      raw: true
+    }
+  ];
+  (logger.raw ?? logger.log)(commandLineUsage(usageGroups));
+};
 const printCommandHelp = (logger, runtime, commands, name) => {
   let command = commands.get(name);
   if (!command) {
@@ -110,6 +155,12 @@ const printCommandHelp = (logger, runtime, commands, name) => {
     }
   }
   if (!command) {
+    const parentPath = name.split(" ").filter(Boolean);
+    const children = parentPath.length > 0 ? findChildren(commands, parentPath) : [];
+    if (children.length > 0) {
+      printParentHelp(logger, runtime, parentPath, children);
+      return;
+    }
     logger.error(`Command "${name}" not found`);
     return;
   }
@@ -159,6 +210,17 @@ const printCommandHelp = (logger, runtime, commands, name) => {
       header: "Examples"
     });
   }
+  const ownPath = [...command.commandPath ?? [], command.name];
+  const ownChildren = findChildren(commands, ownPath);
+  if (ownChildren.length > 0) {
+    usageGroups.push({
+      content: ownChildren.map((child) => {
+        const fullPath = [...child.commandPath ?? [], child.name].join(" ");
+        return [green(fullPath), child.description ?? ""];
+      }),
+      header: inverse.green(" Subcommands ")
+    });
+  }
   (logger.raw ?? logger.log)(commandLineUsage(usageGroups));
 };
 class HelpCommand {

package/dist/index.js

@@ -1,4 +1,4 @@
-import { Cli } from './packem_shared/Cerebro-f9jDcQQy.js';
+import { Cli } from './packem_shared/Cerebro-C1h3DXwy.js';
 export { VERBOSITY_DEBUG, VERBOSITY_NORMAL, VERBOSITY_QUIET, VERBOSITY_VERBOSE } from './packem_shared/VERBOSITY_QUIET-Dp46zlLW.js';
 export { lazyNamed } from './packem_shared/lazyNamed-B278Tf9_.js';
 export { VisulimaError } from './packem_shared/VisulimaError-DA7QsCxH.js';

package/dist/packem_shared/{Cerebro-f9jDcQQy.js → Cerebro-C1h3DXwy.js}

@@ -1531,18 +1531,21 @@ const parseNestedCommand = (availableCommands, argv) => {
     return { argv: [], commandPath: void 0 };
   }
   const pathKeyParts = [];
+  let bestMatch;
   for (let depth = 1; depth <= argv.length; depth += 1) {
     const argument = argv[depth - 1];
-    if (argument === void 0) {
+    if (argument === void 0 || argument.startsWith("-")) {
       break;
     }
     pathKeyParts.push(argument);
     const pathKey = pathKeyParts.join(" ");
     if (availableCommands.has(pathKey)) {
-      const remainingArgv = argv.slice(depth);
-      return { argv: remainingArgv, commandPath: [...pathKeyParts] };
+      bestMatch = { commandPath: [...pathKeyParts], depth };
     }
   }
+  if (bestMatch) {
+    return { argv: argv.slice(bestMatch.depth), commandPath: bestMatch.commandPath };
+  }
   return { argv, commandPath: void 0 };
 };
 const getCommandPathKey = (commandPath) => commandPath.join(" ");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/cerebro",
-  "version": "3.0.0-alpha.12",
+  "version": "3.0.0-alpha.13",
   "description": "A delightful toolkit for building cross-runtime CLIs for Node.js, Deno, and Bun.",
   "keywords": [
     "ansi",
@@ -116,7 +116,7 @@
     "fastest-levenshtein": "^1.0.16"
   },
   "peerDependencies": {
-    "@bomb.sh/tab": "0.0.14",
+    "@bomb.sh/tab": "0.0.15",
     "@visulima/boxen": "3.0.0-alpha.10",
     "@visulima/find-cache-dir": "3.0.0-alpha.9",
     "@visulima/pail": "4.0.0-alpha.12",