diff --git a/docs/renderer-parity.md b/docs/renderer-parity.md index 4534ffc..fdc0d7b 100644 --- a/docs/renderer-parity.md +++ b/docs/renderer-parity.md @@ -5,18 +5,24 @@ but the browser reference is the first renderer that can be used as a practical comparison oracle. See [runtime-app-parity-roadmap.md](./runtime-app-parity-roadmap.md) for the -generic Eve app plan across web, Fensalir Direct2D, iOS/UIKit, and +generic Eve app plan across web, Flutter, Fensalir Direct2D, iOS/UIKit, and Android/Kotlin. Repixelizer is the first style-parity target. +Pixel parity is not byte-identical screenshot parity. Text rasterization, +antialiasing, GPU backends, and device scale will differ. The target is +recognizable CultUI fidelity: the same partitions, fonts, colors, panel +treatments, spacing, image sampling intent, and control anatomy lower cleanly +enough that Repixelizer remains itself across runtimes. + ## Current State | Renderer | Status | Proof | Gap | | --- | --- | --- | --- | -| Web reference | First generic app target | `web/` renders live VoidBot and fixture surfaces through the provider picker | Needs visual regression fixtures and command round-trip tests | -| iOS / UIKit | Native proof | Renders Odin's fullscreen interface wall from `surface.root`, generic provider trees, and a custom VoidBot cockpit with avatar images | Needs provider picker, Repixelizer style token lowering, and visual parity fixtures | -| Android / Kotlin | Device-edge proof | APK builds and shows broker/sensor status | Needs provider picker, full surface tree rendering, style token lowering, asset image lowering, and command controls | -| Fensalir Direct2D | Documented landing zone | Existing `AquariumUiDocument` and `DirectWriteOverlay` path | Needs adapter from Eve surface document to `AquariumUiDocument` and DirectWrite/Direct2D token lowering | -| Flutter | Candidate shared native path | Not installed locally | Needs toolchain and client scaffold | +| Web reference | Active reference/debug renderer | `web/` renders live VoidBot and fixture surfaces through the provider picker; compiles indentation CultUI; lowers partitions, field rows, and slider anatomy | Needs visual regression fixtures and command round-trip tests | +| Flutter | Preferred shared graphical client candidate | Not installed locally | Needs toolchain, app scaffold, provider picker, CultUI tree lowerer, token mapping, and slider anatomy fixture | +| iOS / UIKit | Native proof | Renders Odin's fullscreen interface wall from `surface.root`, generic provider trees, and a custom VoidBot cockpit with avatar images | Needs provider picker, Repixelizer style token lowering, and a decision on what UIKit still owns if Flutter covers the shared graphical path | +| Android / Kotlin | Device-edge proof | APK builds and shows broker/sensor status | Needs provider picker, full surface tree rendering, style token lowering, asset image lowering, command controls, and a decision on what Kotlin still owns if Flutter covers the shared graphical path | +| Fensalir Direct2D | Specialized native/game-runtime landing zone | Existing `AquariumUiDocument` and `DirectWriteOverlay` path | Needs adapter from Eve surface document to `AquariumUiDocument`, DirectWrite/Direct2D token lowering, and a clear reason to stay separate from Flutter for desktop UI | ## Spawned Surfaces @@ -32,6 +38,8 @@ provider picker: - `Sai VN Surface`: loads `web/fixtures/sai-vn-surface.json`. - `Huginn .cc`: compiles `web/fixtures/huginn-cc-surface.eve`. - `Reactive DSL`: compiles `web/fixtures/reactive-composition.eve`. +- `CultUI Inspector`: compiles `web/fixtures/cultui-slider-inspector.eve` + and proves partition/field-row/slider-anatomy lowering in the web reference. The remaining temporary part is the local provider list itself. The runtime app target is the same picker fed by live `gamecult.eve.provider_advertisement.v1` diff --git a/docs/runtime-app-parity-roadmap.md b/docs/runtime-app-parity-roadmap.md index 7c9a7f1..0c61eca 100644 --- a/docs/runtime-app-parity-roadmap.md +++ b/docs/runtime-app-parity-roadmap.md @@ -3,6 +3,7 @@ Eve should exist as one generic app per supported runtime: - Web reference +- Flutter shared graphical client - Fensalir Direct2D / DirectWrite - iOS / UIKit - Android / Kotlin @@ -13,11 +14,23 @@ sends commands through the advertised command boundary. The app is the renderer and local input edge. It is not the provider and not a product-specific dashboard. +Flutter is now the preferred shared graphical client candidate. It does not +promise byte-identical pixels across every platform, especially around text +rasterization, antialiasing, GPU backends, and device scale. It does promise a +much smaller parity problem than rebuilding the same CultUI anatomy in DOM, +UIKit, Android Views, and Direct2D by hand. The bet is that CultUI owns the UI +tree, style tokens, and control anatomy, while Flutter lowers that contract once +for Android, iOS, desktop, and possibly web. + Repixelizer is the first parity target. Its current browser GUI already carries the product feel: pixel fonts, dark shell, blue panels, warm pixel accents, scanlines, image comparison, upload flow, solver progress, and cleanup tools. -The Eve app family should make that surface recognizable across web, Direct2D, -iOS, and Android before expanding into broader product coverage. +The Eve app family should make that surface recognizable across web, Flutter, +Direct2D, iOS, and Android before expanding into broader product coverage. +Recognizable means the fonts are present, spacing/partitioning is coherent, +colors and panels translate, control anatomy survives, and Repixelizer still +feels like Repixelizer. It does not mean screenshot bytes match across all text +engines. ## Authority Map @@ -43,7 +56,7 @@ Inputs: Outputs: -- Native rendered UI in each target runtime +- Rendered UI in each target runtime - Provider command documents or advertised command route calls - Runtime capability/fidelity diagnostics - Optional visual parity snapshots for comparison against the web reference @@ -53,8 +66,8 @@ Derived State: - Selected provider is local Eve app state unless the provider advertises a shared selection document. - Runtime style objects are derived from `surface.styles.tokens`. -- Browser CSS variables, UIKit colors/fonts, Android styles, and DirectWrite - brushes are lowerings, not portable authority. +- Browser CSS variables, Flutter theme/drawing objects, UIKit colors/fonts, + Android styles, and DirectWrite brushes are lowerings, not portable authority. - Visual parity reports are diagnostics, not product truth. Forbidden Writers: @@ -113,7 +126,7 @@ Role: - Canonical behavior oracle. - Fastest fixture runner. -- Visual parity screenshot source. +- Reference/debug lowering for CultUI authoring, providers, and command flow. First cuts: @@ -124,6 +137,31 @@ First cuts: - Add screenshot capture for the Repixelizer first viewport and main app workflow states. +### Flutter Shared Graphical Client + +Role: + +- Preferred cross-platform graphical renderer experiment. +- Candidate shared body for Android, iOS, desktop, and possibly web. +- Primary place to prove CultUI partitions, standard controls, control anatomy, + and Repixelizer style tokens can be lowered once instead of repeatedly + reimplemented per native toolkit. + +First cuts: + +- Scaffold a generic Eve Flutter app with the same provider picker as web. +- Load the same local provider advertisements and local fixture surfaces during + development. +- Lower `surface.root` recursively into Flutter widgets/custom painters. +- Lower CultUI partitions, `fieldRow`, labels, cards, buttons, metrics, and + slider anatomy from `control.box`, `control.part`, and `control.hitArea`. +- Map Repixelizer tokens to Flutter fonts, colors, borders, shadows, image + sampling, and panel treatments. +- Package or load Repixelizer fonts and verify they render on every Flutter + target. +- Emit commands through the same `gamecult.eve.command.v1` shape as web. +- Capture parity screenshots for the CultUI Inspector and Repixelizer fixtures. + ### Fensalir Direct2D Role: @@ -144,7 +182,8 @@ First cuts: Role: -- Native multitouch Eve app and sensor edge. +- Native multitouch Eve app and sensor edge when direct UIKit ownership earns + its keep beyond Flutter. First cuts: @@ -158,7 +197,8 @@ First cuts: Role: -- Native Kotlin Eve app and Periwinkle device edge. +- Native Kotlin Eve app and Periwinkle device edge when direct Android + ownership earns its keep beyond Flutter. First cuts: @@ -175,9 +215,12 @@ Repixelizer parity starts with recognizability, not total editor feature completion. Each runtime should first prove: - provider picker can open Repixelizer; -- title/body fonts preserve the pixel-art profile; +- title/body fonts are present and preserve the pixel-art profile well enough + to be recognizable; - background, panel, text, muted text, accent, border, and shadow tokens lower visibly; +- partition structure, padding, gaps, and standard control anatomy lower without + runtime-specific reinvention; - shell frame, card hierarchy, metrics, and primary action controls match the surface structure; - image assets render with pixelated sampling; @@ -200,5 +243,7 @@ Minimum parity verification should cover: - screenshot or frame capture for the first viewport where the runtime supports it. -The web reference remains the visual oracle until a better cross-runtime -snapshot harness exists. +The web reference remains the fastest behavior/debug oracle. Flutter should +become the preferred graphical parity oracle if it proves the CultUI Inspector +and Repixelizer fixtures can stay recognizable across its target platforms with +less duplicate renderer work.