Thing/packages/org.gamecult.eve.surface

Eve Surface Contract

Inventory surfaces may publish irregular shapeCells, optional grid validCells, and payload.* fields. Lowerers use those fields for transient placement previews and forward the namespaced payload through typed drop operations; providers remain the final placement authority.

Eve owns this renderer-neutral package. It defines the retained CultUI surface document, provider advertisement, asset catalog, input vocabulary, and builder primitives shared by providers and lowerers. Headless daemons depend on this package without depending on EveUnity; Unity is one consumer among many.

Components own normal child layout through Children, live CultMesh value bindings through StateBindings, and nested synced document regions through EmbeddedDocuments. An embedded document slot names the child document id, schema, presentation kind, and route hint; renderers resolve that child through CultMesh instead of rebuilding it with runtime-local projection code.

See the surface contract for the full contract and the embedded-surface fixture for parity evidence. Runtime discovery and required feature coverage live in the parity manifest; active GUI runtimes must list embeddedDocuments as a supported feature and require the embedded-surface fixture.

Verification entrypoints:

• clean .NET package consumer: powershell -ExecutionPolicy Bypass -File .\scripts\pack-dotnet-surface.ps1
• C# serialization: dotnet test tests/GameCult.Eve.Surface.Serialization.Tests/GameCult.Eve.Surface.Serialization.Tests.csproj
• Browser/TypeScript: node --test web\eve-dsl.test.mjs
• Semantic runtime matrix: powershell -ExecutionPolicy Bypass -File .\scripts\run-parity-harness.ps1
• Flutter GUI contract, when Flutter is installed: flutter test --plain-name embedded_surface_fixture_contract
• Rust/CultMesh document sync: run cargo test rust_preserves_cultui_embedded_surface_slots_through_typed_document_sync from the sibling CultLib/packages/cultnet-rs directory.

The parity manifest is the discovery source for web, Flutter desktop/Linux/Android, iOS/UIKit, Android/Kotlin, Unity UI Toolkit, and Rust contract coverage. Do not add a new renderer claim without adding its nested-surface fixture requirement there.

EveUnity must not carry another live copy of this package. Its Unity Scene and UI Toolkit packages depend on the released Eve-owned package.