@visulima/cerebro 3.1.3 → 4.0.0

package/CHANGELOG.md

@@ -1,3 +1,113 @@
+## @visulima/cerebro [4.0.0](https://github.com/visulima/visulima/compare/@visulima/cerebro@3.1.3...@visulima/cerebro@4.0.0) (2026-10-15)
+
+### ⚠ BREAKING CHANGES
+
+* Deno is no longer a supported runtime or package manager.
+vis targets node/bun runtimes and aube/npm/pnpm/yarn package managers; the
+deno-lint/deno-fmt adapters and deno inference targets are removed.
+
+* fix: resolve eslint errors after deno removal
+
+- vis: use a block body for applyIgnoreScripts (arrow-body-style)
+- is-ansi-color-supported: drop stale eslint-disable directives and
+  replace the raw-release if/else with a ternary (unicorn/prefer-ternary)
+
+* docs(cron-parser): remove remaining deno runtime mentions
+
+These doc/config files arrived with main's dialect-gating commit after this
+branch's base, so they still listed Deno as a supported runtime.
+
+* feat!: remove deno runtime and tooling support
+
+Deno is being wound down: Cloudflare is acquiring the Deno team, the runtime
+gets one more year of monthly maintenance before development ends, and Deno
+Deploy shuts down. Drop Deno as a supported runtime, package manager, and
+lint/fmt/inference target across the monorepo.
+
+- vis: remove the deno runtime path, deno-lint/deno-fmt adapters, the
+  deno.json inference detector, Deno PM handling (TypeScript + Rust native
+  resolver), and the devcontainer deno mount; regenerate the JSON schemas.
+- libraries: drop Deno runtime detection from cerebro, ono,
+  is-ansi-color-supported, and task-runner command parsing; remove Deno
+  wording from package docs and READMEs.
+- delete the examples/deno directories (ono, pail, storage) and Deno docs.
+- keep JSR publishing (registry usable from Node), license/attribution
+  comments, the secret-scanner Deno-token rule, and the historical RFCs.
+* Deno is no longer a supported runtime or package manager.
+vis targets node/bun runtimes and aube/npm/pnpm/yarn package managers; the
+deno-lint/deno-fmt adapters and deno inference targets are removed.
+
+* fix: resolve eslint errors after deno removal
+
+- vis: use a block body for applyIgnoreScripts (arrow-body-style)
+- is-ansi-color-supported: drop stale eslint-disable directives and
+  replace the raw-release if/else with a ternary (unicorn/prefer-ternary)
+
+* chore(vis): tidy deno-removal leftovers from review
+
+* fix(vis): drop unused logger from x handler, restore bun typing
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* docs: add migration notes for removed deno exports
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* feat(vis): warn on stale adapter ids and deno-only projects
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* refactor(vis): derive runtime ids and reuse bun detection
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* refactor(vis): drop jsr deno option and deno auth reference
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* fix(vis): restore runtime id schema description
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* refactor(vis): remove jsr publishing support
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* feat(bytes): port @std/bytes helpers back in
+
+Carries the Uint8Array helpers from @std/bytes@1.0.6 (MIT, Copyright the Deno authors)
+into src/std-bytes.ts and re-exports them from the package entry. Keeps the public API that
+the Deno-removal commit dropped, without the jsr: devDependency. Docs and AGENTS notes are
+restored to describe the ported functions.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* docs(bytes): attribute ported @std/bytes source
+
+The license file still listed @jsr/std__bytes as a bundled dependency.
+Replace it with the MIT notice for the ported src/std-bytes.ts, placed outside
+the generated dependency blocks.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* fix(cron-parser): keep reviewed docs and 1.1.0 version
+
+The rebase onto the remote branch dropped the reviewed dialect sentence in the README and
+the installation table row, and the release commit's 1.1.0 version bump.
+
+### Features
+
+* remove deno runtime and tooling support ([#973](https://github.com/visulima/visulima/issues/973)) ([26fada1](https://github.com/visulima/visulima/commit/26fada1ac04731cba9db8f74fe20849c0a15db74))
+
+
+### Dependencies
+
+* **@visulima/colorize:** upgraded to 3.0.0
+* **@visulima/boxen:** upgraded to 6.0.0
+* **@visulima/find-cache-dir:** upgraded to 4.0.0
+* **@visulima/pail:** upgraded to 6.0.0
+* **@visulima/path:** upgraded to 5.0.0
+
 ## @visulima/cerebro [3.1.3](https://github.com/visulima/visulima/compare/@visulima/cerebro@3.1.2...@visulima/cerebro@3.1.3) (2026-10-13)
 
 

package/LICENSE.md

@@ -559,6 +559,36 @@ Repository: git+https://github.com/visulima/visulima.git
 > MIT
 >
 > # Bundled dependencies:
+> ## codsen-format-diagnostic-value
+> License: MIT
+> By: Roy Revelt
+> Repository: git+https://github.com/codsen/codsen.git
+>
+> > MIT License
+> >
+> > Copyright © 2010-2026 Roy Revelt and other contributors
+> >
+> > Permission is hereby granted, free of charge, to any person obtaining
+> > a copy of this software and associated documentation files (the
+> > "Software"), to deal in the Software without restriction, including
+> > without limitation the rights to use, copy, modify, merge, publish,
+> > distribute, sublicense, and/or sell copies of the Software, and to
+> > permit persons to whom the Software is furnished to do so, subject to
+> > the following conditions:
+> >
+> > The above copyright notice and this permission notice shall be
+> > included in all copies or substantial portions of the Software.
+> >
+> > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+> > EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+> > MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+> > NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+> > LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+> > OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+> > WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+>
+> ---------------------------------------
+>
 > ## codsen-utils
 > License: MIT
 > By: Roy Revelt
@@ -566,7 +596,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright © 2010-2025 Roy Revelt and other contributors
+> > Copyright © 2010-2026 Roy Revelt and other contributors
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining
 > > a copy of this software and associated documentation files (the
@@ -664,68 +694,14 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > ---------------------------------------
 >
-> ## html-entities
-> License: MIT
-> By: Marat Dulin
-> Repository: https://github.com/mdevils/html-entities.git
->
-> > Copyright (c) 2021 Dulin Marat
-> >
-> > Permission is hereby granted, free of charge, to any person obtaining a copy
-> > of this software and associated documentation files (the "Software"), to deal
-> > in the Software without restriction, including without limitation the rights
-> > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-> > copies of the Software, and to permit persons to whom the Software is
-> > furnished to do so, subject to the following conditions:
-> >
-> > The above copyright notice and this permission notice shall be included in
-> > all copies or substantial portions of the Software.
-> >
-> > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-> > IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-> > FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-> > AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-> > LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-> > OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-> > THE SOFTWARE.
->
-> ---------------------------------------
->
-> ## indent-string
+> ## html-entity-codec
 > License: MIT
-> By: Sindre Sorhus
-> Repository: sindresorhus/indent-string
+> By: Roy Revelt
+> Repository: git+https://github.com/codsen/codsen.git
 >
 > > MIT License
 > >
-> > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
-> >
-> > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-> >
-> > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-> >
-> > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
->
-> ---------------------------------------
->
-> ## lodash-es
-> License: MIT
-> By: John-David Dalton, Mathias Bynens
-> Repository: lodash/lodash
->
-> > Copyright OpenJS Foundation and other contributors <https://openjsf.org/>
-> >
-> > Based on Underscore.js, copyright Jeremy Ashkenas,
-> > DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
-> >
-> > This software consists of voluntary contributions made by many
-> > individuals. For exact contribution history, see the revision history
-> > available at https://github.com/lodash/lodash
-> >
-> > The following license applies to all parts of this software except as
-> > documented below:
-> >
-> > ====
+> > Copyright © 2010-2026 Roy Revelt and other contributors
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining
 > > a copy of this software and associated documentation files (the
@@ -745,21 +721,23 @@ Repository: git+https://github.com/visulima/visulima.git
 > > LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 > > OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 > > WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+>
+> ---------------------------------------
+>
+> ## indent-string
+> License: MIT
+> By: Sindre Sorhus
+> Repository: sindresorhus/indent-string
+>
+> > MIT License
 > >
-> > ====
-> >
-> > Copyright and related rights for sample code are waived via CC0. Sample
-> > code is defined as all source code displayed within the prose of the
-> > documentation.
+> > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
 > >
-> > CC0: http://creativecommons.org/publicdomain/zero/1.0/
+> > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 > >
-> > ====
+> > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 > >
-> > Files located in the node_modules and vendor directories are externally
-> > maintained libraries used by this software which have their own
-> > licenses; we recommend you read them, as their terms may differ from the
-> > terms above.
+> > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 >
 > ---------------------------------------
 >
@@ -770,7 +748,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright © 2010-2025 Roy Revelt and other contributors
+> > Copyright © 2010-2026 Roy Revelt and other contributors
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining
 > > a copy of this software and associated documentation files (the
@@ -800,7 +778,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright © 2010-2025 Roy Revelt and other contributors
+> > Copyright © 2010-2026 Roy Revelt and other contributors
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining
 > > a copy of this software and associated documentation files (the
@@ -830,7 +808,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright © 2010-2025 Roy Revelt and other contributors
+> > Copyright © 2010-2026 Roy Revelt and other contributors
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining
 > > a copy of this software and associated documentation files (the
@@ -860,7 +838,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright © 2010-2025 Roy Revelt and other contributors
+> > Copyright © 2010-2026 Roy Revelt and other contributors
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining
 > > a copy of this software and associated documentation files (the
@@ -900,29 +878,6 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > ---------------------------------------
 >
-> ## rfdc
-> License: MIT
-> By: David Mark Clements
-> Repository: git+https://github.com/davidmarkclements/rfdc.git
->
-> > Copyright 2019 "David Mark Clements <david.mark.clements@gmail.com>"
-> >
-> > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated 
-> > documentation files (the "Software"), to deal in the Software without restriction, including without limitation 
-> > the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and 
-> > to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-> >
-> > The above copyright notice and this permission notice shall be included in all copies or substantial portions 
-> > of the Software.
-> >
-> > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED 
-> > TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
-> > THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF 
-> > CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS 
-> > IN THE SOFTWARE.
->
-> ---------------------------------------
->
 > ## string-collapse-leading-whitespace
 > License: MIT
 > By: Roy Revelt
@@ -930,7 +885,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright © 2010-2025 Roy Revelt and other contributors
+> > Copyright © 2010-2026 Roy Revelt and other contributors
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining
 > > a copy of this software and associated documentation files (the
@@ -960,7 +915,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright © 2010-2025 Roy Revelt and other contributors
+> > Copyright © 2010-2026 Roy Revelt and other contributors
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining
 > > a copy of this software and associated documentation files (the
@@ -990,7 +945,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright © 2010-2025 Roy Revelt and other contributors
+> > Copyright © 2010-2026 Roy Revelt and other contributors
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining
 > > a copy of this software and associated documentation files (the
@@ -1028,35 +983,6 @@ Repository: git+https://github.com/visulima/visulima.git
 > >
 > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 >
-> ---------------------------------------
->
-> ## tiny-invariant
-> License: MIT
-> By: Alex Reardon
-> Repository: https://github.com/alexreardon/tiny-invariant.git
->
-> > MIT License
-> >
-> > Copyright (c) 2019 Alexander Reardon
-> >
-> > Permission is hereby granted, free of charge, to any person obtaining a copy
-> > of this software and associated documentation files (the "Software"), to deal
-> > in the Software without restriction, including without limitation the rights
-> > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-> > copies of the Software, and to permit persons to whom the Software is
-> > furnished to do so, subject to the following conditions:
-> >
-> > The above copyright notice and this permission notice shall be included in all
-> > copies or substantial portions of the Software.
-> >
-> > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-> > IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-> > FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-> > AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-> > LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-> > OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-> > SOFTWARE.
->
 >
 >
 >

package/MIGRATION-GUIDE.md

@@ -6,14 +6,36 @@ This guide documents breaking changes and migration steps for the `@visulima/cer
 
 ### Breaking Changes Summary
 
-- **Supported runtimes**: Node.js 20.19+, Deno 1.0+, Bun 1.0+
+- **Supported runtimes**: Node.js 20.19+, Bun 1.0+
 - **Module format**: ESM-only (CommonJS removed)
 - **Import structure**: Granular plugin and command exports
 - **Error handling**: Enhanced error types and validation
 
+### Deno runtime removed
+
+Deno is no longer a supported runtime. Three public types changed with it:
+
+- `RuntimeType` is now `"bun" | "node"`. `"deno"` is gone.
+- `runtimeVersionCheckPlugin({ runtimes })` no longer accepts `runtimes.deno`. Remove that key. Passing it is a type error.
+- The plugin no longer detects Deno. A Deno process falls through to the Node branch.
+
+#### Before
+
+```ts
+runtimeVersionCheckPlugin({ runtimes: { bun: { minVersion: 1 }, deno: { minVersion: 2 }, node: { minVersion: 20 } } });
+```
+
+#### After
+
+```ts
+runtimeVersionCheckPlugin({ runtimes: { bun: { minVersion: 1 }, node: { minVersion: 20 } } });
+```
+
+If you match on the detected runtime type, drop the `"deno"` branch.
+
 ### CommonJS (CJS) Export Removed
 
-The CommonJS (CJS) export has been removed in favor of ECMAScript Modules (ESM) only. Cerebro now supports Node.js, Deno, and Bun runtimes. For CJS compatibility in Node.js 20.19+, use dynamic imports.
+The CommonJS (CJS) export has been removed in favor of ECMAScript Modules (ESM) only. Cerebro now supports Node.js and Bun runtimes. For CJS compatibility in Node.js 20.19+, use dynamic imports.
 
 #### Before (v1.x)
 
@@ -22,14 +44,14 @@ The CommonJS (CJS) export has been removed in favor of ECMAScript Modules (ESM)
 const { Cerebro, createCerebro } = require("@visulima/cerebro");
 ```
 
-#### After (v2.x) - Node.js 20.19+, Deno 1.0+, Bun 1.0+
+#### After (v2.x) - Node.js 20.19+, Bun 1.0+
 
 ```javascript
 // Use dynamic import for ESM modules from CJS (Node.js only)
 const { Cerebro, createCerebro } = await import("@visulima/cerebro");
 ```
 
-**Note**: Deno and Bun natively support ESM, so you can use standard `import` statements directly.
+**Note**: Bun natively supports ESM, so you can use standard `import` statements directly.
 
 #### Alternative: Convert to ESM
 
@@ -271,7 +293,7 @@ Ensure your `package.json` uses ESM:
 }
 ```
 
-> **Note**: Deno and Bun don't use the `package.json` engines field. Deno uses `deno.json`, and Bun supports both `package.json` and `bunfig.toml`.
+> **Note**: Bun doesn't use the `package.json` engines field; it supports both `package.json` and `bunfig.toml`.
 
 #### 2. Update Imports
 
@@ -709,8 +731,8 @@ cli.addPlugin(
 
 ### ESM Migration Benefits
 
-- **Better Performance**: ESM's improved module caching in Node.js 20.19+, native ESM support in Deno and Bun
-- **Cross-Runtime Support**: Works seamlessly across Node.js, Deno, and Bun
+- **Better Performance**: ESM's improved module caching in Node.js 20.19+, native ESM support in Bun
+- **Cross-Runtime Support**: Works seamlessly across Node.js and Bun
 - **Modern JavaScript**: Consistent module syntax across environments
 - **Bundle Optimization**: Better tree-shaking and dead code elimination
 - **Developer Experience**: Improved IDE support and error messages

package/README.md

@@ -6,7 +6,7 @@
 
 </a>
 
-<h3 align="center">A delightful toolkit for building cross-runtime CLIs for Node.js, Deno, and Bun.</h3>
+<h3 align="center">A delightful toolkit for building cross-runtime CLIs for Node.js and Bun.</h3>
 
 <!-- END_PACKAGE_OG_IMAGE_PLACEHOLDER -->
 
@@ -135,7 +135,7 @@ cli.addCommand({
 await cli.run();
 ```
 
-Now you can run your CLI with `node index.js` (or `deno run index.js`, `bun index.js`). Here are some example usages:
+Now you can run your CLI with `node index.js` (or `bun index.js`). Here are some example usages:
 
 ```bash
 # Show help
@@ -237,7 +237,7 @@ When your command's `execute` function is called, it receives a toolbox object w
 - **`args`**: Named positional arguments (camelCase keys) from the command's `arguments: [ ... ]` definitions; empty when none are declared
 - **`env`**: Environment variables (camelCase keys) processed from the command's `env: [...]` definitions
 - **`fs`**: Injected filesystem adapter (subset of `node:fs/promises`). Swap via `CliOptions.fs` for tests or sandboxed runtimes.
-- **`process`**: Runtime snapshot — `cwd`, `env`, `argv`, `stdin`, `exit`, `platform`, `arch`. Prefer this over the global `process` so commands stay portable across Node, Deno, Bun, and mocked test runtimes.
+- **`process`**: Runtime snapshot — `cwd`, `env`, `argv`, `stdin`, `exit`, `platform`, `arch`. Prefer this over the global `process` so commands stay portable across Node, Bun, and mocked test runtimes.
 - **`runtime`**: Reference to the CLI instance
 - **`argv`**: Original command-line arguments array
 
@@ -287,7 +287,7 @@ cli.addCommand({
 
 ## Runtime Injection
 
-Commands receive an injected `{ fs, console, process }` context on the toolbox. Prefer reading from these over reaching for `node:fs/promises`, the global `console`, or the global `process` — commands written against the injected context stay testable, portable across Node/Deno/Bun, and ready to run inside sandboxed environments like MCP servers.
+Commands receive an injected `{ fs, console, process }` context on the toolbox. Prefer reading from these over reaching for `node:fs/promises`, the global `console`, or the global `process` — commands written against the injected context stay testable, portable across Node/Bun, and ready to run inside sandboxed environments like MCP servers.
 
 ```ts
 import { Cerebro } from "@visulima/cerebro";
@@ -513,7 +513,7 @@ yarn add @bomb.sh/tab
 Import and add the completion command to your CLI. The completion command supports two options:
 
 - **`--shell`**: Shell type (bash, zsh, fish, powershell) - auto-detected by default
-- **`--runtime`**: JavaScript runtime (node, bun, deno) - auto-detected by default
+- **`--runtime`**: JavaScript runtime (node, bun) - auto-detected by default
 
 ```ts
 import { Cerebro } from "@visulima/cerebro";
@@ -621,7 +621,6 @@ If completions don't work:
 Cerebro supports multiple JavaScript runtimes:
 
 - **Node.js**: >=20.19 <=25.x (follows [Node.js' release schedule](https://github.com/nodejs/release#release-schedule))
-- **Deno**: 1.0+
 - **Bun**: 1.0+
 
 The library uses runtime-agnostic APIs to ensure compatibility across all supported runtimes. Here's [a post on why we think tracking Node.js releases is important](https://medium.com/the-node-js-collection/maintainers-should-consider-following-node-js-release-schedule-ab08ed4de71a).

package/dist/commands/completion-command.d.ts

@@ -1,4 +1,4 @@
-import { C as Command } from "../packem_shared/command.d-Dz7hkMI0.js";
+import { C as Command } from "../packem_shared/command.d-DNTe-FYX.js";
 import '@visulima/tabular';
 /**
  * Generates shell completion scripts for the CLI application.

package/dist/commands/completion-command.js

@@ -1,5 +1,5 @@
-import{C as u}from"../packem_shared/cerebro-error-Dv3FuXO8.js";class d extends u{troubleshooting;constructor(t,n,o=[]){super(t,n,{troubleshooting:o}),this.name="CompletionError",this.troubleshooting=o,o.length>0&&(this.hint=o.join(`
-`))}}const c=["bash","zsh","fish","powershell"],h=["node","bun","deno"],f=e=>"Deno"in e,S=e=>"Bun"in e,p=()=>f(globalThis)?"deno":S(globalThis)?"bun":"node",m=e=>{const n=e?.starshipShell??e?.shell;if(n){const s=n.toLowerCase();if(s.includes("zsh"))return"zsh";if(s.includes("bash"))return"bash";if(s.includes("fish"))return"fish"}const o=e?.psModulePath,i=e?.prompt;if(o||i?.includes("PS"))return"powershell";if(e?.comSpec?.toLowerCase().includes("cmd.exe"))return"bash"},b=async()=>(await import("@bomb.sh/tab")).default,g=(e,t)=>{for(const n of t)n.hidden||(n.name&&e.option(n.name,n.description??""),n.alias&&e.option(n.alias,n.description??""))},w=(e,t)=>{for(const[n,o]of t){if(o.name!==n||o.hidden)continue;const i=e.command(o.name,o.description??"");o.options&&g(i,o.options)}},$=e=>{if(!c.includes(e))throw new d(`Invalid shell type: ${e}`,"INVALID_SHELL",[`Valid shells are: ${c.join(", ")}`,"Shell will be auto-detected if not specified"])},y=e=>{if(e&&!h.includes(e))throw new d(`Invalid runtime: ${e}`,"INVALID_RUNTIME",[`Valid runtimes are: ${h.join(", ")}`,"Runtime will be auto-detected if not specified"])},C=(e,t)=>{e.error("Could not detect current shell");const n=[`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(n)},L={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:e,logger:t,options:n,runtime:o})=>{const i=o.getCliName(),l=n.shell??m(e);if(!l){C(t,i);return}try{$(l),y(n.runtime);const s=await b();w(s,o.getCommands());const r=`${n.runtime??p()} ${i}`;s.setup(i,r,l)}catch(s){if(s instanceof d){const a=[`Failed to generate completion script: ${s.message}`,`Error code: ${s.code}`];throw s.troubleshooting.length>0&&a.push("","Troubleshooting:",...s.troubleshooting.map(r=>`  • ${r}`)),t.error(a.join(`
+import{C as u}from"../packem_shared/cerebro-error-Dv3FuXO8.js";import{h as f}from"../packem_shared/runtime-process-BLYbrTb0.js";class d extends u{troubleshooting;constructor(t,n,o=[]){super(t,n,{troubleshooting:o}),this.name="CompletionError",this.troubleshooting=o,o.length>0&&(this.hint=o.join(`
+`))}}const c=["bash","zsh","fish","powershell"],h=["node","bun"],p=()=>f(globalThis)?"bun":"node",m=e=>{const n=e?.starshipShell??e?.shell;if(n){const s=n.toLowerCase();if(s.includes("zsh"))return"zsh";if(s.includes("bash"))return"bash";if(s.includes("fish"))return"fish"}const o=e?.psModulePath,i=e?.prompt;if(o||i?.includes("PS"))return"powershell";if(e?.comSpec?.toLowerCase().includes("cmd.exe"))return"bash"},S=async()=>(await import("@bomb.sh/tab")).default,b=(e,t)=>{for(const n of t)n.hidden||(n.name&&e.option(n.name,n.description??""),n.alias&&e.option(n.alias,n.description??""))},g=(e,t)=>{for(const[n,o]of t){if(o.name!==n||o.hidden)continue;const i=e.command(o.name,o.description??"");o.options&&b(i,o.options)}},w=e=>{if(!c.includes(e))throw new d(`Invalid shell type: ${e}`,"INVALID_SHELL",[`Valid shells are: ${c.join(", ")}`,"Shell will be auto-detected if not specified"])},$=e=>{if(e&&!h.includes(e))throw new d(`Invalid runtime: ${e}`,"INVALID_RUNTIME",[`Valid runtimes are: ${h.join(", ")}`,"Runtime will be auto-detected if not specified"])},y=(e,t)=>{e.error("Could not detect current shell");const n=[`Usage: ${t} completion --shell=<bash|zsh|fish|powershell> [--runtime=<node|bun>]`,"","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(n)},L={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:e,logger:t,options:n,runtime:o})=>{const i=o.getCliName(),l=n.shell??m(e);if(!l){y(t,i);return}try{w(l),$(n.runtime);const s=await S();g(s,o.getCommands());const r=`${n.runtime??p()} ${i}`;s.setup(i,r,l)}catch(s){if(s instanceof d){const a=[`Failed to generate completion script: ${s.message}`,`Error code: ${s.code}`];throw s.troubleshooting.length>0&&a.push("","Troubleshooting:",...s.troubleshooting.map(r=>`  • ${r}`)),t.error(a.join(`
 `)),s}else{const r=["Failed to generate completion script",`Error: ${s instanceof Error?s.message:String(s)}`,"","Troubleshooting:","  • Ensure @bomb.sh/tab is installed: pnpm add @bomb.sh/tab",`  • Verify shell is supported: ${c.join(", ")}`,`  • Verify runtime is supported: ${h.join(", ")}`,"  • Check that your CLI name is correct"];t.error(r.join(`
-`))}}},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}"},{defaultValue:p(),description:"JavaScript runtime (node, bun, deno). Defaults to current runtime if detected.",name:"runtime",type:String,typeLabel:"{underline runtime}"}]};export{L as default};
+`))}}},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}"},{defaultValue:p(),description:"JavaScript runtime (node, bun). Defaults to current runtime if detected.",name:"runtime",type:String,typeLabel:"{underline runtime}"}]};export{L as default};

package/dist/commands/help-command.d.ts

@@ -1,4 +1,4 @@
-import { O as OptionDefinition, A as ArgumentDefinition, C as Command, T as Toolbox } from "../packem_shared/command.d-Dz7hkMI0.js";
+import { O as OptionDefinition, A as ArgumentDefinition, C as Command, T as Toolbox } from "../packem_shared/command.d-DNTe-FYX.js";
 import '@visulima/tabular';
 declare class HelpCommand<TLogger extends Console = Console> implements Command<OptionDefinition<string>, TLogger> {
   argument: ArgumentDefinition<string>;

package/dist/commands/help-command.js

@@ -1 +1 @@
-import{inverse as d,cyan as f,green as h,yellow as y}from"@visulima/colorize";import{t as v,c as b,f as E}from"../packem_shared/format-positional-usage-O92DKKjW.js";const N=[{defaultValue:"32",description:"Controls the verbosity level of output. Valid values: '16' (quiet), '32' (normal), '64' (verbose), '128' (debug)",name:"CEREBRO_OUTPUT_LEVEL",type:String},{description:"Sets the minimum required Node.js version. Overrides the default minimum version check",name:"CEREBRO_MIN_NODE_VERSION",type:Number},{defaultValue:!1,description:"When set, disables the update notifier check",name:"NO_UPDATE_NOTIFIER",type:Boolean},{description:"Standard Node.js environment variable. When set to 'test', disables update notifier",name:"NODE_ENV",type:String},{defaultValue:!1,description:"When set, enables debug output (same as --debug flag)",name:"DEBUG",type:Boolean},{description:"Sets the terminal width for table rendering. Useful for testing and consistent output",name:"CEREBRO_TERMINAL_WIDTH",type:Number}],$="__Other",C=r=>r.charAt(0).toUpperCase()+r.slice(1),w=(r,s,l,o)=>{r.debug("no command given, printing general help...");let m=[...new Set(l.values())].filter(t=>!t.hidden);o&&(m=m.filter(t=>t.group===o));const e=m.reduce((t,i)=>{const p=i.group??$;return t[p]??=[],t[p].push(i),t},{}),a=t=>t.map(i=>{let p="";typeof i.alias=="string"?p=i.alias:Array.isArray(i.alias)&&(p=i.alias.join(", ")),p!==""&&(p=` [${p}]`);let u=i.name;return i.commandPath&&i.commandPath.length>0&&(u=`${i.commandPath.join(" ")} ${i.name}`),[`${h(u)}${p}`,i.description??""]});(r.raw??r.log)(b([{content:`${f(s.getCliName())} ${h("<command>")} [positional arguments] ${y("[options]")}`,header:d.cyan(" Usage ")},...Object.keys(e).map(t=>{const i=o?` ${C(o)}`:"";return{content:a(e[t]),header:t===$||o?d.green(` Available${i} Commands `):` ${d.green(` ${C(t)} `)}`}}),l.has("help")?{header:d.yellow(" Command Options "),optionList:l.get("help").options?.filter(t=>!t.hidden)}:void 0,{header:d.yellow(" Global Options "),optionList:s.getGlobalOptions()},{content:N.filter(t=>!t.hidden).map(t=>[t.name,t.description??""]),header:d.magenta(" Environment Variables ")},{content:`Run "${f(s.getCliName())} ${h("help <command>")}" or "${f(s.getCliName())} ${h("<command>")} ${y("--help")}" for help with a specific command.`,raw:!0}].filter(Boolean)))},P=(r,s)=>{const l=[];for(const o of r.values()){if(o.hidden)continue;const m=o.commandPath??[];if(m.length<s.length)continue;let e=!0;for(const[a,t]of s.entries())if(m[a]!==t){e=!1;break}e&&l.push(o)}return l},O=(r,s,l,o)=>{const m=l.join(" "),e=[{content:`${f(s.getCliName())} ${h(m)} ${h("<subcommand>")} [positional arguments] ${y("[options]")}`,header:d.cyan(" Usage ")},{content:o.map(a=>{const t=[...a.commandPath??[],a.name].join(" ");return[h(t),a.description??""]}),header:d.green(" Subcommands ")},{header:d.yellow(" Global Options "),optionList:s.getGlobalOptions()},{content:`Run "${f(s.getCliName())} ${h(`${m} <subcommand>`)} ${y("--help")}" for help with a specific subcommand.`,raw:!0}];(r.raw??r.log)(b(e))},A=(r,s,l,o,m)=>{let e=m??l.get(o);if(!e)for(const n of l.values()){const c=n.commandPath?[...n.commandPath,n.name]:[n.name];if(c.at(-1)===o||c.join(" ")===o){e=n;break}}if(!e){const n=o.split(" ").filter(Boolean),c=n.length>0?P(l,n):[];if(c.length>0){O(r,s,n,c);return}r.error(`Command "${o}" not found`);return}const a=[],i=(e.commandPath?[...e.commandPath,e.name]:[e.name]).join(" ");a.push({content:`${f(s.getCliName())} ${h(i)}${E(e)}${e.options?" [options]":""}`,header:d.cyan(" Usage ")}),e.description&&a.push({content:e.description,header:d.green(" Description ")});const p=(e.argument?[e.argument]:e.arguments??[]).filter(n=>!n.hidden);if(p.length>0&&a.push({header:"Command Positional Arguments",isArgument:!0,optionList:p}),Array.isArray(e.options)&&e.options.length>0&&a.push({header:d.yellow(" Command Options "),optionList:e.options.filter(n=>!n.hidden)}),a.push({header:d.yellow(" Global Options "),optionList:s.getGlobalOptions()}),Array.isArray(e.env)&&e.env.length>0){const n=e.env.filter(c=>!c.hidden);n.length>0&&a.push({content:n.map(c=>[c.name,c.description??""]),header:d.magenta(" Environment Variables ")})}if(e.alias!==void 0&&e.alias.length>0){let n=e.alias;typeof e.alias=="string"&&(n=[e.alias]),a.splice(1,0,{content:n,header:"Alias(es)"})}Array.isArray(e.examples)&&e.examples.length>0&&a.push({content:e.examples,header:"Examples"});const u=[...e.commandPath??[],e.name],g=P(l,u);g.length>0&&a.push({content:g.map(n=>{const c=[...n.commandPath??[],n.name].join(" ");return[h(c),n.description??""]}),header:d.green(" Subcommands ")}),(r.raw??r.log)(b(a))};class S{argument={description:"Command to show help for (subcommand path supported, e.g. `cli help docker build`)",name:"command",type:String};name="help";options=[{description:"Display only the specified group",name:"group",type:String}];commands;constructor(s){this.commands=s}execute(s){const{argument:l,command:o,commandName:m,logger:e,options:a,runtime:t}=s,{footer:i,header:p}=t.getCommandSection();p&&(e.raw??e.log)(v(p));const u=m==="help"&&Array.isArray(l)&&l.length>0?l.join(" "):void 0;if(m==="help"&&u===void 0)w(e,t,this.commands,typeof a?.group=="string"?a.group:void 0);else{const g=u!==void 0||o===void 0||o.name==="help"?void 0:o;A(e,t,this.commands,u??m,g)}i&&(e.raw??e.log)(v(i))}}export{S as default};
+import{inverse as d,cyan as f,green as h,yellow as y}from"@visulima/colorize";import{t as v,c as b,f as E}from"../packem_shared/format-positional-usage-Cm4bukjQ.js";const N=[{defaultValue:"32",description:"Controls the verbosity level of output. Valid values: '16' (quiet), '32' (normal), '64' (verbose), '128' (debug)",name:"CEREBRO_OUTPUT_LEVEL",type:String},{description:"Sets the minimum required Node.js version. Overrides the default minimum version check",name:"CEREBRO_MIN_NODE_VERSION",type:Number},{defaultValue:!1,description:"When set, disables the update notifier check",name:"NO_UPDATE_NOTIFIER",type:Boolean},{description:"Standard Node.js environment variable. When set to 'test', disables update notifier",name:"NODE_ENV",type:String},{defaultValue:!1,description:"When set, enables debug output (same as --debug flag)",name:"DEBUG",type:Boolean},{description:"Sets the terminal width for table rendering. Useful for testing and consistent output",name:"CEREBRO_TERMINAL_WIDTH",type:Number}],$="__Other",C=r=>r.charAt(0).toUpperCase()+r.slice(1),w=(r,s,l,o)=>{r.debug("no command given, printing general help...");let m=[...new Set(l.values())].filter(t=>!t.hidden);o&&(m=m.filter(t=>t.group===o));const e=m.reduce((t,i)=>{const p=i.group??$;return t[p]??=[],t[p].push(i),t},{}),a=t=>t.map(i=>{let p="";typeof i.alias=="string"?p=i.alias:Array.isArray(i.alias)&&(p=i.alias.join(", ")),p!==""&&(p=` [${p}]`);let u=i.name;return i.commandPath&&i.commandPath.length>0&&(u=`${i.commandPath.join(" ")} ${i.name}`),[`${h(u)}${p}`,i.description??""]});(r.raw??r.log)(b([{content:`${f(s.getCliName())} ${h("<command>")} [positional arguments] ${y("[options]")}`,header:d.cyan(" Usage ")},...Object.keys(e).map(t=>{const i=o?` ${C(o)}`:"";return{content:a(e[t]),header:t===$||o?d.green(` Available${i} Commands `):` ${d.green(` ${C(t)} `)}`}}),l.has("help")?{header:d.yellow(" Command Options "),optionList:l.get("help").options?.filter(t=>!t.hidden)}:void 0,{header:d.yellow(" Global Options "),optionList:s.getGlobalOptions()},{content:N.filter(t=>!t.hidden).map(t=>[t.name,t.description??""]),header:d.magenta(" Environment Variables ")},{content:`Run "${f(s.getCliName())} ${h("help <command>")}" or "${f(s.getCliName())} ${h("<command>")} ${y("--help")}" for help with a specific command.`,raw:!0}].filter(Boolean)))},P=(r,s)=>{const l=[];for(const o of r.values()){if(o.hidden)continue;const m=o.commandPath??[];if(m.length<s.length)continue;let e=!0;for(const[a,t]of s.entries())if(m[a]!==t){e=!1;break}e&&l.push(o)}return l},O=(r,s,l,o)=>{const m=l.join(" "),e=[{content:`${f(s.getCliName())} ${h(m)} ${h("<subcommand>")} [positional arguments] ${y("[options]")}`,header:d.cyan(" Usage ")},{content:o.map(a=>{const t=[...a.commandPath??[],a.name].join(" ");return[h(t),a.description??""]}),header:d.green(" Subcommands ")},{header:d.yellow(" Global Options "),optionList:s.getGlobalOptions()},{content:`Run "${f(s.getCliName())} ${h(`${m} <subcommand>`)} ${y("--help")}" for help with a specific subcommand.`,raw:!0}];(r.raw??r.log)(b(e))},A=(r,s,l,o,m)=>{let e=m??l.get(o);if(!e)for(const n of l.values()){const c=n.commandPath?[...n.commandPath,n.name]:[n.name];if(c.at(-1)===o||c.join(" ")===o){e=n;break}}if(!e){const n=o.split(" ").filter(Boolean),c=n.length>0?P(l,n):[];if(c.length>0){O(r,s,n,c);return}r.error(`Command "${o}" not found`);return}const a=[],i=(e.commandPath?[...e.commandPath,e.name]:[e.name]).join(" ");a.push({content:`${f(s.getCliName())} ${h(i)}${E(e)}${e.options?" [options]":""}`,header:d.cyan(" Usage ")}),e.description&&a.push({content:e.description,header:d.green(" Description ")});const p=(e.argument?[e.argument]:e.arguments??[]).filter(n=>!n.hidden);if(p.length>0&&a.push({header:"Command Positional Arguments",isArgument:!0,optionList:p}),Array.isArray(e.options)&&e.options.length>0&&a.push({header:d.yellow(" Command Options "),optionList:e.options.filter(n=>!n.hidden)}),a.push({header:d.yellow(" Global Options "),optionList:s.getGlobalOptions()}),Array.isArray(e.env)&&e.env.length>0){const n=e.env.filter(c=>!c.hidden);n.length>0&&a.push({content:n.map(c=>[c.name,c.description??""]),header:d.magenta(" Environment Variables ")})}if(e.alias!==void 0&&e.alias.length>0){let n=e.alias;typeof e.alias=="string"&&(n=[e.alias]),a.splice(1,0,{content:n,header:"Alias(es)"})}Array.isArray(e.examples)&&e.examples.length>0&&a.push({content:e.examples,header:"Examples"});const u=[...e.commandPath??[],e.name],g=P(l,u);g.length>0&&a.push({content:g.map(n=>{const c=[...n.commandPath??[],n.name].join(" ");return[h(c),n.description??""]}),header:d.green(" Subcommands ")}),(r.raw??r.log)(b(a))};class S{argument={description:"Command to show help for (subcommand path supported, e.g. `cli help docker build`)",name:"command",type:String};name="help";options=[{description:"Display only the specified group",name:"group",type:String}];commands;constructor(s){this.commands=s}execute(s){const{argument:l,command:o,commandName:m,logger:e,options:a,runtime:t}=s,{footer:i,header:p}=t.getCommandSection();p&&(e.raw??e.log)(v(p));const u=m==="help"&&Array.isArray(l)&&l.length>0?l.join(" "):void 0;if(m==="help"&&u===void 0)w(e,t,this.commands,typeof a?.group=="string"?a.group:void 0);else{const g=u!==void 0||o===void 0||o.name==="help"?void 0:o;A(e,t,this.commands,u??m,g)}i&&(e.raw??e.log)(v(i))}}export{S as default};

package/dist/commands/readme-command.d.ts

@@ -1,4 +1,4 @@
-import { C as Command } from "../packem_shared/command.d-Dz7hkMI0.js";
+import { C as Command } from "../packem_shared/command.d-DNTe-FYX.js";
 import '@visulima/tabular';
 /**
  * Generates README documentation for cerebro CLI commands.

package/dist/commands/readme-command.js

@@ -1,4 +1,4 @@
-import{createRequire as L}from"node:module";import{f as R,c as F}from"../packem_shared/format-positional-usage-O92DKKjW.js";import{g as q,a as G,b as U}from"../packem_shared/runtime-process-BN-eTlwy.js";let k;const O=e=>(k??=L(import.meta.url))(e),$=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,T=e=>{if(typeof $<"u"&&$.versions&&$.versions.node){const[n,t]=$.versions.node.split(".").map(Number);if(n>22||n===22&&t>=3||n===20&&t>=16)return $.getBuiltinModule(e)}return O(e)},{resolve:v,join:V,dirname:B}=T("node:path"),C=async(e,n)=>{try{return await e.access(n),!0}catch{return!1}},z=async()=>{const{default:e}=await import("github-slugger"),n=new e;return t=>n.slug(t)},I=e=>e.filter(Boolean),W=(e,n)=>{const t=new Set,o=[];for(const s of e){const r=n(s);t.has(r)||(t.add(r),o.push(s))}return o},D=(e,n)=>{const o=(e.commandPath?[...e.commandPath,e.name]:[e.name]).join(" ");return`${n} ${o}${R(e,"readme")}`},H=(e,n)=>{if(!Array.isArray(e.env)||e.env.length===0)return;const t=e.env.filter(o=>!o.hidden);t.length>0&&n.push({content:t.map(o=>[o.name,o.description??""]),header:" Environment Variables "})},N=(e,n)=>{const t=[],s=(e.commandPath?[...e.commandPath,e.name]:[e.name]).join(" "),r=!!e.options;t.push({content:`${n} ${s}${R(e)}${r?" [options]":""}`,header:" Usage "}),e.description&&t.push({content:e.description,header:" Description "});const c=(e.argument?[e.argument]:e.arguments??[]).filter(a=>!a.hidden);if(c.length>0&&t.push({header:"Command Positional Arguments",isArgument:!0,optionList:c}),Array.isArray(e.options)&&e.options.length>0&&t.push({header:" Command Options ",optionList:e.options.filter(a=>!a.hidden)}),H(e,t),e.alias!==void 0&&e.alias.length>0){const a=Array.isArray(e.alias)?e.alias:[e.alias];t.splice(1,0,{content:a,header:"Alias(es)"})}return Array.isArray(e.examples)&&e.examples.length>0&&t.push({content:e.examples,header:"Examples"}),F(t)},J=(e,n)=>{const t=e.description?.trim().split(`
+import{createRequire as L}from"node:module";import{f as R,c as F}from"../packem_shared/format-positional-usage-Cm4bukjQ.js";import{g as q,a as G,b as U}from"../packem_shared/runtime-process-BLYbrTb0.js";let k;const O=e=>(k??=L(import.meta.url))(e),$=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,T=e=>{if(typeof $<"u"&&$.versions&&$.versions.node){const[n,t]=$.versions.node.split(".").map(Number);if(n>22||n===22&&t>=3||n===20&&t>=16)return $.getBuiltinModule(e)}return O(e)},{resolve:v,join:V,dirname:B}=T("node:path"),C=async(e,n)=>{try{return await e.access(n),!0}catch{return!1}},z=async()=>{const{default:e}=await import("github-slugger"),n=new e;return t=>n.slug(t)},I=e=>e.filter(Boolean),W=(e,n)=>{const t=new Set,o=[];for(const s of e){const r=n(s);t.has(r)||(t.add(r),o.push(s))}return o},D=(e,n)=>{const o=(e.commandPath?[...e.commandPath,e.name]:[e.name]).join(" ");return`${n} ${o}${R(e,"readme")}`},H=(e,n)=>{if(!Array.isArray(e.env)||e.env.length===0)return;const t=e.env.filter(o=>!o.hidden);t.length>0&&n.push({content:t.map(o=>[o.name,o.description??""]),header:" Environment Variables "})},N=(e,n)=>{const t=[],s=(e.commandPath?[...e.commandPath,e.name]:[e.name]).join(" "),r=!!e.options;t.push({content:`${n} ${s}${R(e)}${r?" [options]":""}`,header:" Usage "}),e.description&&t.push({content:e.description,header:" Description "});const c=(e.argument?[e.argument]:e.arguments??[]).filter(a=>!a.hidden);if(c.length>0&&t.push({header:"Command Positional Arguments",isArgument:!0,optionList:c}),Array.isArray(e.options)&&e.options.length>0&&t.push({header:" Command Options ",optionList:e.options.filter(a=>!a.hidden)}),H(e,t),e.alias!==void 0&&e.alias.length>0){const a=Array.isArray(e.alias)?e.alias:[e.alias];t.splice(1,0,{content:a,header:"Alias(es)"})}return Array.isArray(e.examples)&&e.examples.length>0&&t.push({content:e.examples,header:"Examples"}),F(t)},J=(e,n)=>{const t=e.description?.trim().split(`
 `)[0]??"",o=D(e,n),s=N(e,n);return I([`## \`${o}\``,t,`\`\`\`
 ${s.trim()}
 \`\`\``]).join(`

package/dist/commands/version-command.d.ts

@@ -1,4 +1,4 @@
-import { C as Command } from "../packem_shared/command.d-Dz7hkMI0.js";
+import { C as Command } from "../packem_shared/command.d-DNTe-FYX.js";
 import '@visulima/tabular';
 declare const _default: Command;
 export { _default as default };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as CerebroFs, b as CommandSection, O as OptionDefinition, T as Toolbox, c as CommandInput, P as Plugin, d as PluginManager, C as Command, e as CliRunOptions, R as RunCommandOptions, f as CommandExecute, g as Cli$1, h as OptionDefinitionRecord, E as EnvDefinitionRecord, A as ArgumentDefinition, L as LazyCommandModule } from "./packem_shared/command.d-Dz7hkMI0.js";
-export type { i as AnyCommandInput, j as CerebroProcess, k as EnvDefinition, l as OutputType, m as PluginContext, V as VERBOSITY_LEVEL } from "./packem_shared/command.d-Dz7hkMI0.js";
+import { a as CerebroFs, b as CommandSection, O as OptionDefinition, T as Toolbox, c as CommandInput, P as Plugin, d as PluginManager, C as Command, e as CliRunOptions, R as RunCommandOptions, f as CommandExecute, g as Cli$1, h as OptionDefinitionRecord, E as EnvDefinitionRecord, A as ArgumentDefinition, L as LazyCommandModule } from "./packem_shared/command.d-DNTe-FYX.js";
+export type { i as AnyCommandInput, j as CerebroProcess, k as EnvDefinition, l as OutputType, m as PluginContext, V as VERBOSITY_LEVEL } from "./packem_shared/command.d-DNTe-FYX.js";
 import { V as VisulimaError } from "./packem_shared/index.d-CnnVYgSZ.js";
 import '@visulima/tabular';
 type CliOptions<T extends Console = Console> = {

package/dist/index.js

@@ -1 +1 @@
-import{Cli as o}from"./packem_shared/Cerebro-CENsjWZ1.js";import{VERBOSITY_DEBUG as E,VERBOSITY_NORMAL as s,VERBOSITY_QUIET as p,VERBOSITY_VERBOSE as u}from"./packem_shared/VERBOSITY_DEBUG-D7HfSD5l.js";import{default as l}from"./packem_shared/defineCommand-C_isHeEs.js";import{default as d}from"./packem_shared/InvalidArgumentChoiceError-BpovuqrZ.js";import{default as B}from"./packem_shared/MissingArgumentError-D78kza2a.js";import{default as O}from"./packem_shared/SurplusArgumentError-BLwT9lo0.js";import{lazyNamed as S}from"./packem_shared/lazyNamed-BKSCmVsV.js";import{c as C}from"./packem_shared/VisulimaError-BDqtOVL5-Db_MJ_p7.js";const a=(r,e)=>new o(r,e);export{o as Cerebro,d as InvalidArgumentChoiceError,B as MissingArgumentError,O as SurplusArgumentError,E as VERBOSITY_DEBUG,s as VERBOSITY_NORMAL,p as VERBOSITY_QUIET,u as VERBOSITY_VERBOSE,C as VisulimaError,a as createCerebro,l as defineCommand,S as lazyNamed};
+import{Cli as o}from"./packem_shared/Cerebro-ggJmXJrF.js";import{VERBOSITY_DEBUG as E,VERBOSITY_NORMAL as s,VERBOSITY_QUIET as p,VERBOSITY_VERBOSE as u}from"./packem_shared/VERBOSITY_DEBUG-D7HfSD5l.js";import{default as l}from"./packem_shared/defineCommand-C_isHeEs.js";import{default as d}from"./packem_shared/InvalidArgumentChoiceError-BpovuqrZ.js";import{default as B}from"./packem_shared/MissingArgumentError-D78kza2a.js";import{default as O}from"./packem_shared/SurplusArgumentError-BLwT9lo0.js";import{lazyNamed as S}from"./packem_shared/lazyNamed-BKSCmVsV.js";import{c as C}from"./packem_shared/VisulimaError-BDqtOVL5-Db_MJ_p7.js";const a=(r,e)=>new o(r,e);export{o as Cerebro,d as InvalidArgumentChoiceError,B as MissingArgumentError,O as SurplusArgumentError,E as VERBOSITY_DEBUG,s as VERBOSITY_NORMAL,p as VERBOSITY_QUIET,u as VERBOSITY_VERBOSE,C as VisulimaError,a as createCerebro,l as defineCommand,S as lazyNamed};