Skip to main content

LayoutBreakpoint

Enum LayoutBreakpoint 

Source
pub enum LayoutBreakpoint {
    Narrow,
    MediumNarrow,
    Medium,
    Wide,
    UltraWide,
}
Expand description

Responsive layout breakpoint based on terminal width.

§Topology Matrix

SurfaceNarrow (<80)MediumNarrow (80-119)Medium (120-159)Wide (≥160)
SearchSingle pane, focusSide-by-side tightSide-by-side balancedSide-by-side spacious
└ ResultsFull-width or hidemin 35 colsmin 45 colsmin 50 cols
└ DetailFull-width or hidemin 25 colsmin 32 colsmin 34 cols
└ Split handleNone (no split)Active (draggable)Active (draggable)Active (draggable)
└ NavigationFocus toggles paneFocus + mouse + dragFocus + mouse + dragFocus + mouse + drag
AnalyticsCompact chromeStandard chromeFull chrome + tabsFull chrome + tabs
└ Tab barHidden (active only)Hidden (active only)Full tab barFull tab bar
└ Filter summaryHiddenShownShownShown
└ Footer hintsMinimalFull nav hintsFull nav hintsFull nav hints
└ Content viewsmin 20w×4h guardFull area, inline adjustFull area, inline adjustFull area, inline adjust
Detail modalFull-screen overlayFull-screen overlayFull-screen overlayFull-screen overlay
Other modalsCentered, fixedCentered, fixedCentered, fixedCentered, fixed
Footer“narrow”“med-n”“med”“wide”
Inspector“Narrow (<80)”“MedNarrow (80-119)”“Medium (120-159)”“Wide (>=160)”

§Interaction expectations

  • Narrow: Keyboard-primary. Tab/Enter switches between results ↔ detail. No split handle. Mouse clicks work on the visible pane only.
  • MediumNarrow: Both panes visible but tight. Detail shows wrapped message previews (25-col minimum). Split handle is draggable but range is constrained.
  • Medium: Comfortable dual-pane. Both panes have enough room for full content. Split handle draggable within 25–75% range.
  • Wide: Spacious dual-pane. Extra width used for wider result columns and full detail formatting. Split handle draggable within 25–75% range.

§Ultra-narrow fallback

Below ULTRA_NARROW_MIN_WIDTH (30) or ULTRA_NARROW_MIN_HEIGHT (6), the full UI is not rendered. Instead, a compact “terminal too small” message is shown. This prevents layout panics and unreadable content at degenerate sizes (e.g., 10x3). See LayoutBreakpoint::is_ultra_narrow.

§Analytics surface notes

Analytics view content areas do NOT consume LayoutBreakpoint — each view checks its assigned Rect dimensions directly (e.g., area.height < 4 as a minimum guard) and adapts layout inline. The breakpoint drives the outer chrome: header tab bar visibility, filter summary, and footer hint density. See AnalyticsTopology for the per-breakpoint contract.

Variants§

§

Narrow

<80 cols: single pane with tab switching (very tight)

§

MediumNarrow

80-119 cols: side-by-side with tight detail pane

§

Medium

120-159 cols: side-by-side results/detail with balanced ratio

§

Wide

=160 cols: comfortable side-by-side results + detail panes

§

UltraWide

=240 cols: massive screen real-estate with expansive detail pane

Implementations§

Source§

impl LayoutBreakpoint

Source

pub fn from_width(cols: u16) -> Self

Classify from terminal width.

Source

pub fn is_ultra_narrow(width: u16, height: u16) -> bool

Check whether the given dimensions are below the ultra-narrow threshold.

When true, the UI should render a minimal fallback instead of the full surface. This prevents empty/broken layouts at very constrained sizes.

Source

pub fn search_topology(self) -> SearchTopology

Return the search surface topology contract for this breakpoint.

Source

pub fn analytics_topology(self) -> AnalyticsTopology

Return the analytics surface topology contract for this breakpoint.

Source

pub fn visibility_policy(self) -> VisibilityPolicy

Return the visibility policy for optional UI elements at this breakpoint.

Source

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

Short label for the status footer.

Source

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

Descriptive label for the inspector overlay.

Source

pub fn cockpit_topology(self, mode: CockpitMode) -> CockpitTopology

Return the cockpit overlay topology for this breakpoint and mode.

Trait Implementations§

Source§

impl Clone for LayoutBreakpoint

Source§

fn clone(&self) -> LayoutBreakpoint

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for LayoutBreakpoint

Source§

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

Formats the value using the given formatter. Read more
Source§

impl PartialEq for LayoutBreakpoint

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Copy for LayoutBreakpoint

Source§

impl Eq for LayoutBreakpoint

Source§

impl StructuralPartialEq for LayoutBreakpoint

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

Source§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

Source§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

Source§

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> Downcast for T
where T: Any,

Source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Converts Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>, which can then be downcast into Box<dyn ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Converts Rc<Trait> (where Trait: Downcast) to Rc<Any>, which can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
Source§

fn as_any(&self) -> &(dyn Any + 'static)

Converts &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Converts &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
Source§

impl<T> Downcast for T
where T: Any,

Source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
Source§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
Source§

impl<T> DowncastSend for T
where T: Any + Send,

Source§

fn into_any_send(self: Box<T>) -> Box<dyn Any + Send>

Converts Box<Trait> (where Trait: DowncastSend) to Box<dyn Any + Send>, which can then be downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

Source§

fn into_any_sync(self: Box<T>) -> Box<dyn Any + Send + Sync>

Converts Box<Trait> (where Trait: DowncastSync) to Box<dyn Any + Send + Sync>, which can then be downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Converts Arc<Trait> (where Trait: DowncastSync) to Arc<Any>, which can then be downcast into Arc<ConcreteType> where ConcreteType implements Trait.
Source§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

Source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T> Instrument for T

Source§

fn instrument(self, _span: NoopSpan) -> Self

Instruments this future with a span (no-op when disabled).
Source§

fn in_current_span(self) -> Self

Instruments this future with the current span (no-op when disabled).
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> Fruit for T
where T: Send + Downcast,