Sep 11, 2025 #

🛠 Fixed #

• Error state now updates correctly after valid input in TextFieldCubit.
• Added ImageFieldValidator typedef for consistency with TextFieldValidator.
• ImageFieldCubit accepts an optional validator, defaults to validateImageFile.
• ImageFieldState stores the validator, so validation logic stays consistent.
• clear() preserves the validator.

Sep 11, 2025 #

✨ Added #

• Added variables filled, borderRadius in the AppTextField,

Sep 11, 2025 #

✨ Added #

• isDirty flag to track user interaction in FieldState<T> and ImageFieldState.
• validate({bool force = false}) for create/update validation logic.

🔄 Changed #

• Fields marked as dirty on user input or image selection.
• Errors show only after interaction or forced validation.

Sep 9, 2025 #

✨ Updated #

• Updated i_validator to 1.1.6

Sep 9, 2025 #

✨ Updated #

• Updated i_validator to 1.1.5

Sep 8, 2025 #

✨ Updated #

• Updated i_validator to 1.1.4

Sep 7, 2025 #

✨ Updated #

• Improved AssetImageToFile extension
• Improved AssetToXFileExtension extension
• Added XFile Image Validation Extension

✨ Removed #

• Removed BaseBloc And place it in the submission_state package.
• Removed BaseState And place it in the submission_state package.
• Removed FormSubmissionState And place it in the submission_state package.

Aug 22, 2025 #

✨ Updated #

• Updated Dart sdk to 3.9.0
• Updated i_validator to 1.1.2
• Updated get_it_di_global_variable to 0.0.6
• Updated provider to 6.1.5+1
• Updated file_picker to 10.3.2
• Removed flutter_lints Dependency

Aug 10, 2025 #

Added #

• Updated file_picker version as file_picker: ^10.2.4

Aug 8, 2025 #

Added #

• Added setUploadedUrl method in the ImageFieldCubit to set uploaded file Url.
• Updated file_picker version as file_picker: ^10.2.2

Aug 8, 2025 #

Refactored #

• Uses TextFieldState in the TextFieldCubit instead of FieldCubit.

Aug 5, 2025 #

♻️ Refactored #

• Uses TextFieldCubit in the AppTextField, for state management.
• Added optional variables builder in the AppTextField, to pass custom input field widget.
• Added Border & fill config variables in the AppTextField, for text field customization.

July 27, 2025 #

♻️ Updated #

• Added failDelete in the ImageFieldCubit to improved delete state management and user feedback.

July 27, 2025 #

♻️ Updated #

• Added failUpload in the ImageFieldCubit to improved upload state management and user feedback.

July 26, 2025 #

♻️ Updated #

• Improved ImageFieldCubit to support upload and delete state management.
• Added uploadProgress, isUploading, and isDeleting to ImageFieldState for improved image operation tracking and user feedback in forms.

July 26, 2025 #

➕ Created

• Usages ImageFieldState in the ImageFieldCubit.

• base_bloc.dart: Introduced a foundational abstract class for all BLoCs. This class enforces the use of a common state that extends BaseState, encouraging consistency and reusability across all business logic components.

• base_state.dart: Defined an abstract base state that all Cubit or Bloc states should extend. It encapsulates a FormSubmissionStatus to track form states (e.g., loading, success, failure), aligning with the Single Responsibility Principle.

• form_submission_status.dart: Added sealed classes to represent the different statuses of form submission: initial, submitting, success, and failed. These classes ensure clear and maintainable handling of form-related logic, and provide extensibility for future states.

• loading_cubit.dart: Implemented a dedicated Cubit to manage general-purpose loading states across the app. This promotes separation of concerns by delegating loading logic to its own class.

• loading_state.dart: Introduced a strongly-typed state system for LoadingCubit, including LoadingInitial, LoadingInProgress, and LoadingError. This supports more expressive and testable UI loading feedback.

These additions were created following SOLID principles and ensure a clean architecture approach for scalable and maintainable Flutter applications.

July 23, 2025 #

♻️ Updated

• Usages ImageFieldState in the ImageFieldCubit.

July 22, 2025 #

♻️ Updated

• Added selectImage method in the ImageFieldCubit.

July 22, 2025 #

♻️ Refactored

• Renamed update to onChanged in the FieldCubit<T>.

July 22, 2025 #

♻️ Refactored

• Added formFieldValidator getter to FieldCubit<T> to provide a reusable Flutter form validator callback without duplicating validation logic.

July 22, 2025 #

✅ Added #

• String?.loadAsXFile() for converting asset paths to XFile

✅ Refactored #

• SwitchCubit has been completely replaced by ToggleCubit, which extends FieldCubit<bool>.
  • Offers cleaner implementation using .toggle(), .enable(), .disable().
  • Leverages FieldCubit validation and reset mechanics.
  • More reusable and aligns with all other form field cubits.

✨ Enhanced #

• Updated example usage in main.dart to demonstrate:
  • Modern ToggleCubit instead of SwitchCubit.
  • Unified form field cubit usage.
  • validate() pattern on all FieldCubit<T> instances.
  • Usage of EnumOptionDropDownMenuFormField, AppCheckbox, AppTextField, AppDatePicker, etc.

