This repository has been archived on 2026-10-29. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
EveFlutter/README.md
2026-07-10 16:58:04 +01:00

1.6 KiB

EveFlutter

Generic Flutter lowering for Eve surface documents. EveFlutter owns native Flutter projection, provider selection, command-intent construction, platform build glue, tests, and captures. Providers retain state and command authority; plugins retain domain semantics.

The eveflutter-v1.0.2 release is owner-built. CI analyzes the runtime, runs the responsive capture suite, verifies lifecycle evidence, and publishes the committed golden captures as a commit-keyed artifact. Linux CI regenerates Linux goldens rather than byte-comparing them with Windows captures; widget and contract assertions remain shared across platforms.

Current smoke target:

  • CultUiInspectorSurface
  • custom-painted slider track/fill/thumb
  • EmbeddedSurfaceDemo, which verifies surface.slot / embeddedDocuments parsing and rendering from the shared fixture
  • golden PNG output through flutter test --update-goldens

Run from the repository root:

powershell -ExecutionPolicy Bypass -File .\scripts\capture-flutter-parity.ps1 -Target windows -SurfacePath <surface.json>

Linux capture requires running the same harness on a Linux host. The Windows host must not pretend to be a Linux renderer.

Split lifecycle evidence lives in eveflutter-lifecycle.json. From the repository root, run:

powershell -ExecutionPolicy Bypass -File .\scripts\run-eveflutter-lifecycle-smoke.ps1

That smoke validates the owner lifecycle document and runs the Dart analyzer. Pass an exported conformance directory and Eve's generic export consumer to verify contract consumption without importing Eve source layout.