Files
pipelines/app/lib/features/terminal/terminal_shortcuts.dart
T
alan fdc730422d Host floating chats on the shell window system
Phase 2.3 and 2.4 of docs/plans/floating-windows.md. A floating chat is a
window of the chat kind over the app's WindowManager, built from the
app-lifetime ChatRuntime, so it shows over every destination and at start
without the Chat destination being built. Float and Dock move the same
keyed view between the tiling and the window host. The pipelines app keeps
one runtime and one ChatWindows; saved chatFloat records (v1 and v2) are
brought over once.

ChatFloatHost, ChatFloatWindow, the float frames and binding, the
controller's float list and FloatingFocusRoot are gone; the workspace only
asks whether a chat is out in a window. Every MenuAnchor targets the root
overlay (guarded by a test), and menus and tooltips name the Alt chords.
2026-11-10 21:17:40 +00:00

82 lines
3.0 KiB
Dart

import 'package:flutter/foundation.dart';
import 'package:flutter/services.dart';
/// Whether [event] shows or hides the terminal: Alt+T, Ctrl+T, Cmd+T
/// (Meta+T) or Ctrl+` (Shift allowed only with Ctrl+`). They are global key
/// handlers, so inside the terminal they toggle rather than reaching the
/// shell (whose Ctrl+T, transpose-chars, is then not available) and inside
/// text fields they toggle rather than type.
///
/// A held chord's repeats match too (and are swallowed); only its first
/// press toggles.
bool terminalToggleShortcut(KeyEvent event, HardwareKeyboard keyboard) {
if (event is KeyUpEvent) return false;
final control = keyboard.isControlPressed;
final meta = keyboard.isMetaPressed;
final alt = keyboard.isAltPressed;
if (event.logicalKey == LogicalKeyboardKey.backquote) {
// Cmd+` is the macOS window switcher.
return control && !meta && !alt;
}
// Option+T types a symbol (†) on a Mac, so with Alt the key is also
// recognised by its position.
final t =
event.logicalKey == LogicalKeyboardKey.keyT ||
alt && event.physicalKey == PhysicalKeyboardKey.keyT;
if (!t || keyboard.isShiftPressed) return false;
return [control, meta, alt].where((pressed) => pressed).length == 1;
}
/// The step Ctrl+Tab (1) or Ctrl+Shift+Tab (-1) moves between terminal
/// tabs (again as it repeats), or null for any other key.
int? terminalTabShortcut(KeyEvent event, HardwareKeyboard keyboard) {
if (event is KeyUpEvent ||
event.logicalKey != LogicalKeyboardKey.tab ||
!keyboard.isControlPressed ||
keyboard.isMetaPressed ||
keyboard.isAltPressed) {
return null;
}
return keyboard.isShiftPressed ? -1 : 1;
}
/// The terminal's shortcuts as they work on this platform, for its tooltip
/// and menu. A browser tab never receives Cmd+T, Ctrl+Tab or Ctrl+Shift+Tab
/// (new tab, next and previous tab), nor Ctrl+T outside macOS, where it
/// also opens a tab; native builds get them all.
class TerminalShortcutLabels {
const TerminalShortcutLabels({required this.web, required this.platform});
TerminalShortcutLabels.current()
: web = kIsWeb,
platform = defaultTargetPlatform;
final bool web;
final TargetPlatform platform;
bool get _apple =>
platform == TargetPlatform.macOS || platform == TargetPlatform.iOS;
/// The keys that show or hide the terminal. The Alt chord leads (the
/// button's tooltip names it): every platform and browser delivers it.
List<String> get toggle => [
_apple ? 'Option+T' : 'Alt+T',
if (!web && _apple) 'Cmd+T',
if (!web || _apple) 'Ctrl+T',
'Ctrl+`',
];
/// The keys that move between tabs, or none where the browser keeps them.
List<String> get tabs =>
web ? const [] : const ['Ctrl+Tab', 'Ctrl+Shift+Tab'];
/// The toggle button's tooltip.
String get button => 'Terminal (${toggle.first})';
/// Every shortcut, one per line, for the terminal's menu.
String get summary => [
'Show or hide: ${toggle.join(', ')}',
if (tabs.isNotEmpty) 'Next or previous tab: ${tabs.join(' / ')}',
].join('\n');
}