beathers 5.7.6 → 5.9.1

package/.prettierrc.js

@@ -1,8 +1,10 @@
-export default {
-  trailingComma: 'es5',
-  bracketSpacing: true,
-  tabWidth: 2,
-  printWidth: 120,
-  semi: false,
-  singleQuote: true,
-}
+export default {
+  trailingComma: 'es5',
+  bracketSpacing: true,
+  tabWidth: 2,
+  printWidth: 120,
+  semi: false,
+  singleQuote: true,
+
+  overrides: [{ files: ['*.scss', '*.sass'], options: { trailingComma: 'none' } }],
+}

package/CHANGELOG

@@ -1,274 +1,305 @@
-
-# Changelog
-
-## [5.7.4, 5.7.5, 5.7.6] - 2026-02-23
-
-### Fixed
-
-- **mQ Mixin**: Updated default condition in mQ mixin to true and adjusted wrapper breakpoint handling for improved SCSS logic.
-
-## [5.7.0, 5.7.1, 5.7.2, 5.7.3] - 2025-11-24
-
-### Added
-
-- **Button Utilities**: Added comprehensive button utilities with support for rounded, circle, and sharp corners, loading states, hover effects, and proper focus management
-- **Configuration Options**: Added `useButton` toggle to enable/disable button utilities generation
-
-### Changed
-
-- **Button Styles**: Moved button-related styles from resets to dedicated button module for better organization
-
-## [5.6.2, 5.6.3] - 2025-09-27
-
-### Added
-
-- **Documentation**: Added comprehensive documentation for colors, typography, grid system, and visual effects
-- **Package Configuration**: Included documentation files in package.json for better distribution
-
-### Fixed
-
-- **SCSS Styling**: Uncommented style imports in beathers.min.scss to ensure proper styling functionality
-
-### Changed
-
-- **Media Query Settings**: Removed useMediaQueries from theme roles and related settings for cleaner configuration
-
-## [5.6.0, 5.6.1] - 2025-08-08
-
-### Added
-
-- **Media Query Controls**: Added granular control over responsive utility generation with new role variables:
-  - `useFontFamiliesMediaQueries` - Control responsive font family utilities
-  - `useFontSizesMediaQueries` - Control responsive font size utilities
-  - `useFontShapesMediaQueries` - Control responsive font style utilities
-  - `useTextAlignsMediaQueries` - Control responsive text alignment utilities
-  - `useTextTruncateMediaQueries` - Control responsive text truncation utilities
-  - `useShadowsMediaQueries` - Control responsive shadow utilities
-  - `useDisplaysMediaQueries` - Control responsive display utilities
-  - `useOverflowsMediaQueries` - Control responsive overflow utilities
-  - `useOpacitiesMediaQueries` - Control responsive opacity utilities
-  - `useBlurMediaQueries` - Control responsive blur utilities
-  - `useObjectFitsMediaQueries` - Control responsive object-fit utilities
-  - `usePositionsMediaQueries` - Control responsive positioning utilities
-  - `useInsetsMediaQueries` - Control responsive inset utilities
-  - `useSizesMediaQueries` - Control responsive sizing utilities
-  - `useGuttersMediaQueries` - Control responsive spacing utilities
-  - `useBordersMediaQueries` - Control responsive border utilities
-  - `useTextBordersMediaQueries` - Control responsive text border utilities
-  - `useRadiusMediaQueries` - Control responsive border radius utilities
-  - `useGridMediaQueries` - Control responsive grid utilities
-
-### Improved
-
-- **CLI User Experience**: Significantly enhanced console output with professional, user-friendly messaging
-  - Added meaningful emojis and color coding for better visual clarity
-  - Implemented clean formatting for yes/no questions with clear [Y/N] options
-  - Enhanced loading and processing state indicators
-  - Improved error messages and success confirmations
-  - Added consistent color styling for interactive elements (cyan, green, yellow)
-- **CSS Output Optimization**: Users can now fine-tune which responsive utilities are generated, reducing CSS bundle size
-- **Documentation**: Updated README with comprehensive documentation for all new media query control variables
-- **Type Safety**: Enhanced TypeScript types to include all new role variables
-
-## [5.5.4] - 2025-07-07
-
-### Improved
-
-- **Documentation**: Added comprehensive Glass settings documentation to README.md
-- **Glass utilities**: Enhanced glassmorphism configuration examples and usage instructions
-
-### Fixed
-
-- **DeepMerge function**: Added missing glass property merging in theme configuration merge operation
-- Minor bug fixes and improvements
-- Enhanced build process stability
-
-## [5.5.0] - 2025-07-04
-
-### Added
-
-- **Glass effects**: New glassmorphism settings and utilities for modern UI effects
-- **Bhoenix branding colors**: Added official Bhoenix Studio brand colors to the color palette
-
-### Fixed
-
-- **Typography**: Updated font mixin parameters to include font key for better font handling
-- **Build system**: Enhanced build process with proper isLocalBuild flag handling and improved font path resolution
-- **Icon fonts**: Fixed icon font path references for reliable icon loading
-- **Font families**: Updated font family definitions and color selections in reset styles
-- **CSS validation**: Improved SizeUnit type to properly handle zero values as valid CSS units
-
-## [5.4.1] - 2025-06-15
-
-### Fixed
-
-- Minor bug fixes and improvements
-- Enhanced build process stability
-- Improved CLI command reliability
-- Fixed edge cases in configuration handling
-
-## [5.4.0] - 2025-06-12
-
-### Changed
-
-- **BREAKING CHANGE**: Removed `dist` folder from package structure for cleaner imports
-- **Import paths**: Updated import paths from `beathers/dist/css/beathers.min.css` to `beathers/css/beathers.min.css`
-- **Package structure**: Moved CSS files from `dist/css/` to `css/` and SCSS files from `dist/scss/` to `scss/`
-- **Build scripts**: Updated all build and CLI scripts to work with new folder structure
-
-### Fixed
-
-- **Package exports**: Updated package.json exports to reflect new structure without `dist` folder
-
-## [5.3.6] - 2025-06-12
-
-### Fixed
-
-- **CLI build paths**: Updated build paths to correctly reference package installation location
-- **Output directory logic**: Improved default output path handling for different execution contexts
-
-## [5.3.5] - 2025-06-12
-
-### Fixed
-
-- **CLI execution**: Fixed "Command failed: npm run build:pack" error when using `npx beathers` as library in other projects
-- **Package dependencies**: Moved `sass` from devDependencies to dependencies to ensure it's available when package is installed
-- **Build system**: CLI now uses sass compiler directly instead of trying to run npm scripts from user projects
-
-## [5.3.4] - 2025-06-12
-
-### Updated
-
-- **Package maintenance**: Minor fixes
-
-## [5.3.3] - 2025-06-12
-
-### Fixed
-
-- **Module exports**: Added CSS and SCSS files to package exports to fix "Module not found" error when importing CSS files
-- **Import paths**: Fixed package.json exports field to properly expose css/_and scss/_ files
-
-## [5.3.2] - 2025-06-12
-
-### Fixed
-
-- **CLI version display**: Fixed version command to show correct package version (5.3.2) instead of incorrect version
-- **NPM package structure**: Fixed SCSS file paths in distributed package by copying source SCSS files to scss/ directory
-
-## [5.3.1] - 2025-06-12
-
-### Fixed
-
-- **Module exports**: Fixed TypeScript path aliases in npm package exports to use relative paths for proper module resolution
-
-## [5.3.0] - 2025-06-12
-
-### Added
-
-- **Custom output path**: Added support for custom output path in build command for more flexible project structures
-- **Import commands**: New CLI import commands for colors and fonts to streamline workflow
-- **Enhanced console messaging**: Improved console.log messages across all commands for better user experience and clarity
-- **Type definitions enhancement**: Extended type definitions for typography and settings with new properties for font configurations, grid settings, and utility features
-
-### Changed
-
-- **Code organization**: Moved functions to helper folder for better code structure and maintainability
-- **CLI cleanup**: Cleaned up CLI file structure for improved readability and maintenance
-- **Build script refactoring**: Refactored build scripts and removed stylelint configuration
-- **Path mapping**: Improved module importing with better path mapping
-
-### Fixed
-
-- **Colors commands**: Fixed `add`, `remove` and `import` commands for colors
-- **Fonts commands**: Fixed `add`, `remove` and `import` commands for fonts
-- **Colors duplication**: Resolved issues with color duplication
-- **Default colors reading**: Fixed reading of default color values
-- **Help functions**: Updated and improved help command functions
-
-## [5.2.2] - 2025-06-05
-
-### Fixed
-
-- **README logo display**: Updated logo image source to use unpkg CDN for better compatibility and reliability on npm package page
-
-## [5.2.1] - 2025-06-05
-
-### Fixed
-
-- **ES module compatibility**: Fixed config loading to use `pathToFileURL` for better compatibility with ES modules
-- **Import resolution**: Enhanced module import handling in `LoadUserConfigs.ts` for cross-platform compatibility
-
-## [5.2.0] - 2025-06-05
-
-### Added
-
-- **Enhanced theme building system**: Complete refactor of `ReadDefaultValues.ts` with improved SCSS variable parsing
-- **Better default theme loading**: Added proper merging of default values with user configurations in `BuildTheme.ts`
-- **Improved type definitions**: Consolidated and organized type exports in `types.ts` for better developer experience
-- **Enhanced configuration handling**: Better support for nullish coalescing in `LoadUserConfigs.ts`
-- **More robust SCSS parsing**: Enhanced parsing logic for colors, fonts, breakpoints, and wrappers
-- **Better wrapper configuration**: Fixed wrapper property structure (size → width) for consistency
-
-### Changed
-
-- **Type system overhaul**: Moved from separate type exports to consolidated type definitions
-- **Better configuration merging**: Enhanced default theme loading and user config integration
-- **Improved code organization**: More consistent code structure across TypeScript files
-- **Enhanced error handling**: Better validation and error messages in configuration loading
-
-### Fixed
-
-- **Configuration parsing bugs**: Fixed various issues with SCSS variable parsing
-- **Type consistency**: Resolved type mismatches between different modules
-- **Wrapper configuration**: Fixed property naming inconsistency in wrapper settings
-
-## [5.1.1] - 2025-06-05
-
-### Fixed
-
-- Small bug fixes and improvements
-
-## [5.1.0] - 2025-06-05
-
-### Added
-
-- Enhanced CSS utility documentation in README
-- Comprehensive configuration examples for TypeScript users
-- Improved color utility system with better dark/light mode support
-- Font weight and size utility examples
-
-### Changed
-
-- Updated README with detailed configuration tables
-- Improved TypeScript configuration examples
-- Enhanced documentation structure and readability
-
-### Fixed
-
-- Configuration file format consistency
-- TypeScript type definitions alignment
-
-## [5.0.0] - Initial Release
-
-### Added
-
-- Core SCSS framework with utility-first approach
-- Interactive CLI tool for theme configuration
-- Comprehensive color system with light/dark variants
-- Typography utilities with customizable font families and sizes
-- Responsive grid system with 12-column layout
-- Flexbox utilities for modern layouts
-- Spacing utilities with customizable gutters
-- Border and border-radius utilities
-- Shadow and blur effects
-- Position and sizing utilities
-- Opacity and overflow utilities
-- Transition utilities for smooth animations
-- Display utilities for various layout needs
-- Container/wrapper utilities for responsive layouts
-- Icon integration support
-- Complete customization through configuration files
-- Support for JSON, JS, and TypeScript config formats
-- CSS custom properties (CSS variables) generation
-- Media query utilities for responsive design
-- Text alignment and truncation utilities
+
+# Changelog
+
+## [5.9.0, 5.9.1] - 2026-04-01
+
+### Changed
+
+- Refactored SCSS variable assignments to use `sass()` for improved null checks and default values across style files, enhancing code readability and consistency.
+- Updated button styles and corner radius definitions for better visual consistency.
+- Updated import statements to use Node module syntax.
+- Refactored code structure for improved readability and maintainability.
+- Updated build:clean and build:update scripts for improved reliability and to use new commands.
+
+### Fixed
+
+- Removed trailing commas in SCSS variable definitions for syntax consistency.
+- Enhanced null checks in validation functions using `sass()` for better error handling.
+- Removed unused stylelint rules and cleaned up SCSS files.
+- Replaced error messages with debug statements in validation functions.
+- Removed debug statements for cleaner color definitions.
+- Removed baseUrl and paths from tsconfig.json for cleaner configuration.
+- Corrected font name assignment in font-face mixin and improved unicode check spacing.
+
+### Added
+
+- Added version update script with changelog integration.
+- Added overrides for SCSS and SASS files in Prettier configuration.
+
+## [5.8.0] - 2026-03-31
+
+### Changed
+
+- Fix some font issues.
+
+## [5.7.4, 5.7.5, 5.7.6] - 2026-02-23
+
+### Fixed
+
+- **mQ Mixin**: Updated default condition in mQ mixin to true and adjusted wrapper breakpoint handling for improved SCSS logic.
+
+## [5.7.0, 5.7.1, 5.7.2, 5.7.3] - 2025-11-24
+
+### Added
+
+- **Button Utilities**: Added comprehensive button utilities with support for rounded, circle, and sharp corners, loading states, hover effects, and proper focus management
+- **Configuration Options**: Added `useButton` toggle to enable/disable button utilities generation
+
+### Changed
+
+- **Button Styles**: Moved button-related styles from resets to dedicated button module for better organization
+
+## [5.6.2, 5.6.3] - 2025-09-27
+
+### Added
+
+- **Documentation**: Added comprehensive documentation for colors, typography, grid system, and visual effects
+- **Package Configuration**: Included documentation files in package.json for better distribution
+
+### Fixed
+
+- **SCSS Styling**: Uncommented style imports in beathers.min.scss to ensure proper styling functionality
+
+### Changed
+
+- **Media Query Settings**: Removed useMediaQueries from theme roles and related settings for cleaner configuration
+
+## [5.6.0, 5.6.1] - 2025-08-08
+
+### Added
+
+- **Media Query Controls**: Added granular control over responsive utility generation with new role variables:
+  - `useFontFamiliesMediaQueries` - Control responsive font family utilities
+  - `useFontSizesMediaQueries` - Control responsive font size utilities
+  - `useFontShapesMediaQueries` - Control responsive font style utilities
+  - `useTextAlignsMediaQueries` - Control responsive text alignment utilities
+  - `useTextTruncateMediaQueries` - Control responsive text truncation utilities
+  - `useShadowsMediaQueries` - Control responsive shadow utilities
+  - `useDisplaysMediaQueries` - Control responsive display utilities
+  - `useOverflowsMediaQueries` - Control responsive overflow utilities
+  - `useOpacitiesMediaQueries` - Control responsive opacity utilities
+  - `useBlurMediaQueries` - Control responsive blur utilities
+  - `useObjectFitsMediaQueries` - Control responsive object-fit utilities
+  - `usePositionsMediaQueries` - Control responsive positioning utilities
+  - `useInsetsMediaQueries` - Control responsive inset utilities
+  - `useSizesMediaQueries` - Control responsive sizing utilities
+  - `useGuttersMediaQueries` - Control responsive spacing utilities
+  - `useBordersMediaQueries` - Control responsive border utilities
+  - `useTextBordersMediaQueries` - Control responsive text border utilities
+  - `useRadiusMediaQueries` - Control responsive border radius utilities
+  - `useGridMediaQueries` - Control responsive grid utilities
+
+### Improved
+
+- **CLI User Experience**: Significantly enhanced console output with professional, user-friendly messaging
+  - Added meaningful emojis and color coding for better visual clarity
+  - Implemented clean formatting for yes/no questions with clear [Y/N] options
+  - Enhanced loading and processing state indicators
+  - Improved error messages and success confirmations
+  - Added consistent color styling for interactive elements (cyan, green, yellow)
+- **CSS Output Optimization**: Users can now fine-tune which responsive utilities are generated, reducing CSS bundle size
+- **Documentation**: Updated README with comprehensive documentation for all new media query control variables
+- **Type Safety**: Enhanced TypeScript types to include all new role variables
+
+## [5.5.4] - 2025-07-07
+
+### Improved
+
+- **Documentation**: Added comprehensive Glass settings documentation to README.md
+- **Glass utilities**: Enhanced glassmorphism configuration examples and usage instructions
+
+### Fixed
+
+- **DeepMerge function**: Added missing glass property merging in theme configuration merge operation
+- Minor bug fixes and improvements
+- Enhanced build process stability
+
+## [5.5.0] - 2025-07-04
+
+### Added
+
+- **Glass effects**: New glassmorphism settings and utilities for modern UI effects
+- **Bhoenix branding colors**: Added official Bhoenix Studio brand colors to the color palette
+
+### Fixed
+
+- **Typography**: Updated font mixin parameters to include font key for better font handling
+- **Build system**: Enhanced build process with proper isLocalBuild flag handling and improved font path resolution
+- **Icon fonts**: Fixed icon font path references for reliable icon loading
+- **Font families**: Updated font family definitions and color selections in reset styles
+- **CSS validation**: Improved SizeUnit type to properly handle zero values as valid CSS units
+
+## [5.4.1] - 2025-06-15
+
+### Fixed
+
+- Minor bug fixes and improvements
+- Enhanced build process stability
+- Improved CLI command reliability
+- Fixed edge cases in configuration handling
+
+## [5.4.0] - 2025-06-12
+
+### Changed
+
+- **BREAKING CHANGE**: Removed `dist` folder from package structure for cleaner imports
+- **Import paths**: Updated import paths from `beathers/dist/css/beathers.min.css` to `beathers/css/beathers.min.css`
+- **Package structure**: Moved CSS files from `dist/css/` to `css/` and SCSS files from `dist/scss/` to `scss/`
+- **Build scripts**: Updated all build and CLI scripts to work with new folder structure
+
+### Fixed
+
+- **Package exports**: Updated package.json exports to reflect new structure without `dist` folder
+
+## [5.3.6] - 2025-06-12
+
+### Fixed
+
+- **CLI build paths**: Updated build paths to correctly reference package installation location
+- **Output directory logic**: Improved default output path handling for different execution contexts
+
+## [5.3.5] - 2025-06-12
+
+### Fixed
+
+- **CLI execution**: Fixed "Command failed: npm run build:pack" error when using `npx beathers` as library in other projects
+- **Package dependencies**: Moved `sass` from devDependencies to dependencies to ensure it's available when package is installed
+- **Build system**: CLI now uses sass compiler directly instead of trying to run npm scripts from user projects
+
+## [5.3.4] - 2025-06-12
+
+### Updated
+
+- **Package maintenance**: Minor fixes
+
+## [5.3.3] - 2025-06-12
+
+### Fixed
+
+- **Module exports**: Added CSS and SCSS files to package exports to fix "Module not found" error when importing CSS files
+- **Import paths**: Fixed package.json exports field to properly expose css/_and scss/_ files
+
+## [5.3.2] - 2025-06-12
+
+### Fixed
+
+- **CLI version display**: Fixed version command to show correct package version (5.3.2) instead of incorrect version
+- **NPM package structure**: Fixed SCSS file paths in distributed package by copying source SCSS files to scss/ directory
+
+## [5.3.1] - 2025-06-12
+
+### Fixed
+
+- **Module exports**: Fixed TypeScript path aliases in npm package exports to use relative paths for proper module resolution
+
+## [5.3.0] - 2025-06-12
+
+### Added
+
+- **Custom output path**: Added support for custom output path in build command for more flexible project structures
+- **Import commands**: New CLI import commands for colors and fonts to streamline workflow
+- **Enhanced console messaging**: Improved console.log messages across all commands for better user experience and clarity
+- **Type definitions enhancement**: Extended type definitions for typography and settings with new properties for font configurations, grid settings, and utility features
+
+### Changed
+
+- **Code organization**: Moved functions to helper folder for better code structure and maintainability
+- **CLI cleanup**: Cleaned up CLI file structure for improved readability and maintenance
+- **Build script refactoring**: Refactored build scripts and removed stylelint configuration
+- **Path mapping**: Improved module importing with better path mapping
+
+### Fixed
+
+- **Colors commands**: Fixed `add`, `remove` and `import` commands for colors
+- **Fonts commands**: Fixed `add`, `remove` and `import` commands for fonts
+- **Colors duplication**: Resolved issues with color duplication
+- **Default colors reading**: Fixed reading of default color values
+- **Help functions**: Updated and improved help command functions
+
+## [5.2.2] - 2025-06-05
+
+### Fixed
+
+- **README logo display**: Updated logo image source to use unpkg CDN for better compatibility and reliability on npm package page
+
+## [5.2.1] - 2025-06-05
+
+### Fixed
+
+- **ES module compatibility**: Fixed config loading to use `pathToFileURL` for better compatibility with ES modules
+- **Import resolution**: Enhanced module import handling in `LoadUserConfigs.ts` for cross-platform compatibility
+
+## [5.2.0] - 2025-06-05
+
+### Added
+
+- **Enhanced theme building system**: Complete refactor of `ReadDefaultValues.ts` with improved SCSS variable parsing
+- **Better default theme loading**: Added proper merging of default values with user configurations in `BuildTheme.ts`
+- **Improved type definitions**: Consolidated and organized type exports in `types.ts` for better developer experience
+- **Enhanced configuration handling**: Better support for nullish coalescing in `LoadUserConfigs.ts`
+- **More robust SCSS parsing**: Enhanced parsing logic for colors, fonts, breakpoints, and wrappers
+- **Better wrapper configuration**: Fixed wrapper property structure (size → width) for consistency
+
+### Changed
+
+- **Type system overhaul**: Moved from separate type exports to consolidated type definitions
+- **Better configuration merging**: Enhanced default theme loading and user config integration
+- **Improved code organization**: More consistent code structure across TypeScript files
+- **Enhanced error handling**: Better validation and error messages in configuration loading
+
+### Fixed
+
+- **Configuration parsing bugs**: Fixed various issues with SCSS variable parsing
+- **Type consistency**: Resolved type mismatches between different modules
+- **Wrapper configuration**: Fixed property naming inconsistency in wrapper settings
+
+## [5.1.1] - 2025-06-05
+
+### Fixed
+
+- Small bug fixes and improvements
+
+## [5.1.0] - 2025-06-05
+
+### Added
+
+- Enhanced CSS utility documentation in README
+- Comprehensive configuration examples for TypeScript users
+- Improved color utility system with better dark/light mode support
+- Font weight and size utility examples
+
+### Changed
+
+- Updated README with detailed configuration tables
+- Improved TypeScript configuration examples
+- Enhanced documentation structure and readability
+
+### Fixed
+
+- Configuration file format consistency
+- TypeScript type definitions alignment
+
+## [5.0.0] - Initial Release
+
+### Added
+
+- Core SCSS framework with utility-first approach
+- Interactive CLI tool for theme configuration
+- Comprehensive color system with light/dark variants
+- Typography utilities with customizable font families and sizes
+- Responsive grid system with 12-column layout
+- Flexbox utilities for modern layouts
+- Spacing utilities with customizable gutters
+- Border and border-radius utilities
+- Shadow and blur effects
+- Position and sizing utilities
+- Opacity and overflow utilities
+- Transition utilities for smooth animations
+- Display utilities for various layout needs
+- Container/wrapper utilities for responsive layouts
+- Icon integration support
+- Complete customization through configuration files
+- Support for JSON, JS, and TypeScript config formats
+- CSS custom properties (CSS variables) generation
+- Media query utilities for responsive design
+- Text alignment and truncation utilities