Merge branch 'main' of https://github.com/syncfusion/maui-toolkit into internal_public

# Conflicts:
#	maui/src/BottomSheet/SfBottomSheet.cs
#	maui/tests/Syncfusion.Maui.Toolkit.UnitTest/Navigation/SfBottomSheetUnitTests.cs

Author: naveenkumar-sanjeevirayan

maui/src/BottomSheet/SfBottomSheet.cs

@@ -1201,7 +1201,7 @@ public bool CollapseOnOverlayTap
 		}
 
 		/// <summary> 
-		/// Gets or sets a value that can be used to adjust the duration of the opening and closing animations.
+		/// Gets or sets the duration, in milliseconds, for the opening and closing animations.
 		/// </summary> 
 		/// <value> 
 		/// It accepts double values, and the default value is 150ms.
@@ -1287,9 +1287,12 @@ public void Close()
 		}
 
 		/// <summary>
-		/// Updates the animation duration with the given value.
+		/// Returns the value of <c>AnimationDuration</c>, ensuring it is clamped to a non-negative integer.
+		/// This method is useful when passing the duration to animation APIs that require a <c>uint</c> value,
+		/// preventing issues caused by negative durations.
 		/// </summary>
-		int SetAnimationDuration()
+		/// <returns>A non-negative integer representing the animation duration.</returns>
+		int GetClampedAnimationDuration()
 		{
 			return (int)Math.Max(0, AnimationDuration);
 		}
@@ -2135,13 +2138,13 @@ void AnimateBottomSheet(double targetPosition, Action? onFinish = null)
 				_overlayGrid.AbortAnimation("overlayGridAnimation");
 			}
 
-			int animationDuration =this.SetAnimationDuration();
-		    const int topPadding = 2;
+			int animationDuration = this.GetClampedAnimationDuration();
+			const int topPadding = 2;
 			_isSheetOpen = true;
 			if (_bottomSheet is not null)
 			{
 				var bottomSheetAnimation = new Animation(d => _bottomSheet.TranslationY = d, _bottomSheet.TranslationY, targetPosition + topPadding);
-				_bottomSheet?.Animate("bottomSheetAnimation", bottomSheetAnimation, length: (uint)animationDuration, easing: Easing.Linear, finished: (v, e) =>
+				_bottomSheet?.Animate("bottomSheetAnimation", bottomSheetAnimation, length: (uint)animationDuration, easing: Easing.Linear, finished: (v, e) => 
 				{
 					UpdateBottomSheetHeight();
 					onFinish?.Invoke();
@@ -2177,6 +2180,7 @@ void AnimateOverlay(int animationDuration)
 
 					var overlayGridAnimation = new Animation(d =>
 					{
+						// Ensure the opacity is only updated with valid numeric values to avoid rendering issues.
 						if (!double.IsNaN(d))
 						{
 							_overlayGrid.Opacity = d;

maui/tests/Syncfusion.Maui.Toolkit.UnitTest/Navigation/SfBottomSheetUnitTests.cs

@@ -38,7 +38,7 @@ public void Constructor_InitializesDefaultsCorrectly()
 			Assert.Equal(4d, _bottomSheet.GrabberHeight);
 			Assert.Equal(32d, _bottomSheet.GrabberWidth);
 			Assert.Equal(12d, _bottomSheet.GrabberCornerRadius);
-			Assert.Equal(150d,_bottomSheet.AnimationDuration);
+			Assert.Equal(150d, _bottomSheet.AnimationDuration);
 			if (_bottomSheet.GrabberBackground is SolidColorBrush grabberBrush)
 			{
 				var grabberColor = grabberBrush.Color;
@@ -477,12 +477,12 @@ public void CollapseOnOverlayTap(bool input, bool expected)
 		}
 
 		[Theory]
-		[InlineData(500d,500d)]
-		[InlineData(0d,0d)]
-		[InlineData(-500d,-500d)]
-		public void AnimationDuration(double input, double expected)
+		[InlineData(500d, 500d)]
+		[InlineData(0d, 0d)]
+		[InlineData(-500d, -500d)]
+		public void AnimationDurationProperty_ReturnsSetValue(double input, double expected)
 		{
-			_bottomSheet.AnimationDuration=input;
+			_bottomSheet.AnimationDuration = input;
 
 			var actual = _bottomSheet.AnimationDuration;
 
@@ -749,10 +749,10 @@ public void UpdateGrabberHeightProperty(double input, double expected)
 		}
 
 		[Fact]
-		public void SetAnimationDuration()
+		public void GetClampedAnimationDuration()
 		{
 			_bottomSheet.AnimationDuration = -500;
-			var actual = InvokePrivateMethod(_bottomSheet, "SetAnimationDuration");
+			var actual = InvokePrivateMethod(_bottomSheet, "GetClampedAnimationDuration");
 			Assert.Equal(0, actual);
 		}