nebux_design_system 0.1.17

nebux_design_system: ^0.1.17 copied to clipboard

• FIX: Forward requiredErrorMessage to customValidator when field is empty and required
  • Previously, inputValidator returned requiredErrorMessage early without calling customValidator, preventing external error notifiers from capturing required-field errors
  • Now calls customValidator(requiredErrorMessage) before returning, allowing consumers to handle the required error externally (e.g., shadow-style inputs with InputExternalErrorWidget)

• NEW FEATURE: Added showErrorText, customValidator, and border customization options to NbxCountryPickerInput
  • Introduced showErrorText parameter to control error message visibility in country picker input
  • Added customValidator callback for custom validation logic
  • Added border customization support for greater styling flexibility

• NEW FEATURE: Added showErrorText parameter to NbxInputParameters to control error message visibility

  • Introduced showErrorText boolean parameter (defaults to true) in NbxInputParameters
  • When set to false, hides the error text below input fields while preserving validation behavior
  • Updated NbxInputDecorationExtension to conditionally apply error text style based on the parameter

• ENHANCEMENT: Enhanced letter validation to include accented characters

  • Updated TextValidationRules.onlyLetters regex to support accented characters (ñ, á, é, í, ó, ú, ü and their uppercase variants)
  • Improved input validation for Spanish and other Latin-based language inputs

• CI/CD: Added GitHub Actions for automated CI, release and publishing

  • ci.yml: runs flutter analyze and flutter test on PRs to main/develop
  • release.yml: creates git tag and GitHub Release on PR merge to main
  • publish.yml: publishes to pub.dev via OIDC (workflow_dispatch)
  • Excluded country_picker_pro2 and example from static analysis

• DOCS: Rewrote README with concise documentation and all current components

• CHORE: Improved pub.dev score (130 → 160)

  • Added example/example.dart with a complete usage sample
  • Updated google_fonts from ^6.2.1 to ^8.0.1
  • Updated toml from ^0.16.0 to ^0.18.0
  • Bumped minimum Dart SDK to ^3.9.0 and Flutter to >=3.29.0
  • Removed orphan file country_json copy.dart with invalid naming

• NEW FEATURE: Added onBeforeOpen callback to NbxCountryPickerInput
  • Introduced onBeforeOpen async callback to validation before opening the country picker
  • Updated _openCountryPicker to await the callback result

• NEW FEATURE: Enhanced country selection functionality with custom country list support

  • Added getCountriesByCodes method in CountryProvider to retrieve countries based on a list of country codes
  • Updated countrySelector, CountryListView, and showCountryListView to accept a custom list of countries for improved flexibility
  • Modified NbxCountryPickerModalParameters to include a countries parameter, allowing for custom country lists in the picker
  • Adjusted validation logic to ensure compatibility between custom countries and other parameters
  • Enhanced country picker functionality with better customization options

• REFACTOR: Removed countryPreferred parameter and updated documentation for country selection

  • Removed the countryPreferred parameter from countrySelector, CountryListView, and related components to streamline the country selection process
  • Updated documentation to reflect the new countries parameter, allowing for custom country lists instead of preferred countries
  • Adjusted related code to ensure compatibility with the updated country selection logic
  • Improved API consistency by consolidating country selection parameters

• NEW FEATURE: Added maxLines parameter to NbxCountryPickerInput and NbxCountryPickerParameters

  • Introduced optional maxLines parameter in NbxCountryPickerParameters to control the maximum number of lines for the input field
  • Updated NbxCountryPickerInput to utilize the maxLines parameter, enhancing input flexibility
  • Adjusted NbxTextFormFieldWidget to reflect the new maxLines property in its text display
  • Improved country picker input customization options

• NEW FEATURE: Added findByPhoneCode method to CountryProvider for enhanced country selection

  • Implemented method to retrieve a country based on its phone code
  • Returns null if no matching country is found, improving error handling
  • Enhanced country picker functionality with better phone code lookup capabilities

• REFACTOR: Enhanced NbxButton widget structure and documentation

  • Improved widget properties and methods organization for better clarity and maintainability
  • Updated documentation comments following custom doc template for clearer parameter descriptions
  • Introduced helper methods to streamline button style and content building
  • Removed legacy constructor to simplify API and encourage use of configuration classes
  • Enhanced code readability and maintainability

