feat(draw): clide draw command — drive a drawing card from the CLI (T-318)

Mirrors image.show: a Flutter-free `draw` handler reads + JSON-parses the document (injected reader), lowers it to SVG via the template registry, and publishes {svg, label, description} on the `draw` MessageBus channel for the Claude extension to inject. Honest errors — notFound (missing file), userError (bad JSON / unknown template / no --file), toolError (no live UI). Covered by dart test (7 cases). The extension subscription that injects the card remains to wire. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-28 22:18:53 +02:00
parent ed5cd6e312
commit 14bbd1fd2d
4 changed files with 193 additions and 0 deletions
@@ -0,0 +1,100 @@
+import 'package:clide/clide.dart';
+import 'package:clide/src/daemon/draw_commands.dart';
+import 'package:clide/src/draw/draw_dispatch.dart';
+import 'package:test/test.dart';
+
+void main() {
+  late List<({String publisher, String channel, Map<String, Object?> data})> published;
+  late DaemonDispatcher d;
+  late DrawingRegistry registry;
+  late Map<String, String> files;
+
+  setUp(() {
+    published = [];
+    files = {};
+    registry = DrawingRegistry();
+    d = DaemonDispatcher();
+  });
+
+  void wire({bool liveUi = true}) => registerDrawCommands(
+    d,
+    () => liveUi ? (pub, ch, data) => published.add((publisher: pub, channel: ch, data: data)) : null,
+    registry: registry,
+    readFile: (p) async => files[p],
+  );
+
+  Future<IpcResponse> draw(String? file) => d.dispatch(
+    IpcRequest(
+      id: '1',
+      cmd: 'draw',
+      args: {
+        'positional': const [],
+        'flags': {'file': ?file},
+      },
+    ),
+  );
+
+  test('primitive doc: publishes the svg + captions on the draw channel', () async {
+    wire();
+    files['card.json'] = '{"card":{"label":"Pipeline","description":"how"},"svg":"<svg id=\\"x\\"/>"}';
+    final r = await draw('card.json');
+    expect(r.ok, isTrue, reason: r.error?.message);
+    expect(r.data['shown'], isTrue);
+    expect(published.single.publisher, 'cli');
+    expect(published.single.channel, drawShowChannel);
+    expect(published.single.data['svg'], '<svg id="x"/>');
+    expect(published.single.data['label'], 'Pipeline');
+    expect(published.single.data['description'], 'how');
+  });
+
+  test('template doc lowers via the registry before publishing', () async {
+    wire();
+    registry.register('d2', (doc) async => '<svg data-d2="${doc.fields['source']}"/>');
+    files['c.json'] = '{"template":"d2","source":"a -> b"}';
+    final r = await draw('c.json');
+    expect(r.ok, isTrue, reason: r.error?.message);
+    expect(published.single.data['svg'], '<svg data-d2="a -> b"/>');
+    expect(r.data['template'], 'd2');
+  });
+
+  test('a missing file → notFound, nothing published', () async {
+    wire();
+    final r = await draw('nope.json');
+    expect(r.ok, isFalse);
+    expect(r.error?.kind, IpcErrorKind.notFound);
+    expect(published, isEmpty);
+  });
+
+  test('invalid JSON → userError, nothing published', () async {
+    wire();
+    files['bad.json'] = 'not json';
+    final r = await draw('bad.json');
+    expect(r.ok, isFalse);
+    expect(r.error?.kind, IpcErrorKind.userError);
+    expect(published, isEmpty);
+  });
+
+  test('an unknown template → userError', () async {
+    wire();
+    files['c.json'] = '{"template":"nope"}';
+    final r = await draw('c.json');
+    expect(r.ok, isFalse);
+    expect(r.error?.kind, IpcErrorKind.userError);
+  });
+
+  test('missing --file → userError (schema-required)', () async {
+    wire();
+    final r = await draw(null);
+    expect(r.ok, isFalse);
+    expect(r.error?.kind, IpcErrorKind.userError);
+  });
+
+  test('no live UI → toolError, not a hang', () async {
+    wire(liveUi: false);
+    files['card.json'] = '{"svg":"<svg/>"}';
+    final r = await draw('card.json');
+    expect(r.ok, isFalse);
+    expect(r.error?.kind, IpcErrorKind.toolError);
+    expect(published, isEmpty);
+  });
+}