@visulima/cerebro 1.1.58 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/CHANGELOG.md +72 -1
  2. package/LICENSE.md +1360 -7
  3. package/README.md +74 -5
  4. package/dist/commands/completion-command.d.ts +6 -0
  5. package/dist/commands/completion-command.js +5 -0
  6. package/dist/commands/help-command.d.ts +12 -0
  7. package/dist/commands/help-command.js +1 -0
  8. package/dist/commands/readme-command.d.ts +6 -0
  9. package/dist/commands/readme-command.js +45 -0
  10. package/dist/commands/version-command.d.ts +6 -0
  11. package/dist/commands/version-command.js +1 -0
  12. package/dist/index.d.ts +39 -141
  13. package/dist/index.js +1 -0
  14. package/dist/logger/create-pail-logger.d.ts +5 -0
  15. package/dist/logger/create-pail-logger.js +1 -0
  16. package/dist/packem_chunks/has-new-version.js +1 -0
  17. package/dist/packem_shared/Cerebro-UuSm4ZWa.js +4 -0
  18. package/dist/packem_shared/VERBOSITY_QUIET-XPultrIA.js +1 -0
  19. package/dist/packem_shared/VisulimaError--04oA1Oy.js +76 -0
  20. package/dist/packem_shared/cerebro-error-BnJTixb2.js +1 -0
  21. package/dist/packem_shared/help-command-C_CdZQSd.js +1 -0
  22. package/dist/packem_shared/index-DQ3pvLQH.js +6 -0
  23. package/dist/packem_shared/index.d-BkzZomTF.d.ts +65 -0
  24. package/dist/packem_shared/isVisulimaError-jVZgumOU-C4fgdbWg.js +1 -0
  25. package/dist/packem_shared/plugin-manager-BjEuiNxv.d.ts +147 -0
  26. package/dist/packem_shared/renderError-ZMlMvw1N-eVUSdl6c.js +24 -0
  27. package/dist/packem_shared/runtime-process-G-n-wOub.js +1 -0
  28. package/dist/plugins/error-handler-plugin.d.ts +15 -0
  29. package/dist/plugins/error-handler-plugin.js +1 -0
  30. package/dist/plugins/runtime-version-check-plugin.d.ts +18 -0
  31. package/dist/plugins/runtime-version-check-plugin.js +1 -0
  32. package/dist/plugins/update-notifier/update-notifier-plugin.d.ts +21 -0
  33. package/dist/plugins/update-notifier/update-notifier-plugin.js +1 -0
  34. package/package.json +63 -27
  35. package/dist/index.cjs +0 -1
  36. package/dist/index.d.cts +0 -158
  37. package/dist/index.d.mts +0 -158
  38. package/dist/index.mjs +0 -1
  39. package/dist/packem_chunks/has-new-version.cjs +0 -1
  40. package/dist/packem_chunks/has-new-version.mjs +0 -1
  41. package/dist/packem_shared/default-BkkIk32s.mjs +0 -10
  42. package/dist/packem_shared/default-DpvcDeMt.cjs +0 -10
