phosphor-layer

Layer-shell surface primitives: Surface, factory, registry, coordinator.

Policy layer on top of phosphor-wayland. Surface is the per-overlay wrapper; SurfaceFactory builds it with injected ILayerShellTransport, IQmlEngineProvider, IScreenProvider, and ISurfaceAnimator. ScreenSurfaceRegistry<T> tracks one-surface-per-screen mappings; TopologyCoordinator debounces screensChanged and reconciles. defaults/ ships bundled implementations (PhosphorWaylandTransport, JsonSurfaceStore, DefaultScreenProvider, NoOpSurfaceAnimator, XdgToplevelTransport) so composition roots wire the common case in three lines.

Full API →

Key types

Surface
Per-overlay wrapper around a layer-shell role.
SurfaceFactory
Stateless builder: SurfaceConfig → Surface.
Role
Enum + metadata for well-known overlay roles.
ScreenSurfaceRegistry<T>
Per-screen surface tracking (template).
TopologyCoordinator
Debounces screensChanged; reconciles registry.
ILayerShellTransport
Adapter into the Wayland binding.
ISurfaceStore
Persistence of per-surface state across restarts.

Dependencies

See also

phosphor-wayland
Default transport binds to its LayerSurface.
phosphor-surfaces
Higher-level surface manager built on these primitives.

References