Files
pipelines/app/lib/features/pipelines/screen.dart
T
alan 8476cfd740 feat(app): wire the native pipelines browser on the shared session
Register the landed PipelinesScreen at /pipelines through AppSession, with
an honest first-connection gate, a native reconnect banner that retains the
open list and detail, and an in-place refresh on reconnect. Move the shared
connection chrome out of RunsDestination so both destinations use one
implementation and one wording.

Add destination, registration and reconnect coverage plus an isolated
loopback Chrome probe that drives the real runPipelinesApp() composition.
2026-10-21 19:47:08 +01:00

197 lines
6.0 KiB
Dart

import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import '../../core/api_gateway.dart';
import 'pipeline_graph_hook.dart';
import 'pipeline_repository.dart';
import 'pipelines_controller.dart';
import 'widgets/pipeline_controls.dart';
import 'widgets/pipeline_detail_panel.dart';
import 'widgets/pipeline_list_panel.dart';
export 'pipeline_graph_hook.dart';
export 'pipeline_models.dart' show PipelineDetail, PipelineVersion;
/// Below this width the list and detail are separate pages; above it they sit
/// side by side. One local breakpoint, not a styling system.
const double kPipelinesWideBreakpoint = 720;
/// The read-only Pipelines destination: list, filters/sort, detail, source and
/// version history.
///
/// [graphBuilder] is the optional integration hook for the later graph item.
/// Without it the Graph tab states that graph rendering is pending.
///
/// Standalone use keeps the screen's own native scaffolding. The application
/// shell sets [embedded] because it already owns the one navigation bar, and
/// supplies [syncToken] so a reconnect refreshes in place.
class PipelinesScreen extends StatefulWidget {
const PipelinesScreen({
super.key,
required this.gateway,
this.graphBuilder,
this.onStageSelected,
this.embedded = false,
this.syncToken = 0,
});
final ApiGateway gateway;
final PipelineGraphBuilder? graphBuilder;
final ValueChanged<PipelineStageRef>? onStageSelected;
/// True under the application shell, which owns the single navigation bar.
final bool embedded;
/// Advances when the shared socket is replaced. The mounted controller
/// reloads the list and the selected detail without losing the selection.
final int syncToken;
@override
State<PipelinesScreen> createState() => _PipelinesScreenState();
}
class _PipelinesScreenState extends State<PipelinesScreen> {
late PipelinesController _controller;
@override
void initState() {
super.initState();
_controller = PipelinesController(PipelinesRepository(widget.gateway))
..load();
}
@override
void didUpdateWidget(PipelinesScreen oldWidget) {
super.didUpdateWidget(oldWidget);
if (oldWidget.gateway != widget.gateway) {
_controller.dispose();
_controller = PipelinesController(PipelinesRepository(widget.gateway))
..load();
} else if (oldWidget.syncToken != widget.syncToken) {
// The socket was replaced; re-read through the existing controller so the
// selected pipeline and requested version survive the reconnect.
_controller.load();
}
}
@override
void dispose() {
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return AnimatedBuilder(
animation: _controller,
builder: (context, _) {
final body = LayoutBuilder(
builder: (context, constraints) {
final wide = constraints.maxWidth >= kPipelinesWideBreakpoint;
if (!wide) {
return _controller.hasSelection
? PipelineDetailPanel(
controller: _controller,
showBack: true,
graphBuilder: widget.graphBuilder,
onStageSelected: widget.onStageSelected,
)
: PipelineListPanel(controller: _controller);
}
return Row(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
Expanded(
flex: 2,
child: PipelineListPanel(controller: _controller),
),
_divider(context),
Expanded(
flex: 3,
child: PipelineDetailPanel(
controller: _controller,
showBack: false,
graphBuilder: widget.graphBuilder,
onStageSelected: widget.onStageSelected,
),
),
],
);
},
);
if (widget.embedded) return _embeddedBody(context, body);
return useCupertinoControls(context)
? _cupertinoShell(context, body)
: _materialShell(context, body);
},
);
}
/// The shell owns the navigation bar here, so the content keeps a native
/// Refresh action without adding a second bar.
Widget _embeddedBody(BuildContext context, Widget body) {
return Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
Align(
alignment: AlignmentDirectional.centerEnd,
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 8),
child: _refreshButton(context),
),
),
Expanded(child: body),
],
);
}
Widget _refreshButton(BuildContext context) {
if (useCupertinoControls(context)) {
return Semantics(
button: true,
label: 'Refresh',
child: CupertinoButton(
padding: EdgeInsets.zero,
onPressed: _controller.load,
child: const Icon(CupertinoIcons.refresh),
),
);
}
return IconButton(
tooltip: 'Refresh',
onPressed: _controller.load,
icon: const Icon(Icons.refresh),
);
}
Widget _divider(BuildContext context) {
if (useCupertinoControls(context)) {
return Container(
width: 1,
color: CupertinoColors.separator.resolveFrom(context),
);
}
return const VerticalDivider(width: 1);
}
Widget _materialShell(BuildContext context, Widget body) {
return Scaffold(
appBar: AppBar(
title: const Text('Pipelines'),
actions: [_refreshButton(context)],
),
body: SafeArea(child: body),
);
}
Widget _cupertinoShell(BuildContext context, Widget body) {
return CupertinoPageScaffold(
navigationBar: CupertinoNavigationBar(
middle: const Text('Pipelines'),
trailing: _refreshButton(context),
),
child: SafeArea(top: false, child: body),
);
}
}