// Copyright 2013 The Flutter Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef FLUTTER_SHELL_PLATFORM_WINDOWS_KEYBOARD_HOOK_HANDLER_H_
#define FLUTTER_SHELL_PLATFORM_WINDOWS_KEYBOARD_HOOK_HANDLER_H_

#include "flutter/shell/platform/windows/public/flutter_windows.h"

#include <string>

namespace flutter {

class FlutterWindowsView;

// Interface for classes that handles keyboard input events.
//
// Keyboard handlers are added to |FlutterWindowsView| in a chain.
// When a key event arrives, |KeyboardHook| is called on each handler
// until the first one that returns true. Then the proper text hooks
// are called on each handler.
class KeyboardHandlerBase {
 public:
  virtual ~KeyboardHandlerBase() = default;

  // A function for hooking into keyboard input.
  //
  // Returns true if the key event has been handled, to indicate that other
  // handlers should not be called for this event.
  virtual bool KeyboardHook(FlutterWindowsView* view,
                            int key,
                            int scancode,
                            int action,
                            char32_t character,
                            bool extended,
                            bool was_down) = 0;

  // A function for hooking into Unicode text input.
  virtual void TextHook(FlutterWindowsView* view,
                        const std::u16string& text) = 0;

  // Handler for IME compose begin events.
  //
  // Triggered when the user begins editing composing text using a multi-step
  // input method such as in CJK text input.
  virtual void ComposeBeginHook() = 0;

  // Handler for IME compose commit events.
  //
  // Triggered when the user commits the current composing text while using a
  // multi-step input method such as in CJK text input. Composing continues with
  // the next keypress.
  virtual void ComposeCommitHook() = 0;

  // Handler for IME compose end events.
  //
  // Triggered when the user ends editing composing text while using a
  // multi-step input method such as in CJK text input.
  virtual void ComposeEndHook() = 0;

  // Handler for IME compose change events.
  //
  // Triggered when the user edits the composing text while using a multi-step
  // input method such as in CJK text input.
  virtual void ComposeChangeHook(const std::u16string& text,
                                 int cursor_pos) = 0;
};

}  // namespace flutter

#endif  // FLUTTER_SHELL_PLATFORM_WINDOWS_KEYBOARD_HOOK_HANDLER_H_