Files
pipelines/app/lib/features/changes/widgets/changes_viewer.dart
T
alan 963adec122 Float glass tab bars everywhere the app has bottom tabs
One floating frosted tab bar (host NavigationBar / CupertinoTabBar in the
shared GlassPill) replaces the NavigationRail, the Cupertino sidebar and the
run detail, stage page and pipeline detail tab strips. Below 600px it spans
the width minus 16px margins; wider it is sized to its tabs at the right edge.
Content keeps the full width, scrolls behind the bar and learns its height as
bottom media padding; lists pad their end clear of it and FABs sit above it.

The bar now sizes itself from its own constraints instead of the screen size,
which fixes the widget_test failure where a MediaQuery without a size gave it
negative width constraints.
2026-10-31 01:50:42 +00:00

223 lines
8.4 KiB
Dart

import 'package:flutter/material.dart';
import '../../../core/api_gateway.dart';
import '../domain/change_capture.dart';
import '../domain/change_wording.dart';
import '../domain/file_change.dart';
import '../domain/run_changes.dart';
import 'capture_section.dart';
import 'change_style.dart';
import 'file_diff_viewer.dart';
import 'visit_pager.dart';
import '../../../ui/adaptive/floating_bar_layout.dart';
/// The run's Changes surface: an honest final-state summary followed by the
/// recorded stage/visit captures, with changed-filename filtering and the
/// reusable single-file diff viewer.
///
/// The run-wide header and filter always describe the whole run. Below them the
/// viewer shows one recorded visit at a time and offers Previous/Next paging
/// through the rest in run order, so a long run stays readable without changing
/// the aggregate. The shown visit keeps its own stage/visit heading.
///
/// The viewer fills the available height, so give it a bounded parent (a
/// Scaffold body, tab body or Expanded child). It never opens its own socket or
/// requests data; the caller passes the run detail's `steps`.
class ChangesViewer extends StatefulWidget {
const ChangesViewer({
super.key,
required this.steps,
this.showSummary = true,
this.finalOnly = false,
});
/// The run detail's steps exactly as the server returned them. Each step's
/// `file_changes` may be null (no capture), a complete/partial/unavailable
/// capture, or a capture with zero files (a recorded no-change).
///
/// Pass a stable list: the same instance until the server reply changes. The
/// captures and the summary are derived from it rather than on every rebuild.
final List<JsonMap> steps;
/// Whether the run-wide final-state header and filter are shown. The web
/// client gates its aggregate on [showRunChangesSummary]; the per-stage
/// sections stay the evidence for a run without a settled final state.
final bool showSummary;
/// The run's final changes only: the summary and every changed path once,
/// as the last recorded visit left it, with no visit pages.
final bool finalOnly;
@override
State<ChangesViewer> createState() => _ChangesViewerState();
}
class _ChangesViewerState extends State<ChangesViewer> {
late List<StageCapture> _captures;
late RunChanges _run;
/// The zero-based position of the shown visit in [_captures] (run order).
/// The page opens at the first recorded visit; Previous/Next never wrap.
int _visitIndex = 0;
@override
void initState() {
super.initState();
_derive();
}
@override
void didUpdateWidget(ChangesViewer oldWidget) {
super.didUpdateWidget(oldWidget);
// Filter keystrokes rebuild this widget with the same steps list; only a
// new server reply re-derives the captures and the aggregate.
if (!identical(oldWidget.steps, widget.steps)) _derive();
}
void _derive() {
_captures = stageCaptures(widget.steps);
_run = runChangesFor(_captures);
// A fresh reply may have fewer recorded visits; never point past the end.
_visitIndex = _clampVisit(_visitIndex, _captures.length);
}
static int _clampVisit(int index, int count) {
if (count <= 0 || index < 0) return 0;
return index >= count ? count - 1 : index;
}
void _stepVisit(int delta) {
final next = _clampVisit(_visitIndex + delta, _captures.length);
if (next == _visitIndex) return;
setState(() => _visitIndex = next);
}
/// No filter field: the visit lists every file its capture recorded.
static const _query = '';
@override
Widget build(BuildContext context) {
final run = _run;
final captures = _captures;
final showSummary = widget.showSummary;
final hasFiles = captures.any(
(visit) => visit.capture?.files.isNotEmpty ?? false,
);
final note = showSummary ? runChangesNote(run) : '';
final visit = captures.isEmpty ? null : captures[_visitIndex];
return Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
if (showSummary)
Padding(
padding: const EdgeInsets.fromLTRB(16, 16, 16, 8),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
ChangeStatText(
runChangesHeader(run),
style: Theme.of(context).textTheme.titleMedium,
),
if (note.isNotEmpty)
Padding(
padding: const EdgeInsets.only(top: 4),
child: Text(
note,
style: Theme.of(context).textTheme.bodySmall,
),
),
if (hasFiles)
Padding(
padding: const EdgeInsets.only(top: 8),
child: Text(
widget.finalOnly
? 'Each path once, as the last recorded visit left '
'it. A stage\'s own changes are in its timeline '
'detail.'
: 'The summary counts each path once, as the last '
'recorded visit left it. Each stage/visit page '
'below lists what its own capture recorded.',
style: Theme.of(context).textTheme.bodySmall,
),
),
],
),
),
if (showSummary) const Divider(height: 1),
// The run's final changes: every changed path once, as it ended.
if (widget.finalOnly)
Expanded(
child: run.files.isEmpty
? SingleChildScrollView(
padding: withFloatingBarClearance(
context,
const EdgeInsets.all(16),
),
child: Text(noChangeDetail(run)),
)
: ListView(
key: const ValueKey<String>('changes-final'),
children: [
for (final file in run.files)
ChangeFileRow(
key: ValueKey<String>('change-final-${file.path}'),
file: file,
onOpen: (file) => showFileDiffViewer(
context,
file,
files: run.files,
),
),
],
),
),
if (!widget.finalOnly)
Expanded(
child: visit == null
? SingleChildScrollView(
padding: withFloatingBarClearance(
context,
const EdgeInsets.all(16),
),
child: Text(noChangeDetail(run)),
)
: SingleChildScrollView(
// Keying the body by visit keeps each page's pager and heading
// at the top instead of inheriting the previous scroll offset.
key: ValueKey<String>(
'changes-visit-${visit.stage}-${visit.sequence}',
),
padding: withFloatingBarClearance(context, EdgeInsets.zero),
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
StageCaptureSection(
stage: visit,
query: _query,
// The page steps through the files this visit shows.
onOpen: (file) => showFileDiffViewer(
context,
file,
files: filterFileChanges(
visit.capture?.files ?? const <FileChange>[],
_query,
),
),
),
],
),
),
),
// Previous/next visit sit at the bottom right, under the visit.
if (!widget.finalOnly && visit != null)
ChangesVisitPager(
index: _visitIndex,
count: captures.length,
onPrevious: () => _stepVisit(-1),
onNext: () => _stepVisit(1),
),
],
);
}
}