Swappable inline YAML editor for F∆I Studio flows.

Find a file

flemming-it 8b918f8f2a fix: dirty detection — compare fullText, snapshot after load Stefan reported false-positive "Discard unsaved changes?" dialogs when clicking around in the file list. Cause: the naive `_code.text == _loadedText` check fired stale even right after _code.text = text, because CodeController silently rewrites the visible text during the assignment (trailing-newline normalisation, fold marker insertion on some YAML constructs, …) so _code.text deviated from the just-stored _loadedText immediately. Fix: * Drop `_loadedText` field, replace with `_baseline`. * Set `_code.text = ...` first (outside setState), then capture `_baseline = _code.fullText` inside setState. fullText is the canonical post-processed value, not the visible-after-folding text — comparing fullText against fullText eliminates the spurious diff. * _dirty getter now compares `_code.fullText != _baseline`. Applied to all four load / save / new-flow sites. Bump version 0.1.0 → 0.1.1. Studio's pubspec already pins `ref: main` so the next `flutter pub get` picks the fix up. Signed-off-by: flemming-it <sf@flemming.it>		2026-05-30 14:56:39 +02:00
lib	fix: dirty detection — compare fullText, snapshot after load	2026-05-30 14:56:39 +02:00
.gitignore	feat: initial scaffold — swappable flow editor	2026-05-30 14:33:03 +02:00
pubspec.yaml	fix: dirty detection — compare fullText, snapshot after load	2026-05-30 14:56:39 +02:00
README.md	feat: initial scaffold — swappable flow editor	2026-05-30 14:33:03 +02:00

README.md

fai_studio_flow_editor

Swappable inline YAML editor for F∆I Studio flows.

Public surface

import 'package:fai_studio_flow_editor/fai_studio_flow_editor.dart';

// Studio embeds the page as one of its destinations:
FlowEditorPage(
  initialFlowName: 'hello',                       // optional
  locale: FlowEditorLocale.de,                    // or .en
  onRun: (name) =>                                // optional callback
      HubService.instance.runSavedFlow(name: name),
)

initialFlowName — when set, the page loads that flow from ~/.fai/data/flows/<name>.yaml on first build. Used by Studio's Flows-page pencil → editor route push.
locale — picks EN or DE for the editor's internal string table. Studio passes its active locale through.
onRun — async callback that runs the named flow against the host hub and returns the typed outputs map. When null, the Run button is disabled (e.g. when the editor is embedded in a context without hub access).

Behaviour

File browser (left, 240 px) lists *.yaml in ~/.fai/data/flows/.
Code field (right) ships YAML syntax highlighting via flutter_code_editor + the highlight package's yaml grammar.
Save writes directly to disk via dart:io; the hub picks up the change on its next ListFlows / RunSavedFlow call.
Cmd+S / Ctrl+S — save. Cmd+Enter / Ctrl+Enter — run.

Swap it

Studio depends on this package via pubspec.yaml git reference:

dependencies:
  fai_studio_flow_editor:
    git:
      url: https://git.flemming.ai/fai/studio-flow-editor
      ref: main

To use a different editor:

Fork this repo (or write your own from scratch).
Keep the FlowEditorPage constructor signature (initialFlowName, locale, onRun) — that's the stable host contract.

Point Studio's pubspec at your fork (or local-path during development):

fai_studio_flow_editor:
  git:
    url: https://your-host/your/flow-editor
    ref: main

Rebuild Studio. Done.

The contract is intentionally minimal: a single page widget with three parameters. The package brings its own tokens, its own empty/error widgets, its own l10n table, so the host doesn't have to share internals. The trade-off is visual drift if Studio's design tokens change — that's the deal you accept for a swappable module.

Develop

flutter pub get
flutter analyze
flutter test

The package's own widget tests live in test/. End-to-end tests against a live hub stay in the host repo (Studio).

License

Apache-2.0. Same as the rest of the F∆I platform.