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

40 lines
1.6 KiB
Markdown

# 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
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
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.