import 'package:flutter/cupertino.dart'; import 'package:flutter/material.dart'; import '../../../core/api_gateway.dart'; import '../domain/graph_definition.dart'; import '../layout/layout_models.dart'; import '../layout/linear_graph_layout.dart'; import '../routing/route_models.dart'; import '../viewport/graph_expanded_view.dart'; import '../viewport/graph_viewport.dart'; import '../viewport/graph_viewport_controller.dart'; import 'definition_graph_canvas.dart'; import 'graph_canvas_style.dart'; import 'graph_measurements.dart'; /// The definition's own empty-state wording (web `PIPELINE_GRAPH_EMPTY`). const String definitionGraphEmpty = 'This pipeline has no stages.'; /// The expanded definition presentation's title. const String definitionGraphExpandedTitle = 'Pipeline graph'; /// One pipeline definition as a readable native graph: measured stage nodes, /// routed passive edges behind them and native outcome labels on their boxes. /// /// [selectedStage] is a node key (including `#success`/`#failure`) and /// [onSelected] reports the exact key activated. Nothing reads run evidence: /// nodes show no status and terminals stay plain, so no visit is implied. The /// view fills bounded caller constraints with a pan/zoom [GraphViewport] and can /// present the same canvas full screen without losing the selection. class DefinitionGraphView extends StatefulWidget { const DefinitionGraphView({ super.key, required this.graph, required this.onSelected, this.selectedStage, }); final JsonMap graph; final String? selectedStage; final ValueChanged onSelected; @override State createState() => _DefinitionGraphViewState(); } class _DefinitionGraphViewState extends State { final Map _nodeSizes = {}; final Map _labelSizes = {}; final GraphViewportController _viewport = GraphViewportController(); TextScaler? _scaler; bool _rebuildScheduled = false; @override void dispose() { _viewport.dispose(); super.dispose(); } @override void didChangeDependencies() { super.didChangeDependencies(); // A different text scale changes every measured extent; drop the old // extents so a stale 1x layout is never rendered around 2x text. final scaler = MediaQuery.textScalerOf(context); if (scaler != _scaler) { _scaler = scaler; _nodeSizes.clear(); _labelSizes.clear(); } } /// Records one measured extent and schedules the frame that uses it. void _record(Map sizes, String key, Size size) { if (sizes[key] == size) return; sizes[key] = size; if (_rebuildScheduled) return; _rebuildScheduled = true; WidgetsBinding.instance.addPostFrameCallback((_) { _rebuildScheduled = false; if (mounted) setState(() {}); }); } /// The landed layout and routing for the measured extents, or null until /// every node and every edge label has a real measurement. (GraphLayout, GraphRouting)? _geometry( List nodes, List edges, ) { final extents = {}; for (final node in nodes) { final size = _nodeSizes[node.key]; if (size == null) return null; extents[node.key] = NodeExtent(width: size.width, height: size.height); } final labelExtents = {}; for (final edge in edges) { final size = _labelSizes[edge.label]; if (size == null) return null; labelExtents[edge.id] = LabelExtent( width: size.width, height: size.height, ); } // The web's linear drawing: stages in one row, the ends below it. final (layout, routing) = layoutLinearGraph( nodes: nodes, edges: edges, extents: extents, labelExtents: labelExtents, ); return (layout, routing); } @override Widget build(BuildContext context) { final nodes = graphNodes(widget.graph); final edges = graphEdges(widget.graph); final style = GraphCanvasStyle.of(context); return LayoutBuilder( builder: (context, constraints) { assert( constraints.hasBoundedWidth && constraints.hasBoundedHeight, 'DefinitionGraphView needs a bounded viewport; constrain it, for ' 'example with a SizedBox or an Expanded slot.', ); final geometry = nodes.isEmpty ? null : _geometry(nodes, edges); return Stack( fit: StackFit.expand, children: [ if (nodes.isEmpty) _message(definitionGraphEmpty, style) else if (geometry != null) _canvas(nodes, geometry.$1, geometry.$2, style) else const SizedBox.shrink(), if (nodes.isNotEmpty) GraphMeasurements( nodes: nodes, edges: edges, maxNodeWidth: constraints.maxWidth, labelStyle: style.labelStyle, selectedStage: widget.selectedStage, onNodeSize: (key, size) => _record(_nodeSizes, key, size), onLabelSize: (key, size) => _record(_labelSizes, key, size), ), ], ); }, ); } Widget _message(String message, GraphCanvasStyle style) { return Padding( padding: const EdgeInsets.all(24), child: Align( alignment: AlignmentDirectional.topStart, child: Text(message, style: style.messageStyle), ), ); } Widget _canvas( List nodes, GraphLayout layout, GraphRouting routing, GraphCanvasStyle style, ) { final size = Size(routing.width, routing.height); return Column( crossAxisAlignment: CrossAxisAlignment.stretch, children: [ Expanded( child: GraphViewport( controller: _viewport, contentSize: size, onExpand: () => _openExpanded(nodes, layout, routing, size), child: DefinitionGraphCanvas( nodes: nodes, layout: layout, routing: routing, style: style, selectedStage: widget.selectedStage, onSelected: widget.onSelected, ), ), ), if (routing.skipped.isNotEmpty) Flexible( child: SingleChildScrollView( child: _message( [ for (final diagnostic in routing.skipped) '${diagnostic.source} → ${diagnostic.outcome}: ' '${diagnostic.message}', ].join('\n'), style, ), ), ), ], ); } /// Opens the same measured canvas full screen, keeping the selection. void _openExpanded( List nodes, GraphLayout layout, GraphRouting routing, Size size, ) { openGraphExpanded( context, contentSize: size, title: definitionGraphExpandedTitle, selectedStage: widget.selectedStage, onSelected: widget.onSelected, canvasBuilder: (context, selected, onSelected) => DefinitionGraphCanvas( nodes: nodes, layout: layout, routing: routing, style: GraphCanvasStyle.of(context), selectedStage: selected, onSelected: onSelected, ), ); } }