• REFACTOR: Simplified NbxAppBar layout and improved title rendering

  • Removed leading button logic from app bar for cleaner architecture
  • Adjusted title spacing based on presence of leading button in appBarConfig
  • Updated title widget to conditionally include leading button within a Row for better layout management
  • Improved component structure and predictability

• FIX: Updated font sizes and weights in NebuxTypography for consistency

  • Adjusted font sizes for content, caption, heading, and section styles to align with design specifications
  • Updated documentation comments to reflect new font sizes and weights
  • Improved typography consistency across the design system

• ENHANCEMENT: Improved NbxPhoneFieldWidget layout

  • Adjusted crossAxisAlignment from start to end for improved visual alignment
  • Enhanced layout consistency in phone input fields

• CHORE: Updated repository links in pubspec.yaml to reflect new ownership

  • Changed homepage, repository, and issue tracker URLs to point to new GitHub account
  • Updated package metadata for better maintainability

• CHORE: Updated package dependencies

  • Added app_shimmer package as transitive dependency in pubspec.lock
  • Updated local package version references

• FIX: Updated package dependencies and version constraints
  • Fixed app_shimmer dependency to use proper version constraint (^1.0.0)
  • Bumped package version to 0.1.7 for proper publishing sequence
  • Improved package stability and dependency management

• FIX: Updated package dependencies and version constraints
  • Fixed app_shimmer dependency to use proper version constraint (^1.0.0)
  • Bumped package version to 0.1.6 for proper publishing sequence
  • Improved package stability and dependency management

• REFACTOR: Chip configuration and list tile integration
  • Added ChipConfig utility to centralize chip parameters (label, labelStyle, colors, density, onTap)
  • Updated internal components to consume ChipConfig for improved reusability and maintainability
  • Refactored AppListTileWithChip to remove chip-specific parameters and accept a ChipConfig
  • Improved documentation consistency using the custom doc template
  • No breaking API changes; backwards-compatible migration path provided via config object

• FIX: Updated NbxAppBar to automatically imply leading button for better Material Design compliance
  • Fixed automaticallyImplyLeading behavior to properly handle leading button display
  • Refactored NbxScaffold decoration property for improved customization options
  • Enhanced component consistency with Material Design guidelines

• REFACTOR: Enhanced NbxAppBar component with improved leading button handling
  • Refactored leading button logic for better clarity and maintainability
  • Changed default centerTitle behavior from true to false in AppBarConfig for better alignment with Material Design guidelines
  • Improved titleSpacing logic to properly handle cases when no leading button is present
  • Set automaticallyImplyLeading to false for more predictable behavior
  • Enhanced code organization by extracting leading button building logic

• NEW FEATURE: Enhanced Country model with minLength and maxLength properties for improved phone number validation
  • Added minLength property to Country model for minimum phone number length validation
  • Added maxLength property to Country model for maximum phone number length validation
  • Updated country JSON data to include length validation information
  • Improved country picker functionality with better phone number validation support
  • Enhanced user experience with more accurate phone number input validation

• REFACTOR: NbxAppBar improvements for clarity and predictable spacing
  • Adjusted titleSpacing logic to better align with Material AppBar expectations
  • Simplified status bar brightness handling by removing redundant branches
  • Minor cleanups for readability and consistency

• BREAKING CHANGE: Refactored NbxButton component architecture for improved modularity and maintainability
  • Introduced configuration-based architecture with specialized config classes:
    • ButtonIconConfig: Manages icon properties (leading/trailing icons and colors)
    • ButtonStyleConfig: Handles visual styling (variant, colors, border radius, text style)
    • ButtonStateConfig: Controls state management (loading, enabled, selected)
    • ButtonLayoutConfig: Manages layout properties (expansion behavior)
  • Added new constructor with configuration objects for better organization
  • Maintained backward compatibility with NbxButton.legacy() constructor
  • Improved code organization by reducing main widget from 275 lines to ~100 lines
  • Enhanced testability with isolated configuration classes
  • Increased component reusability through modular configuration system
  • Better separation of concerns with dedicated config files
  • Added comprehensive documentation following custom doc format
  • Improved maintainability with isolated change impact