Jul 16, 2025 #

🐞 Fixed #

• Fixed clear() method behavior in various Cubits to properly emit cleared state using emit().

Jul 16, 2025 #

🐞 Fixed #

• fixed Angle brackets will be interpreted as HTML for AppDatePicker and AppSlider.

Jul 16, 2025 #

✨ Enhanced #

• Introduced FieldCubit<T> and FieldState<T>:

  • Generic, reusable Cubit for form input fields.
  • Tracks current value and error message.
  • Includes .update(value), .clear(), and .reset() methods.

✅ Refactored #

• DateTimeCubit, TextFieldCubit, and SwitchCubit updated to:

  • Respect user-provided initial values.
  • Improved state updates and structure.
  • Used common structure aligning with FieldCubit<T>.

Jul 6, 2025 #

🧹 Refactored #

• Removed ImagePickerCubit registration and BlocProvider setup from reusable_editor.
• Decoupled image picking functionality:
  • reusable_editor no longer handles or depends on image picking, cropping, or compressing logic.
  • All related logic has been moved to the independent package reusable_image_widget.

🔄 Migration Note #

If you were using ImagePickerCubit or image-related widgets in reusable_editor, you must now:

• Add the reusable_image_widget package to your project.
• Register its dependencies using registerReusableImageWidgetDependencies().
• Include ImagePickerCubit in your widget tree using reusableImageWidgetBlocProviders.

✅ This makes reusable_editor cleaner, more modular, and focused strictly on form field editors and reusable input Cubits.

Jul 4, 2025 #

📘 Updated #

• Updated GitHub Pages-based documentation under the doc/ folder:
  • Setup widget usage examples files
  • Setup package Libraries linking with API Reference
  • API Reference – Full Dart API docs generated by dartdoc

Jul 3, 2025 #

📘 Removed #

* `VALIDATOR_USAGE.md` – Guide for using built-in and custom validators.
* Separated in the `i_validator` package for built-in and custom validators.

Jul 3, 2025 #

📘 Documentation #

• Added GitHub Pages-based documentation under the doc/ folder:

  • VALIDATOR_USAGE.md – Guide for using built-in and custom validators.

Jul 3, 2025 #

📘 Documentation #

• Added GitHub Pages-based documentation under the doc/ folder:

  • WIDGET_USAGE.md – widget usage examples
  • CUBIT_USAGE.md – usage of FieldCubit, ToggleCubit, etc.
  • FIELD_TYPE_USAGE.md – usage patterns for FieldCubit<T> with various types
  • Setup index.md as the documentation landing page
  • Linked documentation from README

Jul 3, 2025 #

🆕 Added #

• New Input Widgets using FieldCubit<T> (renamed to App-prefixed)

  • AppTextField – for text input with validation
  • AppCheckbox – checkbox input with error text
  • AppDropdown<T> – generic dropdown field
  • AppSwitch – switch toggle input
  • AppRadioGroup<T> – radio button group input
  • AppSlider – numeric slider input
  • AppRangeSlider – range slider input with min/max
  • AppDatePicker – date picker field
  • AppTimePicker – time picker field
  • AppFilePicker – file picker using file_picker package

✅ Renamed #

• selection_cubit.dart ➔ enum_option_cubit.dart
• selection_state.dart ➔ enum_option_state.dart

🧱 Cubits #

• ToggleCubit added for boolean toggle handling using FieldCubit<bool>
• FieldCubit<T> added as a generic form state cubit with validation support

🎨 Styles #

• Text field and error styles use centralized AppFormTextStyles
• Input decoration elements follow InputDecorationStyles for consistent field UI (e.g., border, padding, label styles)

• Export Bloc Provider.
• Export GetIt DI.

• Added DateTimeCubit Bloc Provider.
• Registered DateTimeCubit GetIt DI.

• Implemented Bloc Provider.
• Implemented GetIt DI.
• Removed fileRegisterGetItDiRestApiDataSource.

• Added fileRegisterGetItDiRestApiDataSource,

• Added Register Input Field Get It Di,

Updated #

• Refactored SwitchCubit:

  • Now uses a typed SwitchState model instead of a raw bool.
  • Introduced debug logging in onChanged and clearSwitch for easier tracing.
  • Improved structure following SOLID principles.

• Added

  • clearSwitch() method to SwitchCubit for resetting the switch state to default (true).

Added #

• Support for uploading and deleting files via Firestore or REST API.

• FileEntity and FileResponseEntity models.

• Enum-based dropdown form field (EnumOptionDropDownMenuFormField).

• Cubits for managing UI state:

  • DateTimeCubit
  • ImageCrudCubit
  • SelectionCubit
  • SwitchCubit
  • TextFieldCubit

• Utility extensions:

  • String?.loadAsFile() for converting asset paths to File
  • String.loadAssetImage() for loading images as bytes

• Abstract interfaces for file handling and dependency constants.

• Example usage with a mock implementation of IFireStorageService.

• Initial release of reusable_editor package.