phosphor-shell-patterns

Named UI-pattern recipes on top of phosphor-layer Role.

The axis-2 vocabulary between wlr-layer-shell wire primitives in phosphor-layer and consumer-side application roles. phosphor-layer exposes domain-agnostic Role bundles of layer, anchors, exclusive zone, and keyboard interactivity; this library names the UI patterns a shell wants (a wallpaper, a panel, a modal, a toast) as ready-to-use Role values, so consumers compose their public roles from named recipes instead of re-deriving the combo each time. Any Phosphor shell links this; PlasmaZones today, Phosphor-as-standalone tomorrow.

Full API →

Key types

Wallpaper
Background-layer Role preset: all anchors, exclusive zone 0, no keyboard.
Panel
Edge-anchored Role factory reserving space via exclusive zone; takes an Edge.
Modal
Top-layer keyboard-grabbing Role preset for modal dialogs.
Toast
Corner-anchored click-through Role factory; takes a Corner.
Hud
Overlay-layer click-through Role preset for drag indicators and highlights.
Floating
Overlay-layer no-anchor Role preset; consumer supplies the position.

Dependencies

See also

phosphor-layer
Provides the Role primitive these recipes compose.
phosphor-overlay
ShellHost uses these patterns when consumers don't supply a custom Role.

References