package/CHANGELOG.md CHANGED
@@ -1,3 +1,74 @@
1
+ ## @visulima/cerebro [2.0.0](https://github.com/visulima/visulima/compare/@visulima/cerebro@1.1.58...@visulima/cerebro@2.0.0) (2025-11-05)
2
+
3
+ ### ⚠ BREAKING CHANGES
4
+
5
+ * **cerebro:** This release introduces significant breaking changes:
6
+
7
+ - **ESM-only**: CommonJS exports removed, now requires ESM (Node.js 20.19+, Deno 1.0+, Bun 1.0+)
8
+ - **Granular exports**: Plugins and commands must be imported from specific paths (e.g., `@visulima/cerebro/plugins/error-handler`)
9
+ - **Enhanced error types**: New error classes with improved validation and error codes
10
+ - **Runtime requirements**: Minimum Node.js version is now 20.19
11
+
12
+ ## Features
13
+
14
+ - **Cross-runtime support**: Full support for Node.js, Deno, and Bun with runtime-agnostic utilities
15
+ - **Nested commands**: Hierarchical command structure with parent-child relationships
16
+ - **Plugin system**: Extensible plugin architecture with built-in plugins:
17
+ - Error handler plugin for custom error formatting
18
+ - Runtime version check plugin
19
+ - Update notifier plugin for package version checks
20
+ - **Shell completion**: New completion command for bash/zsh/fish autocompletion
21
+ - **README generation**: Command to automatically generate CLI documentation
22
+ - **Environment variables**: Support for environment variable definitions in command options
23
+ - **Enhanced logging**: Integration with Pail logger for structured logging
24
+ - **Performance benchmarks**: Comprehensive benchmark suite for performance monitoring
25
+ - **Enhanced error handling**: Improved error types, validation, and error codes
26
+ - **Security enhancements**: Input validation and security utilities
27
+
28
+ ## Improvements
29
+
30
+ - **Type safety**: Replaced 'any' types with 'unknown' for better type safety
31
+ - **Code organization**: Restructured types from `@types` to `types` directory
32
+ - **Documentation**: Extensive API documentation, migration guide, and enhanced guides
33
+ - **Examples**: Reorganized and expanded examples covering all major features
34
+ - **Testing**: Comprehensive unit tests, integration tests, and improved test coverage
35
+ - **Performance**: Optimized command processing and enhanced performance
36
+
37
+ ## Documentation
38
+
39
+ - Added migration guide (MIGRATION-GUIDE.md) with detailed breaking change information
40
+ - Enhanced API documentation with complete type definitions
41
+ - Added guides for advanced usage, commands, options, and plugins
42
+ - Expanded examples with README files and comprehensive use cases
43
+
44
+ See MIGRATION-GUIDE.md for detailed migration instructions.
45
+
46
+ ### Features
47
+
48
+ * **cerebro:** major upgrade with cross-runtime support, plugin system, and nested commands ([6e2c930](https://github.com/visulima/visulima/commit/6e2c930322ae263ecf8c1b44e63e53094b26631b))
49
+
50
+ ### Bug Fixes
51
+
52
+ * update dependencies across multiple packages ([36a47f2](https://github.com/visulima/visulima/commit/36a47f26d65d25a7b4d8371186710e7d0ab61a2b))
53
+ * update dependencies and add terminal width support ([c50fc05](https://github.com/visulima/visulima/commit/c50fc05f0b6c2ec925ca3483e05a6db08a6d6be7))
54
+
55
+ ### Tests
56
+
57
+ * add CEREBRO_TERMINAL_WIDTH environment variable for terminal output ([88ce74e](https://github.com/visulima/visulima/commit/88ce74eb7f16646de9e515676d5aed904a9b0132))
58
+
59
+
60
+ ### Dependencies
61
+
62
+ * **@visulima/colorize:** upgraded to 1.4.26
63
+ * **@visulima/tabular:** upgraded to 3.0.0
64
+ * **@visulima/error:** upgraded to 5.0.3
65
+ * **@visulima/find-cache-dir:** upgraded to 2.0.3
66
+ * **@visulima/boxen:** upgraded to 2.0.7
67
+ * **@visulima/command-line-args:** upgraded to 1.0.1
68
+ * **@visulima/pail:** upgraded to 3.0.3
69
+ * **@visulima/path:** upgraded to 2.0.2
70
+ * **@visulima/string:** upgraded to 2.0.3
71
+
1
72
  ## @visulima/cerebro [1.1.58](https://github.com/visulima/visulima/compare/@visulima/cerebro@1.1.57...@visulima/cerebro@1.1.58) (2025-10-22)
2
73
 
3
74
  ### Bug Fixes
@@ -74,7 +145,7 @@
74
145
  ### Bug Fixes
75
146
 
76
147
  * update @visulima/packem to 2.0.0-alpha.29 and refine packem.config.ts settings ([63f14a1](https://github.com/visulima/visulima/commit/63f14a1c11bd7c004e76874ed0b3938ad4740da6))
77
- * update @visulima/packem to 2.0.0-alpha.30 across multiple packages for improved compatibility ([27b346e](https://github.com/visulima/visulima/commit/27b346eaa1c0fb0e420d9a9824482028307f4249))
148
+ * update @visulima/packem to 2.0.0-alpha.32 across multiple packages for improved compatibility ([27b346e](https://github.com/visulima/visulima/commit/27b346eaa1c0fb0e420d9a9824482028307f4249))
78
149
 
79
150
  ### Miscellaneous Chores
80
151