Class ModeHandler

src/mode/modeHandler.ts:71–1678

 * See:  https://github.com/VSCodeVim/Vim/blob/master/.github/CONTRIBUTING.md#the-vim-state-machine
 */
export class ModeHandler implements vscode.Disposable, IModeHandler {
  public readonly vimState: VimState;
  public readonly remapState: RemapState;

  public lastMovementFailed: boolean = false;

  public focusChanged = false;

  private searchDecorationCacheKey: { searchString: string; documentVersion: number } | undefined;

  private readonly disposables: vscode.Disposable[] = [];
  private readonly handlerMap: IModeHandlerMap;
  private readonly remappers: Remappers;

  public internalSelectionsTracker = new InternalSelectionsTracker();

  /**
   * Was the previous mouse click past EOL
   */
  private lastClickWasPastEol: boolean = false;

  private _currentMode!: Mode;
  private get currentMode(): Mode {
    return this._currentMode;
  }
  private async setCurrentMode(mode: Mode): Promise<void> {
    if (this.vimState.currentMode !== mode) {
      await this.vimState.setCurrentMode(mode);
    }
    this._currentMode = mode;
  }

  public static async create(
    handlerMap: IModeHandlerMap,
    textEditor: vscode.TextEditor,
  ): Promise<ModeHandler> {
    const modeHandler = new ModeHandler(handlerMap, textEditor);
    await modeHandler.vimState.load();
    await modeHandler.setCurrentMode(configuration.startInInsertMode ? Mode.Insert : Mode.Normal);
    modeHandler.syncCursors();
    return modeHandler;
  }

  private constructor(handlerMap: IModeHandlerMap, textEditor: vscode.TextEditor) {
    this.handlerMap = handlerMap;
    this.remappers = new Remappers();

    this.vimState = new VimState(textEditor, new EasyMotion());
    this.remapState = new RemapState();
    this.disposables.push(this.vimState);
  }

  /**
   * Updates VSCodeVim's internal representation of cursors to match VSCode's selections.
   * This loses some information, so it should only be done when necessary.
   */
  public syncCursors() {
    // TODO: getCursorsAfterSync() is basically this, but stupider