Files
pipelines/app/lib/ui/status/outcome_palette.dart
T
alan 6b11b136db fix(app): meaning colours for common outcomes; detail pages fill the pane
Timeline outcomes: success-like words are green, failures red,
rejections orange, retries/advisories amber, skips/cancellations grey;
a second word of the same family takes the family's next shade and any
other word a distinct hue outside the families, so different outcomes
still never share a colour.
Run detail, stage page and pipeline Summary no longer cap their width
at 840: on an unfolded foldable the sections fill the pane. The unused
ReadingWidth helper is removed.
2026-10-31 14:36:15 +00:00

155 lines
4.9 KiB
Dart

import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
/// Colours for recorded outcome names within one run.
///
/// Well-known outcome words get a colour family that matches their meaning —
/// success-like words are green, failures red, rejections orange, retries and
/// advisories amber, skips and cancellations grey — and every other word gets
/// a distinct hue outside those families, by first appearance. The same name
/// always gets the same colour, and two different names never share one: a
/// second word of the same family takes that family's next shade.
class OutcomePalette {
OutcomePalette(Iterable<String> outcomes) {
final familyUse = <_Family, int>{};
var other = 0;
for (final outcome in outcomes) {
final key = _key(outcome);
if (key.isEmpty || _swatches.containsKey(key)) continue;
final family = _familyOf(key);
if (family != null) {
final used = familyUse[family] ?? 0;
final shades = _familyShades[family]!;
if (used < shades.length) {
familyUse[family] = used + 1;
_swatches[key] = _Swatch.material(shades[used]);
continue;
}
}
_swatches[key] = other < _otherHues.length
? _Swatch.material(_otherHues[other])
: _Swatch.wheel(other);
other += 1;
}
}
final Map<String, _Swatch> _swatches = {};
static String _key(String outcome) => outcome.trim().toLowerCase();
/// Whether [outcome] was seen (and so has a colour of its own).
bool contains(String outcome) => _swatches.containsKey(_key(outcome));
/// [outcome]'s colour for the host's brightness; an unseen or blank name
/// uses the host's secondary text colour.
Color colorFor(BuildContext context, String outcome) {
final cupertino =
context.findAncestorWidgetOfExactType<MaterialApp>() == null;
final brightness = cupertino
? CupertinoTheme.brightnessOf(context)
: Theme.of(context).brightness;
final swatch = _swatches[_key(outcome)];
if (swatch == null) {
return cupertino
? CupertinoColors.secondaryLabel.resolveFrom(context)
: Theme.of(context).colorScheme.onSurfaceVariant;
}
return swatch.resolve(brightness);
}
/// [outcome]'s colour on a page of [brightness], or null when unseen.
Color? colorForBrightness(String outcome, Brightness brightness) =>
_swatches[_key(outcome)]?.resolve(brightness);
}
enum _Family { success, failure, rejection, caution, neutral }
/// The meaning a well-known outcome word carries, if any.
_Family? _familyOf(String key) {
final word = key.replaceAll(RegExp(r'[\s-]+'), '_');
const success = {
'success',
'succeeded',
'ok',
'pass',
'passed',
'approved',
'accepted',
'done',
'completed',
'complete',
'merged',
'landed',
};
const failure = {'error', 'failure', 'failed', 'fail', 'crashed', 'broken'};
const rejection = {
'rejected',
'reject',
'blocked',
'denied',
'declined',
'changes_requested',
};
const caution = {
'retry',
'blocked_retryable',
'advisory',
'warning',
'needs_work',
'partial',
};
const neutral = {
'skipped',
'skip',
'canceled',
'cancelled',
'stopped',
'none',
};
if (success.contains(word)) return _Family.success;
if (failure.contains(word)) return _Family.failure;
if (rejection.contains(word)) return _Family.rejection;
if (caution.contains(word)) return _Family.caution;
if (neutral.contains(word)) return _Family.neutral;
return null;
}
/// Each family's shades, in the order successive distinct words take them.
const Map<_Family, List<MaterialColor>> _familyShades = {
_Family.success: [Colors.green, Colors.lightGreen, Colors.teal],
_Family.failure: [Colors.red, Colors.pink],
_Family.rejection: [Colors.deepOrange, Colors.orange],
_Family.caution: [Colors.amber, Colors.yellow],
_Family.neutral: [Colors.blueGrey, Colors.grey],
};
/// Hues for words with no family, chosen away from the family colours.
const List<MaterialColor> _otherHues = [
Colors.blue,
Colors.purple,
Colors.indigo,
Colors.cyan,
Colors.brown,
Colors.deepPurple,
Colors.lightBlue,
];
class _Swatch {
const _Swatch.material(MaterialColor this.color) : wheelIndex = null;
const _Swatch.wheel(int this.wheelIndex) : color = null;
final MaterialColor? color;
final int? wheelIndex;
Color resolve(Brightness brightness) {
final dark = brightness == Brightness.dark;
final material = color;
if (material != null) return dark ? material.shade300 : material.shade800;
// Past the named hues, continue round the wheel by the golden angle,
// starting from a blue-violet so the next words stay clear of the
// families' greens, reds, oranges and ambers.
final degrees = (230 + wheelIndex! * 137.508) % 360;
return HSLColor.fromAHSL(1, degrees, 0.55, dark ? 0.72 : 0.35).toColor();
}
}