jpmschweitzer/clide
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

add app test suite — unit, widget, golden, a11y (168 tests)

Browse Source 
Four layers under app/test/:

  * kernel/, extension/ — unit tests for every kernel service and
    the extension contract. i18n fallback chain gets the full
    matrix (exact/lang/default/placeholder, namespace isolation,
    unknown namespace, interpolation). Theme resolver and
    extension-manager topo sort covered.
  * widgets/, builtin/ — widget tests for every primitive and each
    Tier 0 built-in. Assertions reach into the Semantics node so
    a missing label fails structurally, not visually.
  * goldens/ — Alchemist + Ahem font for cross-platform pixel
    stability; primitives only (button, tab bar, icon set). No
    goldens for compositions — they'd churn through every tier.
  * a11y/ — contract-level gate: semantic coverage walks the
    built-in catalogue, contrast walks every token pair in every
    bundled theme against WCAG-AA thresholds (catches real
    regressions: the first run caught `tab.inactive_text` at 2.81
    in summer-night), i18n coverage asserts every referenced key
    exists in its catalog (exists-in-map, not "key == value" — too
    ambiguous for keys that happen to equal their translation).

Helpers under helpers/: `KernelFixture.create()` boots a
KernelServices with in-memory stores + a FakeDaemonClient (no
socket, drivable connected-state), `widget_harness` wraps a
widget in the minimum tree that resolves theme + i18n.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
jpmschweitzer
2026-04-21 15:47:14 +02:00
co-authored by Claude
parent b13483e2d5
commit 96b26e29f0
45 changed files with 2730 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
app/test/widgets/src/clide_button_test.dart
+94
View File
@@ -0,0 +1,94 @@
import 'package:clide_app/widgets/widgets.dart';
import 'package:flutter/semantics.dart';
import 'package:flutter_test/flutter_test.dart';
import '../../helpers/kernel_fixture.dart';
import '../../helpers/widget_harness.dart';
void main() {
group('ClideButton', () {
late KernelFixture f;
setUp(() async {
f = await KernelFixture.create();
});
tearDown(() async {
await f.dispose();
});
testWidgets('renders the label text', (tester) async {
await tester.pumpWidget(
harness(f, const ClideButton(label: 'Save', onPressed: null)),
);
expect(find.text('Save'), findsOneWidget);
});
testWidgets('emits a Semantics node with button: true + label',
(tester) async {
await tester.pumpWidget(
harness(f, ClideButton(label: 'Commit', onPressed: () {})),
);
final semantics = tester.getSemantics(find.byType(ClideButton));
expect(semantics.label, 'Commit');
expect(
semantics.getSemanticsData().hasAction(SemanticsAction.tap),
isTrue,
reason: 'enabled button must expose tap action',
);
});
testWidgets('semanticLabel overrides the visible label for a11y',
(tester) async {
await tester.pumpWidget(
harness(
f,
ClideButton(
label: 'Save',
semanticLabel: 'Save document',
onPressed: () {},
),
),
);
final semantics = tester.getSemantics(find.byType(ClideButton));
expect(semantics.label, 'Save document');
});
testWidgets('semanticHint propagates to the Semantics node',
(tester) async {
await tester.pumpWidget(
harness(
f,
ClideButton(
label: 'Pick',
semanticHint: 'Select a theme',
onPressed: () {},
),
),
);
final semantics = tester.getSemantics(find.byType(ClideButton));
expect(semantics.hint, 'Select a theme');
});
testWidgets('disabled button drops the tap action', (tester) async {
await tester.pumpWidget(
harness(f, const ClideButton(label: 'Nope', onPressed: null)),
);
final semantics = tester.getSemantics(find.byType(ClideButton));
expect(
semantics.getSemanticsData().hasAction(SemanticsAction.tap), isFalse);
});
testWidgets('tap invokes onPressed', (tester) async {
var pressed = 0;
await tester.pumpWidget(
harness(
f,
ClideButton(label: 'Go', onPressed: () => pressed++),
),
);
await tester.tap(find.byType(ClideButton));
expect(pressed, 1);
});
});
}
app/test/widgets/src/clide_divider_test.dart
+31
View File
@@ -0,0 +1,31 @@
import 'package:clide_app/widgets/widgets.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter_test/flutter_test.dart';
import '../../helpers/kernel_fixture.dart';
import '../../helpers/widget_harness.dart';
void main() {
group('ClideDivider', () {
late KernelFixture f;
setUp(() async => f = await KernelFixture.create());
tearDown(() async => f.dispose());
testWidgets('renders a 1px horizontal container by default',
(tester) async {
await tester.pumpWidget(harness(f, const ClideDivider()));
final c = tester.widget<Container>(find.byType(Container));
expect(c.constraints?.maxHeight, 1.0);
expect(c.color, f.services.theme.current.surface.dividerColor);
});
testWidgets('vertical axis yields a width-constrained container',
(tester) async {
await tester.pumpWidget(
harness(f, const ClideDivider(axis: Axis.vertical, thickness: 2)),
);
final c = tester.widget<Container>(find.byType(Container));
expect(c.constraints?.maxWidth, 2.0);
});
});
}
app/test/widgets/src/clide_icon_test.dart
+33
View File
@@ -0,0 +1,33 @@
import 'package:clide_app/widgets/widgets.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter_test/flutter_test.dart';
import '../../helpers/kernel_fixture.dart';
import '../../helpers/widget_harness.dart';
void main() {
group('ClideIcon', () {
late KernelFixture f;
setUp(() async => f = await KernelFixture.create());
tearDown(() async => f.dispose());
testWidgets('sizes a SizedBox + CustomPaint to the given size',
(tester) async {
await tester.pumpWidget(
harness(f, const ClideIcon(FolderIcon(), size: 24)),
);
final sb = tester.widget<SizedBox>(find.byType(SizedBox).first);
expect(sb.width, 24);
expect(sb.height, 24);
expect(find.byType(CustomPaint), findsWidgets);
});
testWidgets('default color is globalForeground', (tester) async {
await tester.pumpWidget(
harness(f, const ClideIcon(CheckIcon())),
);
// Color is inaccessible after painting; ensure it renders without crashing.
expect(find.byType(ClideIcon), findsOneWidget);
});
});
}
app/test/widgets/src/clide_surface_test.dart
+51
View File
@@ -0,0 +1,51 @@
import 'package:clide_app/widgets/widgets.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter_test/flutter_test.dart';
import '../../helpers/kernel_fixture.dart';
import '../../helpers/widget_harness.dart';
void main() {
group('ClideSurface', () {
late KernelFixture f;
setUp(() async => f = await KernelFixture.create());
tearDown(() async => f.dispose());
testWidgets('default background comes from panelBackground token',
(tester) async {
await tester.pumpWidget(
harness(f, const ClideSurface(child: Text('x'))),
);
final container = tester.widget<Container>(find.byType(Container));
final decoration = container.decoration as BoxDecoration;
expect(
decoration.color, f.services.theme.current.surface.panelBackground);
});
testWidgets('explicit color overrides the token default', (tester) async {
const custom = Color(0xFF123456);
await tester.pumpWidget(
harness(f, const ClideSurface(color: custom, child: Text('x'))),
);
final container = tester.widget<Container>(find.byType(Container));
final decoration = container.decoration as BoxDecoration;
expect(decoration.color, custom);
});
testWidgets('border when provided renders a BoxBorder', (tester) async {
await tester.pumpWidget(
harness(
f,
ClideSurface(
border: f.services.theme.current.surface.modalSurfaceBorder,
child: const Text('x'),
),
),
);
final container = tester.widget<Container>(find.byType(Container));
final decoration = container.decoration as BoxDecoration;
expect(decoration.border, isNotNull);
});
});
}
app/test/widgets/src/clide_tab_bar_test.dart
+88
View File
@@ -0,0 +1,88 @@
import 'package:clide_app/widgets/widgets.dart';
import 'package:flutter_test/flutter_test.dart';
import '../../helpers/kernel_fixture.dart';
import '../../helpers/widget_harness.dart';
void main() {
group('ClideTabBar', () {
late KernelFixture f;
setUp(() async => f = await KernelFixture.create());
tearDown(() async => f.dispose());
testWidgets('renders one tab per item', (tester) async {
await tester.pumpWidget(
harness(
f,
ClideTabBar(
items: const [
ClideTabItem(id: 'a', title: 'A'),
ClideTabItem(id: 'b', title: 'B'),
],
activeId: 'a',
onSelect: (_) {},
),
),
);
expect(find.text('A'), findsOneWidget);
expect(find.text('B'), findsOneWidget);
});
testWidgets('tapping a tab fires onSelect with the id', (tester) async {
String? selected;
await tester.pumpWidget(
harness(
f,
ClideTabBar(
items: const [
ClideTabItem(id: 'a', title: 'A'),
ClideTabItem(id: 'b', title: 'B'),
],
activeId: 'a',
onSelect: (id) => selected = id,
),
),
);
await tester.tap(find.text('B'));
expect(selected, 'b');
});
testWidgets('each tab is a selectable Semantics button', (tester) async {
await tester.pumpWidget(
harness(
f,
ClideTabBar(
items: const [
ClideTabItem(id: 'a', title: 'Files'),
ClideTabItem(id: 'b', title: 'Git'),
],
activeId: 'a',
onSelect: (_) {},
),
),
);
final handle = tester.ensureSemantics();
expect(
tester.getSemantics(find.bySemanticsLabel('Files')),
matchesSemantics(
label: 'Files',
isButton: true,
isSelected: true,
hasSelectedState: true,
hasTapAction: true,
),
);
expect(
tester.getSemantics(find.bySemanticsLabel('Git')),
matchesSemantics(
label: 'Git',
isButton: true,
isSelected: false,
hasSelectedState: true,
hasTapAction: true,
),
);
handle.dispose();
});
});
}
app/test/widgets/src/clide_text_test.dart
+40
View File
@@ -0,0 +1,40 @@
import 'package:clide_app/widgets/widgets.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter_test/flutter_test.dart';
import '../../helpers/kernel_fixture.dart';
import '../../helpers/widget_harness.dart';
void main() {
group('ClideText', () {
late KernelFixture f;
setUp(() async => f = await KernelFixture.create());
tearDown(() async => f.dispose());
testWidgets('renders the given string', (tester) async {
await tester.pumpWidget(harness(f, const ClideText('hello world')));
expect(find.text('hello world'), findsOneWidget);
});
testWidgets('default color is globalForeground token', (tester) async {
await tester.pumpWidget(harness(f, const ClideText('x')));
final text = tester.widget<Text>(find.byType(Text));
final tokens = f.services.theme.current.surface;
expect(text.style!.color, tokens.globalForeground);
});
testWidgets('muted mode uses globalTextMuted', (tester) async {
await tester.pumpWidget(harness(f, const ClideText('x', muted: true)));
final text = tester.widget<Text>(find.byType(Text));
expect(
text.style!.color, f.services.theme.current.surface.globalTextMuted);
});
testWidgets('explicit color wins over tokens', (tester) async {
await tester.pumpWidget(
harness(f, const ClideText('x', color: Color(0xFFAABBCC))));
final text = tester.widget<Text>(find.byType(Text));
expect(text.style!.color, const Color(0xFFAABBCC));
});
});
}