• REFACTOR: Enhanced NbxButton rendering logic with improved clarity and modularity
  • Introduced dedicated _buildTextWidget method to handle text rendering based on button variant
  • Simplified button child widget construction by consolidating text and icon handling
  • Enhanced readability and maintainability of the NbxButton component
  • Added proper text overflow handling with TextOverflow.fade and maxLines: 2
  • Improved text alignment and spacing with CrossAxisAlignment.center and TextAlign.center
  • Added Flexible wrapper for better text layout flexibility

• ENHANCEMENT: Added isSelected property to NbxButton to indicate selection state with corresponding background/foreground style updates
• REFACTOR: Simplified NbxButton variant rendering by replacing if-else with switch-case and consolidating text style application
• CHORE: Commented out repository and issue_tracker fields in pubspec.yaml for cleaner configuration

Country Picker Integration #

The Nebux Design System includes a custom implementation of country picker functionality based on the country_picker_pro package. This integration provides:

• Custom Implementation: Fork of the original country_picker_pro package with enhanced Nebux theming
• Internationalization: Full support for 25+ languages
• Theme Integration: Seamless integration with Nebux color and typography systems
• Enhanced Customization: Improved accessibility and styling options
• Consistent UX: Matches the design patterns of other Nebux components

The country picker functionality is available through the NbxCountryPickerInput component and can be used for country selection in forms, user registration, and profile management.

• NEW FEATURE: Added comprehensive country picker functionality with NbxCountryPickerInput component
• NEW FEATURE: Integrated custom country picker implementation based on country_picker_pro package
• NEW FEATURE: Full internationalization support (25+ languages) for country selection
• ENHANCEMENT: Added customizable phone code display option in country picker input
• ENHANCEMENT: Improved button component with renamed isDisabled to enabled for better clarity
• ENHANCEMENT: Enhanced input styling with improved hint text consistency
• ENHANCEMENT: Added flexible appBar support in NbxScaffold (now supports null appBar)
• ENHANCEMENT: Added default SizedBox constants for standardized spacing
• IMPROVEMENT: Refactored country selection logic with context-based theming
• IMPROVEMENT: Updated export structure to include new country picker components
• DEPENDENCY: Replaced external country_picker_pro dependency with custom implementation for better integration

• BREAKING CHANGE: Refactored button variants for better clarity - renamed 'primary' to 'filled' and 'secondary' to 'text'
• Enhanced typography system with custom factory method for flexible text style overrides
• Improved text validation rules with named parameters for better clarity and maintainability
• Enhanced input field styling with improved label and hint styles using textSecondary color with reduced opacity
• Added floatingLabelStyle to input decoration for consistent theming across input fields
• Introduced customBackgroundColor property to NbxButton for flexible background color customization
• Enhanced NbxAppBar with customizable leading button for improved component flexibility
• Added secondaryVariant color to NebuxColors for better theming support
• Refined typography styles with updated font sizes for improved consistency
• Generated new model files for enhanced component structure and theming consistency
• Updated .gitignore configuration for better generated file management

• BREAKING CHANGE: Removed font_awesome_flutter dependency for better performance and smaller bundle size
• Enhanced NebuxAppBar with customizable icon support, removing dependency on FontAwesome icons
• Refactored NbxSocialLoginButton to support custom icons instead of FontAwesome icons
• Improved input field styling with enhanced enabledBorder configuration in NbxInputDecorationExtension
• Better visual consistency across input components

• Enhanced README.md with improved documentation
• Improved package documentation and usage examples

• Updated version to reflect latest changes in the Nebux Design System

• Enhanced README.md with improved feature descriptions
• Added detailed installation instructions
• Included comprehensive usage examples for components and theming
• Updated support contact information

• Initial release of NebuX Design System
• Complete theme system with light and dark mode support
• Typography system with consistent text styles and font sizes
• Spacing utilities for standardized layouts
• UI Components including:
  • App bars with customizable styling
  • Button components with multiple variants
  • Text field widgets with validation
  • Network image component with caching
  • Scaffold components for consistent page structure
• Color management system with primary, secondary, and neutral colors
• Responsive design utilities
• Comprehensive documentation and examples