Struct CompilationMode 

pub struct CompilationMode;

Major mode for the *compilation* buffer.

Implementations

impl CompilationMode

pub fn mode_id() -> ModeId

Trait Implementations

impl Mode for CompilationMode

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

MG.RO: read-only-mode is where the operator gate actually is.

ReadOnly = true above stops Insert-mode TYPING and nothing else — it is read by read_only_edit_rejected, which guards the char path, while a Document’s grammar dispatch applies its own edits and hands the host an already-applied Effect::Edits. So x deleted a character out of this buffer while it reported itself read-only. Verified, not inferred.

read-only-mode carries the option AND the invocation_runner (Editor::run_read_only_motion): motions move, : and / fall through, mutating operators echo instead of silently editing. Declared on the MAJOR because an implied mode is followed from the mode being activated.

fn keymap(&self) -> Keymap

<C-c> kill + <CR> jump-to-location. Resolved at host translation time via CommandRegistry against the names registered by lattice-host::actions::populate.

RV.2: gr is deliberately absent — see Self::refresh_action.

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

RV.2 (2026-08-10): recompile is this mode’s refresh.

The chord (gr) lives once on refreshable-view-mode, which the implies cascade activates because this returns Some. The handler body is unchanged — action:compilation-recompile is the same command the mode’s own gr entry used to name directly. See docs/dev/architecture/mode-architecture.md §5.5.

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

OA.4b: this view folds by blocks, so <Tab> / <S-Tab> come from the shared foldable-view-mode. Nothing special to do on a block, so it names the generic body.

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

CM.3c: severity gutter marks for the *compilation* buffer. Reads the per-buffer severity index the renderer injected as [CompilationSeverityData] — produced off-thread by the drain, delivered through render_state (never scanned at paint time) — and maps each (line, level) to a leftmost-gutter [GutterDecoration::Severity], the SAME column LSP diagnostics paint (so no renderer edit is needed). Graceful empty when the service is absent (no marks produced yet, or a stripped render path). O(entries), no allocation proportional to buffer size.

type Guard = CompilationModeGuard

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 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 action_handlers(&self) -> Vec<ActionHandlerContribution>

Global (buffer-agnostic) action handlers this mode contributes (SN.3c.0). The host walks every registered mode’s action_handlers() once at boot, resolves each action_name → CommandId, registers the handler in the ActionHandlerRegistry, and holds the tokens for the app’s lifetime. Use this for handlers that read the active buffer / cursor / services from the ActionContext at call time and close over no per-buffer state (e.g. snippet expand). Per-buffer, session-scoped handlers register in on_activate instead, so their tokens drop with the Guard. Default: none. See feedback_effect_vocabulary_is_host_boundary.

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_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).