@quicktvui/ai 1.0.6 → 1.0.8

package/rules/.source/ESCore/src/router/ESRouter.ts

@@ -0,0 +1,364 @@
+import {
+  HistoryLocation,
+  LifecycleState,
+  RouteLocationRaw,
+  Router,
+  RouteRecordRaw,
+  RouterHistory,
+} from "@extscreen/es3-router";
+import { EventBus, Native } from "@extscreen/es3-vue";
+import { createAndroidRouterKeyManager } from "./ESRouterKeyManager.android";
+import { createHarmonyRouterKeyManager } from "./ESRouterKeyManager.harmony";
+
+import {
+  createESRouterLifecycleManager,
+  ESRouterLifecycleManager,
+} from "./ESRouterLifecycleManager";
+import { ESSlotEventName } from "../slot";
+import { ESRouterKeyManager } from "./ESRouterKeyManager";
+
+export interface ESRouterOptions {
+  limit?: number;
+  main?: string;
+  error?: string;
+  routes: Readonly<RouteRecordRaw[]>;
+}
+
+export interface ESRouter extends Router {}
+
+export function initESRouter(router?: ESRouter): Router | undefined {
+  if (!router) {
+    return router;
+  }
+  //-----------------------------------------------------------------------------------
+  // 判断路由的类型
+  // const routeTypes = router.options.types
+  // const index = routeTypes.findIndex((type) => type == ESRouteType.ES_ROUTE_TYPE_SLOT)
+  // const supportSlot = index > -1
+
+  //按键管理
+  const routerKeyManager: ESRouterKeyManager = Native.isOhos()
+    ? createHarmonyRouterKeyManager(router)
+    : createAndroidRouterKeyManager(router);
+
+  //声明周期
+  const routerLifecycleManager: ESRouterLifecycleManager =
+    createESRouterLifecycleManager();
+  //
+  const routerHistory: RouterHistory = router.getRouterHistory();
+  //##############################################################################################
+  //##############################################################################################
+  //---------------------------------------快应用按键事件----------------------------------------------
+  // 快应用按键事件:   hardwareBackPress、DispatchKeyEvent
+  EventBus.$on("hardwareBackPress", () => {
+    console.log("ESRouter: " + "native event:hardwareBackPress");
+    const historyLocationList = routerHistory.getHistoryLocations();
+    if (historyLocationList && historyLocationList.length > 0) {
+      const topHistoryLocation =
+        historyLocationList[historyLocationList.length - 1];
+      routerKeyManager.dispatchBackPressed(topHistoryLocation);
+    }
+  });
+  EventBus.$on("DispatchKeyEvent", (keyEvent) => {
+    console.log("ESRouter: " + "native event:DispatchKeyEvent", keyEvent);
+    const historyLocationList = routerHistory.getHistoryLocations();
+    if (historyLocationList && historyLocationList.length > 0) {
+      const topHistoryLocation =
+        historyLocationList[historyLocationList.length - 1];
+      routerKeyManager.dispatchKeyEvent(topHistoryLocation, keyEvent);
+    }
+  });
+
+  //----------------------------------------鸿蒙按键事件----------------------------------------------
+  EventBus.$on("onKeyEvent", (keyEvent) => {
+    console.log("ESRouter: " + "ohos native event:DispatchKeyEvent", keyEvent);
+    const historyLocationList = routerHistory.getHistoryLocations();
+    if (historyLocationList && historyLocationList.length > 0) {
+      const topHistoryLocation =
+        historyLocationList[historyLocationList.length - 1];
+      routerKeyManager.dispatchKeyEvent(topHistoryLocation, keyEvent);
+    }
+  });
+
+  //##############################################################################################
+  //##############################################################################################
+  //----------------------------------------安卓生命周期----------------------------------------------
+  // 快应用生命周期:   LifecycleChange、OnNewIntent
+  //---------------------------------RouterLifecycleManager-----------------------------------------
+  EventBus.$on("LifecycleChange", (event) => {
+    console.log("ESRouter: " + "native event:LifecycleChange", event);
+    const historyLocationList = routerHistory.getHistoryLocations();
+    if (historyLocationList && historyLocationList.length > 0) {
+      const topHistoryLocation =
+        historyLocationList[historyLocationList.length - 1];
+      if (event === "onCreate") {
+        routerLifecycleManager.onESCreate(topHistoryLocation);
+      } else if (event === "onRestart") {
+        routerLifecycleManager.onESRestart(topHistoryLocation);
+      } else if (event === "onStart") {
+        //20250610:使用router进行生命周期的处理 1.2.0版本
+        // routerLifecycleManager.onESStart(topHistoryLocation);
+      } else if (event === "onResume") {
+        //20250610:使用router进行生命周期的处理 1.2.0版本
+        // routerLifecycleManager.onESResume(topHistoryLocation);
+        console.log("ESRouter: " + "使用router进行生命周期的处理");
+        router.setActive(true);
+      } else if (event === "onPause") {
+        routerLifecycleManager.onESPause(topHistoryLocation);
+        router.setActive(false);
+      } else if (event === "onStop") {
+        routerLifecycleManager.onESStop(topHistoryLocation);
+      } else if (event === "onDestroy") {
+        routerLifecycleManager.onESDestroy(topHistoryLocation);
+      }
+    }
+  });
+  EventBus.$on("OnNewIntent", (intent) => {
+    console.log("ESRouter: " + "native event:OnNewIntent", intent);
+    const historyLocationList = routerHistory.getHistoryLocations();
+    if (historyLocationList && historyLocationList.length > 0) {
+      const topHistoryLocation =
+        historyLocationList[historyLocationList.length - 1];
+      routerLifecycleManager.onESNewIntent(topHistoryLocation, intent);
+    }
+  });
+  //##############################################################################################
+  //##############################################################################################
+  //----------------------------------------鸿蒙生命周期----------------------------------------------
+  // 快应用生命周期:   LifecycleChange、OnNewIntent
+  //---------------------------------RouterLifecycleManager-----------------------------------------
+  EventBus.$on("onLifecycleEvent", (evt) => {
+    console.log("ESRouter: " + "HarmonyOS native event:onLifecycleEvent", evt);
+    const historyLocationList = routerHistory.getHistoryLocations();
+    const event = evt.name;
+    const params = evt.params;
+    if (historyLocationList && historyLocationList.length > 0) {
+      const topHistoryLocation =
+        historyLocationList[historyLocationList.length - 1];
+      //onCreate
+      if (event === "onAppear") {
+        routerLifecycleManager.onESCreate(topHistoryLocation);
+      }
+      //没有对应的
+      else if (event === "onRestart") {
+        routerLifecycleManager.onESRestart(topHistoryLocation);
+      }
+      //onStart
+      else if (event === "onWillShow") {
+        //20250610:使用router进行生命周期的处理 1.2.0版本
+        // routerLifecycleManager.onESStart(topHistoryLocation);
+      }
+      //onResume
+      else if (event === "onShown") {
+        //20250610:使用router进行生命周期的处理 1.2.0版本
+        // routerLifecycleManager.onESResume(topHistoryLocation);
+        console.log("ESRouter: " + "使用router进行生命周期的处理");
+        router.setActive(true);
+      }
+      //onPause
+      else if (event === "onHidden") {
+        routerLifecycleManager.onESPause(topHistoryLocation);
+        router.setActive(false);
+      }
+      //onStop
+      else if (event === "onWillDisappear") {
+        routerLifecycleManager.onESStop(topHistoryLocation);
+      }
+      //onDestroy
+      else if (event === "onDisappear") {
+        routerLifecycleManager.onESDestroy(topHistoryLocation);
+      }
+      //OnNewIntent
+      else if (event === "onNewParam") {
+        routerLifecycleManager.onESNewIntent(topHistoryLocation, params);
+      }
+    }
+  });
+  //##############################################################################################
+  //##############################################################################################
+  //---------------------------------------------插槽声明周期---------------------------------------
+  // 插槽生命周期:   onStart、onResume、onPause、onStop、
+  //               onBindViewHolder、onViewRecycled、onViewAttachedToWindow、onViewDetachedFromWindow
+  // 插槽事件:      onCustomEvent、onCustomEvent
+  // 插槽按键事件:   onDispatchKeyEvent、onHardwareBackPress
+  //------------------------------------------------------------------------------------------------
+
+  //------------------------------------------插槽声明周期--------------------------------------------
+  EventBus.$on("onStart", (event: RouteLocationRaw) => {
+    console.log("ESRouter: " + "native event:onStart", event);
+    //获取先对应的插槽
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      // if (location.lifecycle >= LifecycleState.stop) {
+      routerLifecycleManager.onESStart(location);
+      // } else {
+      //   console.log("ESRouter: " + "native event:onStart no op!", location.lifecycle)
+      // }
+    } else {
+      console.log(
+        "ESRouter: " + "native event:onStart, location is null, so no op!",
+      );
+    }
+  });
+  EventBus.$on("onResume", (event) => {
+    console.log("ESRouter: " + "native event:onResume", event);
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      // if (location.lifecycle >= LifecycleState.pause) {
+      routerLifecycleManager.onESResume(location);
+      // } else {
+      //   console.log("ESRouter: " + "native event:onResume no op!", location.lifecycle)
+      // }
+    } else {
+      console.log(
+        "ESRouter: " + "native event:onResume, location is null, so no op!",
+      );
+    }
+  });
+  EventBus.$on("onPause", (event: RouteLocationRaw) => {
+    console.log("ESRouter: " + "native event:onPause", event);
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      routerLifecycleManager.onESPause(location);
+    } else {
+      console.log(
+        "ESRouter: " + "native event:onPause, location is null, so no op!",
+      );
+    }
+  });
+  EventBus.$on("onStop", (event: RouteLocationRaw) => {
+    console.log("ESRouter: " + "native event:onStop", event);
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      routerLifecycleManager.onESStop(location);
+    } else {
+      console.log(
+        "ESRouter: " + "native event:onStop, location is null, so no op!",
+      );
+    }
+  });
+  EventBus.$on("onBindViewHolder", (event) => {
+    console.log("ESRouter: " + "native event:onBindViewHolder", event);
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      routerLifecycleManager.onESBind(location, event.params);
+    } else {
+      console.log(
+        "ESRouter: " +
+          "native event:onBindViewHolder, location is null, so no op!",
+      );
+    }
+  });
+  EventBus.$on("onViewRecycled", (event: RouteLocationRaw) => {
+    console.log("ESRouter: " + "native event:onViewRecycled", event);
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      routerLifecycleManager.onESRecycle(location);
+    } else {
+      console.log(
+        "ESRouter: " +
+          "native event:onViewRecycled, location is null, so no op!",
+      );
+    }
+  });
+  EventBus.$on("onViewAttachedToWindow", (event) => {
+    console.log("ESRouter: " + "native event:onViewAttachedToWindow", event);
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      routerLifecycleManager.onESAttached(location, event.params);
+    } else {
+      console.log(
+        "ESRouter: " +
+          "native event:onViewAttachedToWindow, location is null, so no op!",
+      );
+    }
+  });
+  EventBus.$on("onViewDetachedFromWindow", (event) => {
+    console.log("ESRouter: " + "native event:onViewDetachedFromWindow", event);
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      routerLifecycleManager.onESDetached(location, event.params);
+    } else {
+      console.log(
+        "ESRouter: " +
+          "native event:onViewDetachedFromWindow, location is null, so no op!",
+      );
+    }
+  });
+
+  //------------------------------------------插槽事件-----------------------------------------------
+  /**
+   *
+   {
+      "name": "BeJson",
+      "key": "BeJson",
+      "params": {
+          "eventName": "BeJson",
+          "eventData": any
+      }
+    }
+   *
+   */
+  EventBus.$on("onCustomEvent", (event) => {
+    console.log("ESRouter: " + "native event:onCustomEvent", event);
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      routerLifecycleManager.onESSlotEvent(location, event.params);
+    }
+  });
+
+  EventBus.$on("onFocusChanged", (event) => {
+    console.log("ESRouter: " + "native event:onFocusChanged", event);
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      routerLifecycleManager.onESSlotEvent(location, {
+        eventName: ESSlotEventName.ES_SLOT_EVENT_NAME_FOCUS,
+        eventData: {
+          viewName: event.name,
+          isFocused: event.params.gainFocus,
+          direction: event.params.direction,
+        },
+      });
+    }
+  });
+  //--------------------------------------插槽按键---------------------------------------------------
+  EventBus.$on("onHardwareBackPress", (event) => {
+    console.log("ESRouter: " + "native event:onHardwareBackPress");
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      routerKeyManager.dispatchBackPressed(location);
+    } else {
+      console.log(
+        "ESRouter: " +
+          "native event:onHardwareBackPress, location is null, so no op!",
+      );
+    }
+  });
+  EventBus.$on("onDispatchKeyEvent", (event) => {
+    console.log("ESRouter: " + "native event:onDispatchKeyEvent", event);
+    const location = getLocation(routerHistory, event);
+    if (location) {
+      routerKeyManager.dispatchKeyEvent(location, event.params);
+    } else {
+      console.log(
+        "ESRouter: " +
+          "native event:onDispatchKeyEvent, location is null, so no op!",
+      );
+    }
+  });
+  //##############################################################################################
+  return router;
+}
+
+function getLocation(
+  routerHistory: RouterHistory,
+  route,
+): HistoryLocation | undefined {
+  if (!route || !route.key || !route.name) {
+    return undefined;
+  }
+  const key = route.key;
+  const historyLocationList = routerHistory.getHistoryLocations();
+  const history = historyLocationList.find((history) => history.key == key);
+  return history;
+}

