feat(graph): graph context-panel shell — states + click-to-open (T-323)

Wraps GraphController + GraphView into the panel widget: loads the vault graph on mount, shows a spinner / empty / error state until it is ready, then draws the graph and opens a note on node click via editor.open. A debounced refresh keeps the current graph on screen instead of flashing back to the spinner. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-02 09:43:57 +02:00
parent 3b67725b7e
commit 6fae1bc46a
2 changed files with 168 additions and 0 deletions
@@ -0,0 +1,99 @@
+import 'dart:async';
+
+import 'package:clide/builtin/graph/src/graph_panel.dart';
+import 'package:clide/builtin/graph/src/graph_view.dart';
+import 'package:clide/clide.dart';
+import 'package:clide/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() {
+  late KernelFixture f;
+  setUp(() async => f = await KernelFixture.create());
+  tearDown(() => f.dispose());
+
+  IpcResponse ok(Map<String, Object?> data) => IpcResponse.ok(id: '1', data: data);
+
+  /// Stubs `pql.files` (from the map's keys) and `pql.outlinks` (per path).
+  void stubVault(Map<String, List<String>> vault) {
+    f.ipc.stub(
+      'pql.files',
+      (_) async => ok({
+        'files': [
+          for (final p in vault.keys) {'path': p},
+        ],
+      }),
+    );
+    f.ipc.stub('pql.outlinks', (args) async {
+      final links = vault[args['path'] as String?] ?? const [];
+      return ok({
+        'links': [
+          for (final t in links) {'target': t},
+        ],
+      });
+    });
+  }
+
+  Widget panel([Size size = const Size(400, 400)]) => anchoredHarness(f, SizedBox(width: size.width, height: size.height, child: const GraphPanel()));
+
+  testWidgets('shows a spinner while the first load is in flight', (tester) async {
+    // A never-completing pql.files keeps the panel in its loading state.
+    f.ipc.stub('pql.files', (_) => Completer<IpcResponse>().future);
+    await tester.pumpWidget(panel());
+    await tester.pump();
+    expect(find.byType(ClideSpinner), findsOneWidget);
+    expect(find.byType(GraphView), findsNothing);
+  });
+
+  testWidgets('renders the graph once loaded', (tester) async {
+    stubVault({
+      'a.md': ['b.md'],
+      'b.md': [],
+    });
+    await tester.pumpWidget(panel());
+    await pumpAsync(tester);
+    expect(find.byType(GraphView), findsOneWidget);
+    expect(find.byType(ClideSpinner), findsNothing);
+  });
+
+  testWidgets('shows an empty message for a vault with no notes', (tester) async {
+    stubVault(const {});
+    await tester.pumpWidget(panel());
+    await pumpAsync(tester);
+    expect(find.text('No linked notes in this vault.'), findsOneWidget);
+    expect(find.byType(GraphView), findsNothing);
+  });
+
+  testWidgets('surfaces a load error', (tester) async {
+    f.ipc.stub(
+      'pql.files',
+      (_) async => IpcResponse.err(
+        id: '1',
+        error: IpcError(code: IpcExitCode.toolError, kind: IpcErrorKind.toolError, message: 'index locked'),
+      ),
+    );
+    await tester.pumpWidget(panel());
+    await pumpAsync(tester);
+    expect(find.text('index locked'), findsOneWidget);
+    expect(find.byType(GraphView), findsNothing);
+  });
+
+  testWidgets('clicking a node opens it in the editor', (tester) async {
+    stubVault({'only.md': const []});
+    String? opened;
+    f.ipc.stub('editor.open', (args) async {
+      opened = args['path'] as String?;
+      return ok(const {});
+    });
+    await tester.pumpWidget(panel());
+    await pumpAsync(tester);
+    // A single node lays out at the layout centre → a square canvas maps it to
+    // the view's centre, which is where a byType tap lands.
+    await tester.tap(find.byType(GraphView));
+    await pumpAsync(tester);
+    expect(opened, 'only.md');
+  });
+}