refactor(Overscroll): Refactor overscroll physics (#138)

* Refactors the overscroll effect to use a new damping calculation based on window size, replacing the previous `parabolaScrollEasing` function.
* Updates the `scrollEasing` parameter signature to take `distance` and `range` instead of `currentOffset` and `newOffset`.
* Adjusts the spring stiffness value for a different feel.
* Rewrites the `NestedScrollConnection` implementation to track touch delta and calculate damped offsets, improving the overscroll behavior for scroll and fling gestures.

Author: HChenX

docs/guide/utils.md

@@ -53,7 +53,7 @@ Normally, you don't need to use it actively. See the [ListPopup](../components/l
 
 ## Overscroll Effects
 
-Miuix provides easy-to-use overscroll effects modifier for smoother and more natural scrolling experiences.
+Miuix provides easy-to-use overscroll effect modifiers for smoother and more natural scrolling experiences.
 
 ### Vertical Overscroll
 
@@ -81,19 +81,19 @@ LazyRow(
 
 ### Custom Overscroll Parameters
 
-You can customize the parameters of the overscroll effect to meet specific requirements.
+You can customize the overscroll effect parameters as needed:
 
 ```kotlin
 LazyColumn(
     modifier = Modifier.overScrollVertical(
-        nestedScrollToParent = true, // Whether to dispatch nested scroll events to the parent, default is true
-        scrollEasing = { currentOffset, newOffset -> // Custom scroll easing function
-            parabolaScrollEasing(currentOffset, newOffset, p = 25f, density = LocalDensity.current.density)
+        nestedScrollToParent = true, // Dispatch nested scroll events to parent, default true
+        scrollEasing = { distance, range -> // Custom easing, default effect is similar to HyperOS feel
+            // Example: DefaultParabolaScrollEasing(distance, range)
         },
-        springStiff = 200f, // Spring stiffness for the rebound animation, default is 200f
-        springDamp = 1f,  // Spring damping for the rebound animation, default is 1f
-        isEnabled = { platform() == Platform.Android || platform() == Platform.IOS } // Whether to enable the overscroll effect, enabled by default on Android and iOS
-        ),
+        springStiff = 280f, // Spring stiffness, default 280f
+        springDamp = 1f,    // Spring damping, default 1f
+        isEnabled = { platform() == Platform.Android || platform() == Platform.IOS } // Enable only on Android/iOS by default
+    ),
     overscrollEffect = null // It is recommended to set this parameter to null to disable the default effect
 ) {
     // List content
@@ -102,11 +102,11 @@ LazyColumn(
 
 **Parameter Explanations:**
 
-*   `nestedScrollToParent`: Boolean, controls whether nested scroll events (e.g., from parent scroll containers) are dispatched to the parent. Defaults to `true`.
-*   `scrollEasing`: A function that defines the easing effect when scrolling beyond the bounds. It takes the current offset (`currentOffset`) and the new offset delta (`newOffset`) as parameters and returns the calculated new offset. By default, it uses `parabolaScrollEasing`, providing an iOS-like damping effect.
-*   `springStiff`: Float, defines the spring stiffness for the rebound animation. Higher values result in a faster and stiffer rebound. Defaults to `200f`.
-*   `springDamp`: Float, defines the spring damping for the rebound animation. Higher values result in less oscillation. Defaults to `1f`.
-*   `isEnabled`: A lambda expression returning a Boolean, used to dynamically control whether the overscroll effect is enabled. By default, it is enabled only on Android and iOS platforms.
+*   `nestedScrollToParent`: Boolean, whether to dispatch nested scroll events to parent. Default: `true`.
+*   `scrollEasing`: Function `(distance: Float, range: Int) -> Float`, custom easing， default effect is similar to HyperOS feel.
+*   `springStiff`: Float, spring stiffness for rebound. Default: `280f`.
+*   `springDamp`: Float, spring damping for rebound. Default: `1f`.
+*   `isEnabled`: Lambda, whether to enable overscroll. Default: only Android/iOS.
 
 ## Scroll End Haptic Feedback (Modifier.scrollEndHaptic())
 

docs/zh_CN/guide/utils.md

@@ -81,19 +81,19 @@ LazyRow(
 
 ### 自定义越界回弹参数
 
-您可以自定义越界回弹效果的参数，以满足特定的需求。
+您可以根据需要自定义越界回弹效果的参数：
 
 ```kotlin
 LazyColumn(
     modifier = Modifier.overScrollVertical(
-        nestedScrollToParent = true, // 是否将嵌套滚动事件分发给父级，默认为 true
-        scrollEasing = { currentOffset, newOffset -> // 自定义滚动缓动函数
-            parabolaScrollEasing(currentOffset, newOffset, p = 25f, density = LocalDensity.current.density)
+        nestedScrollToParent = true, // 是否分发嵌套滚动事件到父级，默认 true
+        scrollEasing = { distance, range -> // 自定义回弹阻尼，默认效果类似 HyperOS 手感
+            // 示例：DefaultParabolaScrollEasing(distance, range)
         },
-        springStiff = 200f, // 回弹动画的弹簧刚度，默认为 200f
-        springDamp = 1f,  // 回弹动画的弹簧阻尼，默认为 1f
-        isEnabled = { platform() == Platform.Android || platform() == Platform.IOS } // 是否启用越界回弹效果，默认在 Android 和 iOS 上启用
-    ), 
+        springStiff = 280f, // 回弹弹性系数，默认 280f
+        springDamp = 1f,    // 回弹阻尼系数，默认 1f
+        isEnabled = { platform() == Platform.Android || platform() == Platform.IOS } // 默认仅在 Android/iOS 启用
+    ),
     overscrollEffect = null // 建议将此参数设置为 null，禁用默认效果
 ) {
     // 列表内容
@@ -102,11 +102,11 @@ LazyColumn(
 
 **参数说明:**
 
-*   `nestedScrollToParent`: 布尔值，控制是否将嵌套滚动事件（如父级滚动容器）传递给父级。默认为 `true`。
-*   `scrollEasing`: 一个函数，用于定义滚动超出边界时的缓动效果。它接收当前偏移量 (`currentOffset`) 和新的偏移量增量 (`newOffset`) 作为参数，并返回计算后的新偏移量。默认使用 `parabolaScrollEasing`，提供类似 iOS 的阻尼效果。
-*   `springStiff`: 浮点数，定义回弹动画的弹簧刚度。值越高，回弹越快越硬。默认为 `200f`。
-*   `springDamp`: 浮点数，定义回弹动画的弹簧阻尼。值越高，振荡越小。默认为 `1f`。
-*   `isEnabled`: 一个返回布尔值的 Lambda 表达式，用于动态控制是否启用越界回弹效果。默认情况下，仅在 Android 和 iOS 平台上启用。
+*   `nestedScrollToParent`：布尔值，是否分发嵌套滚动事件到父级。默认：`true`。
+*   `scrollEasing`：函数 `(distance: Float, range: Int) -> Float`，自定义回弹阻尼，默认效果类似 HyperOS 手感。
+*   `springStiff`：浮点数，回弹弹性系数。默认：`280f`。
+*   `springDamp`：浮点数，回弹阻尼系数。默认：`1f`。
+*   `isEnabled`：Lambda，是否启用越界回弹。默认仅 Android/iOS。
 
 ## 滚动到边界触觉反馈 (Modifier.scrollEndHaptic())
 

miuix/src/commonMain/kotlin/top/yukonga/miuix/kmp/utils/G2RoundedCornerShape.kt

@@ -3,7 +3,7 @@
 
 package top.yukonga.miuix.kmp.utils
 
-// Form https://github.com/Kyant0/Capsule
+// Based on https://github.com/Kyant0/Capsule
 
 import androidx.annotation.FloatRange
 import androidx.annotation.IntRange