js.foresight 3.0.0 → 3.0.1

package/dist/src/Manager/ForesightManager.d.ts

@@ -0,0 +1,89 @@
+import type { ForesightElement, ForesightElementData, ForesightEventMap, ForesightEventType, ForesightManagerData, ForesightRegisterOptions, ForesightRegisterResult, UpdateForsightManagerSettings } from "../types/types";
+/**
+ * Manages the prediction of user intent based on mouse trajectory and element interactions.
+ *
+ * ForesightManager is a singleton class responsible for:
+ * - Registering HTML elements to monitor.
+ * - Tracking mouse movements and predicting future cursor positions.
+ * - Detecting when a predicted trajectory intersects with a registered element's bounds.
+ * - Invoking callbacks associated with elements upon predicted or actual interaction.
+ * - Optionally unregistering elements after their callback is triggered.
+ * - Handling global settings for prediction behavior (e.g., history size, prediction time).
+ * - Automatically updating element bounds on resize using {@link ResizeObserver}.
+ * - Automatically unregistering elements removed from the DOM using {@link MutationObserver}.
+ * - Detecting broader layout shifts via {@link MutationObserver} to update element positions.
+ *
+ * It should be initialized once using {@link ForesightManager.initialize} and then
+ * accessed via the static getter {@link ForesightManager.instance}.
+ */
+export declare class ForesightManager {
+    private static manager;
+    private elements;
+    private isSetup;
+    private _globalCallbackHits;
+    private _globalSettings;
+    private trajectoryPositions;
+    private tabbableElementsCache;
+    private lastFocusedIndex;
+    private predictedScrollPoint;
+    private scrollDirection;
+    private domObserver;
+    private positionObserver;
+    private lastKeyDown;
+    private globalListenersController;
+    private eventListeners;
+    private constructor();
+    static initialize(props?: Partial<UpdateForsightManagerSettings>): ForesightManager;
+    addEventListener<K extends ForesightEventType>(eventType: K, listener: (event: ForesightEventMap[K]) => void, options?: {
+        signal?: AbortSignal;
+    }): (() => void) | undefined;
+    removeEventListener<K extends ForesightEventType>(eventType: K, listener: (event: ForesightEventMap[K]) => void): void;
+    logSubscribers(): void;
+    private emit;
+    get getManagerData(): Readonly<ForesightManagerData>;
+    static get isInitiated(): Readonly<boolean>;
+    static get instance(): ForesightManager;
+    get registeredElements(): ReadonlyMap<ForesightElement, ForesightElementData>;
+    register({ element, callback, hitSlop, name, }: ForesightRegisterOptions): ForesightRegisterResult;
+    private unregister;
+    private updateNumericSettings;
+    private updateBooleanSetting;
+    alterGlobalSettings(props?: Partial<UpdateForsightManagerSettings>): void;
+    private forceUpdateAllElementBounds;
+    private updatePointerState;
+    /**
+     * Processes elements that unregister after a single callback.
+     *
+     * This is a "fire-and-forget" handler. Its only goal is to trigger the
+     * callback once. It does so if the mouse trajectory is predicted to hit the
+     * element (if prediction is on) OR if the mouse physically hovers over it.
+     * It does not track state, as the element is immediately unregistered.
+     *
+     * @param elementData - The data object for the foresight element.
+     * @param element - The HTML element being interacted with.
+     */
+    private handleCallbackInteraction;
+    private handleMouseMove;
+    /**
+     * Detects when registered elements are removed from the DOM and automatically unregisters them to prevent stale references.
+     *
+     * @param mutationsList - Array of MutationRecord objects describing the DOM changes
+     *
+     */
+    private handleDomMutations;
+    private handleKeyDown;
+    private handleFocusIn;
+    private updateHitCounters;
+    private callCallback;
+    /**
+     * ONLY use this function when you want to change the rect bounds via code, if the rects are changing because of updates in the DOM do not use this function.
+     * We need an observer for that
+     */
+    private forceUpdateElementBounds;
+    private updateElementBounds;
+    private handleScrollPrefetch;
+    private handlePositionChange;
+    private initializeGlobalListeners;
+    private removeGlobalListeners;
+}
+//# sourceMappingURL=ForesightManager.d.ts.map

