

# 2.1.2 – Updates & Enhancements

**What’s New:**

* Introduced a redesigned, customizable **AppBar** for improved UI consistency.
* Enhanced the **CircleButton** widget with improved styling and responsiveness.
* Added a reusable **AvatarCircle** widget for displaying user avatars and icons.
* Included a clean and minimal **PageIndicator** widget for onboarding and carousel screens.
* Implemented a set of **Common Validators** for consistent and efficient form validation.
* Introduced a flexible **CustomTextField** with built-in validation and optional visibility toggle.


### 2.1.1
### Hotfix
1. Resolved lag issues and fixed crashes caused by complex widget trees.
3. Improved overall performance and stability.


### 2.1.0

### Fixes & Improvements

1. Fixed the non-removable `debugShowCheckedModeBanner` flag.
2. Fixed hot-rebuild issues triggered by orientation changes.
3. Improved responsive logic to reduce unnecessary widget rebuilds in `ResponsiveScope`.
4. Optimized fallback behavior for `MediaQuery` and scaling mechanisms.
5. Updated and enhanced smart scaling logic for more accurate rendering.
6. Improved overall performance and performed a full code cleanup.
7. Introduced `FlatButton` again in Flutter.
8. Added support for orientation lock via internal API.
9. Introduced new `SoulThemes` with improved visual design.
10. Added `Responsive` widget and several utility extensions to simplify responsive and UI development.
11. Centeralized Default Colors in `PureSoul` class

---

## 2.0.0

### Major Features

* Introduced `ResponsiveScope` as a new root-level widget for adaptive layouts.
* Added `Frame.reversed` to support orientation-aware frame swapping.
* Enhanced `SmartUnitUtils` with orientation-aware scaling capabilities.
* Refined design frame handling using `MediaQuery.orientation`.
* Implemented transition animations on responsive widget rebuilds.
* Improved debug logging for orientation and screen type changes.

### Refactor & Maintenance

* Renamed `NavigationExtension` to `NavigationContextExtensions`.
* Refactored `ResponsiveApp` to improve error handling and screen-type detection.
* Performed general code cleanup and restructuring.

### Bug Fixes

* Fixed improper fallback when using invalid `designFrame` values.

---

## 2.0.0-alpha.2

### Features

* Added unified scaling extensions: `.w`, `.h`, `.sp`, and `.rs` for automatic context-aware scaling across Smart, Design, and Percent modes.
* Introduced `.usp()` for unified font scaling with smart awareness.
* Implemented `_safe()` execution wrapper to prevent runtime crashes during uninitialized scaling scenarios.
* Added `.rs` as a shorthand for responsive radius computation.

### Supported Modes

* **Smart**: Context-aware scaling based on screen ratios and device density.
* **Design**: Logical pixel-to-dp mapping based on fixed mockup dimensions.
* **Percent**: Percentage-based scaling relative to current screen size.

### Refactors

* Renamed and formatted internal extensions for naming consistency.
* Enhanced readability and simplified logic for better maintenance.

### Breaking Changes

* Replaced scattered scaling access with centralized control via `UnifiedScale().mode`.
* Deprecated some older `.scale` usages; migrate to `.sx`, `.sy`, `.su`, `.w`, or `.h`.

---

## 1.3.1

### Fixes

* Corrected `SizeBox` shorthand behavior to ensure scaling aligns with design reference instead of percentage.

---

## 1.3.0

### Preparations for 2.0.0

* Upgraded Flutter SDK to 3.32 and Dart SDK to 3.8.
* Addressed breaking changes in Flutter/Dart APIs and updated all dependencies accordingly.
* Marked as the final pre-2.0.0 release, maintaining compatibility with older versions.

---

## 1.2.5

### Features

* Introduced responsive layout support to dynamically adjust UI components across screen sizes and orientations.
* Added `NavigatorManager` for improved navigation flow and control.

### Improvements

* Enhanced layout scaling for consistency across devices.

### Bug Fixes

* Resolved minor layout rendering issues and optimized overall performance.

---

## 1.2.4

### Fixes

* Removed conflicting class names to prevent runtime clashes.
* Added fake data for improved testing scenarios.

---

## 1.2.3

### Theme Engine Enhancements

* Added centralized `ThemeManager` for consistent theming.
* Refined the theme structure for greater flexibility.
* Introduced dynamic theme registry to support seamless theme switching.
* Improved `ColorScheme` integration for better UI consistency.
* Added `ThemeToggleButton` widget for theme interaction.

### Adaptive UI

* Enhanced `getFrame()` to better select design dimensions based on screen type.
* Improved breakpoint detection with `context.isXs`, `context.isSm`, etc.

### Custom Borders

* Added reusable extension for `DottedBorder` and introduced support for new border types: `Triangle`, `Rectangle`, `Dotted`, `Dashed`.
* Enabled displaying text within borders.

### General Improvements

* Improved fallback text handling for failed typography initialization.
* Enhanced Flutter error reporting and asset optimization.

---

## 1.2.2

### Error Handling

* Introduced `AppException` and `ErrorMapper` for structured error control.
* Improved error logging clarity.
* Optimized image, typography, and color handling.

---

## 1.2.1

### Platform Support

* Extended native web support.
* Improved pub.dev metadata and visual representation.

---

## 1.2.0

### Soul Theme Engine

* Released the first version of the `SoulThemeEngine`.
* Included over 10 pre-built themes for easy customization.
* Added asynchronous extensions to enhance workflow.

---

## 1.1.0

### Improvements

* Structured theming with color palettes for consistent UI.
* Introduced `CurrencyFormat` utility for number formatting.

---

## 1.0.0

### Initial Release

* Launched the first stable version of **Flutter Addons**.
* Included core functionality and responsive features.
* Provided comprehensive documentation for usage and setup.

