lecodes-sdk 1.1.0 → 2.0.0

package/src/runtime/touch.ts

@@ -74,3 +74,35 @@ export class LongPressEvent<T = any> {
     this._trackHandler = handler
   }
 }
+
+/** What a hover `track()` takes: the cursor's moves inside the element (only delivered when
+ *  `onMove` is present — otherwise the host never crosses into JS for them), `onEnd` when it
+ *  leaves (with the last position), `onCancel` when the element went away underneath it. No
+ *  `claim`: a hover competes with nothing. */
+export interface HoverTrackHandler {
+  onMove?(pos: { clientX: number, clientY: number, deltaX: number, deltaY: number }): void
+  onEnd?(pos: { clientX: number, clientY: number, deltaX: number, deltaY: number }): void
+  onCancel?(): void
+}
+
+/** Delivered to a `UIButton` `onMouseEnter` handler when a mouse cursor (no button) enters the
+ *  button. There is no separate leave event: `ev.track({ onEnd })` follows this hover to its end,
+ *  `onMove` follows the cursor inside — the visual state itself is the reserved `$hovered` class.
+ *  Touch never produces one. */
+export class MouseEnterEvent<T = any> {
+  readonly type = "mouseenter"
+  readonly clientX: number
+  readonly clientY: number
+  target!: T
+  /** @internal — read by the dispatch system after the handler runs. */
+  _trackHandler?: HoverTrackHandler
+  constructor(clientX: number, clientY: number) {
+    this.clientX = clientX
+    this.clientY = clientY
+  }
+
+  /** Follow this hover: moves inside the element, its end (the cursor left), its cancel. */
+  track(handler: HoverTrackHandler): void {
+    this._trackHandler = handler
+  }
+}