package/dist/src/Manager/ForesightManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForesightManager.d.ts","sourceRoot":"","sources":["../../../src/Manager/ForesightManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EAEpB,wBAAwB,EACxB,uBAAuB,EAOvB,6BAA6B,EAC9B,MAAM,gBAAgB,CAAA;AAkCvB;;;;;;;;;;;;;;;;GAgBG;AAEH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAyD;IACzE,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,mBAAmB,CAgB1B;IACD,OAAO,CAAC,eAAe,CAmBtB;IACD,OAAO,CAAC,mBAAmB,CAI1B;IAED,OAAO,CAAC,qBAAqB,CAAyB;IACtD,OAAO,CAAC,gBAAgB,CAAsB;IAE9C,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,gBAAgB,CAAgC;IAExD,OAAO,CAAC,WAAW,CAA6B;IAGhD,OAAO,CAAC,yBAAyB,CAA+B;IAEhE,OAAO,CAAC,cAAc,CAA+D;IAGrF,OAAO;WAEO,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,6BAA6B,CAAC,GAAG,gBAAgB;IAUnF,gBAAgB,CAAC,CAAC,SAAS,kBAAkB,EAClD,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,EAC/C,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE;IAa7B,mBAAmB,CAAC,CAAC,SAAS,kBAAkB,EACrD,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC9C,IAAI;IAWA,cAAc,IAAI,IAAI;IA+B7B,OAAO,CAAC,IAAI;IAaZ,IAAW,cAAc,IAAI,QAAQ,CAAC,oBAAoB,CAAC,CAM1D;IAED,WAAkB,WAAW,IAAI,QAAQ,CAAC,OAAO,CAAC,CAEjD;IAED,WAAkB,QAAQ,IAAI,gBAAgB,CAE7C;IAED,IAAW,kBAAkB,IAAI,WAAW,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAEnF;IAEM,QAAQ,CAAC,EACd,OAAO,EACP,QAAQ,EACR,OAAO,EACP,IAAI,GACL,EAAE,wBAAwB,GAAG,uBAAuB;IAwDrD,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,oBAAoB;IAWrB,mBAAmB,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,6BAA6B,CAAC,GAAG,IAAI;IA2FhF,OAAO,CAAC,2BAA2B;IAUnC,OAAO,CAAC,kBAAkB;IAY1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,yBAAyB;IAoBjC,OAAO,CAAC,eAAe,CAiBtB;IAED;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB,CAezB;IAMD,OAAO,CAAC,aAAa,CAIpB;IAED,OAAO,CAAC,aAAa,CAgDpB;IAED,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,YAAY;IAkBpB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAwBhC,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,oBAAoB;IAuD5B,OAAO,CAAC,oBAAoB,CAyB3B;IAED,OAAO,CAAC,yBAAyB;IAgCjC,OAAO,CAAC,qBAAqB;CAW9B"}

package/dist/src/Manager/ForesightManager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ForesightManager.test.d.ts.map

package/dist/src/Manager/ForesightManager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForesightManager.test.d.ts","sourceRoot":"","sources":["../../../src/Manager/ForesightManager.test.ts"],"names":[],"mappings":""}

package/dist/src/Manager/constants.d.ts

