vim.rs

   1//! Vim support for Zed.
   2
   3#[cfg(test)]
   4mod test;
   5
   6mod change_list;
   7mod command;
   8mod editor_events;
   9mod insert;
  10mod mode_indicator;
  11mod motion;
  12mod normal;
  13mod object;
  14mod replace;
  15mod state;
  16mod surrounds;
  17mod visual;
  18
  19use anyhow::Result;
  20use change_list::push_to_change_list;
  21use collections::HashMap;
  22use command_palette_hooks::{CommandPaletteFilter, CommandPaletteInterceptor};
  23use editor::{
  24    movement::{self, FindRange},
  25    Anchor, Bias, Editor, EditorEvent, EditorMode, ToPoint,
  26};
  27use gpui::{
  28    actions, impl_actions, Action, AppContext, EntityId, FocusableView, Global, KeystrokeEvent,
  29    Subscription, UpdateGlobal, View, ViewContext, WeakView, WindowContext,
  30};
  31use language::{CursorShape, Point, SelectionGoal, TransactionId};
  32pub use mode_indicator::ModeIndicator;
  33use motion::Motion;
  34use normal::{
  35    mark::create_visual_marks,
  36    normal_replace,
  37    repeat::{observe_action, observe_insertion, record_register, replay_register},
  38};
  39use replace::multi_replace;
  40use schemars::JsonSchema;
  41use serde::Deserialize;
  42use serde_derive::Serialize;
  43use settings::{update_settings_file, Settings, SettingsSources, SettingsStore};
  44use state::{EditorState, Mode, Operator, RecordedSelection, Register, WorkspaceState};
  45use std::{ops::Range, sync::Arc};
  46use surrounds::{add_surrounds, change_surrounds, delete_surrounds, SurroundsType};
  47use ui::BorrowAppContext;
  48use visual::{visual_block_motion, visual_replace};
  49use workspace::{self, Workspace};
  50
  51use crate::state::ReplayableAction;
  52
  53/// Whether or not to enable Vim mode (work in progress).
  54///
  55/// Default: false
  56pub struct VimModeSetting(pub bool);
  57
  58/// An Action to Switch between modes
  59#[derive(Clone, Deserialize, PartialEq)]
  60pub struct SwitchMode(pub Mode);
  61
  62/// PushOperator is used to put vim into a "minor" mode,
  63/// where it's waiting for a specific next set of keystrokes.
  64/// For example 'd' needs a motion to complete.
  65#[derive(Clone, Deserialize, PartialEq)]
  66pub struct PushOperator(pub Operator);
  67
  68/// Number is used to manage vim's count. Pushing a digit
  69/// multiplis the current value by 10 and adds the digit.
  70#[derive(Clone, Deserialize, PartialEq)]
  71struct Number(usize);
  72
  73#[derive(Clone, Deserialize, PartialEq)]
  74struct SelectRegister(String);
  75
  76actions!(
  77    vim,
  78    [
  79        ClearOperators,
  80        Tab,
  81        Enter,
  82        Object,
  83        InnerObject,
  84        FindForward,
  85        FindBackward,
  86        OpenDefaultKeymap
  87    ]
  88);
  89
  90// in the workspace namespace so it's not filtered out when vim is disabled.
  91actions!(workspace, [ToggleVimMode]);
  92
  93impl_actions!(vim, [SwitchMode, PushOperator, Number, SelectRegister]);
  94
  95/// Initializes the `vim` crate.
  96pub fn init(cx: &mut AppContext) {
  97    cx.set_global(Vim::default());
  98    VimModeSetting::register(cx);
  99    VimSettings::register(cx);
 100
 101    cx.observe_keystrokes(observe_keystrokes).detach();
 102    editor_events::init(cx);
 103
 104    cx.observe_new_views(|workspace: &mut Workspace, cx| register(workspace, cx))
 105        .detach();
 106
 107    // Any time settings change, update vim mode to match. The Vim struct
 108    // will be initialized as disabled by default, so we filter its commands
 109    // out when starting up.
 110    CommandPaletteFilter::update_global(cx, |filter, _| {
 111        filter.hide_namespace(Vim::NAMESPACE);
 112    });
 113    Vim::update_global(cx, |vim, cx| {
 114        vim.set_enabled(VimModeSetting::get_global(cx).0, cx)
 115    });
 116    cx.observe_global::<SettingsStore>(|cx| {
 117        Vim::update_global(cx, |vim, cx| {
 118            vim.set_enabled(VimModeSetting::get_global(cx).0, cx)
 119        });
 120    })
 121    .detach();
 122}
 123
 124fn register(workspace: &mut Workspace, cx: &mut ViewContext<Workspace>) {
 125    workspace.register_action(|_: &mut Workspace, &SwitchMode(mode): &SwitchMode, cx| {
 126        Vim::update(cx, |vim, cx| vim.switch_mode(mode, false, cx))
 127    });
 128    workspace.register_action(
 129        |_: &mut Workspace, PushOperator(operator): &PushOperator, cx| {
 130            Vim::update(cx, |vim, cx| vim.push_operator(operator.clone(), cx))
 131        },
 132    );
 133    workspace.register_action(|_: &mut Workspace, _: &ClearOperators, cx| {
 134        Vim::update(cx, |vim, cx| vim.clear_operator(cx))
 135    });
 136    workspace.register_action(|_: &mut Workspace, n: &Number, cx: _| {
 137        Vim::update(cx, |vim, cx| vim.push_count_digit(n.0, cx));
 138    });
 139    workspace.register_action(|_: &mut Workspace, _: &Tab, cx| {
 140        Vim::active_editor_input_ignored(" ".into(), cx)
 141    });
 142
 143    workspace.register_action(|_: &mut Workspace, _: &Enter, cx| {
 144        Vim::active_editor_input_ignored("\n".into(), cx)
 145    });
 146
 147    workspace.register_action(|workspace: &mut Workspace, _: &ToggleVimMode, cx| {
 148        let fs = workspace.app_state().fs.clone();
 149        let currently_enabled = VimModeSetting::get_global(cx).0;
 150        update_settings_file::<VimModeSetting>(fs, cx, move |setting| {
 151            *setting = Some(!currently_enabled)
 152        })
 153    });
 154
 155    workspace.register_action(|_: &mut Workspace, _: &OpenDefaultKeymap, cx| {
 156        cx.emit(workspace::Event::OpenBundledFile {
 157            text: settings::vim_keymap(),
 158            title: "Default Vim Bindings",
 159            language: "JSON",
 160        });
 161    });
 162
 163    normal::register(workspace, cx);
 164    insert::register(workspace, cx);
 165    motion::register(workspace, cx);
 166    command::register(workspace, cx);
 167    replace::register(workspace, cx);
 168    object::register(workspace, cx);
 169    visual::register(workspace, cx);
 170    change_list::register(workspace, cx);
 171}
 172
 173/// Called whenever an keystroke is typed so vim can observe all actions
 174/// and keystrokes accordingly.
 175fn observe_keystrokes(keystroke_event: &KeystrokeEvent, cx: &mut WindowContext) {
 176    if let Some(action) = keystroke_event
 177        .action
 178        .as_ref()
 179        .map(|action| action.boxed_clone())
 180    {
 181        observe_action(action.boxed_clone(), cx);
 182
 183        // Keystroke is handled by the vim system, so continue forward
 184        if action.name().starts_with("vim::") {
 185            return;
 186        }
 187    } else if cx.has_pending_keystrokes() || keystroke_event.keystroke.is_ime_in_progress() {
 188        return;
 189    }
 190
 191    Vim::update(cx, |vim, cx| match vim.active_operator() {
 192        Some(
 193            Operator::FindForward { .. }
 194            | Operator::FindBackward { .. }
 195            | Operator::Replace
 196            | Operator::AddSurrounds { .. }
 197            | Operator::ChangeSurrounds { .. }
 198            | Operator::DeleteSurrounds
 199            | Operator::Mark
 200            | Operator::Jump { .. }
 201            | Operator::Register
 202            | Operator::RecordRegister
 203            | Operator::ReplayRegister,
 204        ) => {}
 205        Some(_) => {
 206            vim.clear_operator(cx);
 207        }
 208        _ => {}
 209    });
 210}
 211
 212/// The state pertaining to Vim mode.
 213#[derive(Default)]
 214struct Vim {
 215    active_editor: Option<WeakView<Editor>>,
 216    editor_subscription: Option<Subscription>,
 217    enabled: bool,
 218    editor_states: HashMap<EntityId, EditorState>,
 219    workspace_state: WorkspaceState,
 220    default_state: EditorState,
 221}
 222
 223impl Global for Vim {}
 224
 225impl Vim {
 226    /// The namespace for Vim actions.
 227    const NAMESPACE: &'static str = "vim";
 228
 229    fn read(cx: &mut AppContext) -> &Self {
 230        cx.global::<Self>()
 231    }
 232
 233    fn update<F, S>(cx: &mut WindowContext, update: F) -> S
 234    where
 235        F: FnOnce(&mut Self, &mut WindowContext) -> S,
 236    {
 237        cx.update_global(update)
 238    }
 239
 240    fn activate_editor(&mut self, editor: View<Editor>, cx: &mut WindowContext) {
 241        if !editor.read(cx).use_modal_editing() {
 242            return;
 243        }
 244
 245        self.active_editor = Some(editor.clone().downgrade());
 246        self.editor_subscription = Some(cx.subscribe(&editor, |editor, event, cx| match event {
 247            EditorEvent::SelectionsChanged { local: true } => {
 248                if editor.read(cx).leader_peer_id().is_none() {
 249                    Vim::update(cx, |vim, cx| {
 250                        vim.local_selections_changed(editor, cx);
 251                    })
 252                }
 253            }
 254            EditorEvent::InputIgnored { text } => {
 255                Vim::active_editor_input_ignored(text.clone(), cx);
 256                observe_insertion(text, None, cx)
 257            }
 258            EditorEvent::InputHandled {
 259                text,
 260                utf16_range_to_replace: range_to_replace,
 261            } => observe_insertion(text, range_to_replace.clone(), cx),
 262            EditorEvent::TransactionBegun { transaction_id } => Vim::update(cx, |vim, cx| {
 263                vim.transaction_begun(*transaction_id, cx);
 264            }),
 265            EditorEvent::TransactionUndone { transaction_id } => Vim::update(cx, |vim, cx| {
 266                vim.transaction_undone(transaction_id, cx);
 267            }),
 268            EditorEvent::Edited { .. } => {
 269                Vim::update(cx, |vim, cx| vim.transaction_ended(editor, cx))
 270            }
 271            EditorEvent::FocusedIn => Vim::update(cx, |vim, cx| vim.sync_vim_settings(cx)),
 272            _ => {}
 273        }));
 274
 275        let editor = editor.read(cx);
 276        let editor_mode = editor.mode();
 277        let newest_selection_empty = editor.selections.newest::<usize>(cx).is_empty();
 278
 279        if editor_mode == EditorMode::Full
 280                && !newest_selection_empty
 281                && self.state().mode == Mode::Normal
 282                // When following someone, don't switch vim mode.
 283                && editor.leader_peer_id().is_none()
 284        {
 285            self.switch_mode(Mode::Visual, true, cx);
 286        }
 287
 288        self.sync_vim_settings(cx);
 289    }
 290
 291    fn update_active_editor<S>(
 292        &mut self,
 293        cx: &mut WindowContext,
 294        update: impl FnOnce(&mut Vim, &mut Editor, &mut ViewContext<Editor>) -> S,
 295    ) -> Option<S> {
 296        let editor = self.active_editor.clone()?.upgrade()?;
 297        Some(editor.update(cx, |editor, cx| update(self, editor, cx)))
 298    }
 299
 300    fn editor_selections(&mut self, cx: &mut WindowContext) -> Vec<Range<Anchor>> {
 301        self.update_active_editor(cx, |_, editor, _| {
 302            editor
 303                .selections
 304                .disjoint_anchors()
 305                .iter()
 306                .map(|selection| selection.tail()..selection.head())
 307                .collect()
 308        })
 309        .unwrap_or_default()
 310    }
 311
 312    /// When doing an action that modifies the buffer, we start recording so that `.`
 313    /// will replay the action.
 314    pub fn start_recording(&mut self, cx: &mut WindowContext) {
 315        if !self.workspace_state.dot_replaying {
 316            self.workspace_state.dot_recording = true;
 317            self.workspace_state.recorded_actions = Default::default();
 318            self.workspace_state.recorded_count = None;
 319
 320            let selections = self
 321                .active_editor
 322                .as_ref()
 323                .and_then(|editor| editor.upgrade())
 324                .map(|editor| {
 325                    let editor = editor.read(cx);
 326                    (
 327                        editor.selections.oldest::<Point>(cx),
 328                        editor.selections.newest::<Point>(cx),
 329                    )
 330                });
 331
 332            if let Some((oldest, newest)) = selections {
 333                self.workspace_state.recorded_selection = match self.state().mode {
 334                    Mode::Visual if newest.end.row == newest.start.row => {
 335                        RecordedSelection::SingleLine {
 336                            cols: newest.end.column - newest.start.column,
 337                        }
 338                    }
 339                    Mode::Visual => RecordedSelection::Visual {
 340                        rows: newest.end.row - newest.start.row,
 341                        cols: newest.end.column,
 342                    },
 343                    Mode::VisualLine => RecordedSelection::VisualLine {
 344                        rows: newest.end.row - newest.start.row,
 345                    },
 346                    Mode::VisualBlock => RecordedSelection::VisualBlock {
 347                        rows: newest.end.row.abs_diff(oldest.start.row),
 348                        cols: newest.end.column.abs_diff(oldest.start.column),
 349                    },
 350                    _ => RecordedSelection::None,
 351                }
 352            } else {
 353                self.workspace_state.recorded_selection = RecordedSelection::None;
 354            }
 355        }
 356    }
 357
 358    pub fn stop_replaying(&mut self, _: &mut WindowContext) {
 359        self.workspace_state.dot_replaying = false;
 360        if let Some(replayer) = self.workspace_state.replayer.take() {
 361            replayer.stop();
 362        }
 363    }
 364
 365    /// When finishing an action that modifies the buffer, stop recording.
 366    /// as you usually call this within a keystroke handler we also ensure that
 367    /// the current action is recorded.
 368    pub fn stop_recording(&mut self) {
 369        if self.workspace_state.dot_recording {
 370            self.workspace_state.stop_recording_after_next_action = true;
 371        }
 372    }
 373
 374    /// Stops recording actions immediately rather than waiting until after the
 375    /// next action to stop recording.
 376    ///
 377    /// This doesn't include the current action.
 378    pub fn stop_recording_immediately(&mut self, action: Box<dyn Action>) {
 379        if self.workspace_state.dot_recording {
 380            self.workspace_state
 381                .recorded_actions
 382                .push(ReplayableAction::Action(action.boxed_clone()));
 383            self.workspace_state.dot_recording = false;
 384            self.workspace_state.stop_recording_after_next_action = false;
 385        }
 386    }
 387
 388    /// Explicitly record one action (equivalents to start_recording and stop_recording)
 389    pub fn record_current_action(&mut self, cx: &mut WindowContext) {
 390        self.start_recording(cx);
 391        self.stop_recording();
 392    }
 393
 394    // When handling an action, you must create visual marks if you will switch to normal
 395    // mode without the default selection behaviour.
 396    fn store_visual_marks(&mut self, cx: &mut WindowContext) {
 397        let mode = self.state().mode;
 398        if mode.is_visual() {
 399            create_visual_marks(self, mode, cx);
 400        }
 401    }
 402
 403    fn switch_mode(&mut self, mode: Mode, leave_selections: bool, cx: &mut WindowContext) {
 404        let state = self.state();
 405        let last_mode = state.mode;
 406        let prior_mode = state.last_mode;
 407        let prior_tx = state.current_tx;
 408        self.update_state(|state| {
 409            state.last_mode = last_mode;
 410            state.mode = mode;
 411            state.operator_stack.clear();
 412            state.selected_register.take();
 413            if mode == Mode::Normal || mode != last_mode {
 414                state.current_tx.take();
 415                state.current_anchor.take();
 416            }
 417        });
 418        if mode != Mode::Insert && mode != Mode::Replace {
 419            self.take_count(cx);
 420        }
 421
 422        // Sync editor settings like clip mode
 423        self.sync_vim_settings(cx);
 424
 425        if leave_selections {
 426            return;
 427        }
 428
 429        if !mode.is_visual() && last_mode.is_visual() {
 430            create_visual_marks(self, last_mode, cx);
 431        }
 432
 433        // Adjust selections
 434        self.update_active_editor(cx, |_, editor, cx| {
 435            if last_mode != Mode::VisualBlock && last_mode.is_visual() && mode == Mode::VisualBlock
 436            {
 437                visual_block_motion(true, editor, cx, |_, point, goal| Some((point, goal)))
 438            }
 439            if last_mode == Mode::Insert || last_mode == Mode::Replace {
 440                if let Some(prior_tx) = prior_tx {
 441                    editor.group_until_transaction(prior_tx, cx)
 442                }
 443            }
 444
 445            editor.change_selections(None, cx, |s| {
 446                // we cheat with visual block mode and use multiple cursors.
 447                // the cost of this cheat is we need to convert back to a single
 448                // cursor whenever vim would.
 449                if last_mode == Mode::VisualBlock
 450                    && (mode != Mode::VisualBlock && mode != Mode::Insert)
 451                {
 452                    let tail = s.oldest_anchor().tail();
 453                    let head = s.newest_anchor().head();
 454                    s.select_anchor_ranges(vec![tail..head]);
 455                } else if last_mode == Mode::Insert
 456                    && prior_mode == Mode::VisualBlock
 457                    && mode != Mode::VisualBlock
 458                {
 459                    let pos = s.first_anchor().head();
 460                    s.select_anchor_ranges(vec![pos..pos])
 461                }
 462
 463                let snapshot = s.display_map();
 464                if let Some(pending) = s.pending.as_mut() {
 465                    if pending.selection.reversed && mode.is_visual() && !last_mode.is_visual() {
 466                        let mut end = pending.selection.end.to_point(&snapshot.buffer_snapshot);
 467                        end = snapshot
 468                            .buffer_snapshot
 469                            .clip_point(end + Point::new(0, 1), Bias::Right);
 470                        pending.selection.end = snapshot.buffer_snapshot.anchor_before(end);
 471                    }
 472                }
 473
 474                s.move_with(|map, selection| {
 475                    if last_mode.is_visual() && !mode.is_visual() {
 476                        let mut point = selection.head();
 477                        if !selection.reversed && !selection.is_empty() {
 478                            point = movement::left(map, selection.head());
 479                        }
 480                        selection.collapse_to(point, selection.goal)
 481                    } else if !last_mode.is_visual() && mode.is_visual() {
 482                        if selection.is_empty() {
 483                            selection.end = movement::right(map, selection.start);
 484                        }
 485                    }
 486                });
 487            })
 488        });
 489    }
 490
 491    fn push_count_digit(&mut self, number: usize, cx: &mut WindowContext) {
 492        if self.active_operator().is_some() {
 493            self.update_state(|state| {
 494                state.post_count = Some(state.post_count.unwrap_or(0) * 10 + number)
 495            })
 496        } else {
 497            self.update_state(|state| {
 498                state.pre_count = Some(state.pre_count.unwrap_or(0) * 10 + number)
 499            })
 500        }
 501        // update the keymap so that 0 works
 502        self.sync_vim_settings(cx)
 503    }
 504
 505    fn take_count(&mut self, cx: &mut WindowContext) -> Option<usize> {
 506        if self.workspace_state.dot_replaying {
 507            return self.workspace_state.recorded_count;
 508        }
 509
 510        let count = if self.state().post_count == None && self.state().pre_count == None {
 511            return None;
 512        } else {
 513            Some(self.update_state(|state| {
 514                state.post_count.take().unwrap_or(1) * state.pre_count.take().unwrap_or(1)
 515            }))
 516        };
 517        if self.workspace_state.dot_recording {
 518            self.workspace_state.recorded_count = count;
 519        }
 520        self.sync_vim_settings(cx);
 521        count
 522    }
 523
 524    fn select_register(&mut self, register: Arc<str>, cx: &mut WindowContext) {
 525        self.update_state(|state| {
 526            if register.chars().count() == 1 {
 527                state
 528                    .selected_register
 529                    .replace(register.chars().next().unwrap());
 530            }
 531            state.operator_stack.clear();
 532        });
 533        self.sync_vim_settings(cx);
 534    }
 535
 536    fn write_registers(
 537        &mut self,
 538        content: Register,
 539        register: Option<char>,
 540        is_yank: bool,
 541        linewise: bool,
 542        cx: &mut ViewContext<Editor>,
 543    ) {
 544        if let Some(register) = register {
 545            let lower = register.to_lowercase().next().unwrap_or(register);
 546            if lower != register {
 547                let current = self.workspace_state.registers.entry(lower).or_default();
 548                current.text = (current.text.to_string() + &content.text).into();
 549                // not clear how to support appending to registers with multiple cursors
 550                current.clipboard_selections.take();
 551                let yanked = current.clone();
 552                self.workspace_state.registers.insert('"', yanked);
 553            } else {
 554                self.workspace_state.registers.insert('"', content.clone());
 555                match lower {
 556                    '_' | ':' | '.' | '%' | '#' | '=' | '/' => {}
 557                    '+' => {
 558                        cx.write_to_clipboard(content.into());
 559                    }
 560                    '*' => {
 561                        #[cfg(target_os = "linux")]
 562                        cx.write_to_primary(content.into());
 563                        #[cfg(not(target_os = "linux"))]
 564                        cx.write_to_clipboard(content.into());
 565                    }
 566                    '"' => {
 567                        self.workspace_state.registers.insert('0', content.clone());
 568                        self.workspace_state.registers.insert('"', content);
 569                    }
 570                    _ => {
 571                        self.workspace_state.registers.insert(lower, content);
 572                    }
 573                }
 574            }
 575        } else {
 576            let setting = VimSettings::get_global(cx).use_system_clipboard;
 577            if setting == UseSystemClipboard::Always
 578                || setting == UseSystemClipboard::OnYank && is_yank
 579            {
 580                self.workspace_state.last_yank.replace(content.text.clone());
 581                cx.write_to_clipboard(content.clone().into());
 582            } else {
 583                self.workspace_state.last_yank = cx
 584                    .read_from_clipboard()
 585                    .map(|item| item.text().to_owned().into());
 586            }
 587
 588            self.workspace_state.registers.insert('"', content.clone());
 589            if is_yank {
 590                self.workspace_state.registers.insert('0', content);
 591            } else {
 592                let contains_newline = content.text.contains('\n');
 593                if !contains_newline {
 594                    self.workspace_state.registers.insert('-', content.clone());
 595                }
 596                if linewise || contains_newline {
 597                    let mut content = content;
 598                    for i in '1'..'8' {
 599                        if let Some(moved) = self.workspace_state.registers.insert(i, content) {
 600                            content = moved;
 601                        } else {
 602                            break;
 603                        }
 604                    }
 605                }
 606            }
 607        }
 608    }
 609
 610    fn read_register(
 611        &mut self,
 612        register: Option<char>,
 613        editor: Option<&mut Editor>,
 614        cx: &mut WindowContext,
 615    ) -> Option<Register> {
 616        let Some(register) = register.filter(|reg| *reg != '"') else {
 617            let setting = VimSettings::get_global(cx).use_system_clipboard;
 618            return match setting {
 619                UseSystemClipboard::Always => cx.read_from_clipboard().map(|item| item.into()),
 620                UseSystemClipboard::OnYank if self.system_clipboard_is_newer(cx) => {
 621                    cx.read_from_clipboard().map(|item| item.into())
 622                }
 623                _ => self.workspace_state.registers.get(&'"').cloned(),
 624            };
 625        };
 626        let lower = register.to_lowercase().next().unwrap_or(register);
 627        match lower {
 628            '_' | ':' | '.' | '#' | '=' => None,
 629            '+' => cx.read_from_clipboard().map(|item| item.into()),
 630            '*' => {
 631                #[cfg(target_os = "linux")]
 632                {
 633                    cx.read_from_primary().map(|item| item.into())
 634                }
 635                #[cfg(not(target_os = "linux"))]
 636                {
 637                    cx.read_from_clipboard().map(|item| item.into())
 638                }
 639            }
 640            '%' => editor.and_then(|editor| {
 641                let selection = editor.selections.newest::<Point>(cx);
 642                if let Some((_, buffer, _)) = editor
 643                    .buffer()
 644                    .read(cx)
 645                    .excerpt_containing(selection.head(), cx)
 646                {
 647                    buffer
 648                        .read(cx)
 649                        .file()
 650                        .map(|file| file.path().to_string_lossy().to_string().into())
 651                } else {
 652                    None
 653                }
 654            }),
 655            _ => self.workspace_state.registers.get(&lower).cloned(),
 656        }
 657    }
 658
 659    fn system_clipboard_is_newer(&self, cx: &mut AppContext) -> bool {
 660        cx.read_from_clipboard().is_some_and(|item| {
 661            if let Some(last_state) = &self.workspace_state.last_yank {
 662                last_state != item.text()
 663            } else {
 664                true
 665            }
 666        })
 667    }
 668
 669    fn push_operator(&mut self, operator: Operator, cx: &mut WindowContext) {
 670        if matches!(
 671            operator,
 672            Operator::Change
 673                | Operator::Delete
 674                | Operator::Replace
 675                | Operator::Indent
 676                | Operator::Outdent
 677                | Operator::Lowercase
 678                | Operator::Uppercase
 679                | Operator::OppositeCase
 680                | Operator::ToggleComments
 681        ) {
 682            self.start_recording(cx)
 683        };
 684        // Since these operations can only be entered with pre-operators,
 685        // we need to clear the previous operators when pushing,
 686        // so that the current stack is the most correct
 687        if matches!(
 688            operator,
 689            Operator::AddSurrounds { .. }
 690                | Operator::ChangeSurrounds { .. }
 691                | Operator::DeleteSurrounds
 692        ) {
 693            self.update_state(|state| state.operator_stack.clear());
 694            if let Operator::AddSurrounds { target: None } = operator {
 695                self.start_recording(cx);
 696            }
 697        };
 698        self.update_state(|state| state.operator_stack.push(operator));
 699        self.sync_vim_settings(cx);
 700    }
 701
 702    fn maybe_pop_operator(&mut self) -> Option<Operator> {
 703        self.update_state(|state| state.operator_stack.pop())
 704    }
 705
 706    fn pop_operator(&mut self, cx: &mut WindowContext) -> Operator {
 707        let popped_operator = self.update_state(|state| state.operator_stack.pop())
 708            .expect("Operator popped when no operator was on the stack. This likely means there is an invalid keymap config");
 709        self.sync_vim_settings(cx);
 710        popped_operator
 711    }
 712
 713    fn clear_operator(&mut self, cx: &mut WindowContext) {
 714        self.take_count(cx);
 715        self.update_state(|state| {
 716            state.selected_register.take();
 717            state.operator_stack.clear()
 718        });
 719        self.sync_vim_settings(cx);
 720    }
 721
 722    fn active_operator(&self) -> Option<Operator> {
 723        self.state().operator_stack.last().cloned()
 724    }
 725
 726    fn transaction_begun(&mut self, transaction_id: TransactionId, _: &mut WindowContext) {
 727        self.update_state(|state| {
 728            let mode = if (state.mode == Mode::Insert
 729                || state.mode == Mode::Replace
 730                || state.mode == Mode::Normal)
 731                && state.current_tx.is_none()
 732            {
 733                state.current_tx = Some(transaction_id);
 734                state.last_mode
 735            } else {
 736                state.mode
 737            };
 738            if mode == Mode::VisualLine || mode == Mode::VisualBlock {
 739                state.undo_modes.insert(transaction_id, mode);
 740            }
 741        });
 742    }
 743
 744    fn transaction_undone(&mut self, transaction_id: &TransactionId, cx: &mut WindowContext) {
 745        match self.state().mode {
 746            Mode::VisualLine | Mode::VisualBlock | Mode::Visual => {
 747                self.update_active_editor(cx, |vim, editor, cx| {
 748                    let original_mode = vim.state().undo_modes.get(transaction_id);
 749                    editor.change_selections(None, cx, |s| match original_mode {
 750                        Some(Mode::VisualLine) => {
 751                            s.move_with(|map, selection| {
 752                                selection.collapse_to(
 753                                    map.prev_line_boundary(selection.start.to_point(map)).1,
 754                                    SelectionGoal::None,
 755                                )
 756                            });
 757                        }
 758                        Some(Mode::VisualBlock) => {
 759                            let mut first = s.first_anchor();
 760                            first.collapse_to(first.start, first.goal);
 761                            s.select_anchors(vec![first]);
 762                        }
 763                        _ => {
 764                            s.move_with(|map, selection| {
 765                                selection.collapse_to(
 766                                    map.clip_at_line_end(selection.start),
 767                                    selection.goal,
 768                                );
 769                            });
 770                        }
 771                    });
 772                });
 773                self.switch_mode(Mode::Normal, true, cx)
 774            }
 775            Mode::Normal => {
 776                self.update_active_editor(cx, |_, editor, cx| {
 777                    editor.change_selections(None, cx, |s| {
 778                        s.move_with(|map, selection| {
 779                            selection
 780                                .collapse_to(map.clip_at_line_end(selection.end), selection.goal)
 781                        })
 782                    })
 783                });
 784            }
 785            Mode::Insert | Mode::Replace => {}
 786        }
 787    }
 788
 789    fn transaction_ended(&mut self, editor: View<Editor>, cx: &mut WindowContext) {
 790        push_to_change_list(self, editor, cx)
 791    }
 792
 793    fn local_selections_changed(&mut self, editor: View<Editor>, cx: &mut WindowContext) {
 794        let newest = editor.read(cx).selections.newest_anchor().clone();
 795        let is_multicursor = editor.read(cx).selections.count() > 1;
 796
 797        let state = self.state();
 798        if state.mode == Mode::Insert && state.current_tx.is_some() {
 799            if state.current_anchor.is_none() {
 800                self.update_state(|state| state.current_anchor = Some(newest));
 801            } else if state.current_anchor.as_ref().unwrap() != &newest {
 802                if let Some(tx_id) = self.update_state(|state| state.current_tx.take()) {
 803                    self.update_active_editor(cx, |_, editor, cx| {
 804                        editor.group_until_transaction(tx_id, cx)
 805                    });
 806                }
 807            }
 808        } else if state.mode == Mode::Normal && newest.start != newest.end {
 809            if matches!(newest.goal, SelectionGoal::HorizontalRange { .. }) {
 810                self.switch_mode(Mode::VisualBlock, false, cx);
 811            } else {
 812                self.switch_mode(Mode::Visual, false, cx)
 813            }
 814        } else if newest.start == newest.end
 815            && !is_multicursor
 816            && [Mode::Visual, Mode::VisualLine, Mode::VisualBlock].contains(&state.mode)
 817        {
 818            self.switch_mode(Mode::Normal, true, cx);
 819        }
 820    }
 821
 822    fn active_editor_input_ignored(text: Arc<str>, cx: &mut WindowContext) {
 823        if text.is_empty() {
 824            return;
 825        }
 826
 827        match Vim::read(cx).active_operator() {
 828            Some(Operator::FindForward { before }) => {
 829                let find = Motion::FindForward {
 830                    before,
 831                    char: text.chars().next().unwrap(),
 832                    mode: if VimSettings::get_global(cx).use_multiline_find {
 833                        FindRange::MultiLine
 834                    } else {
 835                        FindRange::SingleLine
 836                    },
 837                    smartcase: VimSettings::get_global(cx).use_smartcase_find,
 838                };
 839                Vim::update(cx, |vim, _| {
 840                    vim.workspace_state.last_find = Some(find.clone())
 841                });
 842                motion::motion(find, cx)
 843            }
 844            Some(Operator::FindBackward { after }) => {
 845                let find = Motion::FindBackward {
 846                    after,
 847                    char: text.chars().next().unwrap(),
 848                    mode: if VimSettings::get_global(cx).use_multiline_find {
 849                        FindRange::MultiLine
 850                    } else {
 851                        FindRange::SingleLine
 852                    },
 853                    smartcase: VimSettings::get_global(cx).use_smartcase_find,
 854                };
 855                Vim::update(cx, |vim, _| {
 856                    vim.workspace_state.last_find = Some(find.clone())
 857                });
 858                motion::motion(find, cx)
 859            }
 860            Some(Operator::Replace) => match Vim::read(cx).state().mode {
 861                Mode::Normal => normal_replace(text, cx),
 862                Mode::Visual | Mode::VisualLine | Mode::VisualBlock => visual_replace(text, cx),
 863                _ => Vim::update(cx, |vim, cx| vim.clear_operator(cx)),
 864            },
 865            Some(Operator::AddSurrounds { target }) => match Vim::read(cx).state().mode {
 866                Mode::Normal => {
 867                    if let Some(target) = target {
 868                        add_surrounds(text, target, cx);
 869                        Vim::update(cx, |vim, cx| vim.clear_operator(cx));
 870                    }
 871                }
 872                Mode::Visual | Mode::VisualLine | Mode::VisualBlock => {
 873                    add_surrounds(text, SurroundsType::Selection, cx);
 874                    Vim::update(cx, |vim, cx| vim.clear_operator(cx));
 875                }
 876                _ => Vim::update(cx, |vim, cx| vim.clear_operator(cx)),
 877            },
 878            Some(Operator::ChangeSurrounds { target }) => match Vim::read(cx).state().mode {
 879                Mode::Normal => {
 880                    if let Some(target) = target {
 881                        change_surrounds(text, target, cx);
 882                        Vim::update(cx, |vim, cx| vim.clear_operator(cx));
 883                    }
 884                }
 885                _ => Vim::update(cx, |vim, cx| vim.clear_operator(cx)),
 886            },
 887            Some(Operator::DeleteSurrounds) => match Vim::read(cx).state().mode {
 888                Mode::Normal => {
 889                    delete_surrounds(text, cx);
 890                    Vim::update(cx, |vim, cx| vim.clear_operator(cx));
 891                }
 892                _ => Vim::update(cx, |vim, cx| vim.clear_operator(cx)),
 893            },
 894            Some(Operator::Mark) => Vim::update(cx, |vim, cx| {
 895                normal::mark::create_mark(vim, text, false, cx)
 896            }),
 897            Some(Operator::RecordRegister) => record_register(text.chars().next().unwrap(), cx),
 898            Some(Operator::ReplayRegister) => replay_register(text.chars().next().unwrap(), cx),
 899            Some(Operator::Register) => Vim::update(cx, |vim, cx| match vim.state().mode {
 900                Mode::Insert => {
 901                    vim.update_active_editor(cx, |vim, editor, cx| {
 902                        if let Some(register) =
 903                            vim.read_register(text.chars().next(), Some(editor), cx)
 904                        {
 905                            editor.do_paste(
 906                                &register.text.to_string(),
 907                                register.clipboard_selections.clone(),
 908                                false,
 909                                cx,
 910                            )
 911                        }
 912                    });
 913                    vim.clear_operator(cx);
 914                }
 915                _ => {
 916                    vim.select_register(text, cx);
 917                }
 918            }),
 919            Some(Operator::Jump { line }) => normal::mark::jump(text, line, cx),
 920            _ => match Vim::read(cx).state().mode {
 921                Mode::Replace => multi_replace(text, cx),
 922                _ => {}
 923            },
 924        }
 925    }
 926
 927    fn set_enabled(&mut self, enabled: bool, cx: &mut AppContext) {
 928        if self.enabled == enabled {
 929            return;
 930        }
 931        if !enabled {
 932            CommandPaletteInterceptor::update_global(cx, |interceptor, _| {
 933                interceptor.clear();
 934            });
 935            CommandPaletteFilter::update_global(cx, |filter, _| {
 936                filter.hide_namespace(Self::NAMESPACE);
 937            });
 938            *self = Default::default();
 939            return;
 940        }
 941
 942        self.enabled = true;
 943        CommandPaletteFilter::update_global(cx, |filter, _| {
 944            filter.show_namespace(Self::NAMESPACE);
 945        });
 946        CommandPaletteInterceptor::update_global(cx, |interceptor, _| {
 947            interceptor.set(Box::new(command::command_interceptor));
 948        });
 949
 950        if let Some(active_window) = cx
 951            .active_window()
 952            .and_then(|window| window.downcast::<Workspace>())
 953        {
 954            active_window
 955                .update(cx, |workspace, cx| {
 956                    let active_editor = workspace.active_item_as::<Editor>(cx);
 957                    if let Some(active_editor) = active_editor {
 958                        self.activate_editor(active_editor, cx);
 959                        self.switch_mode(Mode::Normal, false, cx);
 960                    }
 961                })
 962                .ok();
 963        }
 964    }
 965
 966    /// Returns the state of the active editor.
 967    pub fn state(&self) -> &EditorState {
 968        if let Some(active_editor) = self.active_editor.as_ref() {
 969            if let Some(state) = self.editor_states.get(&active_editor.entity_id()) {
 970                return state;
 971            }
 972        }
 973
 974        &self.default_state
 975    }
 976
 977    /// Updates the state of the active editor.
 978    pub fn update_state<T>(&mut self, func: impl FnOnce(&mut EditorState) -> T) -> T {
 979        let mut state = self.state().clone();
 980        let ret = func(&mut state);
 981
 982        if let Some(active_editor) = self.active_editor.as_ref() {
 983            self.editor_states.insert(active_editor.entity_id(), state);
 984        }
 985
 986        ret
 987    }
 988
 989    fn sync_vim_settings(&mut self, cx: &mut WindowContext) {
 990        self.update_active_editor(cx, |vim, editor, cx| {
 991            let state = vim.state();
 992            editor.set_cursor_shape(state.cursor_shape(), cx);
 993            editor.set_clip_at_line_ends(state.clip_at_line_ends(), cx);
 994            editor.set_collapse_matches(true);
 995            editor.set_input_enabled(state.editor_input_enabled());
 996            editor.set_autoindent(state.should_autoindent());
 997            editor.selections.line_mode = matches!(state.mode, Mode::VisualLine);
 998            if editor.is_focused(cx) || editor.mouse_menu_is_focused(cx) {
 999                editor.set_keymap_context_layer::<Self>(state.keymap_context_layer(), cx);
1000                // disable vim mode if a sub-editor (inline assist, rename, etc.) is focused
1001            } else if editor.focus_handle(cx).contains_focused(cx) {
1002                editor.remove_keymap_context_layer::<Self>(cx);
1003            }
1004        });
1005    }
1006
1007    fn unhook_vim_settings(editor: &mut Editor, cx: &mut ViewContext<Editor>) {
1008        if editor.mode() == EditorMode::Full {
1009            editor.set_cursor_shape(CursorShape::Bar, cx);
1010            editor.set_clip_at_line_ends(false, cx);
1011            editor.set_collapse_matches(false);
1012            editor.set_input_enabled(true);
1013            editor.set_autoindent(true);
1014            editor.selections.line_mode = false;
1015        }
1016        editor.remove_keymap_context_layer::<Self>(cx)
1017    }
1018}
1019
1020impl Settings for VimModeSetting {
1021    const KEY: Option<&'static str> = Some("vim_mode");
1022
1023    type FileContent = Option<bool>;
1024
1025    fn load(sources: SettingsSources<Self::FileContent>, _: &mut AppContext) -> Result<Self> {
1026        Ok(Self(sources.user.copied().flatten().unwrap_or(
1027            sources.default.ok_or_else(Self::missing_default)?,
1028        )))
1029    }
1030}
1031
1032/// Controls when to use system clipboard.
1033#[derive(Copy, Clone, Debug, Serialize, Deserialize, PartialEq, Eq, JsonSchema)]
1034#[serde(rename_all = "snake_case")]
1035pub enum UseSystemClipboard {
1036    /// Don't use system clipboard.
1037    Never,
1038    /// Use system clipboard.
1039    Always,
1040    /// Use system clipboard for yank operations.
1041    OnYank,
1042}
1043
1044#[derive(Deserialize)]
1045struct VimSettings {
1046    // all vim uses vim clipboard
1047    // vim always uses system cliupbaord
1048    // some magic where yy is system and dd is not.
1049    pub use_system_clipboard: UseSystemClipboard,
1050    pub use_multiline_find: bool,
1051    pub use_smartcase_find: bool,
1052}
1053
1054#[derive(Clone, Default, Serialize, Deserialize, JsonSchema)]
1055struct VimSettingsContent {
1056    pub use_system_clipboard: Option<UseSystemClipboard>,
1057    pub use_multiline_find: Option<bool>,
1058    pub use_smartcase_find: Option<bool>,
1059}
1060
1061impl Settings for VimSettings {
1062    const KEY: Option<&'static str> = Some("vim");
1063
1064    type FileContent = VimSettingsContent;
1065
1066    fn load(sources: SettingsSources<Self::FileContent>, _: &mut AppContext) -> Result<Self> {
1067        sources.json_merge()
1068    }
1069}