Files
pipelines/app/lib/features/terminal/terminal_panel.dart
T
alan 30934aa71c Toggle the terminal with Alt/Ctrl/Cmd+T, animate it, focus it, and cycle its tabs with Ctrl+Tab
Alt+T, Ctrl+T and Cmd+T join Ctrl+` as early focus-manager key handlers, so
they toggle the panel, window or narrow page from anywhere without reaching
the shell or a text field. Opening with no terminal starts one. The shown
terminal takes the keyboard (also on reload and tab changes) and hiding gives
it back. The panel slides from the bottom edge as the app shrinks, the window
scales and fades, both on Motion.standard and off under reduced motion.
While shown, Ctrl+Tab/Ctrl+Shift+Tab move between terminal tabs instead of
chat panes. The tooltip and menu list the shortcuts the platform delivers.
2026-11-09 23:43:56 +00:00

165 lines
5.2 KiB
Dart

import 'dart:async';
import 'package:flutter/cupertino.dart';
import 'package:flutter/gestures.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import '../../ui/adaptive/resize_grip.dart';
import 'terminal_body.dart';
import 'terminal_hub.dart';
import 'terminal_layout.dart';
import 'terminal_tab_strip.dart';
/// Arrow-key step of the panel's resize handle.
const double terminalPanelKeyStep = 24;
/// Space the docked panel always leaves the app above it.
const double terminalPanelAppMin = 160;
/// [height] within what a window [available] tall allows the panel.
double terminalPanelHeight(double height, double available) {
final max = (available - terminalPanelAppMin).clamp(
terminalPanelMinHeight,
double.infinity,
);
return height.clamp(terminalPanelMinHeight, max);
}
/// The terminal docked at the bottom of the window, filling the height its
/// parent gives it (the layout's, see [terminalPanelHeight]): a resize
/// handle on its top edge (drag, or the arrow keys), the tabs and the
/// selected terminal.
class TerminalPanel extends StatefulWidget {
const TerminalPanel({
super.key,
required this.hub,
required this.layout,
required this.cupertino,
required this.available,
this.focus,
});
final TerminalHub hub;
final TerminalLayout layout;
final bool cupertino;
/// The height of the window the panel shares with the app.
final double available;
/// The terminal's focus scope (see [TerminalBody.focus]).
final FocusScopeNode? focus;
@override
State<TerminalPanel> createState() => _TerminalPanelState();
}
class _TerminalPanelState extends State<TerminalPanel> {
bool _active = false;
double get _height =>
terminalPanelHeight(widget.layout.panelHeight, widget.available);
void _resize(double height, {bool save = true}) =>
widget.layout.setPanelHeight(
terminalPanelHeight(height, widget.available),
save: save,
);
String _describe(double height) =>
'${terminalPanelHeight(height, widget.available).round()} pixels';
KeyEventResult _key(FocusNode _, KeyEvent event) {
if (event is! KeyDownEvent && event is! KeyRepeatEvent) {
return KeyEventResult.ignored;
}
if (event.logicalKey == LogicalKeyboardKey.arrowUp) {
_resize(_height + terminalPanelKeyStep);
} else if (event.logicalKey == LogicalKeyboardKey.arrowDown) {
_resize(_height - terminalPanelKeyStep);
} else {
return KeyEventResult.ignored;
}
return KeyEventResult.handled;
}
@override
Widget build(BuildContext context) {
final height = _height;
final handle = Semantics(
identifier: 'terminal-panel-resize',
label: 'Terminal height',
hint: 'Drag, or use the arrow keys, to resize the terminal',
slider: true,
value: _describe(height),
increasedValue: _describe(height + terminalPanelKeyStep),
decreasedValue: _describe(height - terminalPanelKeyStep),
onIncrease: () => _resize(height + terminalPanelKeyStep),
onDecrease: () => _resize(height - terminalPanelKeyStep),
child: Focus(
onKeyEvent: _key,
onFocusChange: (value) => setState(() => _active = value),
child: MouseRegion(
cursor: SystemMouseCursors.resizeRow,
child: GestureDetector(
key: const ValueKey('terminal-panel-resize'),
behavior: HitTestBehavior.opaque,
excludeFromSemantics: true,
dragStartBehavior: DragStartBehavior.down,
onVerticalDragStart: (_) => setState(() => _active = true),
onVerticalDragUpdate: (details) =>
_resize(_height - details.delta.dy, save: false),
onVerticalDragEnd: (_) {
setState(() => _active = false);
unawaited(widget.layout.save());
},
child: Padding(
padding: const EdgeInsets.symmetric(vertical: 4),
child: Center(
child: AdaptiveResizeGrip(compact: true, emphasized: _active),
),
),
),
),
),
);
final surface = widget.cupertino
? CupertinoColors.systemBackground.resolveFrom(context)
: Theme.of(context).colorScheme.surfaceContainerLow;
final divider = widget.cupertino
? CupertinoColors.separator.resolveFrom(context)
: Theme.of(context).colorScheme.outlineVariant;
return Semantics(
container: true,
label: 'Terminal panel',
child: DecoratedBox(
decoration: BoxDecoration(
color: surface,
border: Border(top: BorderSide(color: divider)),
),
child: Material(
type: MaterialType.transparency,
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
handle,
TerminalTabStrip(
hub: widget.hub,
layout: widget.layout,
cupertino: widget.cupertino,
),
Expanded(
child: TerminalBody(
hub: widget.hub,
cupertino: widget.cupertino,
focus: widget.focus,
),
),
],
),
),
),
);
}
}