@@ -0,0 +1,23 @@
+export declare const MIN_TRAJECTORY_PREDICTION_TIME: number;
+export declare const MAX_TRAJECTORY_PREDICTION_TIME: number;
+export declare const DEFAULT_TRAJECTORY_PREDICTION_TIME: number;
+export declare const TRAJECTORY_PREDICTION_TIME_UNIT: string;
+export declare const MIN_POSITION_HISTORY_SIZE: number;
+export declare const MAX_POSITION_HISTORY_SIZE: number;
+export declare const DEFAULT_POSITION_HISTORY_SIZE: number;
+export declare const POSITION_HISTORY_SIZE_UNIT: string;
+export declare const MIN_TAB_OFFSET: number;
+export declare const MAX_TAB_OFFSET: number;
+export declare const DEFAULT_TAB_OFFSET: number;
+export declare const TAB_OFFSET_UNIT: string;
+export declare const MIN_HITSLOP: number;
+export declare const MAX_HITSLOP: number;
+export declare const DEFAULT_HITSLOP: number;
+export declare const DEFAULT_SCROLL_MARGIN: number;
+export declare const MIN_SCROLL_MARGIN: number;
+export declare const MAX_SCROLL_MARGIN: number;
+export declare const SCROLL_MARGIN_UNIT: string;
+export declare const DEFAULT_ENABLE_TAB_PREDICTION: boolean;
+export declare const DEFAULT_ENABLE_MOUSE_PREDICTION: boolean;
+export declare const DEFAULT_ENABLE_SCROLL_PREDICTION: boolean;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/Manager/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/Manager/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,8BAA8B,EAAE,MAAW,CAAC;AACzD,eAAO,MAAM,8BAA8B,EAAE,MAAY,CAAC;AAC1D,eAAO,MAAM,kCAAkC,EAAE,MAAY,CAAC;AAC9D,eAAO,MAAM,+BAA+B,EAAE,MAAa,CAAC;AAE5D,eAAO,MAAM,yBAAyB,EAAE,MAAU,CAAC;AACnD,eAAO,MAAM,yBAAyB,EAAE,MAAW,CAAC;AACpD,eAAO,MAAM,6BAA6B,EAAE,MAAU,CAAC;AACvD,eAAO,MAAM,0BAA0B,EAAE,MAAiB,CAAC;AAE3D,eAAO,MAAM,cAAc,EAAE,MAAU,CAAC;AACxC,eAAO,MAAM,cAAc,EAAE,MAAW,CAAC;AACzC,eAAO,MAAM,kBAAkB,EAAE,MAAU,CAAC;AAC5C,eAAO,MAAM,eAAe,EAAE,MAAe,CAAC;AAE9C,eAAO,MAAM,WAAW,EAAE,MAAU,CAAC;AACrC,eAAO,MAAM,WAAW,EAAE,MAAa,CAAC;AACxC,eAAO,MAAM,eAAe,EAAE,MAAU,CAAC;AAEzC,eAAO,MAAM,qBAAqB,EAAE,MAAY,CAAC;AACjD,eAAO,MAAM,iBAAiB,EAAE,MAAW,CAAC;AAC5C,eAAO,MAAM,iBAAiB,EAAE,MAAY,CAAC;AAC7C,eAAO,MAAM,kBAAkB,EAAE,MAAa,CAAC;AAE/C,eAAO,MAAM,6BAA6B,EAAE,OAAc,CAAC;AAC3D,eAAO,MAAM,+BAA+B,EAAE,OAAc,CAAC;AAC7D,eAAO,MAAM,gCAAgC,EAAE,OAAc,CAAC"}

package/dist/src/Manager/helpers/clampNumber.d.ts

@@ -0,0 +1,2 @@
+export declare function clampNumber(number: number, lowerBound: number, upperBound: number, settingName: string): number;
+//# sourceMappingURL=clampNumber.d.ts.map

package/dist/src/Manager/helpers/clampNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clampNumber.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/clampNumber.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,UAapB"}

package/dist/src/Manager/helpers/clampNumber.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=clampNumber.test.d.ts.map

package/dist/src/Manager/helpers/clampNumber.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clampNumber.test.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/clampNumber.test.ts"],"names":[],"mappings":""}

package/dist/src/Manager/helpers/getFocusedElementIndex.d.ts

@@ -0,0 +1,15 @@
+import type { FocusableElement } from "tabbable";
+/**
+ * Finds the index of a focused element within a cache of tabbable elements.
+ * It uses a predictive search for O(1) performance in the common case of
+ * sequential tabbing, and falls back to a linear search O(n) if the
+ * prediction fails.
+ *
+ * @param isReversed - True if the user is tabbing backward (Shift+Tab).
+ * @param lastFocusedIndex - The index of the previously focused element, or null if none.
+ * @param tabbableElementsCache - The array of all tabbable elements.
+ * @param targetElement - The new HTML element that has received focus.
+ * @returns The index of the targetElement in the cache, or -1 if not found.
+ */
+export declare function getFocusedElementIndex(isReversed: boolean, lastFocusedIndex: number | null, tabbableElementsCache: FocusableElement[], targetElement: HTMLElement): number;
+//# sourceMappingURL=getFocusedElementIndex.d.ts.map

package/dist/src/Manager/helpers/getFocusedElementIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFocusedElementIndex.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/getFocusedElementIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEhD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,OAAO,EACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,qBAAqB,EAAE,gBAAgB,EAAE,EACzC,aAAa,EAAE,WAAW,GACzB,MAAM,CAiBR"}

package/dist/src/Manager/helpers/getFocusedElementIndex.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getFocusedElementIndex.test.d.ts.map

package/dist/src/Manager/helpers/getFocusedElementIndex.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFocusedElementIndex.test.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/getFocusedElementIndex.test.ts"],"names":[],"mappings":""}

package/dist/src/Manager/helpers/getScrollDirection.d.ts

@@ -0,0 +1,3 @@
+import type { Rect, ScrollDirection } from "../../types/types";
+export declare function getScrollDirection(oldRect: Rect, newRect: Rect): ScrollDirection;
+//# sourceMappingURL=getScrollDirection.d.ts.map

package/dist/src/Manager/helpers/getScrollDirection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getScrollDirection.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/getScrollDirection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAE9D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,eAAe,CAoBhF"}

