feat(editor): three-tab WYSIWYG editor — graph / text / run

Full rewrite of the editor surface, layered on top of the
FlowGraph foundation. One in-memory flow drives three tabs
that the operator can flip between freely:

 - Graph: a drag-and-drop canvas. Nodes are step cards with
   port dots on their left (one per `with:` field) and a
   combined output port on the right. Pinned inputs and
   outputs pseudo-nodes sit at the left and right edges so
   every flow has a visually obvious source and sink. Pan +
   zoom via InteractiveViewer; drag a node by its body to
   reposition it (positions persisted to a sidecar JSON file
   under ~/.fai/data/flows/.layout/<name>.json — kept OUT of
   the YAML so `fai run` stays byte-stable).
 - Text: the existing YAML CodeField with expands:true so
   line 1 anchors at the top edge. YAML-aware syntax
   highlighting picks up the theme's primary / secondary /
   tertiary palette for keys / strings / numbers.
 - Run: an inputs form (text fields + file-pick), a Start
   button that calls the host's FlowRunDriver, a live step
   list driven by the driver's event stream (matches the
   `fai run` CLI rendering — ◻ pending, · running, ✔ done +
   duration, ✗ failed, ⏸ awaiting approval), and the typed
   outputs once the run resolves.

Source of truth = the YAML text. Graph edits emit fresh YAML
into the shared CodeController; text edits re-parse the
graph on a 350 ms debounce. Layout sidecar persists drag
positions only.

New public API (lib/fai_studio_flow_editor.dart):

  FlowEditorPage(
    initialFlowName: ...,
    locale: ...,
    runDriver: FlowRunDriver?,        // NEW — host bridge
    availableCapabilities: List<String>, // NEW — for the
                                          // capability picker
                                          // dialog when adding
                                          // a step
  )

The host (Studio) implements FlowRunDriver to bridge the
hub's gRPC SDK into the editor's event vocabulary. The
StepStarted/Completed/Failed/AwaitingApproval events are
shared verbatim with the CLI's run_progress renderer so
both surfaces speak the same visual language.

Files in this commit:
 - lib/src/editor_controller.dart       — shared state +
   debounced reparse loop
 - lib/src/run_driver.dart              — host bridge
   interface + event types
 - lib/src/widgets/flow_canvas.dart     — pan / zoom / drag /
   port-to-port connection drawing
 - lib/src/widgets/flow_node.dart       — node card primitive
   (module / approval / inputs / outputs variants)
 - lib/src/widgets/edge_painter.dart    — single CustomPainter
   for every edge + draft drag line, cubic bezier with
   arrow-head caps
 - lib/src/widgets/properties_panel.dart — right-side editor
   when a step is selected (rename id, change capability, add
   / remove / rename with-fields, delete step)
 - lib/src/widgets/capability_picker.dart — searchable list
   dialog used by Add-step
 - lib/src/widgets/run_tab.dart         — inputs form +
   live step progress + outputs renderer
 - lib/src/flow_editor_page.dart        — host scaffolding,
   toolbar, file list, three-tab body, keyboard shortcuts
 - lib/src/l10n.dart                    — EN + DE strings for
   every new label
 - lib/fai_studio_flow_editor.dart      — exports the new
   public types (FlowRunDriver, FlowRunEvent variants,
   FlowOutputValue variants)

flutter analyze: 0 issues. flutter test: 7/7 green.

Signed-off-by: flemming-it <sf@flemming.it>

lib/fai_studio_flow_editor.dart

@@ -1,17 +1,38 @@
-/// Inline YAML editor for F∆I Studio flows — swappable.
+/// Inline flow editor for F∆I Studio — swappable.
 ///
-/// Studio depends on this package via pubspec.yaml. To use a
-/// different editor, fork this repo, change the implementation,
-/// point Studio's pubspec at the fork, rebuild Studio.
+/// Studio depends on this package via pubspec.yaml. To use
+/// a different editor, fork this repo, change the
+/// implementation, point Studio's pubspec at the fork,
+/// rebuild Studio.
 ///
 /// Public surface:
+///
 ///   * [FlowEditorPage] — the page widget Studio embeds as
-///     its "Editor" destination + as a route push from the
-///     Flows page's pencil icon.
-///   * [FlowEditorLocale] — the locale the package renders
-///     its inline strings in. Studio passes its active
-///     Locale through.
+///     its Flows destination. Three tabs over one in-memory
+///     flow: graph (drag-and-drop WYSIWYG), text (raw YAML),
+///     run (inputs form + live step progress + outputs).
+///   * [FlowEditorLocale] — render language for inline
+///     strings. Studio passes its active Locale through.
+///   * [FlowRunDriver] — host-supplied bridge to the hub.
+///     Studio implements it with the gRPC SDK; a CLI host
+///     could shell out; a test harness can stub it in-memory.
+///   * [FlowRunEvent] family — events the driver streams
+///     during a run (StepStarted, StepCompleted, …).
+///   * [FlowOutputValue] family — typed outputs the driver
+///     returns when the run finishes.
 library;
 
 export 'src/flow_editor_page.dart' show FlowEditorPage;
 export 'src/l10n.dart' show FlowEditorLocale;
+export 'src/run_driver.dart'
+    show
+        FlowRunDriver,
+        FlowRunEvent,
+        StepStarted,
+        StepCompleted,
+        StepFailed,
+        StepAwaitingApproval,
+        FlowOutputValue,
+        FlowOutputText,
+        FlowOutputJson,
+        FlowOutputBytes;