Enum BufferDisplayPreference 

pub enum BufferDisplayPreference {
    Default,
    PopupCentered,
    PopupCursor,
    FloatingCursor,
    ActivePane,
    SplitHorizontal,
    SplitVertical,
}

User-facing override for a BufferDisplay. Each BufferDisplayCategory gets a typed option keyed <category>.display whose value is one of these variants; the App’s resolver maps the variant to the matching BufferDisplay. Default means “use the built-in default for this category” — the fallback when the user hasn’t set the option explicitly.

Flat (non-parametric) shape so the typed-options system can store + parse it as one scalar; the parametric BufferDisplay variants (Popup(PopupPlacement), Split(SplitOrientation)) are flattened here as PopupCentered / PopupCursor / SplitHorizontal / SplitVertical.

Slice 3c.unify.option-docs-builtin migrated this enum to labeled_enum! — adding a new display preference is now one line; label / parse_label / doc / all are derived automatically.

Variants

Default

The implicit value when no override has been set.

PopupCentered

Centred focused popup (focus moves into the popup). Accepts popup as an alias of popup-centered.

PopupCursor

Focused popup anchored at the cursor.

FloatingCursor

Doc keeps focus, popup auto-dismisses on cursor motion (the hover shape). floating is the canonical short alias.

ActivePane

Swap the buffer into the active pane. Alias pane.

SplitHorizontal

Horizontal split (new pane below). Aliases split, split-horizontal.

SplitVertical

Vertical split (new pane beside). Alias split-vertical.

Implementations

impl BufferDisplayPreference

pub fn label(self) -> &'static str

Canonical string label.

pub fn doc(self) -> &'static str

Short marginalia doc shown in cmdline-completion’s right-aligned column.

pub fn all() -> &'static [Self]

Variants in declaration order.

pub fn parse_label(s: &str) -> Result<Self, String>

Parse from canonical label or any registered alias.

impl BufferDisplayPreference

pub fn resolve(self, category: BufferDisplayCategory) -> BufferDisplay

Map to the concrete BufferDisplay for the given category. Default falls through to default_display; any explicit variant returns its fixed shape.

Examples

use lattice_core::ui::display::{
    BufferDisplay, BufferDisplayCategory, BufferDisplayPreference,
};

// No override: hover keeps its built-in floating popup.
assert_eq!(
    BufferDisplayPreference::Default.resolve(BufferDisplayCategory::Hover),
    BufferDisplay::FLOATING_CURSOR,
);
// `:set lsp.log.display=split` — the alias parses, then resolves.
let pref = BufferDisplayPreference::parse_label("split")
    .unwrap_or_default();
assert_eq!(
    pref.resolve(BufferDisplayCategory::LspLog),
    BufferDisplay::SPLIT_HORIZONTAL,
);

Trait Implementations

impl Clone for BufferDisplayPreference

fn clone(&self) -> BufferDisplayPreference

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for BufferDisplayPreference

impl Debug for BufferDisplayPreference

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BufferDisplayPreference

fn default() -> BufferDisplayPreference

Returns the “default value” for a type.

impl Eq for BufferDisplayPreference

impl PartialEq for BufferDisplayPreference

fn eq(&self, other: &BufferDisplayPreference) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BufferDisplayPreference