bernova 1.3.2 → 1.4.0

package/CHANGELOG.md

@@ -1,165 +1,135 @@
 # Changelog
 
-All notable changes to Bernova will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## 1.4.0
 
-## [1.3.2] - 2926-01-28
+### Minor Changes
 
-### Patch
+- Add documentation about changeset and automations workflows
+- Add documentation about changeset and automations workflows
 
-- **Fixed js modules compability**: Fixed the compability when the js modules are transpiled with ts-node
-- **Deleted multiple ora instances**: Delete the multiple ora instances to prevent failures
+All notable changes to Bernova will be documented in this file.
 
-## [1.3.1] - 2026-01-21
+The format uses [Changesets](https://github.com/changesets/changesets) for automated version management and changelog generation.
 
-### Patch
+## 1.3.2
 
-- **prevent minify provider**: Prevent minify providerTemplate.js file
+### Patch Changes
 
-## [1.3.0] - 2026-01-21
+- Fixed js modules compability when transpiled with ts-node
+- Deleted multiple ora instances to prevent failures
 
-### New Features
+## 1.3.1
 
-- **Added --embed-css flag**: Added the function for embedded styles.
+### Patch Changes
 
-## [1.2.2] - 2026-01-16
+- Prevent minify providerTemplate.js file
 
-### Fixed
+## 1.3.0
 
-- **Fixed the css generated into js modules folder**: Prevent the copy of the css into js modules folders
-- **Fixed the css minified name**: Fixed the minified css name
+### Minor Changes
 
-## [1.2.1] - 2026-01-15
+- Added --embed-css flag for embedded styles functionality
 
-### Fixed
+## 1.2.2
 
-- **Fixed the dependencies**: Fixed the package.json dependencies types
-- **Fixed the css custom output dir**: Fixed the custom css output dir
+### Patch Changes
 
-## [1.2.0] - 2026-01-14
+- Fixed the css generated into js modules folder
+- Fixed the css minified name
 
-### New Features
+## 1.2.1
 
-- **Added new bv-build cli flags**: Added flags to overwrite baseOutDir, rootDir, preventMoveJS, preventMoveDTS and set preventProcessJS
+### Patch Changes
 
-### Fixed
+- Fixed the package.json dependencies types
+- Fixed the css custom output dir
 
-- **Prevent minify declaration files**: Prevent minify with terser the typescript declaration files
+## 1.2.0
 
-### Documentation
+### Minor Changes
 
-- **Added the new flags documentation**: Added the documentation about the new flags cases
+- Added new bv-build cli flags: baseOutDir, rootDir, preventMoveJS, preventMoveDTS and preventProcessJS
 
-## [1.1.0] - 2026-01-13
+### Patch Changes
 
-### New Features
+- Prevent minify declaration files with terser
 
-- **Added cli bv-build flags**: Added flags to overwrite css, tools and provider customOutDirs
+## 1.1.0
 
-### Documentation
+### Minor Changes
 
-- **Added documentation for cli flags**: Added documentation about the flags uses cases
+- Added cli bv-build flags to overwrite css, tools and provider customOutDirs
 
-### Fixed
+### Patch Changes
 
-- **Prevent transpile declaration files**: Added logic to prevent process typescript declaration files
+- Prevent transpile declaration files
 
-## [1.0.1] - 2026-01-12
+## 1.0.1
 
-### Fixed
+### Patch Changes
 
-- **Semantic problem solved**: change target for targets
+- Semantic problem solved: change target for targets
+- Added the bernova build script example
+- Added the instalation examples with npm and yarn
 
-### Documentatation
+## 1.0.0
 
-- **Added the bernova build script example**: Added the bv-build example.
-- **Added the instalation examples with anothers packages manager**: Added examples for `'npm'` and `'yarn`
+### Major Changes
 
-## [1.0.0] - 2026-01-08
+- **Initial stable release** - Production ready CSS-in-JS framework
 
-### New Features
+### Minor Changes
 
-- **Improve library styles and tools build/dist**: Complete the buildStyle.js cli function.
-- **Improve provider router hanler**: Improve the Bernova provider for handler relative doc routes.
+- Improve library styles and tools build/dist
+- Improve provider router handler for relative doc routes
 
-### Fixed
+### Patch Changes
 
-- **Fixed the doc routes**: Change the absolute routes for relative routes into provides's stats.
-- **Fixed Error in partial transpilation**: Fixed the function for the flags --foundationsOnly and --componentsOnly.
+- Fixed the doc routes: Change absolute routes for relative routes
+- Fixed Error in partial transpilation for --foundationsOnly and --componentsOnly flags
 
-## [0.3.0] - 2026-01-01
+## 0.3.0
 
-### ✨ New Features
+### Minor Changes
 
 - **Modern Build System**: Migrated to Vite 7 with TypeScript configuration for improved build performance
 - **Dual Package Support**: Added ESM (`.mjs`) and CommonJS (`.cjs`) support for better compatibility across different module systems
-- **Custom Build Plugins**: Implemented 4 specialized Vite plugins:
-  - `copyCSSPlugin`: Minifies and copies CSS files
-  - `copyCLIBinariesPlugin`: Preserves CLI executables with proper shebangs
-  - `copySourcePlugin`: Minifies source files with aggressive optimization
-  - `removeTestFilesPlugin`: Ensures test files are excluded from distribution
-
-### 🚀 Performance Improvements
-
+- **Custom Build Plugins**: Implemented 4 specialized Vite plugins (copyCSSPlugin, copyCLIBinariesPlugin, copySourcePlugin, removeTestFilesPlugin)
 - **Ultra-optimized Bundle**: Reduced package size from 56.4 KB to 41.4 KB (27% reduction)
 - **Aggressive Minification**: Implemented Terser with 3-pass optimization removing all comments
 - **Tree-shaking**: Enhanced dead code elimination for smaller bundles
-- **Zero JSDoc in Distribution**: Removed all TSDoc comments as they're unnecessary for CLI tools
-
-### 📚 Documentation
-
-- **Professional README**: Added comprehensive badges (npm version, downloads, license, coverage, PRs welcome)
-- **Package Distribution**: Created `.npmignore` to exclude unnecessary files from npm package
-- **Modern Package Exports**: Updated `package.json` with conditional exports for better module resolution
-
-### 🔧 Infrastructure
-
-- **TypeScript Build Configuration**: Separated development and production TypeScript configs (`tsconfig.build.json`)
-- **Node.js Compatibility**: Maintained Node.js >=20.0.0 target with ES2020 output
-- **Build Validation**: Enhanced CI/CD with proper build verification steps
 
-## [0.1.2] - 2025-10-28
+### Patch Changes
 
-### 🔧 Changed
+- Professional README with comprehensive badges
+- Created `.npmignore` to exclude unnecessary files from npm package
+- Updated `package.json` with conditional exports for better module resolution
+- Separated development and production TypeScript configs (`tsconfig.build.json`)
+- Enhanced CI/CD with proper build verification steps
 
-- **License update**: Changed project license from ISC to Apache-2.0 for better open source compliance
-- **Package management**: Improved gitignore configuration to exclude package-lock.json for better npm/yarn compatibility
+## 0.1.2
 
-### 🗑️ Removed
+### Patch Changes
 
+- Changed project license from ISC to Apache-2.0 for better open source compliance
+- Improved gitignore configuration to exclude package-lock.json
 - Removed package-lock.json file from version control to avoid package manager conflicts
 
-## [0.1.1] - 2025-10-22
-
-### 🐛 Fixed
-
-- **Build system**: Resolved NPM versioning and authentication issues
-- **Package metadata**: Improved package.json with complete metadata for open source distribution
-- **Workflow automation**: Fixed auto-publish workflow build validation and authentication verification
-
-### 🔧 Changed
-
-- **Node.js compatibility**: Updated minimum Node.js version requirements
-- **Build optimization**: Enhanced build process for better distribution
-
-## [0.1.0] - 2025-10-21
-
-All notable changes to Bernova will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## 0.1.1
 
-## [0.1.2] - 2025-10-28
+### Patch Changes
 
-## [0.1.1] - 2025-10-21
+- Resolved NPM versioning and authentication issues
+- Improved package.json with complete metadata for open source distribution
+- Fixed auto-publish workflow build validation and authentication verification
+- Updated minimum Node.js version requirements
+- Enhanced build process for better distribution
 
-## [0.1.0] - 2025-10-21
+## 0.1.0
 
-### 🎉 Initial Release
+### Minor Changes
 
-Bernova is a powerful CSS-in-JS framework that allows you to write CSS with JavaScript syntax, providing a comprehensive solution for modern web styling.
+- **Initial Release** - Bernova CSS-in-JS framework
 
 ### ✨ Core Features
 

package/README.md

@@ -52,6 +52,11 @@
 - [Provider](#library-provider)
 - [Foreign CSS documents](#foreign-css-documents)
 - [Compiler Options](#compiler-options)
+- [Contributing](#contributing)
+  - [Branch Naming](#branch-naming-required)
+  - [PR Title Format](#pr-title-format-required)
+  - [Commit Guidelines](#commit-message-guidelines)
+  - [Automated Workflow](#automated-workflow)
 
 ## Installation
 
@@ -651,16 +656,16 @@ const BUTTON = {
   color: 'white',
   $pseudoClasses: {
     active: {
-      background_color: '#ac0202'
+      background_color: '#ac0202',
     },
     hover: {
       background_color: '#e94141',
     },
     focus: {
       border_color: '#0000ff',
-    }
-  }
-}
+    },
+  },
+};
 ```
 
 The result of this when transpiling is:
@@ -1479,8 +1484,15 @@ table {
 }
 @supports (font: system-ui) {
   html {
-    font: system-ui, -apple-system, Segoe UI, Roboto, Ubuntu, Cantarell,
-      Noto Sans, sans-serif;
+    font:
+      system-ui,
+      -apple-system,
+      Segoe UI,
+      Roboto,
+      Ubuntu,
+      Cantarell,
+      Noto Sans,
+      sans-serif;
   }
 }
 ```
@@ -1845,18 +1857,17 @@ When publishing our projects, depending of the packager configuration, it is nec
 - **preventMoveDTS**: When set to `true`, TypeScript declaration files (.d.ts) will not be copied to the output directory. Set this to `true` if you're handling type definitions through another process.
 
 - **types**: An array that specifies the module formats to generate. Accepts `"cjs"` (Commonjs) and/or `"esm"` (ES Modules). For each type specified, Bernova will create a separate folder and transpile the code accordingly.
-
   - `"cjs"`: Generate CommonJS modules for node.js compability.
   - `"esm"`: Generate ES Modules for modern JavaScript environments
 
 - **customOutDirs**: An optional object that allows you to specify custom output directories for different file types, overriding the default structure:
- - `"css"`: Custom output path for CSS files
- - `"provider"`: Custom output path for provider file
- - `"tools"`: Custom output path for tools files (cssVars, cssClasses, etc)
+- `"css"`: Custom output path for CSS files
+- `"provider"`: Custom output path for provider file
+- `"tools"`: Custom output path for tools files (cssVars, cssClasses, etc)
 
 - **embedCss**: When set to `'true'`, instead of generating a static CSS file, the styles generated by Bernova will be embedded.
 
- ### Overwrite or set a single customOutDirs
+### Overwrite or set a single customOutDirs
 
 You may need to run the bv-build script in multiple outputs, and the bernova.config.json file configuration only supports one path. In these cases, you can use flags to specify the output path for the specific case.
 
@@ -1901,4 +1912,110 @@ npx bv-build --prevent-process-js
 
 # Embed styles
 npx bv-build --embed-css
-```
+```
+
+---
+
+## Contributing
+
+We welcome contributions to **Bernova**! This project uses **[Changesets](https://github.com/changesets/changesets)** for automated version management and publishing.
+
+### Quick Start for Contributors
+
+1. **Fork the repository** on GitHub
+2. **Clone your fork** locally
+3. **Create a branch** following our naming conventions
+4. **Make your changes** with good commit messages
+5. **Push to your fork** and open a Pull Request
+
+### Branch Naming (Required)
+
+Your branch name determines the version bump type:
+
+| Branch Pattern                          | Version Bump              | Example              |
+| --------------------------------------- | ------------------------- | -------------------- |
+| `feat/` or `feature/`                   | **MINOR** (1.3.2 → 1.4.0) | `feat/grid-system`   |
+| `fix/` or `bugfix/`                     | **PATCH** (1.3.2 → 1.3.3) | `fix/button-styling` |
+| `break/` or `breaking/`                 | **MAJOR** (1.3.2 → 2.0.0) | `break/api-redesign` |
+| `docs/`, `chore/`, `refactor/`, `test/` | **PATCH**                 | `docs/update-readme` |
+
+### PR Title Format (Required)
+
+Follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+<type>: <description>
+```
+
+**Examples:**
+
+- ✅ `feat: add responsive grid system`
+- ✅ `fix: resolve button hover state issue`
+- ✅ `docs: update installation guide`
+- ✅ `feat(css): add spacing utility classes`
+- ✅ `fix(build): resolve minification error`
+
+**Breaking changes:**
+
+```
+<type>!: <description>
+```
+
+- ✅ `feat!: redesign CSS variable naming`
+- ✅ `refactor(api)!: change provider interface`
+
+### Commit Message Guidelines
+
+While branch names determine versioning, **good commit messages are essential** for code review and maintainability:
+
+```bash
+# Good commit messages
+git commit -m "feat(css): add margin utility classes"
+git commit -m "fix(build): resolve TypeScript compilation error"
+git commit -m "docs(readme): add usage examples"
+git commit -m "refactor(core): simplify style generation logic"
+git commit -m "test(unit): add tests for CSS parser"
+```
+
+### Automated Workflow
+
+When you open a PR:
+
+1. **Automated validation** checks branch name, PR title, tests, and code quality
+2. **Bot comments** with validation results and expected version bump
+3. **On merge**, changeset is auto-generated
+4. **Version is bumped** automatically
+5. **CHANGELOG is updated**
+6. **Package is built and published** to NPM
+7. **GitHub Release is created**
+8. **PR comment** confirms the published version
+
+**No manual changeset needed - it's all automatic!** 🚀
+
+### PR Validation Checks
+
+✅ Branch naming follows conventions  
+✅ PR title follows conventional commits  
+✅ TypeScript type checking passes  
+✅ All tests pass  
+✅ No `console.log` in production code  
+✅ TODOs reference GitHub issues  
+✅ Documentation updated for new features
+
+For detailed contributing guidelines, see [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+---
+
+## License
+
+This project is licensed under the Apache-2.0 License - see the [LICENSE](./LICENSE) file for details.
+
+## Links
+
+- [NPM Package](https://www.npmjs.com/package/bernova)
+- [GitHub Repository](https://github.com/kubit-ui/bernova)
+- [Issues](https://github.com/kubit-ui/bernova/issues)
+- [Contributing Guidelines](./CONTRIBUTING.md)
+- [Code of Conduct](./CODE_OF_CONDUCT.md)
+- [Security Policy](./SECURITY.md)
+- [Changelog](./CHANGELOG.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bernova",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "The best way to write CSS with Javascript syntax",
   "main": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
@@ -86,6 +86,7 @@
   },
   "devDependencies": {
     "@babel/cli": "^7.28.3",
+    "@changesets/cli": "^2.29.8",
     "@vitejs/plugin-legacy": "^6.1.1",
     "@vitest/coverage-v8": "3.2.4",
     "@vitest/ui": "^3.2.4",
@@ -122,6 +123,10 @@
     "test:coverage": "vitest run --coverage",
     "test:ci": "vitest --coverage.enabled=true --silent --run ",
     "clean": "rm -rf dist types",
-    "postinstall": "echo 'postinstall'"
+    "postinstall": "echo 'postinstall'",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "changeset:publish": "changeset publish",
+    "changeset:status": "changeset status --verbose"
   }
 }