Files
pipelines/app/lib/features/search/search_screen.dart
T

213 lines
6.6 KiB
Dart

import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import '../../core/api_gateway.dart';
import '../../shell/shell_bar.dart';
import '../../shell/shell_search_focus.dart';
import '../../ui/adaptive/host.dart';
import '../../ui/adaptive/segmented_bar.dart';
import 'data/search_repository.dart';
import 'domain/search_controller.dart';
import 'ui/cupertino_search_body.dart';
import 'ui/material_search_body.dart';
import 'ui/search_bar_controls.dart';
import 'ui/search_bounds_note.dart';
import 'ui/search_result_view.dart';
/// Native omni-search over the Pipelines server: the search field, a compact
/// kind menu and the syntax help as the top bar's main pill (no title), and a
/// flat result list whose rows open the server's own target through [onOpen].
/// The screen never mutates server state and never guesses a route for an
/// unknown or targetless hit.
class SearchScreen extends StatefulWidget {
const SearchScreen({
super.key,
required this.gateway,
required this.onOpen,
this.cupertino,
this.embedded = false,
});
final ApiGateway gateway;
final ValueChanged<JsonMap> onOpen;
/// Lets the shell state the surface it composed. When omitted, iOS/macOS use
/// Cupertino controls and every other platform uses Material.
final bool? cupertino;
/// True as the Search tab: the controls go into the shell's bar.
final bool embedded;
@override
State<SearchScreen> createState() => _SearchScreenState();
}
class _SearchScreenState extends State<SearchScreen> {
late final OmniSearchController _controller;
late final TextEditingController _text;
final FocusNode _focus = FocusNode(debugLabel: 'omni-search');
@override
void initState() {
super.initState();
_controller = OmniSearchController(
repository: SearchRepository(widget.gateway),
);
_text = TextEditingController();
_controller.addListener(_onState);
}
void _onState() {
final query = _controller.query;
if (_text.text != query) {
_text.value = TextEditingValue(
text: query,
selection: TextSelection.collapsed(offset: query.length),
);
}
if (mounted) setState(() {});
}
void _clear() {
_text.clear();
_controller.updateQuery('');
}
@override
void dispose() {
_controller.removeListener(_onState);
_controller.dispose();
_text.dispose();
_focus.dispose();
super.dispose();
}
bool get _activeSearch {
final scope = ShellBarScope.maybeOf(context);
return scope == null ||
scope.registry.focus == null ||
scope.registry.focus == scope.destination;
}
void _focusSearch() {
final before = FocusManager.instance.primaryFocus;
// The shell moves Search's field into its bar after changing tabs. End an
// old browser edit only after that layout, then hand focus to the mounted
// field. Ordinary query changes never reset focus or the input connection.
WidgetsBinding.instance.addPostFrameCallback((_) {
if (!mounted || !_activeSearch || !_focus.canRequestFocus) return;
final current = FocusManager.instance.primaryFocus;
if (current != null &&
current != before &&
current != _focus &&
current is! FocusScopeNode) {
return;
}
_focus.unfocus();
WidgetsBinding.instance.addPostFrameCallback((_) {
if (!mounted || !_activeSearch || !_focus.canRequestFocus) return;
final current = FocusManager.instance.primaryFocus;
if (current == null ||
current == _focus ||
current == before ||
current is FocusScopeNode) {
_focus.requestFocus();
}
});
WidgetsBinding.instance.ensureVisualUpdate();
});
WidgetsBinding.instance.ensureVisualUpdate();
}
@override
Widget build(BuildContext context) => ShellSearchShortcut(
onFocus: _focusSearch,
hasFocus: () => _focus.hasPrimaryFocus,
child: _build(context),
);
Widget _build(BuildContext context) {
// Follow the actual host app class: Cupertino only under an explicit
// Cupertino host, Material on every platform otherwise.
final cupertino = widget.cupertino ?? usesCupertinoHost(context);
if (widget.embedded) {
// The shell's bar carries the controls; without a shell (a bare embed)
// they lead the results instead.
if (!ShellBar.available(context)) {
return _body(cupertino, controls: _controls(cupertino));
}
// The field takes the title's place and fills the bar.
return ShellBar(
titleWidget: _controls(cupertino),
child: _body(cupertino),
);
}
final bar = SegmentedBar(
cupertino: cupertino,
title: 'Search',
titleWidget: _controls(cupertino),
);
if (cupertino) {
return CupertinoPageScaffold(navigationBar: bar, child: _body(cupertino));
}
return Scaffold(
extendBodyBehindAppBar: true,
appBar: bar,
body: _body(cupertino),
);
}
Widget _controls(bool cupertino) => SearchBarControls(
focusNode: _focus,
cupertino: cupertino,
text: _text,
kind: _controller.parsed.kind,
onChanged: _controller.updateQuery,
onSubmitted: _controller.submit,
onCleared: _clear,
onKind: _controller.selectKind,
);
/// The server's result and scan bounds, only when they cut the answer
/// short: a complete answer needs no statistics.
Widget _header({Widget? controls}) {
final bounds = _controller.truncated ? _controller.boundsText : null;
if (bounds == null && controls == null) return const SizedBox.shrink();
return Padding(
padding: const EdgeInsets.symmetric(vertical: 4),
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
spacing: 8,
children: [
?controls,
if (bounds != null)
SearchBoundsNote(key: searchBoundsKey, text: bounds),
],
),
);
}
/// No top safe area: the results run behind the floating bar and the
/// scroll view starts them below it.
Widget _body(bool cupertino, {Widget? controls}) {
final header = _header(controls: controls);
return SearchArtifactScope(
gateway: widget.gateway,
onOpen: widget.onOpen,
child: cupertino
? CupertinoSearchBody(
controller: _controller,
query: _controller.parsed.query,
onOpen: widget.onOpen,
header: header,
)
: MaterialSearchBody(
controller: _controller,
query: _controller.parsed.query,
onOpen: widget.onOpen,
header: header,
),
);
}
}