@visulima/cerebro 3.0.0-alpha.6 → 3.0.0-alpha.8

package/CHANGELOG.md

@@ -1,3 +1,43 @@
+## @visulima/cerebro [3.0.0-alpha.8](https://github.com/visulima/visulima/compare/@visulima/cerebro@3.0.0-alpha.7...@visulima/cerebro@3.0.0-alpha.8) (2026-03-26)
+
+### Bug Fixes
+
+* **cerebro:** use workspace:* for internal [@visulima](https://github.com/visulima) deps ([6647854](https://github.com/visulima/visulima/commit/6647854b69a518466318af623938c0435f3a2579))
+* **web:** improve build setup with incremental stats caching and prod install ([fe33e75](https://github.com/visulima/visulima/commit/fe33e75827586779b4b3a0c6d57b39f889ee6207))
+
+### Miscellaneous Chores
+
+* **cerebro:** migrate deps to pnpm catalogs ([75cfac0](https://github.com/visulima/visulima/commit/75cfac01080464cc07279164520177472aff3b13))
+
+### Code Refactoring
+
+* **docs:** migrate Nextra components to fumadocs-ui, remove Nextra stripping ([484878f](https://github.com/visulima/visulima/commit/484878f01879363ef5e9a0282904dc4627d6060c))
+
+
+### Dependencies
+
+* **@visulima/colorize:** upgraded to 2.0.0-alpha.6
+* **@visulima/tabular:** upgraded to 4.0.0-alpha.7
+* **@visulima/boxen:** upgraded to 3.0.0-alpha.7
+* **@visulima/command-line-args:** upgraded to 2.0.0-alpha.5
+* **@visulima/error:** upgraded to 6.0.0-alpha.6
+* **@visulima/find-cache-dir:** upgraded to 3.0.0-alpha.5
+* **@visulima/pail:** upgraded to 4.0.0-alpha.8
+* **@visulima/path:** upgraded to 3.0.0-alpha.6
+* **@visulima/string:** upgraded to 3.0.0-alpha.7
+
+## @visulima/cerebro [3.0.0-alpha.7](https://github.com/visulima/visulima/compare/@visulima/cerebro@3.0.0-alpha.6...@visulima/cerebro@3.0.0-alpha.7) (2026-03-16)
+
+### Miscellaneous Chores
+
+* **cerebro:** update dependencies ([401f0bf](https://github.com/visulima/visulima/commit/401f0bf2bab395ac191e48cded78fa354970b245))
+* visulima website ([#591](https://github.com/visulima/visulima/issues/591)) ([59ab2e2](https://github.com/visulima/visulima/commit/59ab2e2befb03e51cd2088956f83d9b87de6d033))
+
+
+### Dependencies
+
+* **@visulima/pail:** upgraded to 4.0.0-alpha.7
+
 ## @visulima/cerebro [3.0.0-alpha.6](https://github.com/visulima/visulima/compare/@visulima/cerebro@3.0.0-alpha.5...@visulima/cerebro@3.0.0-alpha.6) (2026-03-06)
 
 ### Bug Fixes

package/LICENSE.md

@@ -92,7 +92,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -126,7 +126,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > >
 > > > MIT License
 > > >
-> > > Copyright (c) 2025 visulima
+> > > Copyright (c) 2026 visulima
 > > >
 > > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > > of this software and associated documentation files (the "Software"), to deal
@@ -312,7 +312,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -346,7 +346,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > >
 > > > MIT License
 > > >
-> > > Copyright (c) 2025 visulima
+> > > Copyright (c) 2026 visulima
 > > >
 > > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > > of this software and associated documentation files (the "Software"), to deal
@@ -488,7 +488,7 @@ Repository: git+https://github.com/visulima/visulima.git
 
 > MIT License
 >
-> Copyright (c) 2025 visulima
+> Copyright (c) 2026 visulima
 >
 > Permission is hereby granted, free of charge, to any person obtaining a copy
 > of this software and associated documentation files (the "Software"), to deal
@@ -522,7 +522,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -1463,7 +1463,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -1497,7 +1497,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > >
 > > > MIT License
 > > >
-> > > Copyright (c) 2025 visulima
+> > > Copyright (c) 2026 visulima
 > > >
 > > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > > of this software and associated documentation files (the "Software"), to deal
@@ -1683,7 +1683,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -1717,7 +1717,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > >
 > > > MIT License
 > > >
-> > > Copyright (c) 2025 visulima
+> > > Copyright (c) 2026 visulima
 > > >
 > > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > > of this software and associated documentation files (the "Software"), to deal
@@ -1859,7 +1859,7 @@ Repository: git+https://github.com/visulima/visulima.git
 
 > MIT License
 >
-> Copyright (c) 2025 visulima
+> Copyright (c) 2026 visulima
 >
 > Permission is hereby granted, free of charge, to any person obtaining a copy
 > of this software and associated documentation files (the "Software"), to deal
@@ -1893,7 +1893,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -2808,7 +2808,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -2842,7 +2842,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > >
 > > > MIT License
 > > >
-> > > Copyright (c) 2025 visulima
+> > > Copyright (c) 2026 visulima
 > > >
 > > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > > of this software and associated documentation files (the "Software"), to deal
@@ -3028,7 +3028,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -3062,7 +3062,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > >
 > > > MIT License
 > > >
-> > > Copyright (c) 2025 visulima
+> > > Copyright (c) 2026 visulima
 > > >
 > > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > > of this software and associated documentation files (the "Software"), to deal
@@ -3204,7 +3204,7 @@ Repository: git+https://github.com/visulima/visulima.git
 
 > MIT License
 >
-> Copyright (c) 2025 visulima
+> Copyright (c) 2026 visulima
 >
 > Permission is hereby granted, free of charge, to any person obtaining a copy
 > of this software and associated documentation files (the "Software"), to deal
@@ -3238,7 +3238,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -4148,7 +4148,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -4182,7 +4182,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > >
 > > > MIT License
 > > >
-> > > Copyright (c) 2025 visulima
+> > > Copyright (c) 2026 visulima
 > > >
 > > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > > of this software and associated documentation files (the "Software"), to deal
@@ -4368,7 +4368,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -4402,7 +4402,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > >
 > > > MIT License
 > > >
-> > > Copyright (c) 2025 visulima
+> > > Copyright (c) 2026 visulima
 > > >
 > > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > > of this software and associated documentation files (the "Software"), to deal
@@ -4544,7 +4544,7 @@ Repository: git+https://github.com/visulima/visulima.git
 
 > MIT License
 >
-> Copyright (c) 2025 visulima
+> Copyright (c) 2026 visulima
 >
 > Permission is hereby granted, free of charge, to any person obtaining a copy
 > of this software and associated documentation files (the "Software"), to deal
@@ -4578,7 +4578,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal

package/dist/commands/completion-command.js

@@ -1,5 +1,203 @@
-var g=Object.defineProperty;var a=(e,t)=>g(e,"name",{value:t,configurable:!0});import S from"@bomb.sh/tab";import{c as $}from"../packem_shared/cerebro-error-CXXSmFtP.js";var w=Object.defineProperty,y=a((e,t)=>w(e,"name",{value:t,configurable:!0}),"n");class p extends ${static{a(this,"l")}static{y(this,"CompletionError")}troubleshooting;constructor(t,o,n=[]){super(t,o,{troubleshooting:n}),this.name="CompletionError",this.troubleshooting=n,n.length>0&&(this.hint=n.join(`
-`))}}var C=Object.defineProperty,s=a((e,t)=>C(e,"name",{value:t,configurable:!0}),"s");const h=["bash","zsh","fish","powershell"],d=["node","bun","deno"],v=s(e=>"Deno"in e,"hasDeno"),L=s(e=>"Bun"in e,"hasBun"),u=s(()=>v(globalThis)?"deno":L(globalThis)?"bun":"node","detectRuntime"),m=s(e=>{const t=e?.starshipShell??e?.shell;if(t){const r=t.toLowerCase();if(r.includes("zsh"))return"zsh";if(r.includes("bash"))return"bash";if(r.includes("fish"))return"fish"}const o=e?.psModulePath,n=e?.prompt;if(o||n?.includes("PS"))return"powershell";if(e?.comSpec?.toLowerCase().includes("cmd.exe"))return"bash"},"detectShell"),f=S,I=s((e,t)=>{for(const o of t)o.hidden||(o.name&&e.option(o.name,o.description||""),o.alias&&e.option(o.alias,o.description||""))},"registerCommandOptions"),P=s((e,t)=>{for(const[o,n]of t){if(n.name!==o||n.hidden)continue;const r=e.command(n.name,n.description||"");n.options&&I(r,n.options)}},"registerCommands"),E=s(e=>{if(!h.includes(e))throw new p(`Invalid shell type: ${e}`,"INVALID_SHELL",[`Valid shells are: ${h.join(", ")}`,"Shell will be auto-detected if not specified"])},"validateShell"),j=s(e=>{if(e&&!d.includes(e))throw new p(`Invalid runtime: ${e}`,"INVALID_RUNTIME",[`Valid runtimes are: ${d.join(", ")}`,"Runtime will be auto-detected if not specified"])},"validateRuntime"),z=s((e,t)=>{e.error("Could not detect current shell");const o=[`Usage: ${t} completion --shell=<bash|zsh|fish|powershell> [--runtime=<node|bun|deno>]`,"","Examples:","  # Install completions for zsh:",`  ${t} completion --shell=zsh > ~/.${t}-completion.zsh`,`  echo 'source ~/.${t}-completion.zsh' >> ~/.zshrc`,"","  # Install completions for bash with custom runtime:",`  ${t} completion --shell=bash --runtime=bun > ~/.${t}-completion.bash`,`  echo 'source ~/.${t}-completion.bash' >> ~/.bashrc`,"","  # Install completions for fish:",`  ${t} completion --shell=fish > ~/.config/fish/completions/${t}.fish`].join(`
-`);e.info(o)},"printUsageInstructions"),x={description:"Generate shell completion scripts",env:[{description:"Shell path (Unix-like systems). Used for shell detection.",name:"SHELL",type:String},{description:"Starship shell configuration. Takes precedence over SHELL for detection.",name:"STARSHIP_SHELL",type:String},{description:"PowerShell module path (Windows). Used for PowerShell detection.",name:"PSModulePath",type:String},{description:"Command prompt variable (Windows). Used for PowerShell detection.",name:"PROMPT",type:String},{description:"Command processor (Windows). Used for Windows Command Prompt detection.",name:"ComSpec",type:String}],execute:s(async({env:e,logger:t,options:o,runtime:n})=>{const r=n.getCliName(),c=o?.shell||m(e);if(!c){z(t,r);return}try{E(c),j(o?.runtime),P(f,n.getCommands());const i=`${o?.runtime||u()} ${r}`;f.setup(r,i,c)}catch(i){if(i instanceof p){const l=[`Failed to generate completion script: ${i.message}`,`Error code: ${i.code}`];throw i.troubleshooting.length>0&&l.push("","Troubleshooting:",...i.troubleshooting.map(b=>`  • ${b}`)),t.error(l.join(`
-`)),i}else{const l=["Failed to generate completion script",`Error: ${i instanceof Error?i.message:String(i)}`,"","Troubleshooting:","  • Ensure @bomb.sh/tab is installed: pnpm add @bomb.sh/tab",`  • Verify shell is supported: ${h.join(", ")}`,`  • Verify runtime is supported: ${d.join(", ")}`,"  • Check that your CLI name is correct"];t.error(l.join(`
-`))}}},"execute"),name:"completion",options:[{defaultOption:!0,defaultValue:m(),description:"Shell type (bash, zsh, fish, powershell). Defaults to current shell if detected.",name:"shell",type:String,typeLabel:"{underline shell}"},{defaultOption:!0,defaultValue:u(),description:"JavaScript runtime (node, bun, deno). Defaults to current runtime if detected.",name:"runtime",type:String,typeLabel:"{underline runtime}"}]};export{x as default};
+import tab from '@bomb.sh/tab';
+import { C as CerebroError } from '../packem_shared/cerebro-error-GmJ3jN7Q.js';
+
+class CompletionError extends CerebroError {
+  troubleshooting;
+  constructor(message, code, troubleshooting = []) {
+    super(message, code, { troubleshooting });
+    this.name = "CompletionError";
+    this.troubleshooting = troubleshooting;
+    if (troubleshooting.length > 0) {
+      this.hint = troubleshooting.join("\n");
+    }
+  }
+}
+
+const validShells = ["bash", "zsh", "fish", "powershell"];
+const validRuntimes = ["node", "bun", "deno"];
+const hasDeno = (global) => "Deno" in global;
+const hasBun = (global) => "Bun" in global;
+const detectRuntime = () => {
+  if (hasDeno(globalThis)) {
+    return "deno";
+  }
+  if (hasBun(globalThis)) {
+    return "bun";
+  }
+  return "node";
+};
+const detectShell = (toolboxEnv) => {
+  const starshipShell = toolboxEnv?.starshipShell;
+  const shell = starshipShell ?? toolboxEnv?.shell;
+  if (shell) {
+    const shellPath = shell.toLowerCase();
+    if (shellPath.includes("zsh")) {
+      return "zsh";
+    }
+    if (shellPath.includes("bash")) {
+      return "bash";
+    }
+    if (shellPath.includes("fish")) {
+      return "fish";
+    }
+  }
+  const psModulePath = toolboxEnv?.psModulePath;
+  const prompt = toolboxEnv?.prompt;
+  if (psModulePath || prompt?.includes("PS")) {
+    return "powershell";
+  }
+  const comSpec = toolboxEnv?.comSpec;
+  if (comSpec?.toLowerCase().includes("cmd.exe")) {
+    return "bash";
+  }
+  return void 0;
+};
+const tabInstance = tab;
+const registerCommandOptions = (cmd, options) => {
+  for (const option of options) {
+    if (option.hidden) {
+      continue;
+    }
+    if (option.name) {
+      cmd.option(option.name, option.description || "");
+    }
+    if (option.alias) {
+      cmd.option(option.alias, option.description || "");
+    }
+  }
+};
+const registerCommands = (tabInstance2, commands) => {
+  for (const [commandName, command] of commands) {
+    if (command.name !== commandName || command.hidden) {
+      continue;
+    }
+    const cmd = tabInstance2.command(command.name, command.description || "");
+    if (command.options) {
+      registerCommandOptions(cmd, command.options);
+    }
+  }
+};
+const validateShell = (shell) => {
+  if (!validShells.includes(shell)) {
+    throw new CompletionError(`Invalid shell type: ${shell}`, "INVALID_SHELL", [
+      `Valid shells are: ${validShells.join(", ")}`,
+      "Shell will be auto-detected if not specified"
+    ]);
+  }
+};
+const validateRuntime = (runtime) => {
+  if (runtime && !validRuntimes.includes(runtime)) {
+    throw new CompletionError(`Invalid runtime: ${runtime}`, "INVALID_RUNTIME", [
+      `Valid runtimes are: ${validRuntimes.join(", ")}`,
+      "Runtime will be auto-detected if not specified"
+    ]);
+  }
+};
+const printUsageInstructions = (logger, cliName) => {
+  logger.error("Could not detect current shell");
+  const usageInfo = [
+    `Usage: ${cliName} completion --shell=<bash|zsh|fish|powershell> [--runtime=<node|bun|deno>]`,
+    "",
+    "Examples:",
+    `  # Install completions for zsh:`,
+    `  ${cliName} completion --shell=zsh > ~/.${cliName}-completion.zsh`,
+    `  echo 'source ~/.${cliName}-completion.zsh' >> ~/.zshrc`,
+    "",
+    `  # Install completions for bash with custom runtime:`,
+    `  ${cliName} completion --shell=bash --runtime=bun > ~/.${cliName}-completion.bash`,
+    `  echo 'source ~/.${cliName}-completion.bash' >> ~/.bashrc`,
+    "",
+    `  # Install completions for fish:`,
+    `  ${cliName} completion --shell=fish > ~/.config/fish/completions/${cliName}.fish`
+  ].join("\n");
+  logger.info(usageInfo);
+};
+const completionCommand = {
+  description: "Generate shell completion scripts",
+  env: [
+    {
+      description: "Shell path (Unix-like systems). Used for shell detection.",
+      name: "SHELL",
+      type: String
+    },
+    {
+      description: "Starship shell configuration. Takes precedence over SHELL for detection.",
+      name: "STARSHIP_SHELL",
+      type: String
+    },
+    {
+      description: "PowerShell module path (Windows). Used for PowerShell detection.",
+      name: "PSModulePath",
+      type: String
+    },
+    {
+      description: "Command prompt variable (Windows). Used for PowerShell detection.",
+      name: "PROMPT",
+      type: String
+    },
+    {
+      description: "Command processor (Windows). Used for Windows Command Prompt detection.",
+      name: "ComSpec",
+      type: String
+    }
+  ],
+  execute: async ({ env: toolboxEnv, logger, options, runtime }) => {
+    const cliName = runtime.getCliName();
+    const shell = options?.shell || detectShell(toolboxEnv);
+    if (!shell) {
+      printUsageInstructions(logger, cliName);
+      return;
+    }
+    try {
+      validateShell(shell);
+      validateRuntime(options?.runtime);
+      registerCommands(tabInstance, runtime.getCommands());
+      const jsRuntime = options?.runtime || detectRuntime();
+      const scriptPath = `${jsRuntime} ${cliName}`;
+      tabInstance.setup(cliName, scriptPath, shell);
+    } catch (error) {
+      if (error instanceof CompletionError) {
+        const errorMessages = [`Failed to generate completion script: ${error.message}`, `Error code: ${error.code}`];
+        if (error.troubleshooting.length > 0) {
+          errorMessages.push("", "Troubleshooting:", ...error.troubleshooting.map((tip) => `  • ${tip}`));
+        }
+        logger.error(errorMessages.join("\n"));
+        throw error;
+      } else {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorMessages = [
+          "Failed to generate completion script",
+          `Error: ${errorMessage}`,
+          "",
+          "Troubleshooting:",
+          "  • Ensure @bomb.sh/tab is installed: pnpm add @bomb.sh/tab",
+          `  • Verify shell is supported: ${validShells.join(", ")}`,
+          `  • Verify runtime is supported: ${validRuntimes.join(", ")}`,
+          "  • Check that your CLI name is correct"
+        ];
+        logger.error(errorMessages.join("\n"));
+      }
+    }
+  },
+  name: "completion",
+  options: [
+    {
+      defaultOption: true,
+      defaultValue: detectShell(),
+      description: "Shell type (bash, zsh, fish, powershell). Defaults to current shell if detected.",
+      name: "shell",
+      type: String,
+      typeLabel: "{underline shell}"
+    },
+    {
+      defaultOption: true,
+      defaultValue: detectRuntime(),
+      description: "JavaScript runtime (node, bun, deno). Defaults to current runtime if detected.",
+      name: "runtime",
+      type: String,
+      typeLabel: "{underline runtime}"
+    }
+  ]
+};
+
+export { completionCommand as default };

package/dist/commands/help-command.js

@@ -1 +1,3 @@
-import"@visulima/colorize";import{D as p}from"../packem_shared/help-command-CIRIXN03.js";import"../packem_shared/index-DQ3pvLQH.js";export{p as default};
+import '@visulima/colorize';
+export { H as default } from '../packem_shared/help-command-BY7rQUvM.js';
+import '../packem_shared/index-C2-8b3A4.js';