package/rules/.source/ESCore/src/router/ESRouterKeyManager.android.ts

@@ -0,0 +1,107 @@
+import { HistoryLocation, Router } from "@extscreen/es3-router";
+import { ESKeyEvent } from "../key";
+import {
+  triggerESLifecycle,
+  hasESLifecycleHook,
+  ESLifecycleKeys,
+} from "@extscreen/es3-vue";
+import { ESRouterKeyManager } from "./ESRouterKeyManager";
+
+export function createAndroidRouterKeyManager(
+  router: Router,
+): ESRouterKeyManager {
+  function dispatchBackPressed(historyLocation: HistoryLocation): void {
+    const instance = historyLocation.instances;
+    if (instance) {
+      // @ts-ignore
+      const hasHooks = hasESLifecycleHook(
+        instance,
+        ESLifecycleKeys.ES_BACK_PRESSED,
+      );
+      // @ts-ignore
+      if (isFunction(instance.onBackPressed) || hasHooks) {
+        //1.
+        if (hasHooks) {
+          try {
+            // @ts-ignore
+            triggerESLifecycle(instance, "backPressed");
+          } catch (e) {}
+        }
+        //2.
+        // @ts-ignore
+        if (isFunction(instance.onBackPressed)) {
+          // @ts-ignore
+          instance.onBackPressed();
+        }
+      } else {
+        router.back();
+      }
+    }
+  }
+
+  function dispatchKeyEvent(
+    historyLocation: HistoryLocation,
+    keyEvent: ESKeyEvent,
+  ): void {
+    const instance = historyLocation.instances;
+    if (!instance) {
+      return;
+    }
+    // @ts-ignore
+    const hasHooks = hasESLifecycleHook(
+      instance,
+      ESLifecycleKeys.ES_DISPATCH_KEY_EVENT,
+    );
+    // @ts-ignore
+    if (isFunction(instance.onDispatchKeyEvent) || hasHooks) {
+      //1.
+      if (hasHooks) {
+        try {
+          // @ts-ignore
+          triggerESLifecycle(instance, "dispatchKeyEvent", keyEvent);
+        } catch (e) {}
+      }
+      //2.
+      // @ts-ignore
+      if (isFunction(instance.onDispatchKeyEvent)) {
+        // @ts-ignore
+        instance.onDispatchKeyEvent(keyEvent);
+      }
+    } else {
+      if (keyEvent && keyEvent.action === 0) {
+        try {
+          // @ts-ignore
+          triggerESLifecycle(instance, "keyDown", keyEvent);
+        } catch (e) {}
+
+        // @ts-ignore
+        if (isFunction(instance.onKeyDown)) {
+          // @ts-ignore
+          instance.onKeyDown(keyEvent);
+        }
+      } else if (keyEvent && keyEvent.action === 1) {
+        try {
+          // @ts-ignore
+          triggerESLifecycle(instance!, "keyUp", keyEvent);
+        } catch (e) {}
+
+        // @ts-ignore
+        if (isFunction(instance.onKeyUp)) {
+          // @ts-ignore
+          instance.onKeyUp(keyEvent);
+        }
+      }
+    }
+  }
+
+  function isFunction(func) {
+    return Object.prototype.toString.call(func) === "[object Function]";
+  }
+
+  const routerKeyManager: ESRouterKeyManager = {
+    dispatchBackPressed,
+    dispatchKeyEvent,
+  };
+
+  return routerKeyManager;
+}

