From 4412bcf4e274911e655a17afd2763ee3a18b5c07 Mon Sep 17 00:00:00 2001
From: futpib <futpib@gmail.com>
Date: Fri, 27 Feb 2026 15:53:42 +0000
Subject: [PATCH] feat: add scrollPhysics parameter to TerminalView

Allow callers to override the scroll physics of the internal Scrollable
widget. This is useful when embedding TerminalView inside other
scrollable containers or combining it with pinch-to-zoom gestures,
where the internal scroll gesture recognizer would otherwise win the
gesture arena. Passing NeverScrollableScrollPhysics() disables the
internal scroll handling so the host app can manage scrolling externally
via scrollController.
---
 lib/src/terminal_view.dart | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/lib/src/terminal_view.dart b/lib/src/terminal_view.dart
index d5f519f5..78c3c641 100644
--- a/lib/src/terminal_view.dart
+++ b/lib/src/terminal_view.dart
@@ -48,6 +48,7 @@ class TerminalView extends StatefulWidget {
     this.readOnly = false,
     this.hardwareKeyboardOnly = false,
     this.simulateScroll = true,
+    this.scrollPhysics,
   });
 
   /// The underlying terminal that this widget renders.
@@ -141,6 +142,10 @@ class TerminalView extends StatefulWidget {
   /// emulators. True by default.
   final bool simulateScroll;
 
+  /// Custom scroll physics for the terminal's scrollable. If not provided,
+  /// default scroll physics will be used.
+  final ScrollPhysics? scrollPhysics;
+
   @override
   State<TerminalView> createState() => TerminalViewState();
 }
@@ -219,6 +224,7 @@ class TerminalViewState extends State<TerminalView> {
     Widget child = Scrollable(
       key: _scrollableKey,
       controller: _scrollController,
+      physics: widget.scrollPhysics,
       viewportBuilder: (context, offset) {
         return _TerminalView(
           key: _viewportKey,