Refactored components

lib/presentation/widgets/text_input/custom_search_bar.dart

@@ -1,16 +1,16 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
+/// A custom search bar widget that encapsulates a [SearchBar] with additional customization options.
+/// - [controller]: The controller for the search bar's text input.
+/// - [hintText]: The hint text displayed in the search bar when it is empty.
+/// - [trailingButtonShown]: Whether to show the trailing button.
+/// - [trailingButtonicon]: The icon for the trailing button.
+/// - [trailingButtonEnabled]: Whether the trailing button is in enabled state.
+/// - [onTrailingButtonPressed]: The callback invoked when the trailing button is pressed.
+/// - [onChanged]: The callback invoked when the text in the search bar changes.
+/// - [constraints]: The constraints for the search bar.
 class CustomSearchBar extends StatelessWidget {
-  final TextEditingController controller;
-  final String hintText;
-  final ValueChanged<String>? onChanged;
-  final BoxConstraints? constraints;
-  final bool trailingButtonShown;
-  final bool trailingButtonEnabled;
-  final VoidCallback? onTrailingButtonPressed;
-  final IconData trailingButtonicon;
-
   const CustomSearchBar({
     super.key,
     required this.controller,
@@ -23,6 +23,30 @@ class CustomSearchBar extends StatelessWidget {
     this.constraints,
   });
 
+  /// The controller for the search bar's text input.
+  final TextEditingController controller;
+
+  /// The hint text displayed in the search bar when it is empty.
+  final String hintText;
+
+  /// Whether to show the trailing button.
+  final bool trailingButtonShown;
+
+  /// The icon for the trailing button.
+  final IconData trailingButtonicon;
+
+  /// Whether the trailing button is in enabled state.
+  final bool trailingButtonEnabled;
+
+  /// The callback invoked when the trailing button is pressed.
+  final VoidCallback? onTrailingButtonPressed;
+
+  /// The callback invoked when the text in the search bar changes.
+  final ValueChanged<String>? onChanged;
+
+  /// The constraints for the search bar.
+  final BoxConstraints? constraints;
+
   @override
   Widget build(BuildContext context) {
     return SearchBar(

lib/presentation/widgets/text_input/text_input_field.dart

@@ -1,11 +1,11 @@
 import 'package:flutter/material.dart';
 import 'package:game_tracker/core/custom_theme.dart';
 
+/// A custom text input field widget that encapsulates a [TextField] with specific styling.
+/// - [controller]: The controller for the text input field.
+/// - [onChanged]: The callback invoked when the text in the field changes.
+/// - [hintText]: The hint text displayed in the text input field when it is empty
 class TextInputField extends StatelessWidget {
-  final TextEditingController controller;
-  final ValueChanged<String>? onChanged;
-  final String hintText;
-
   const TextInputField({
     super.key,
     required this.controller,
@@ -13,6 +13,15 @@ class TextInputField extends StatelessWidget {
     this.onChanged,
   });
 
+  /// The controller for the text input field.
+  final TextEditingController controller;
+
+  /// The callback invoked when the text in the field changes.
+  final ValueChanged<String>? onChanged;
+
+  /// The hint text displayed in the text input field when it is empty.
+  final String hintText;
+
   @override
   Widget build(BuildContext context) {
     return TextField(