package/rules/.source/ESCore/src/router/ESRouterKeyManager.harmony.ts

@@ -0,0 +1,205 @@
+import { HistoryLocation, Router } from "@extscreen/es3-router";
+import { ESKeyEvent } from "../key";
+import {
+  triggerESLifecycle,
+  hasESLifecycleHook,
+  ESLifecycleKeys,
+} from "@extscreen/es3-vue";
+import { ESRouterKeyManager } from "./ESRouterKeyManager";
+
+const HarmonyToAndroidKeyMap: Record<number, number> = {
+  2054: 66, // ENTER
+  2016: 23, // DPAD_CENTER
+  2012: 19, // DPAD_UP
+  2013: 20, // DPAD_DOWN
+  2014: 21, // DPAD_LEFT
+  2015: 22, // DPAD_RIGHT
+  2: 4, // BACK
+  2070: 111, // ESCAPE
+  2067: 82, // MENU
+  9: 84, // SEARCH
+  2101: 142, // F12
+  2061: 73, // BACKSLASH
+};
+
+export function convertHarmonyEventToAndroid(ev: ESKeyEvent): ESKeyEvent {
+  return {
+    action: ev.action,
+    keyRepeat: ev.keyRepeat,
+    keyCode: HarmonyToAndroidKeyMap[ev.keyCode] ?? ev.keyCode,
+  };
+}
+
+export function createHarmonyRouterKeyManager(
+  router: Router,
+): ESRouterKeyManager {
+  function dispatchBackPressed(historyLocation: HistoryLocation): void {
+    const instance = historyLocation.instances;
+    if (instance) {
+      // @ts-ignore
+      const hasHooks = hasESLifecycleHook(
+        instance,
+        ESLifecycleKeys.ES_BACK_PRESSED,
+      );
+      // @ts-ignore
+      if (isFunction(instance.onBackPressed) || hasHooks) {
+        //1.
+        if (hasHooks) {
+          try {
+            // @ts-ignore
+            triggerESLifecycle(instance, "backPressed");
+          } catch (e) {}
+        }
+        //2.
+        // @ts-ignore
+        if (isFunction(instance.onBackPressed)) {
+          // @ts-ignore
+          instance.onBackPressed();
+        }
+      } else {
+        router.back();
+      }
+    }
+  }
+
+  // 定义长按的时间阈值（毫秒），通常 500ms 比较合适
+  const REPEAT_INTERVAL_THRESHOLD = 500; // 判定连发的时间间隔阈值
+
+  const UP_DEBOUNCE_TIME = 100; // “吞掉”中间UP的等待时间 (建议 50-100ms，太长会感觉按键迟钝)
+
+  function dispatchKeyEvent(
+    historyLocation: HistoryLocation,
+    harmonyKeyEvent: ESKeyEvent,
+  ): void {
+    const keyEvent = convertHarmonyEventToAndroid(harmonyKeyEvent);
+    const instance = historyLocation.instances;
+
+    if (!instance) {
+      return;
+    }
+
+    // @ts-ignore
+    const hasHooks = hasESLifecycleHook(
+      instance,
+      ESLifecycleKeys.ES_DISPATCH_KEY_EVENT,
+    );
+
+    // 1. 优先处理 onDispatchKeyEvent
+    // @ts-ignore
+    if (isFunction(instance.onDispatchKeyEvent) || hasHooks) {
+      if (hasHooks) {
+        try {
+          // @ts-ignore
+          triggerESLifecycle(instance, "dispatchKeyEvent", keyEvent);
+        } catch (e) {}
+      }
+      // @ts-ignore
+      if (isFunction(instance.onDispatchKeyEvent)) {
+        // @ts-ignore
+        instance.onDispatchKeyEvent(keyEvent);
+      }
+    }
+    // 2. 处理 onKeyDown / onKeyUp
+    else {
+      const now = Date.now();
+
+      // ================== Action: DOWN (按下) ==================
+      if (keyEvent && keyEvent.action === 0) {
+        // 【关键步骤 1】: 既然来了 Down，说明之前的 Up 是连发过程中的假象，取消它！
+        // @ts-ignore
+        if (instance._keyUpTimer) {
+          // @ts-ignore
+          clearTimeout(instance._keyUpTimer);
+          // @ts-ignore
+          instance._keyUpTimer = null;
+        }
+
+        // 计算间隔，判定是否属于长按序列
+        // @ts-ignore
+        const lastDownTime = instance._lastDownTimestamp || 0;
+        const interval = now - lastDownTime;
+
+        // 如果按键相同 且 间隔小于阈值，认为是长按连发
+        // @ts-ignore
+        if (
+          instance._lastKeyCode === keyEvent.keyCode &&
+          interval < REPEAT_INTERVAL_THRESHOLD
+        ) {
+          // @ts-ignore
+          instance._keyRepeatCount = (instance._keyRepeatCount || 0) + 1;
+        } else {
+          // 新的点击
+          // @ts-ignore
+          instance._keyRepeatCount = 0;
+          // @ts-ignore
+          instance._lastKeyCode = keyEvent.keyCode;
+        }
+
+        // 更新时间戳
+        // @ts-ignore
+        instance._lastDownTimestamp = now;
+
+        // 赋值 repeat
+        // @ts-ignore
+        keyEvent.keyRepeat = instance._keyRepeatCount;
+
+        console.log(
+          `[KeyFlow] Down触发: repeat=${keyEvent.keyRepeat}, interval=${interval}`,
+        );
+
+        // 立即触发 onKeyDown
+        try {
+          // @ts-ignore
+          triggerESLifecycle(instance, "keyDown", keyEvent);
+        } catch (e) {}
+
+        // @ts-ignore
+        if (isFunction(instance.onKeyDown)) {
+          // @ts-ignore
+          instance.onKeyDown(keyEvent);
+        }
+      }
+      // ================== Action: UP (抬起) ==================
+      else if (keyEvent && keyEvent.action === 1) {
+        // 【关键步骤 2】: 不要立即触发 Up，而是设定一个定时器
+        // 如果在 UP_DEBOUNCE_TIME 时间内又有 Down 来了，这个定时器就会在步骤1被干掉
+
+        // @ts-ignore
+        instance._keyUpTimer = setTimeout(() => {
+          console.log(`[KeyFlow] Up触发 (真实松手)`);
+
+          // 只有定时器真正存活下来，才执行业务逻辑
+          try {
+            // @ts-ignore
+            triggerESLifecycle(instance!, "keyUp", keyEvent);
+          } catch (e) {}
+
+          // @ts-ignore
+          if (isFunction(instance.onKeyUp)) {
+            // @ts-ignore
+            instance.onKeyUp(keyEvent);
+          }
+
+          // 清理状态
+          // @ts-ignore
+          instance._lastKeyCode = -1;
+          // @ts-ignore
+          instance._keyRepeatCount = 0;
+          // @ts-ignore
+          instance._keyUpTimer = null;
+        }, UP_DEBOUNCE_TIME);
+      }
+    }
+  }
+
+  function isFunction(func) {
+    return Object.prototype.toString.call(func) === "[object Function]";
+  }
+
+  const routerKeyManager: ESRouterKeyManager = {
+    dispatchBackPressed,
+    dispatchKeyEvent,
+  };
+
+  return routerKeyManager;
+}

package/rules/.source/ESCore/src/router/ESRouterKeyManager.ts

@@ -0,0 +1,11 @@
+import { HistoryLocation } from "@extscreen/es3-router";
+import { ESKeyEvent } from "../key";
+
+export interface ESRouterKeyManager {
+  dispatchBackPressed(historyLocation: HistoryLocation): void;
+
+  dispatchKeyEvent(
+    historyLocation: HistoryLocation,
+    keyEvent: ESKeyEvent,
+  ): void;
+}