Breaking #

• Builder signature changed: SilkyScrollWidgetBuilder now receives a 4th parameter PointerDeviceKind? pointerDeviceKind, allowing widgets to adapt their behavior based on the detected input device.
• Removed bubbling option: Scroll bubbling to parent views is now seamlessly integrated into the default edge-locking logic, providing a much more natural nested-scroll experience without any configuration.

Added #

• decayLogFactor parameter — controls the exponential-decay log factor for smooth-scroll convergence speed (default: 12).
• recoilDurationSec parameter — controls the duration of the bounce-back (recoil) animation in seconds (default: 0.2).
• setManualPointerDeviceKind callback — allows manually overriding the detected pointer device kind for custom input handling.
• Exported kDefaultDecayLogFactor and kDefaultRecoilDurationSec constants from barrel file.

Changed #

• Scroll bubbling is now handled automatically within the core edge-locking state machine, eliminating the need for a separate configuration option and delivering smoother transitions in nested scroll views.
• Recoil (bounce-back) animation and overshoot clamping now only activate when the widget's scroll physics is BouncingScrollPhysics. Non-bouncing physics (e.g. ClampingScrollPhysics) no longer overshoot scroll extents or trigger recoil.

Fixed #

• Fixed include_file_not_found warning in example analysis_options.yaml by replacing deprecated flutter_lints with lints.
• Removed unnecessary package:flutter/scheduler.dart import in SilkyScrollState (already provided by material.dart).
• Removed unused package:flutter/foundation.dart import in input handler tests.
• Replaced unnecessary lambdas with tear-offs in state tests.

Changed #

• Ticker-based animation engine: Replaced per-event controller.animateTo() with a single Ticker + jumpTo() loop using frame-rate-independent exponential smoothing. Eliminates the stutter caused by repeatedly cancelling and restarting easing curves on rapid mouse-wheel input.
• Targeted rebuild: Replaced ListenableBuilder (which rebuilt the entire widget subtree on every notifyListeners()) with a dedicated _onPhysicsChanged listener that calls setState only when the ScrollPhysics reference actually changes.
• Recoil animation: Bounce-back (recoil) to edge now runs inside the same Ticker using Curves.easeInOutSine interpolation, avoiding a separate animateTo() call that could conflict with ongoing scroll animations.

Fixed #

• Overscroll bounce-back stutter: Added silkyTickerActive flag to SilkyScrollPosition that suppresses goBallistic() while the Ticker is running. Previously, each jumpTo() during overscroll triggered Flutter's BouncingScrollPhysics spring simulation, which fought with the Ticker every frame — causing visible jitter at both top and bottom edges.

Fixed #

• onScroll and onEdgeOverScroll callbacks were not passed from SilkyScroll widget to SilkyScrollState, causing them to always be null.
• onEdgeOverScroll was never invoked; it is now called when mouse-wheel or touch/trackpad scroll reaches an edge.

Breaking #

• Removed provider dependency; replaced with InheritedWidget + ListenableBuilder.
• Applied Dart 3 final class / abstract interface class modifiers to all public classes. External extends / implements is no longer permitted for concrete types.
• Exported ScrollPhysicsPhase enum from barrel file.

Added #

• SilkyScrollConfig.copyWith, ==, hashCode, and toString.
• SilkyScrollMousePointerManager.resetForTesting (@visibleForTesting).
• SilkyScrollWebManagerInterface.isWebPlatform for conditional-import–based platform detection.
• SilkyEdgeDetector: sub-pixel edge detection using threshold instead of toInt().
• State machine _transitionTo now guards against Timer creation after dispose.
• SilkyScrollController.attach/detach guard against duplicate position registration.
• Test infrastructure: test/helpers/test_helpers.dart shared utilities.
• New tests for SilkyScrollAnimator, SilkyInputHandler, SilkyScrollConfig, and integration tests (67 total, up from 24).

Changed #

• kIsWeb runtime branching in SilkyInputHandler replaced with conditional-import pattern via isWebPlatform.
• ListenableBuilder rebuild scope reduced: onAnimationStateChanged no longer triggers unnecessary widget rebuilds for recoil state.
• Dispose order in SilkyScrollState made deterministic and safe.
• Edge-detection refactored to switch expression / pattern matching (Dart 3).
• SilkyScrollAnimator._handleRecoil refactored to switch expression.
• Web helper magic number Duration(milliseconds: 700) extracted to _kOverscrollBehaviorXResetDelay constant.
• Lint configuration upgraded from flutter_lints to package:lints/recommended.yaml with custom rules.
• Example restructured to example/lib/main.dart + example/pubspec.yaml (pub.dev guideline).
• README image paths updated from Bluebar1/dyn_mouse_scroll to Dynaruid/silky_scroll.

Removed #

• Legacy duplicate source files under lib/ root (moved to lib/src/ in Phase 1).

Fixed #

• _unlockScroll now correctly transitions _physicsPhase back to ScrollPhysicsPhase.normal.
• _transitionTo checks _disposed before creating a new Timer.

Added #

• Support for Android's scroll stretch effect.

Changed #

• Applied dart format.

Fixed #

• Removed usage of Platform from dart:io due to compatibility issues causing errors on Safari in iOS 18.2.

Fixed #

• Fixed bug about web import.

Added #

• Added an option to configure whether scroll bubbling is propagated when an inner scroll view reaches its edge within nested scroll views.

Changed #

• General updates.

Changed #

• Updated README.

Fixed #

• Fixed drag bug.

Changed #

• Adjusted duration of scroll momentum.

Changed #

• Adjusted duration of scroll momentum.

Changed #

• The duration of scroll momentum transferred to the parent widget has been adjusted to behave more naturally.

Added #

• Enhanced scroll behavior for touch interfaces. When the scrollable content reaches the edge during an ongoing scroll gesture, if the parent widget is also scrollable, the scroll momentum is seamlessly transferred to the parent widget.

Changed #

• Changed the method of specifying the scroll duration.

Changed #

• Adjusted the interval of the scroll lock timer.

Added #

• Web support improvements.

Added #

• Web support.

Added #

• Initial release.