Struct LspMode 

pub struct LspMode { /* private fields */ }

lsp-mode – the umbrella minor that gates LSP traffic on a buffer. Cascades to the 15 sub-modes via Mode::implies().

Implementations

impl LspMode

pub fn mode_id() -> ModeId

pub fn new() -> Self

Trait Implementations

impl Default for LspMode

fn default() -> Self

Returns the “default value” for a type.

impl Mode for LspMode

fn keymap(&self) -> Keymap

MO.1: 7 Normal-mode LSP navigation bindings. Scoped to lsp-mode buffers by K.1.c; absent at the Builtin layer.

fn action_handlers(&self) -> Vec<ActionHandlerContribution>

L7 (lsp-architecture.md §16): the handler bodies for the 7 nav chords. Each closure decides only which request to fire and returns the host-owned Effect::Lsp(LspRequest::…); the host’s editor.lsp_request dispatcher runs the (unchanged) async request substrate. The closures read nothing from the ActionContext — the substrate reads live Editor cursor/scroll at apply time, so the popup/jump anchors to the symbol the chord fired on. Global (buffer-agnostic): registered once at boot by the register_mode_action_handlers walk; K.1.c scopes where the chords fire. This is L4b’s gl pattern generalised across the nav surface (feedback_mode_owns_its_surface).

fn gutter_decorations(&self, ctx: &DecorationCtx<'_>) -> Vec<GutterDecoration>

MO.4.a: gutter severity marks. Reads LspDiagnosticsData injected by the renderer for this pane’s buffer URI, aggregates to the max GutterSeverityLevel per line, and emits each as a SIGN (SG.4b).

The aggregation stays here even though per-line contention is now the renderer’s job via priority: collapsing N diagnostics on a line to one mark before crossing is strictly less work than emitting N placements for the renderer to reduce, and the answer is the same either way because the built-in priorities carry the severity order.

type Guard = LspModeGuard

Owned cleanup token returned by [Self::on_activate].

fn id(&self) -> ModeId

Canonical identity. Same value every call.

fn kind(&self) -> ModeKind

Major or minor. Read at registration and on every activation call (activate_major on a minor, or vice versa, is [ModeActivationError::WrongKind]).

fn implies(&self) -> &[ModeId]

Minor modes activating this mode also activates. Used by relative-line-numbers-mode ⇒ line-numbers-mode, and by read-only majors ⇒ read-only-mode.

fn options(&self) -> OptionOverrideSet

Option overrides this mode contributes. Pure declarative (same return value every call); the host merges these into the buffer’s option-resolution layer stack while the mode is active, at the mode’s layer (later-activated minors win ties), and drops them on deactivation. Build with lattice_config::overrides! { lattice_config::Wrap = true, … }.

fn required_capabilities(&self) -> CapabilitySet

Capabilities the mode requires. Validated at activation; missing capability ⇒ [ModeActivationError::MissingCapability], never silent skip.

fn on_activate(&self, ctx: ModeContext) -> LifecycleFuture<'_, Self::Guard>

Lifecycle. Called once per (buffer, activation) cycle after the registry has applied the declarative contributions. Returns an owned Guard carrying every resource the mode allocated. The dispatcher stashes the Guard until deactivation, at which point dropping it performs cleanup via the Guard’s Drop impl.

fn target_buffer_kind(&self) -> Option<BufferKind>

For major modes, the [BufferKind] this mode is the default major for (H.2, 2026-05-31). ModeRegistry::register indexes this so ModeRegistry::find_major_for_kind can dispatch buffer-creation events to the right major without host-side match BufferKind { ... } blocks.

fn target_language(&self) -> Option<&str>

For major modes, the language this mode is the default major for, by canonical name (Lang::name() — "rust", "org") (OM.1). The peer of target_buffer_kind for the dispatch path [BufferKind::Document] takes: language detection rather than kind dispatch.

fn decorations(&self) -> Vec<DecorationProvider>

Decoration providers (gutter / inline / overlay / statusline). Stub — reserved for the WIT plugin path (M.10).

fn completion_sources(&self) -> Vec<CompletionSourceContribution>

Insert-mode completion sources this mode contributes while active on a buffer. Empty by default; minors that own a completion source (lsp-completion-mode, snippet-completion-mode, buffer-words-mode, tree-sitter-completion-mode, path-completion-mode, plugin sources) override.

fn conflicts_with(&self) -> &[ModeId]

Modes this one cannot be active alongside.

fn presents_extensions(&self) -> &[&'static str]

File extensions (lowercase, no dot) this major PRESENTS rather than edits — the file is never loaded as text.

fn mirrors_option(&self) -> Option<&'static str>

Declarative mirror hint for “this mode is the on/off switch for a typed option of the same observable state”. Some(canonical_name) ⇒ a host-driven cascade keeps the mode’s active state and the option’s value in sync.

fn invocation_runner(&self) -> Option<ModeId>

Invocation-runner discovery (2026-05-26). Modes that own command-invocation dispatch for their buffer kind (terminal-mode, oil-mode, file-tree-mode, help-mode, …) return their canonical [ModeId]; the host registers a runner function under that id at boot, and Editor::run_invocation looks it up by walking the active modes on the active pane’s buffer (minors first, then major) before falling back to the central grammar Action gate.

fn refresh_action(&self) -> Option<&'static str>

Which of this mode’s own actions refreshes its view, or None (the default) when the mode backs nothing refreshable (RV.1, 2026-08-10).

fn fold_toggle_action(&self) -> Option<&'static str>

Which of this mode’s actions <Tab> fires, and the declaration that pulls in foldable-view-mode — the shared minor owning the chord.

fn refresh_on_open(&self) -> bool

Should re-opening this view re-run its refresh?

fn activation_policy(&self) -> ActivationPolicy

A minor mode’s default auto-activation policy (MA.1; mode-architecture.md §7.4). The host’s minor-activation resolver reads this for every registered minor when a buffer enters a major mode, and activates those whose policy admits the entered major. The default is [ActivationPolicy::Manual] — auto-activate nowhere until the mode or the user opts in. Ignored for major modes (a buffer’s major is chosen by the major resolver, not this allowlist).

fn editable_tail(&self) -> Option<EditableTail>

The mode’s editable tail on an otherwise read-only buffer, or None (the default) for a fully read-only / fully writable buffer (AU‑3).