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

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:
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
@@ -0,0 +1,52 @@
import 'package:clide_app/builtin/default_layout/default_layout.dart';
import 'package:clide_app/extension/extension.dart';
import 'package:clide_app/kernel/kernel.dart';
import 'package:flutter_test/flutter_test.dart';
import '../../helpers/kernel_fixture.dart';
void main() {
group('DefaultLayoutExtension', () {
late KernelFixture f;
setUp(() async => f = await KernelFixture.create());
tearDown(() async => f.dispose());
test('activates and applies the classic preset', () async {
f.services.extensions.register(DefaultLayoutExtension());
await f.services.extensions.activateAll();
expect(
f.services.arrangement.positionOf(Slots.sidebar), SlotPosition.left);
expect(f.services.arrangement.sizeOf(Slots.sidebar), 240);
expect(f.services.arrangement.positionOf(Slots.workspace),
SlotPosition.center);
expect(f.services.arrangement.positionOf(Slots.statusbar),
SlotPosition.bottom);
});
test('contributes a layout.reset command', () async {
f.services.extensions.register(DefaultLayoutExtension());
await f.services.extensions.activateAll();
final reset = f.services.commands.get('layout.reset');
expect(reset, isNotNull);
});
test('layout.reset re-applies the preset', () async {
f.services.extensions.register(DefaultLayoutExtension());
await f.services.extensions.activateAll();
f.services.arrangement.setSize(Slots.sidebar, 300);
expect(f.services.arrangement.sizeOf(Slots.sidebar), 300);
final resp = await f.services.commands.execute('layout.reset');
expect(resp.ok, true);
expect(f.services.arrangement.sizeOf(Slots.sidebar), 240);
});
test('declares a layout preset contribution', () {
final ext = DefaultLayoutExtension();
expect(
ext.contributions.whereType<LayoutPresetContribution>(),
hasLength(1),
);
});
});
}
@@ -0,0 +1,61 @@
import 'dart:ui';
import 'package:clide_app/builtin/ipc_status/ipc_status.dart';
import 'package:clide_app/extension/extension.dart';
import 'package:clide_app/kernel/kernel.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('IpcStatusExtension', () {
late KernelFixture f;
setUp(() async {
f = await KernelFixture.create(
i18nCatalogs: {
'builtin.ipc-status': {
const Locale('en', 'US'): const {
'connected': {'translation': 'connected'},
'connected.hint': {'translation': 'daemon reachable'},
'disconnected': {'translation': 'disconnected'},
'disconnected.hint': {'translation': 'daemon down'},
},
},
},
);
});
tearDown(() async => f.dispose());
test('contributes a statusbar item', () async {
f.services.extensions.register(IpcStatusExtension());
await f.services.extensions.activateAll();
final items = f.services.panels
.contributionsFor(Slots.statusbar)
.whereType<StatusItemContribution>()
.toList();
expect(items, hasLength(1));
expect(items.first.priority, 100);
});
testWidgets('renders "disconnected" label until connected', (tester) async {
await tester.pumpWidget(
harness(f, IpcStatusItem(ipc: f.services.ipc)),
);
expect(find.text('disconnected'), findsOneWidget);
});
testWidgets('flips to "connected" when the client reports connected',
(tester) async {
await tester.pumpWidget(
harness(f, IpcStatusItem(ipc: f.services.ipc)),
);
f.ipc.setConnected(true);
await tester.pumpAndSettle();
expect(find.text('connected'), findsOneWidget);
});
});
}
@@ -0,0 +1,117 @@
import 'dart:ui';
import 'package:clide_app/builtin/theme_picker/theme_picker.dart';
import 'package:clide_app/kernel/kernel.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter_test/flutter_test.dart';
import '../../helpers/kernel_fixture.dart';
import '../../helpers/widget_harness.dart';
ThemeDefinition _def(String name) => ThemeDefinition(
name: name,
displayName: name,
dark: true,
palette: Palette(const {
'primary': Color(0xFF00A3D2),
'accent': Color(0xFFFA5F8B),
'background': Color(0xFF21262F),
'surface': Color(0xFF393E48),
'panel': Color(0xFF292E38),
'foreground': Color(0xFFE2E8F5),
'success': Color(0xFF00AB9A),
'warning': Color(0xFFD08447),
'error': Color(0xFFF06C6F),
}),
);
void main() {
group('ThemePickerExtension', () {
late KernelFixture f;
setUp(() async {
f = await KernelFixture.create(
bundledThemes: [_def('summer-night'), _def('forest')],
i18nCatalogs: {
'builtin.theme-picker': {
const Locale('en', 'US'): const {
'modal.title': {'translation': 'Select theme'},
'modal.cancel': {'translation': 'Cancel'},
'modal.cancel.hint': {'translation': 'Dismiss'},
'row.select.hint': {'translation': 'Activate this theme'},
},
},
},
);
});
tearDown(() async => f.dispose());
test('contributes a theme.pick command', () async {
f.services.extensions.register(ThemePickerExtension());
await f.services.extensions.activateAll();
expect(f.services.commands.get('theme.pick'), isNotNull);
});
test('default binding ctrl+k is registered', () async {
f.services.extensions.register(ThemePickerExtension());
await f.services.extensions.activateAll();
expect(
f.services.keybindings.commandFor(Keybinding.parse('ctrl+k')),
'theme.pick',
);
});
testWidgets('modal lists every bundled theme', (tester) async {
await tester.pumpWidget(
harness(
f,
ThemePickerView(
controller: f.services.theme,
onDismiss: ([_]) {},
),
),
);
// Each row renders both displayName and name; displayName==name in
// test fixtures so the label appears twice per row.
expect(find.text('summer-night'), findsNWidgets(2));
expect(find.text('forest'), findsNWidgets(2));
expect(find.text('Select theme'), findsOneWidget);
expect(find.text('Cancel'), findsOneWidget);
});
testWidgets('tapping a row calls controller.select + onDismiss',
(tester) async {
String? dismissed;
await tester.pumpWidget(
harness(
f,
ThemePickerView(
controller: f.services.theme,
onDismiss: ([v]) => dismissed = v,
),
),
);
await tester.tap(find.bySemanticsLabel('forest'));
await tester.pumpAndSettle();
expect(f.services.theme.currentName, 'forest');
expect(dismissed, 'forest');
});
testWidgets('Cancel button dismisses without selecting', (tester) async {
String? dismissed = 'not-called';
await tester.pumpWidget(
harness(
f,
ThemePickerView(
controller: f.services.theme,
onDismiss: ([v]) => dismissed = v,
),
),
);
await tester.tap(find.bySemanticsLabel('Cancel'));
await tester.pumpAndSettle();
expect(dismissed, isNull);
});
});
}
+82
View File
@@ -0,0 +1,82 @@
import 'dart:ui';
import 'package:clide_app/builtin/welcome/welcome.dart';
import 'package:clide_app/builtin/welcome/src/welcome_view.dart';
import 'package:clide_app/extension/extension.dart';
import 'package:clide_app/kernel/kernel.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('WelcomeExtension', () {
late KernelFixture f;
setUp(() async {
f = await KernelFixture.create(
i18nCatalogs: {
'builtin.welcome': {
const Locale('en', 'US'): const {
'title': {'translation': 'clide'},
'subtitle': {
'translation': 'Flutter desktop IDE for Claude Code'
},
'open-project': {'translation': 'Open project'},
'open-project.hint': {'translation': 'Pick a git repository'},
'tab.title': {'translation': 'Welcome'},
},
},
},
);
});
tearDown(() async => f.dispose());
test('contributes a workspace tab with an i18n title key', () {
final ext = WelcomeExtension();
final tabs = ext.contributions.whereType<TabContribution>().toList();
expect(tabs, hasLength(1));
expect(tabs.first.slot, Slots.workspace);
expect(tabs.first.titleKey, 'tab.title');
expect(tabs.first.i18nNamespace, ext.id);
});
testWidgets('WelcomeView renders title + subtitle + Open-project button',
(tester) async {
await tester.pumpWidget(harness(f, const WelcomeView()));
expect(find.text('clide'), findsOneWidget);
expect(
find.text('Flutter desktop IDE for Claude Code'),
findsOneWidget,
);
expect(find.text('Open project'), findsOneWidget);
});
testWidgets('Open-project button is a Semantics button w/ hint',
(tester) async {
await tester.pumpWidget(harness(f, const WelcomeView()));
final semantics =
tester.getSemantics(find.bySemanticsLabel('Open project'));
expect(semantics.label, 'Open project');
expect(semantics.hint, 'Pick a git repository');
});
testWidgets('locale switch refreshes the visible text', (tester) async {
await tester.pumpWidget(harness(f, const WelcomeView()));
f.services.i18n
.registerCatalog('builtin.welcome', const Locale('nl'), const {
'title': {'translation': 'clide-nl'},
'subtitle': {'translation': 'Flutter IDE voor Claude Code'},
'open-project': {'translation': 'Project openen'},
'open-project.hint': {'translation': 'Kies een git repo'},
'tab.title': {'translation': 'Welkom'},
});
await f.services.i18n.setLocale(const Locale('nl'));
await tester.pumpAndSettle();
expect(find.text('Project openen'), findsOneWidget);
expect(find.text('clide-nl'), findsOneWidget);
});
});
}