package/dist/src/Manager/helpers/lineSegmentIntersectsRect.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lineSegmentIntersectsRect.test.d.ts.map

package/dist/src/Manager/helpers/lineSegmentIntersectsRect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineSegmentIntersectsRect.test.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/lineSegmentIntersectsRect.test.ts"],"names":[],"mappings":""}

package/dist/src/Manager/helpers/lineSigmentIntersectsRect.d.ts

@@ -0,0 +1,12 @@
+import type { Point, Rect } from "../../types/types";
+/**
+ * Determines if a line segment intersects with a given rectangle.
+ * This function implements the Liang-Barsky line clipping algorithm.
+ *
+ * @param p1 - The starting {@link Point} of the line segment.
+ * @param p2 - The ending {@link Point} of the line segment.
+ * @param rect - The {@link Rect} to check for intersection.
+ * @returns `true` if the line segment intersects the rectangle, `false` otherwise.
+ */
+export declare function lineSegmentIntersectsRect(p1: Point, p2: Point, rect: Rect): boolean;
+//# sourceMappingURL=lineSigmentIntersectsRect.d.ts.map

package/dist/src/Manager/helpers/lineSigmentIntersectsRect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineSigmentIntersectsRect.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/lineSigmentIntersectsRect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAiCnF"}

package/dist/src/Manager/helpers/predictNextMousePosition.d.ts

@@ -0,0 +1,19 @@
+import type { MousePosition, Point } from "../../types/types";
+/**
+ * Predicts the next mouse position based on a history of recent movements.
+ * It calculates velocity from the historical data and extrapolates a future point.
+ * The `history` array is mutated by this function: the new `currentPoint` is added,
+ * and if the history exceeds `positionHistorySize`, the oldest entry is removed.
+ *
+ * @param currentPoint - The current actual mouse coordinates.
+ * @param history - An array of previous mouse positions with timestamps.
+ *                  This array will be modified by this function.
+ * @param positionHistorySize - The maximum number of past positions to store and consider
+ *                              for the prediction.
+ * @param trajectoryPredictionTimeInMs - How far into the future (in milliseconds)
+ *                                       to predict the mouse position.
+ * @returns The predicted {@link Point} (x, y coordinates). If history is insufficient
+ *          (less than 2 points) or time delta is zero, returns the `currentPoint`.
+ */
+export declare function predictNextMousePosition(currentPoint: Point, history: MousePosition[], positionHistorySize: number, trajectoryPredictionTimeInMs: number): Point;
+//# sourceMappingURL=predictNextMousePosition.d.ts.map

package/dist/src/Manager/helpers/predictNextMousePosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predictNextMousePosition.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/predictNextMousePosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,KAAK,EACnB,OAAO,EAAE,aAAa,EAAE,EACxB,mBAAmB,EAAE,MAAM,EAC3B,4BAA4B,EAAE,MAAM,GACnC,KAAK,CAgCP"}

package/dist/src/Manager/helpers/predictNextMousePosition.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=predictNextMousePosition.test.d.ts.map

package/dist/src/Manager/helpers/predictNextMousePosition.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predictNextMousePosition.test.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/predictNextMousePosition.test.ts"],"names":[],"mappings":""}

package/dist/src/Manager/helpers/predictNextScrollPosition.d.ts

@@ -0,0 +1,6 @@
+import type { Point, ScrollDirection } from "../../types/types";
+export declare function predictNextScrollPosition(currentPoint: Point, direction: ScrollDirection, scrollMargin: number): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=predictNextScrollPosition.d.ts.map

package/dist/src/Manager/helpers/predictNextScrollPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predictNextScrollPosition.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/predictNextScrollPosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAE/D,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,KAAK,EACnB,SAAS,EAAE,eAAe,EAC1B,YAAY,EAAE,MAAM;;;EAoBrB"}

package/dist/src/Manager/helpers/rectAndHitSlop.d.ts

