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'; /// 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 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 createState() => _ChangesViewerState(); } class _ChangesViewerState extends State { late List _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: const EdgeInsets.all(16), child: Text(noChangeDetail(run)), ) : ListView( key: const ValueKey('changes-final'), children: [ for (final file in run.files) ChangeFileRow( key: ValueKey('change-final-${file.path}'), file: file, onOpen: (file) => showFileDiffViewer( context, file, files: run.files, ), ), ], ), ), if (!widget.finalOnly) Expanded( child: visit == null ? SingleChildScrollView( padding: 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( 'changes-visit-${visit.stage}-${visit.sequence}', ), 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 [], _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), ), ], ); } }