@visulima/cerebro 1.1.58 → 2.0.1

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 +79 -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,81 @@
1
+ ## @visulima/cerebro [2.0.1](https://github.com/visulima/visulima/compare/@visulima/cerebro@2.0.0...@visulima/cerebro@2.0.1) (2025-11-05)
2
+
3
+
4
+ ### Dependencies
5
+
6
+ * **@visulima/tabular:** upgraded to 3.1.0
7
+
8
+ ## @visulima/cerebro [2.0.0](https://github.com/visulima/visulima/compare/@visulima/cerebro@1.1.58...@visulima/cerebro@2.0.0) (2025-11-05)
9
+
10
+ ### ⚠ BREAKING CHANGES
11
+
12
+ * **cerebro:** This release introduces significant breaking changes:
13
+
14
+ - **ESM-only**: CommonJS exports removed, now requires ESM (Node.js 20.19+, Deno 1.0+, Bun 1.0+)
15
+ - **Granular exports**: Plugins and commands must be imported from specific paths (e.g., `@visulima/cerebro/plugins/error-handler`)
16
+ - **Enhanced error types**: New error classes with improved validation and error codes
17
+ - **Runtime requirements**: Minimum Node.js version is now 20.19
18
+
19
+ ## Features
20
+
21
+ - **Cross-runtime support**: Full support for Node.js, Deno, and Bun with runtime-agnostic utilities
22
+ - **Nested commands**: Hierarchical command structure with parent-child relationships
23
+ - **Plugin system**: Extensible plugin architecture with built-in plugins:
24
+ - Error handler plugin for custom error formatting
25
+ - Runtime version check plugin
26
+ - Update notifier plugin for package version checks
27
+ - **Shell completion**: New completion command for bash/zsh/fish autocompletion
28
+ - **README generation**: Command to automatically generate CLI documentation
29
+ - **Environment variables**: Support for environment variable definitions in command options
30
+ - **Enhanced logging**: Integration with Pail logger for structured logging
31
+ - **Performance benchmarks**: Comprehensive benchmark suite for performance monitoring
32
+ - **Enhanced error handling**: Improved error types, validation, and error codes
33
+ - **Security enhancements**: Input validation and security utilities
34
+
35
+ ## Improvements
36
+
37
+ - **Type safety**: Replaced 'any' types with 'unknown' for better type safety
38
+ - **Code organization**: Restructured types from `@types` to `types` directory
39
+ - **Documentation**: Extensive API documentation, migration guide, and enhanced guides
40
+ - **Examples**: Reorganized and expanded examples covering all major features
41
+ - **Testing**: Comprehensive unit tests, integration tests, and improved test coverage
42
+ - **Performance**: Optimized command processing and enhanced performance
43
+
44
+ ## Documentation
45
+
46
+ - Added migration guide (MIGRATION-GUIDE.md) with detailed breaking change information
47
+ - Enhanced API documentation with complete type definitions
48
+ - Added guides for advanced usage, commands, options, and plugins
49
+ - Expanded examples with README files and comprehensive use cases
50
+
51
+ See MIGRATION-GUIDE.md for detailed migration instructions.
52
+
53
+ ### Features
54
+
55
+ * **cerebro:** major upgrade with cross-runtime support, plugin system, and nested commands ([6e2c930](https://github.com/visulima/visulima/commit/6e2c930322ae263ecf8c1b44e63e53094b26631b))
56
+
57
+ ### Bug Fixes
58
+
59
+ * update dependencies across multiple packages ([36a47f2](https://github.com/visulima/visulima/commit/36a47f26d65d25a7b4d8371186710e7d0ab61a2b))
60
+ * update dependencies and add terminal width support ([c50fc05](https://github.com/visulima/visulima/commit/c50fc05f0b6c2ec925ca3483e05a6db08a6d6be7))
61
+
62
+ ### Tests
63
+
64
+ * add CEREBRO_TERMINAL_WIDTH environment variable for terminal output ([88ce74e](https://github.com/visulima/visulima/commit/88ce74eb7f16646de9e515676d5aed904a9b0132))
65
+
66
+
67
+ ### Dependencies
68
+
69
+ * **@visulima/colorize:** upgraded to 1.4.26
70
+ * **@visulima/tabular:** upgraded to 3.0.0
71
+ * **@visulima/error:** upgraded to 5.0.3
72
+ * **@visulima/find-cache-dir:** upgraded to 2.0.3
73
+ * **@visulima/boxen:** upgraded to 2.0.7
74
+ * **@visulima/command-line-args:** upgraded to 1.0.1
75
+ * **@visulima/pail:** upgraded to 3.0.3
76
+ * **@visulima/path:** upgraded to 2.0.2
77
+ * **@visulima/string:** upgraded to 2.0.3
78
+
1
79
  ## @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
80
 
3
81
  ### Bug Fixes
@@ -74,7 +152,7 @@
74
152
  ### Bug Fixes
75
153
 
76
154
  * 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))
155
+ * update @visulima/packem to 2.0.0-alpha.32 across multiple packages for improved compatibility ([27b346e](https://github.com/visulima/visulima/commit/27b346eaa1c0fb0e420d9a9824482028307f4249))
78
156
 
79
157
  ### Miscellaneous Chores
80
158