@@ -0,0 +1,33 @@
+import type { HitSlop, Point, Rect } from "../../types/types";
+/**
+ * Normalizes a `hitSlop` value into a {@link Rect} object.
+ * If `hitSlop` is a number, it's applied uniformly to all sides (top, left, right, bottom).
+ * If `hitSlop` is already a `Rect` object, it's returned as is.
+ *
+ * @param hitSlop - A number for uniform slop, or a {@link Rect} object for specific slop per side.
+ * @returns A {@link Rect} object with `top`, `left`, `right`, and `bottom` properties.
+ */
+export declare function normalizeHitSlop(hitSlop: HitSlop): Rect;
+/**
+ * Calculates an expanded rectangle by applying a `hitSlop` to a base rectangle.
+ * The `hitSlop` values define how much to extend each side of the `baseRect` outwards.
+ *
+ * @param baseRect - The original {@link Rect} or `DOMRect` to expand.
+ * @param hitSlop - A {@link Rect} object defining how much to expand each side
+ *                  (e.g., `hitSlop.left` expands the left boundary further to the left).
+ * @returns A new {@link Rect} object representing the expanded area.
+ */
+export declare function getExpandedRect(baseRect: Rect | DOMRect, hitSlop: Rect): Rect;
+/**
+ * Checks if two rectangle objects are equal by comparing their respective
+ * `top`, `left`, `right`, and `bottom` properties.
+ * Handles cases where one or both rects might be null or undefined.
+ *
+ * @param rect1 - The first {@link Rect} object to compare.
+ * @param rect2 - The second {@link Rect} object to compare.
+ * @returns `true` if the rectangles have identical dimensions or if both are null/undefined,
+ *          `false` otherwise.
+ */
+export declare function areRectsEqual(rect1: Rect, rect2: Rect): boolean;
+export declare function isPointInRectangle(point: Point, rect: Rect): boolean;
+//# sourceMappingURL=rectAndHitSlop.d.ts.map

package/dist/src/Manager/helpers/rectAndHitSlop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectAndHitSlop.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/rectAndHitSlop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAI7D;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiBvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,IAAI,GAAG,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,IAAI,CAO7E;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAQ/D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAIpE"}

package/dist/src/Manager/helpers/rectAndHitSlop.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rectAndHitSlop.test.d.ts.map

package/dist/src/Manager/helpers/rectAndHitSlop.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectAndHitSlop.test.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/rectAndHitSlop.test.ts"],"names":[],"mappings":""}

package/dist/src/Manager/helpers/shouldUpdateSetting.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Checks if a setting should be updated.
+ * Returns true if the newValue is defined and different from the currentValue.
+ * Uses a type predicate to narrow the type of newValue in the calling scope.
+ *
+ * @param newValue The potentially new value for the setting (can be undefined).
+ * @param currentValue The current value of the setting.
+ * @returns True if the setting should be updated, false otherwise.
+ */
+export declare function shouldUpdateSetting<T>(newValue: T | undefined, currentValue: T): newValue is NonNullable<T>;
+//# sourceMappingURL=shouldUpdateSetting.d.ts.map

package/dist/src/Manager/helpers/shouldUpdateSetting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shouldUpdateSetting.d.ts","sourceRoot":"","sources":["../../../../src/Manager/helpers/shouldUpdateSetting.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,QAAQ,EAAE,CAAC,GAAG,SAAS,EACvB,YAAY,EAAE,CAAC,GACd,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,CAK5B"}

package/dist/src/helpers/shouldRegister.d.ts

@@ -0,0 +1,8 @@
+type ShouldRegister = {
+    shouldRegister: boolean;
+    isTouchDevice: boolean;
+    isLimitedConnection: boolean;
+};
+export declare function evaluateRegistrationConditions(): ShouldRegister;
+export {};
+//# sourceMappingURL=shouldRegister.d.ts.map

package/dist/src/helpers/shouldRegister.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shouldRegister.d.ts","sourceRoot":"","sources":["../../../src/helpers/shouldRegister.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG;IACpB,cAAc,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,CAAA;IACtB,mBAAmB,EAAE,OAAO,CAAA;CAC7B,CAAA;AAED,wBAAgB,8BAA8B,IAAI,cAAc,CAK/D"}

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export { ForesightManager } from "./Manager/ForesightManager";
+export type { Rect as ForesightRect, ForesightElement, ForesightRegisterResult, UpdateForsightManagerSettings, ForesightManagerSettings, ForesightRegisterOptions, ForesightRegisterOptionsWithoutElement, ForesightElementData, CallbackHits as ForesightCallbackHits, ForesightEvent, ElementRegisteredEvent, ElementUnregisteredEvent, ElementDataUpdatedEvent, CallbackFiredEvent, MouseTrajectoryUpdateEvent, ScrollTrajectoryUpdateEvent, ManagerSettingsChangedEvent, HitSlop, } from "./types/types";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC7D,YAAY,EACV,IAAI,IAAI,aAAa,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,sCAAsC,EACtC,oBAAoB,EACpB,YAAY,IAAI,qBAAqB,EACrC,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,OAAO,GACR,MAAM,eAAe,CAAA"}