Enum ExpandHeight 

pub enum ExpandHeight {
    Half,
    Full,
    Fixed(u16),
}

command-line.expand-height — how tall the expanded : band grows.

Variants

Half

Half the frame height (clamped to a sane minimum). The default, matching the MB.2b/c band.

Full

As tall as the frame allows, leaving a single pane row above.

Fixed(u16)

A fixed number of rows, clamped to what the frame can show.

Implementations

impl ExpandHeight

pub fn rows(&self, frame_height: u16) -> u16

Resolve the policy to a concrete band height for a frame of frame_height rows. Always leaves at least one row for the pane area above the band (max), and never returns 0. Half preserves the original MB.2b clamp (≥3 rows where the frame permits). Pure + total — no panic even for tiny frames (the lower bound is itself clamped to max).

pub fn label(&self) -> String

The on-disk / :set spelling: half, full, or the row count as a bare integer. The inverse of Self::parse_label. Owned (unlike the other value types’ label) because Fixed(n) is formatted.

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

One-line description of this value for the :set value completion marginalia. Fixed shares one description whatever its row count.

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

Parse half, full, or a u16 row count (surrounding whitespace ignored). 0 parses as Fixed(0); Self::rows clamps it up to one row.

Examples

use lattice_config::ExpandHeight;

assert_eq!(ExpandHeight::parse_label(" 12 "), Ok(ExpandHeight::Fixed(12)));
// A 40-row frame: `half` is 20 rows, `full` keeps two rows back.
assert_eq!(ExpandHeight::Half.rows(40), 20);
assert_eq!(ExpandHeight::Full.rows(40), 38);
// Fixed heights clamp to what the frame can show.
assert_eq!(ExpandHeight::Fixed(100).rows(40), 38);
assert!(ExpandHeight::parse_label("tall").is_err());

Trait Implementations

impl Clone for ExpandHeight

fn clone(&self) -> ExpandHeight

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ExpandHeight

impl Debug for ExpandHeight

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

Formats the value using the given formatter.

impl Default for ExpandHeight

fn default() -> ExpandHeight

Returns the “default value” for a type.

impl Eq for ExpandHeight

impl OptionType for ExpandHeight

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

Parse the right-hand side of :set name=value. Errors are surfaced verbatim through the cmdline echo, so the message should read well to the user (mention valid forms when the space is finite). The parser MUST round-trip with format: T::parse(&v.format()) == Ok(v) for every v.

fn format(&self) -> String

Render the current value back to a string (:set foo? echo, the customize buffer view, value comparison). Round-trips with Self::parse.

fn type_label() -> &'static str

Short type label for :describe-option ("boolean", "foldmethod", etc.). Used in help bodies and the customize buffer view.

fn enumerate() -> Option<Vec<&'static str>>

Optional: enumerate valid string forms for :set foo=<Tab> completion. None means “free-form” (no enumerable space – integers, file paths, free strings). The values are &'static str to keep the completion source allocation-free in the common case.

fn enumerate_with_docs() -> Option<Vec<EnumeratedValue>>

Optional: enumerate valid string forms WITH per-value doc strings for the cmdline-completion marginalia column. Default impl wraps Self::enumerate with empty docs; types with rich help override.

fn name_forms(_canonical: &str) -> Vec<String>

Optional: alternative name forms this type accepts for the option name itself. Used by completion to surface the name alongside its negation (:set nu / :set nonu). Default: no extra forms. Booleans return [format!("no{canonical}")].

fn is_bool() -> bool

Whether this type’s option supports :set noFOO. bool returns true; everything else false. Drives the negate path in the cmdline parser.

fn accepts_list() -> bool

Whether this option’s value is list-shaped — i.e. a TOML array at config-load time should be joined into the delimited string Self::parse accepts, rather than rejected as “not applicable to a scalar option”. false for every scalar type (the default); true for list types like crate::ModelineZone. Drives loader::apply_array (ML.5). The :set cmdline path is unaffected — it always passes a string and never sees a TOML array.

fn try_negation_value() -> Result<Self, String>

Negation value (only meaningful for Self::is_bool true). Default: returns Err – the registry guards by checking is_bool() first, so callers that respect the contract won’t observe this. The bool impl returns Ok(false).

fn enumerate_is_exhaustive() -> bool

Whether Self::enumerate is the COMPLETE set of valid values (a closed enum) or a completion hint over an open space.

fn schema() -> ConfigSchema

The declared shape of this type’s values.

fn to_value(&self) -> ConfigValue

This value as a schema-shaped tree.

fn from_value(value: &ConfigValue) -> Result<Self, String>

Rebuild from a tree. Default: the inverse of Self::to_value, deferring to parse so a type’s validation rules apply on this path exactly as they do on :set.

impl PartialEq for ExpandHeight

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ExpandHeight