Merge branch 'dev'

Author: maheshj01

CHANGELOG.md

@@ -1,3 +1,8 @@
+### [1.3.2] - May 23, 2025
+
+- Add SearchInputDecoration.hint and SearchInputDecoration.maintainHintSize (Supports Flutter 3.32)
+- hint is deprecated, Use SearchInputDecoration.hintText instead.
+
 ### [1.3.1] - May 16, 2025
 
 - Fix [Issue: #231](https://github.com/maheshj01/searchfield/issues/232) Overlay rebuild on window resize was slow
@@ -12,17 +17,31 @@
 - Fix [Issue: #212](https://github.com/maheshj01/searchfield/issues/212) add new parameter `keepSearchOnSelection`
 - Fix [Issue: #228](https://github.com/maheshj01/searchfield/issues/212) add value parameter to searchfield list item
 
-### [1.2.8] - May 03, 2025
+### [1.3.0-dev.5] - May 03, 2025
+
+- Fix [Issue: #218](https://github.com/maheshj01/searchfield/issues/218) FocusNode listener is not removed
+
+### [1.3.0-dev.4] - May 03, 2025
 
 - Fix [Issue: #222](https://github.com/maheshj01/searchfield/issues/222) Suggestion overlay dimensions not updated on resize
 - Fix [Issue: #224](https://github.com/maheshj01/searchfield/issues/224) calling setState in listener caused setState exception
+- Add VisualDensity Parameter to SearchInputDecoration
 - Fix [Issue: #218](https://github.com/maheshj01/searchfield/issues/218) FocusNode listener is not removed
 
-### [1.2.7] - Apr 16, 2025
+### [1.3.0-dev.3] - Apr 16, 2025
 
 - Allow onSearchTextChanged to serve Future [Issue #215](https://github.com/maheshj01/searchfield/issues/215)
 - Dynamic height is broken when the suggestion direction is up [Issue #216](https://github.com/maheshj01/searchfield/issues/216)
 
+### [1.3.0-dev.2] - Apr 12, 2025
+
+- allow onSearchTextChanged to serve Future [Issue #215](https://github.com/maheshj01/searchfield/issues/215)
+
+### [1.3.0-dev.1] - Mar 19, 2025
+
+- Deprecate `maintainHintHeight` in favour of `maintainHintSize` property of `SearchInputDecoration`
+- Add `hint` property to `SearchInputDecoration`
+
 ### [1.2.6] - Mar 11, 2025
 
 - Fix Range Error on First Suggestion Tap [Issue #210](https://github.com/maheshj01/searchfield/issues/210)

CONTRIBUTING.md

@@ -46,3 +46,16 @@ This part is mainly applicable to the maintainer of the repository but you are w
 - ✅ Publish the package by running `flutter pub publish --dry-run` and `flutter pub publish`
 - Update Min Flutter Sdk Constraints in pubspec.yaml, if a new flutter API is used and mention the version in the changelog.
 - ✅ Tag the release in github with the version number.
+
+
+#### Versioning
+
+This project follows [Semantic Versioning](https://semver.org/). The version X.Y.Z indicates: 
+ 
+  - X is the major version (backward-incompatible),
+  - Y is the minor version (backward-compatible), and
+  - Z is the patch version (backward-compatible bug fix).
+
+  This package has two versions:
+  - Stable version: Compatible with the latest stable version of Flutter.
+  - Pre-release version: Compatible with the latest master/beta version of Flutter generally used for testing purposes.

README.md

@@ -1,4 +1,4 @@
-# [searchfield: ^1.3.1](https://pub.dev/packages/searchfield)
+# [searchfield: ^1.3.2](https://pub.dev/packages/searchfield)
 
 <a href="https://github.com/maheshj01/searchfield" rel="noopener" target="_blank"><img src="https://img.shields.io/badge/platform-flutter-ff69b4.svg" alt="Flutter Platform Badge"></a>
 <a href="https://pub.dev/packages/searchfield"><img src="https://img.shields.io/pub/v/searchfield.svg" alt="Pub"></a>

example/lib/main.dart

@@ -106,14 +106,14 @@ class _SearchFieldSampleState extends State<SearchFieldSample> {
                   borderRadius: BorderRadius.all(Radius.circular(2)),
                   itemPadding: EdgeInsets.symmetric(horizontal: 16),
                 ),
-                hint: 'Search for a city or zip code',
                 maxSuggestionBoxHeight: 300,
                 onSuggestionTap: (SearchFieldListItem<City> item) {
                   setState(() {
                     selectedValue = item;
                   });
                 },
                 searchInputDecoration: SearchInputDecoration(
+                  hintText: 'Search for a city or zip code',
                   prefixIcon: Icon(Icons.search),
                   suffix: Icon(Icons.expand_more),
                   border: OutlineInputBorder(

lib/src/input_decoration.dart

@@ -83,7 +83,13 @@ class SearchInputDecoration extends InputDecoration {
     super.suffixIcon,
     super.suffix,
     super.label,
+    @Deprecated(
+      'Use maintainHintSize instead. '
+      'This will maintain both hint height and hint width. '
+      'This feature was deprecated after v1.26.0',
+    )
     super.maintainHintHeight,
+    super.maintainHintSize,
     super.suffixIconColor,
     super.prefix,
     super.prefixIconColor,
@@ -94,6 +100,7 @@ class SearchInputDecoration extends InputDecoration {
     super.disabledBorder,
     super.contentPadding,
     super.hintText,
+    super.hint,
     super.hintStyle,
     super.labelText,
     super.labelStyle,
@@ -161,6 +168,7 @@ class SearchInputDecoration extends InputDecoration {
     InputBorder? focusedBorder,
     InputBorder? focusedErrorBorder,
     Widget? helper,
+    Widget? hint,
     int? helperMaxLines,
     TextStyle? helperStyle,
     String? helperText,
@@ -191,9 +199,11 @@ class SearchInputDecoration extends InputDecoration {
     BoxConstraints? suffixIconConstraints,
     TextStyle? suffixStyle,
     String? suffixText,
+    bool? maintainHintSize,
   }) {
     return SearchInputDecoration(
       maintainHintHeight: maintainHintHeight ?? this.maintainHintHeight,
+      maintainHintSize: maintainHintSize ?? this.maintainHintSize,
       cursorColor: cursorColor ?? this.cursorColor,
       textCapitalization: textCapitalization ?? this.textCapitalization,
       searchStyle: searchStyle ?? this.searchStyle,
@@ -206,6 +216,7 @@ class SearchInputDecoration extends InputDecoration {
       errorText: errorText ?? this.errorText,
       error: error ?? this.error,
       hintTextDirection: hintTextDirection ?? this.hintTextDirection,
+      hint: hint ?? this.hint,
       hintFadeDuration: hintFadeDuration ?? this.hintFadeDuration,
       helper: helper ?? this.helper,
       cursorErrorColor: cursorErrorColor ?? this.cursorErrorColor,

lib/src/searchfield.dart

@@ -317,6 +317,9 @@ class SearchField<T> extends StatefulWidget {
     this.emptyWidget = const SizedBox(),
     this.enabled,
     this.focusNode,
+    @Deprecated(
+      'Use SearchInputDecoration.hintText instead.',
+    )
     this.hint,
     this.selectedValue,
     this.inputFormatters,
@@ -415,32 +418,7 @@ class _SearchFieldState<T> extends State<SearchField<T>> {
     } else {
       _searchFocus = FocusNode();
     }
-    _searchFocus!.addListener(() {
-      // When focus shifts to ListView prevent suggestions from rebuilding
-      // when user navigates through suggestions using keyboard
-      if (_searchFocus!.hasFocus) {
-        if (searchController!.text.isNotEmpty) {
-          highlightIndex = widget.suggestions
-              .indexWhere((element) => element == widget.selectedValue);
-        }
-        _overlayEntry ??= _createOverlay();
-        if (widget.suggestionState == Suggestion.expand) {
-          isSuggestionsShown = true;
-          Future.delayed(Duration(milliseconds: 100), () {
-            suggestionStream.sink.add(widget.suggestions);
-          });
-        }
-        Overlay.of(context).insert(_overlayEntry!);
-      } else {
-        removeOverlay();
-        if (_suggestionDirection == SuggestionDirection.up) {
-          highlightIndex = length;
-        } else {
-          highlightIndex = -1;
-        }
-        suggestionStream.sink.add(null);
-      }
-    });
+    _searchFocus?.addListener(_handleFocusChange);
   }
 
   /// With SuggestionDirection.flex, the widget will automatically decide the direction of the
@@ -474,6 +452,33 @@ class _SearchFieldState<T> extends State<SearchField<T>> {
     }
   }
 
+  void _handleFocusChange() {
+    // When focus shifts to ListView prevent suggestions from rebuilding
+    // when user navigates through suggestions using keyboard
+    if (_searchFocus!.hasFocus) {
+      if (searchController!.text.isNotEmpty) {
+        highlightIndex = widget.suggestions
+            .indexWhere((element) => element == widget.selectedValue);
+      }
+      _overlayEntry ??= _createOverlay();
+      if (widget.suggestionState == Suggestion.expand) {
+        isSuggestionsShown = true;
+        Future.delayed(Duration(milliseconds: 100), () {
+          suggestionStream.sink.add(widget.suggestions);
+        });
+      }
+      Overlay.of(context).insert(_overlayEntry!);
+    } else {
+      removeOverlay();
+      if (_suggestionDirection == SuggestionDirection.up) {
+        highlightIndex = length;
+      } else {
+        highlightIndex = -1;
+      }
+      suggestionStream.sink.add(null);
+    }
+  }
+
   double _getSuggestionsHeight(Size screenSize) {
     return _totalHeight ??
         widget.maxSuggestionBoxHeight ??
@@ -917,11 +922,6 @@ class _SearchFieldState<T> extends State<SearchField<T>> {
   OverlayEntry _createOverlay() {
     return OverlayEntry(builder: (context) {
       _totalHeight = widget.maxSuggestionsInViewPort * widget.itemHeight;
-      //   final textFieldRenderBox =
-      //     key.currentContext!.findRenderObject() as RenderBox;
-      // final textFieldsize = textFieldRenderBox.size;
-      // final offset = textFieldRenderBox.localToGlobal(Offset.zero);
-      // var yOffset = Offset.zero;
       return LayoutBuilder(
           builder: (BuildContext context, BoxConstraints constraints) {
         _calculateDimensions();

pubspec.yaml

@@ -1,10 +1,11 @@
 name: searchfield
 description: A highly customizable, simple and easy to use AutoComplete widget for your Flutter app
-version: 1.3.1
+version: 1.3.2
 homepage: https://github.com/maheshj01/searchfield
 repository: https://github.com/maheshj01/searchfield
 issue_tracker: https://github.com/maheshj01/searchfield/issues
-
+funding: 
+  - https://github.com/sponsors/maheshj01/
 environment:
   sdk: ">=3.3.0 <4.0.0"
   flutter: ">=3.27.0"

test/searchfield_test.dart

@@ -2254,6 +2254,6 @@ void main() {
     expect(overlayFinder, findsOneWidget);
     expect(overlaySize.width, closeTo(logicalWidth, 0.1));
   });
-
+  
   // todo: add test for `keepSearchOnSelection`
 }