js.foresight 3.5.0 → 4.0.0

package/dist/index.d.ts

@@ -1,531 +0,0 @@
-declare class CircularBuffer<T> {
-    private buffer;
-    private head;
-    private count;
-    private capacity;
-    constructor(capacity: number);
-    add(item: T): void;
-    getFirst(): T | undefined;
-    getLast(): T | undefined;
-    getFirstLast(): [T | undefined, T | undefined];
-    resize(newCapacity: number): void;
-    private getAllItems;
-    clear(): void;
-    get length(): number;
-    get size(): number;
-    get isFull(): boolean;
-    get isEmpty(): boolean;
-}
-
-type Rect = {
-    top: number;
-    left: number;
-    right: number;
-    bottom: number;
-};
-/**
- * A callback function that is executed when a foresight interaction
- * (e.g., hover, trajectory hit) occurs on a registered element.
- */
-type ForesightCallback = (element: ForesightElementData) => void;
-/**
- * Represents the HTML element that is being tracked by the ForesightManager.
- * This is typically a standard DOM `Element`.
- */
-type ForesightElement = Element;
-/**
- * Represents a mouse position captured at a specific point in time.
- * Used for tracking mouse movement history.
- */
-type MousePosition = {
-    /** The (x, y) coordinates of the mouse. */
-    point: Point;
-    /** The timestamp (e.g., from `performance.now()`) when this position was recorded. */
-    time: number;
-};
-type Point = {
-    x: number;
-    y: number;
-};
-type TrajectoryPositions = {
-    positions: CircularBuffer<MousePosition>;
-    currentPoint: Point;
-    predictedPoint: Point;
-};
-/**
- * Internal type representing the calculated boundaries of a foresight element,
- * including its original dimensions and the expanded hit area.
- */
-type ElementBounds = {
-    /** The expanded rectangle, including hitSlop, used for interaction detection. */
-    expandedRect: Readonly<Rect>;
-    /** The original bounding rectangle of the element, as returned by `getBoundingClientRect()`. */
-    originalRect: DOMRectReadOnly;
-    /** The hit slop values applied to this element. */
-    hitSlop: Exclude<HitSlop, number>;
-};
-type ForesightRegisterResult = {
-    /** Whether the current device is a touch device. This is important as ForesightJS only works based on cursor movement. If the user is using a touch device you should handle prefetching differently
-     * @deprecated As of version 3.3, ForesightJS handles touch devices internally with dedicated touch strategies
-     */
-    isTouchDevice: boolean;
-    /** Whether the user has connection limitations (network slower than minimum connection type (default: 3g) or data saver enabled) that should prevent prefetching */
-    isLimitedConnection: boolean;
-    /** Whether ForesightJS will actively track this element. False if touch device or limited connection, true otherwise */
-    isRegistered: boolean;
-    /** Function to unregister the element
-     * @deprecated no longer need to call this manually, you can call Foresightmanager.instance.unregister if needed
-     */
-    unregister: () => void;
-    /** The data associated with the registered element. This will be null if the element was not registered */
-    elementData: ForesightElementData | null;
-};
-/**
- * Represents the data associated with a registered foresight element.
- */
-type ForesightElementData = Required<Pick<ForesightRegisterOptions, "callback" | "name" | "meta">> & {
-    /** Unique identifier assigned during registration */
-    id: string;
-    /** The boundary information for the element. */
-    elementBounds: ElementBounds;
-    /**
-     * Is the element intersecting with the viewport, usefull to track which element we should observe or not
-     * Can be @undefined in the split second the element is registering
-     */
-    isIntersectingWithViewport: boolean;
-    /**
-     * The element you registered
-     */
-    element: ForesightElement;
-    /**
-     * For debugging, check if you are registering the same element multiple times.
-     */
-    registerCount: number;
-    /**
-     * Callbackinfo for debugging purposes
-     */
-    callbackInfo: ElementCallbackInfo;
-};
-type ElementCallbackInfo = {
-    /**
-     * Number of times the callback has been fired for this element
-     */
-    callbackFiredCount: number;
-    /**
-     * Timestamp when the callback was last fired
-     */
-    lastCallbackInvokedAt: number | undefined;
-    /**
-     * Timestamp when the last callback was finished
-     */
-    lastCallbackCompletedAt: number | undefined;
-    /**
-     * Time in milliseconds it took for the last callback to go from invoked to complete.
-     */
-    lastCallbackRuntime: number | undefined;
-    /**
-     * Status of the last ran callback
-     */
-    lastCallbackStatus: callbackStatus;
-    /**
-     * Last callback error message
-     */
-    lastCallbackErrorMessage: string | undefined | null;
-    /**
-     * Time in milliseconds after which the callback can be fired again
-     */
-    reactivateAfter: number;
-    /**
-     * Whether the callback is currently active (within stale time period)
-     */
-    isCallbackActive: boolean;
-    /**
-     * If the element is currently running its callback
-     */
-    isRunningCallback: boolean;
-    /**
-     * Timeout ID for the scheduled reactivation, if any
-     */
-    reactivateTimeoutId?: ReturnType<typeof setTimeout>;
-};
-type callbackStatus = "error" | "success" | undefined;
-type MouseCallbackCounts = {
-    hover: number;
-    trajectory: number;
-};
-type TabCallbackCounts = {
-    reverse: number;
-    forwards: number;
-};
-type ScrollDirection = "down" | "up" | "left" | "right" | "none";
-type ScrollCallbackCounts = Record<`${Exclude<ScrollDirection, "none">}`, number>;
-type CallbackHits = {
-    total: number;
-    mouse: MouseCallbackCounts;
-    tab: TabCallbackCounts;
-    scroll: ScrollCallbackCounts;
-    touch: number;
-    viewport: number;
-};
-type CallbackHitType = {
-    kind: "mouse";
-    subType: keyof MouseCallbackCounts;
-} | {
-    kind: "tab";
-    subType: keyof TabCallbackCounts;
-} | {
-    kind: "scroll";
-    subType: keyof ScrollCallbackCounts;
-} | {
-    kind: "touch";
-    subType?: string;
-} | {
-    kind: "viewport";
-    subType?: string;
-};
-/**
- * Snapshot of the current ForesightManager state
- */
-type ForesightManagerData = {
-    registeredElements: ReadonlyMap<ForesightElement, ForesightElementData>;
-    globalSettings: Readonly<ForesightManagerSettings>;
-    globalCallbackHits: Readonly<CallbackHits>;
-    eventListeners: ReadonlyMap<keyof ForesightEventMap, ForesightEventListener[]>;
-    currentDeviceStrategy: CurrentDeviceStrategy;
-    activeElementCount: number;
-    loadedModules: {
-        desktopHandler: boolean;
-        touchHandler: boolean;
-        predictors: {
-            mouse: boolean;
-            tab: boolean;
-            scroll: boolean;
-            viewport: boolean;
-            touchStart: boolean;
-        };
-    };
-};
-type TouchDeviceStrategy = "none" | "viewport" | "onTouchStart";
-type MinimumConnectionType = "slow-2g" | "2g" | "3g" | "4g";
-type BaseForesightManagerSettings = {
-    /**
-     * Number of mouse positions to keep in history for trajectory calculation.
-     * A higher number might lead to smoother but slightly delayed predictions.
-     *
-     *
-     * @link https://foresightjs.com/docs/getting_started/config#available-global-settings
-     *
-     *
-     * **This value is clamped between 2 and 30.**
-     * @default 8
-     */
-    positionHistorySize: number;
-    /**
-     *
-     * @deprecated will be removed from v4.0
-     * ForesightJS now have its stand-alone devtools library with the debugger built-in
-     * @link https://github.com/spaansba/ForesightJS-DevTools
-     */
-    debug: boolean;
-    /**
-     *
-     * Logs basic information about the ForesightManager and its handlers that doesn't have a dedicated event.
-     *
-     * Mostly used by the maintainers of ForesightJS to debug the manager. But might be useful for implementers aswell.
-     *
-     * This is not the same as logging events, this can be done with the actual developer tools.
-     * @link https://foresightjs.com/docs/debugging/devtools
-     */
-    enableManagerLogging: boolean;
-    /**
-     * How far ahead (in milliseconds) to predict the mouse trajectory.
-     * A larger value means the prediction extends further into the future. (meaning it will trigger callbacks sooner)
-     *
-     * @link https://foresightjs.com/docs/getting_started/config#available-global-settings
-     *
-     * **This value is clamped between 10 and 200.**
-     * @default 120
-     */
-    trajectoryPredictionTime: number;
-    /**
-     * Whether to enable mouse trajectory prediction.
-     * If false, only direct hover/interaction is considered.
-     * @link https://foresightjs.com/docs/getting_started/config#available-global-settings
-     * @default true
-     */
-    enableMousePrediction: boolean;
-    /**
-     * Toggles whether keyboard prediction is on
-     *
-     * @link https://foresightjs.com/docs/getting_started/config#available-global-settings
-     * @default true
-     */
-    enableTabPrediction: boolean;
-    /**
-     * Sets the pixel distance to check from the mouse position in the scroll direction.
-     *
-     * @link https://foresightjs.com/docs/getting_started/config#available-global-settings
-     *
-     * **This value is clamped between 30 and 300.**
-     * @default 150
-     */
-    scrollMargin: number;
-    /**
-     * Toggles whether scroll prediction is on
-     * @link https://foresightjs.com/docs/getting_started/config#available-global-settings
-     * @default true
-     */
-    enableScrollPrediction: boolean;
-    /**
-     * Tab stops away from an element to trigger callback. Only works when @argument enableTabPrediction is true
-     *
-     * **This value is clamped between 0 and 20.**
-     * @default 2
-     */
-    tabOffset: number;
-    /**
-     * The prefetch strategy used for touch devices.
-     * - `viewport`: Prefetching is done based on the viewport, meaning elements in the viewport are preloaded.
-     * - `onTouchStart`: Prefetching is done when the user touches the element
-     * @default onTouchStart
-     */
-    touchDeviceStrategy: TouchDeviceStrategy;
-    /**
-     * Network effective connection types that should be considered as limited connections.
-     * When the user's network matches any of these types, ForesightJS will disable prefetching
-     * to avoid consuming data on slow or expensive connections.
-     *
-     * @link https://developer.mozilla.org/en-US/docs/Web/API/NetworkInformation/effectiveType
-     * @default 3g
-     */
-    minimumConnectionType: MinimumConnectionType;
-};
-type CurrentDeviceStrategy = "mouse" | "touch" | "pen";
-/**
- * Configuration options for the ForesightManager
- * @link https://foresightjs.com/docs/getting_started/config#available-global-settings
- */
-type ForesightManagerSettings = BaseForesightManagerSettings & {
-    defaultHitSlop: Exclude<HitSlop, number>;
-};
-/**
- * Update options for the ForesightManager
- * @link https://foresightjs.com/docs/getting_started/config#available-global-settings
- */
-type UpdateForsightManagerSettings = BaseForesightManagerSettings & {
-    defaultHitSlop: HitSlop;
-};
-/**
- * Type used to register elements to the foresight manager
- */
-type ForesightRegisterOptions = ForesightRegisterOptionsWithoutElement & {
-    element: ForesightElement;
-};
-type ForesightRegisterNodeListOptions = ForesightRegisterOptionsWithoutElement & {
-    element: NodeListOf<ForesightElement>;
-};
-/**
- * Use full for if you want to create a custom button component in a modern framework (for example React).
- * And you want to have the ForesightRegisterOptions used in ForesightManager.instance.register({})
- * without the element as the element will be the ref of the component.
- *
- * @link https://foresightjs.com/docs/getting_started/typescript#foresightregisteroptionswithoutelement
- */
-type ForesightRegisterOptionsWithoutElement = {
-    callback: ForesightCallback;
-    hitSlop?: HitSlop;
-    /**
-     * @deprecated will be removed in V4.0
-     */
-    unregisterOnCallback?: boolean;
-    name?: string;
-    /**
-     * If set by user, stores additional information about the registered element
-     */
-    meta?: Record<string, unknown>;
-    /**
-     * Time in milliseconds after which the callback can be fired again and we reactivate the element.
-     * Set to Infinity to prevent callback from firing again after first execution.
-     * @default Infinity
-     */
-    reactivateAfter?: number;
-};
-/**
- * Fully invisible "slop" around the element.
- * Basically increases the hover hitbox
- */
-type HitSlop = Rect | number;
-interface ForesightEventMap {
-    elementRegistered: ElementRegisteredEvent;
-    elementReactivated: ElementReactivatedEvent;
-    elementUnregistered: ElementUnregisteredEvent;
-    elementDataUpdated: ElementDataUpdatedEvent;
-    callbackInvoked: CallbackInvokedEvent;
-    callbackCompleted: CallbackCompletedEvent;
-    mouseTrajectoryUpdate: MouseTrajectoryUpdateEvent;
-    scrollTrajectoryUpdate: ScrollTrajectoryUpdateEvent;
-    managerSettingsChanged: ManagerSettingsChangedEvent;
-    deviceStrategyChanged: DeviceStrategyChangedEvent;
-}
-type ForesightEvent = "elementRegistered" | "elementReactivated" | "elementUnregistered" | "elementDataUpdated" | "callbackInvoked" | "callbackCompleted" | "mouseTrajectoryUpdate" | "scrollTrajectoryUpdate" | "managerSettingsChanged" | "deviceStrategyChanged";
-interface DeviceStrategyChangedEvent extends ForesightBaseEvent {
-    type: "deviceStrategyChanged";
-    newStrategy: CurrentDeviceStrategy;
-    oldStrategy: CurrentDeviceStrategy;
-}
-interface ElementRegisteredEvent extends ForesightBaseEvent {
-    type: "elementRegistered";
-    elementData: ForesightElementData;
-}
-interface ElementReactivatedEvent extends ForesightBaseEvent {
-    type: "elementReactivated";
-    elementData: ForesightElementData;
-}
-interface ElementUnregisteredEvent extends ForesightBaseEvent {
-    type: "elementUnregistered";
-    elementData: ForesightElementData;
-    unregisterReason: ElementUnregisteredReason;
-    wasLastRegisteredElement: boolean;
-}
-/**
- * The reason an element was unregistered from ForesightManager's tracking.
- * - `callbackHit`: The element was automatically unregistered after its callback fired.
- * - `disconnected`: The element was automatically unregistered because it was removed from the DOM.
- * - `apiCall`: The developer manually called the `unregister()` function for the element.
- * - `devtools`: When clicking the trash icon in the devtools element tab
- * - any other string
- */
-type ElementUnregisteredReason = "disconnected" | "apiCall" | "devtools" | (string & {});
-interface ElementDataUpdatedEvent extends Omit<ForesightBaseEvent, "timestamp"> {
-    type: "elementDataUpdated";
-    elementData: ForesightElementData;
-    updatedProps: UpdatedDataPropertyNames[];
-}
-type UpdatedDataPropertyNames = "bounds" | "visibility";
-interface CallbackInvokedEvent extends ForesightBaseEvent {
-    type: "callbackInvoked";
-    elementData: ForesightElementData;
-    hitType: CallbackHitType;
-}
-interface CallbackCompletedEventBase extends ForesightBaseEvent {
-    type: "callbackCompleted";
-    elementData: ForesightElementData;
-    hitType: CallbackHitType;
-    elapsed: number;
-    wasLastActiveElement: boolean;
-}
-type CallbackCompletedEvent = CallbackCompletedEventBase & {
-    status: callbackStatus;
-    errorMessage: string | undefined | null;
-};
-interface MouseTrajectoryUpdateEvent extends Omit<ForesightBaseEvent, "timestamp"> {
-    type: "mouseTrajectoryUpdate";
-    trajectoryPositions: TrajectoryPositions;
-    predictionEnabled: boolean;
-}
-interface ScrollTrajectoryUpdateEvent extends Omit<ForesightBaseEvent, "timestamp"> {
-    type: "scrollTrajectoryUpdate";
-    currentPoint: Point;
-    predictedPoint: Point;
-    scrollDirection: ScrollDirection;
-}
-interface ManagerSettingsChangedEvent extends ForesightBaseEvent {
-    type: "managerSettingsChanged";
-    managerData: ForesightManagerData;
-    updatedSettings: UpdatedManagerSetting[];
-}
-type UpdatedManagerSetting = {
-    [K in keyof ForesightManagerSettings]: {
-        setting: K;
-        newValue: ForesightManagerSettings[K];
-        oldValue: ForesightManagerSettings[K];
-    };
-}[keyof ForesightManagerSettings];
-type ForesightEventListener<K extends ForesightEvent = ForesightEvent> = (event: ForesightEventMap[K]) => void;
-interface ForesightBaseEvent {
-    type: ForesightEvent;
-    timestamp: number;
-}
-
-/**
- * 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}.
- */
-declare class ForesightManager {
-    private static manager;
-    private elements;
-    private checkableElements;
-    private idCounter;
-    private activeElementCount;
-    private desktopHandler;
-    private touchDeviceHandler;
-    private currentlyActiveHandler;
-    private handlerDependencies;
-    private isSetup;
-    private pendingPointerEvent;
-    private rafId;
-    private domObserver;
-    private currentDeviceStrategy;
-    private eventEmitter;
-    private _globalCallbackHits;
-    private _globalSettings;
-    private constructor();
-    private getOrCreateDesktopHandler;
-    private getOrCreateTouchHandler;
-    static initialize(props?: Partial<UpdateForsightManagerSettings>): ForesightManager;
-    static get isInitiated(): Readonly<boolean>;
-    static get instance(): ForesightManager;
-    private generateId;
-    private get isUsingDesktopHandler();
-    addEventListener<K extends ForesightEvent>(eventType: K, listener: ForesightEventListener<K>, options?: {
-        signal?: AbortSignal;
-    }): void;
-    removeEventListener<K extends ForesightEvent>(eventType: K, listener: ForesightEventListener<K>): void;
-    hasListeners<K extends ForesightEvent>(eventType: K): boolean;
-    get getManagerData(): Readonly<ForesightManagerData>;
-    get registeredElements(): ReadonlyMap<ForesightElement, ForesightElementData>;
-    register(options: ForesightRegisterNodeListOptions): ForesightRegisterResult[];
-    register(options: ForesightRegisterOptions): ForesightRegisterResult;
-    private registerElement;
-    unregister(element: ForesightElement | NodeListOf<ForesightElement>, unregisterReason?: ElementUnregisteredReason): void;
-    private unregisterElement;
-    reactivate(element: ForesightElement | NodeListOf<ForesightElement>): void;
-    private reactivateElement;
-    private clearReactivateTimeout;
-    updateCheckableStatus(elementData: ForesightElementData): void;
-    private callCallback;
-    private markElementAsRunning;
-    private executeCallbackAsync;
-    private finalizeCallback;
-    private updateHitCounters;
-    private setDeviceStrategy;
-    private handlePointerMove;
-    private initializeGlobalListeners;
-    private removeGlobalListeners;
-    private handleDomMutations;
-    alterGlobalSettings(props?: Partial<UpdateForsightManagerSettings>): void;
-    private forceUpdateAllElementBounds;
-    /**
-     * 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 devLog;
-}
-
-type HasListenersFunction = <K extends ForesightEvent>(eventType: K) => boolean;
-
-export { type CallbackCompletedEvent, type CallbackHitType, type CallbackHits, type CallbackInvokedEvent, type DeviceStrategyChangedEvent, type ElementCallbackInfo, type ElementDataUpdatedEvent, type ElementReactivatedEvent, type ElementRegisteredEvent, type ElementUnregisteredEvent, type ForesightCallback, type ForesightElement, type ForesightElementData, type ForesightEvent, ForesightManager, type ForesightManagerSettings, type Rect as ForesightRect, type ForesightRegisterNodeListOptions, type ForesightRegisterOptions, type ForesightRegisterOptionsWithoutElement, type ForesightRegisterResult, type HasListenersFunction, type HitSlop, type ManagerSettingsChangedEvent, type MinimumConnectionType, type MouseTrajectoryUpdateEvent, type ScrollTrajectoryUpdateEvent, type TouchDeviceStrategy, type UpdateForsightManagerSettings, type UpdatedManagerSetting };

package/dist/index.js

@@ -1 +0,0 @@
-import{a as C,b as g,c as v,d as p}from"./chunk-PAYO6NXN.js";function k(){let n=E(),e=L();return{isTouchDevice:n,isLimitedConnection:e,shouldRegister:!e}}function E(){return typeof window>"u"||typeof navigator>"u"?!1:window.matchMedia("(pointer: coarse)").matches&&navigator.maxTouchPoints>0}function L(){let n=navigator.connection;if(!n)return!1;let e=u.instance.getManagerData.globalSettings.minimumConnectionType,t=["slow-2g","2g","3g","4g"],i=t.indexOf(n.effectiveType),r=t.indexOf(e);return i<r||n.saveData}function F(n){if(typeof window>"u"||typeof document>"u")return!1;let e=window.innerWidth||document.documentElement.clientWidth,t=window.innerHeight||document.documentElement.clientHeight;return n.top<t&&n.bottom>0&&n.left<e&&n.right>0}function T(){return{mouse:{hover:0,trajectory:0},tab:{forwards:0,reverse:0},scroll:{down:0,left:0,right:0,up:0},touch:0,viewport:0,total:0}}function H(){return{debug:!1,enableManagerLogging:!1,enableMousePrediction:!0,enableScrollPrediction:!0,positionHistorySize:8,trajectoryPredictionTime:120,scrollMargin:150,defaultHitSlop:{top:0,left:0,right:0,bottom:0},enableTabPrediction:!0,tabOffset:2,touchDeviceStrategy:"onTouchStart",minimumConnectionType:"3g"}}function R(n,e,t){let{element:i,callback:r,hitSlop:o,name:s,meta:c,reactivateAfter:b}=n,d=i.getBoundingClientRect(),a=o?g(o):t;return{id:e,element:i,callback:r,elementBounds:{originalRect:d,expandedRect:v(d,a),hitSlop:a},name:s||i.id||"unnamed",isIntersectingWithViewport:F(d),registerCount:1,meta:c??{},callbackInfo:{callbackFiredCount:0,lastCallbackInvokedAt:void 0,lastCallbackCompletedAt:void 0,lastCallbackRuntime:void 0,lastCallbackStatus:void 0,lastCallbackErrorMessage:void 0,reactivateAfter:b??1/0,isCallbackActive:!0,isRunningCallback:!1,reactivateTimeoutId:void 0}}}var f=class{constructor(){this.eventListeners=new Map}addEventListener(e,t,i){if(i?.signal?.aborted)return;let r=this.eventListeners.get(e)??[];r.push(t),this.eventListeners.set(e,r),i?.signal?.addEventListener("abort",()=>this.removeEventListener(e,t))}removeEventListener(e,t){let i=this.eventListeners.get(e);if(!i)return;let r=i.indexOf(t);r>-1&&i.splice(r,1)}emit(e){let t=this.eventListeners.get(e.type);if(!(!t||t.length===0))for(let i=0;i<t.length;i++)try{let r=t[i];r&&r(e)}catch(r){console.error(`Error in ForesightManager event listener ${i} for ${e.type}:`,r)}}hasListeners(e){let t=this.eventListeners.get(e);return t!==void 0&&t.length>0}getEventListeners(){return this.eventListeners}};function y(n,e){return n!==void 0&&e!==n}var I={trajectoryPredictionTime:{min:10,max:200},positionHistorySize:{min:2,max:30},scrollMargin:{min:30,max:300},tabOffset:{min:0,max:20}};function h(n,e,t){if(!y(t,n[e]))return!1;let{min:i,max:r}=I[e];return n[e]=C(t,i,r,e),!0}function m(n,e,t){return y(t,n[e])?(n[e]=t,!0):!1}function M(n,e){h(n,"trajectoryPredictionTime",e.trajectoryPredictionTime),h(n,"positionHistorySize",e.positionHistorySize),h(n,"scrollMargin",e.scrollMargin),h(n,"tabOffset",e.tabOffset),m(n,"enableMousePrediction",e.enableMousePrediction),m(n,"enableScrollPrediction",e.enableScrollPrediction),m(n,"enableTabPrediction",e.enableTabPrediction),m(n,"enableManagerLogging",e.enableManagerLogging),e.defaultHitSlop!==void 0&&(n.defaultHitSlop=g(e.defaultHitSlop)),e.touchDeviceStrategy!==void 0&&(n.touchDeviceStrategy=e.touchDeviceStrategy),e.minimumConnectionType!==void 0&&(n.minimumConnectionType=e.minimumConnectionType),e.debug!==void 0&&(n.debug=e.debug)}function D(n,e){let t=[],i=!1,r=!1,o=!1,s=!1,c=!1;if(!e)return{changedSettings:t,positionHistorySizeChanged:i,scrollPredictionChanged:r,tabPredictionChanged:o,hitSlopChanged:s,touchStrategyChanged:c};let b=["trajectoryPredictionTime","positionHistorySize","scrollMargin","tabOffset"];for(let a of b){let l=n[a];h(n,a,e[a])&&(t.push({setting:a,oldValue:l,newValue:n[a]}),a==="positionHistorySize"&&(i=!0))}let d=["enableMousePrediction","enableScrollPrediction","enableTabPrediction"];for(let a of d){let l=n[a];m(n,a,e[a])&&(t.push({setting:a,oldValue:l,newValue:n[a]}),a==="enableScrollPrediction"&&(r=!0),a==="enableTabPrediction"&&(o=!0))}if(e.defaultHitSlop!==void 0){let a=n.defaultHitSlop,l=g(e.defaultHitSlop);p(a,l)||(n.defaultHitSlop=l,t.push({setting:"defaultHitSlop",oldValue:a,newValue:l}),s=!0)}if(e.touchDeviceStrategy!==void 0){let a=n.touchDeviceStrategy;n.touchDeviceStrategy=e.touchDeviceStrategy,t.push({setting:"touchDeviceStrategy",oldValue:a,newValue:e.touchDeviceStrategy}),c=!0}if(e.minimumConnectionType!==void 0){let a=n.minimumConnectionType;n.minimumConnectionType=e.minimumConnectionType,t.push({setting:"minimumConnectionType",oldValue:a,newValue:e.minimumConnectionType})}return{changedSettings:t,positionHistorySizeChanged:i,scrollPredictionChanged:r,tabPredictionChanged:o,hitSlopChanged:s,touchStrategyChanged:c}}var u=class n{constructor(e){this.elements=new Map;this.checkableElements=new Set;this.idCounter=0;this.activeElementCount=0;this.desktopHandler=null;this.touchDeviceHandler=null;this.currentlyActiveHandler=null;this.isSetup=!1;this.pendingPointerEvent=null;this.rafId=null;this.domObserver=null;this.currentDeviceStrategy=E()?"touch":"mouse";this.eventEmitter=new f;this._globalCallbackHits=T();this._globalSettings=H();this.handlePointerMove=e=>{this.pendingPointerEvent=e,e.pointerType!==this.currentDeviceStrategy&&(this.eventEmitter.emit({type:"deviceStrategyChanged",timestamp:Date.now(),newStrategy:e.pointerType,oldStrategy:this.currentDeviceStrategy}),this.currentDeviceStrategy=e.pointerType,this.setDeviceStrategy(this.currentDeviceStrategy)),!this.rafId&&(this.rafId=requestAnimationFrame(()=>{if(!this.isUsingDesktopHandler){this.rafId=null;return}this.pendingPointerEvent&&this.desktopHandler?.processMouseMovement(this.pendingPointerEvent),this.rafId=null}))};this.handleDomMutations=e=>{if(!e.length)return;this.desktopHandler?.invalidateTabCache();let t=!1;for(let i=0;i<e.length;i++){let r=e[i];if(r&&r.type==="childList"&&r.removedNodes.length>0){t=!0;break}}if(t)for(let i of this.elements.keys())i.isConnected||this.unregister(i,"disconnected")};e!==void 0&&M(this._globalSettings,e),this.handlerDependencies={elements:this.elements,callCallback:this.callCallback.bind(this),emit:this.eventEmitter.emit.bind(this.eventEmitter),hasListeners:this.eventEmitter.hasListeners.bind(this.eventEmitter),settings:this._globalSettings},this.devLog(`ForesightManager initialized with device strategy: ${this.currentDeviceStrategy}`),this.initializeGlobalListeners()}async getOrCreateDesktopHandler(){if(!this.desktopHandler){let{DesktopHandler:e}=await import("./DesktopHandler-BOXAW4XX.js");this.desktopHandler=new e(this.handlerDependencies),this.devLog("DesktopHandler lazy loaded")}return this.desktopHandler}async getOrCreateTouchHandler(){if(!this.touchDeviceHandler){let{TouchDeviceHandler:e}=await import("./TouchDeviceHandler-JWBQ2YOV.js");this.touchDeviceHandler=new e(this.handlerDependencies),this.devLog("TouchDeviceHandler lazy loaded")}return this.touchDeviceHandler}static initialize(e){return this.isInitiated||(n.manager=new n(e)),n.manager}static get isInitiated(){return!!n.manager}static get instance(){return this.initialize()}generateId(){return`foresight-${++this.idCounter}`}get isUsingDesktopHandler(){return this.currentDeviceStrategy==="mouse"||this.currentDeviceStrategy==="pen"}addEventListener(e,t,i){this.eventEmitter.addEventListener(e,t,i)}removeEventListener(e,t){this.eventEmitter.removeEventListener(e,t)}hasListeners(e){return this.eventEmitter.hasListeners(e)}get getManagerData(){let e=this.desktopHandler?.loadedPredictors,t=this.touchDeviceHandler?.loadedPredictors;return{registeredElements:this.elements,globalSettings:this._globalSettings,globalCallbackHits:this._globalCallbackHits,eventListeners:this.eventEmitter.getEventListeners(),currentDeviceStrategy:this.currentDeviceStrategy,activeElementCount:this.activeElementCount,loadedModules:{desktopHandler:this.desktopHandler!==null,touchHandler:this.touchDeviceHandler!==null,predictors:{mouse:e?.mouse??!1,tab:e?.tab??!1,scroll:e?.scroll??!1,viewport:t?.viewport??!1,touchStart:t?.touchStart??!1}}}}get registeredElements(){return this.elements}register(e){let{element:t,...i}=e;return t instanceof NodeList?Array.from(t,r=>this.registerElement({...i,element:r})):this.registerElement({...i,element:t})}registerElement(e){let{isTouchDevice:t,isLimitedConnection:i,shouldRegister:r}=k();if(!r)return{isLimitedConnection:i,isTouchDevice:t,isRegistered:!1,unregister:()=>{},elementData:null};let o=this.elements.get(e.element);if(o)return o.registerCount++,{isLimitedConnection:i,isTouchDevice:t,isRegistered:!1,unregister:()=>{},elementData:null};this.isSetup||this.initializeGlobalListeners();let s=R(e,this.generateId(),this._globalSettings.defaultHitSlop);return this.elements.set(e.element,s),this.activeElementCount++,this.updateCheckableStatus(s),this.currentlyActiveHandler?.observeElement(e.element),this.eventEmitter.emit({type:"elementRegistered",timestamp:Date.now(),elementData:s}),{isTouchDevice:t,isLimitedConnection:i,isRegistered:!0,unregister:()=>{this.unregister(e.element)},elementData:s}}unregister(e,t){e instanceof NodeList?e.forEach(i=>this.unregisterElement(i,t)):this.unregisterElement(e,t)}unregisterElement(e,t){let i=this.elements.get(e);if(!i)return;this.clearReactivateTimeout(i),this.currentlyActiveHandler?.unobserveElement(e),this.elements.delete(e),this.checkableElements.delete(i),i.callbackInfo.isCallbackActive&&this.activeElementCount--;let r=this.elements.size===0&&this.isSetup;r&&(this.devLog("All elements unregistered, removing global listeners"),this.removeGlobalListeners()),this.eventEmitter.emit({type:"elementUnregistered",elementData:i,timestamp:Date.now(),unregisterReason:t??"by user",wasLastRegisteredElement:r})}reactivate(e){e instanceof NodeList?e.forEach(t=>this.reactivateElement(t)):this.reactivateElement(e)}reactivateElement(e){let t=this.elements.get(e);t&&(this.isSetup||this.initializeGlobalListeners(),this.clearReactivateTimeout(t),t.callbackInfo.isRunningCallback||(t.callbackInfo.isCallbackActive=!0,this.activeElementCount++,this.updateCheckableStatus(t),this.currentlyActiveHandler?.observeElement(e),this.eventEmitter.emit({type:"elementReactivated",elementData:t,timestamp:Date.now()})))}clearReactivateTimeout(e){clearTimeout(e.callbackInfo.reactivateTimeoutId),e.callbackInfo.reactivateTimeoutId=void 0}updateCheckableStatus(e){e.isIntersectingWithViewport&&e.callbackInfo.isCallbackActive&&!e.callbackInfo.isRunningCallback?this.checkableElements.add(e):this.checkableElements.delete(e)}callCallback(e,t){e.callbackInfo.isRunningCallback||!e.callbackInfo.isCallbackActive||(this.markElementAsRunning(e),this.executeCallbackAsync(e,t))}markElementAsRunning(e){e.callbackInfo.callbackFiredCount++,e.callbackInfo.lastCallbackInvokedAt=Date.now(),e.callbackInfo.isRunningCallback=!0,this.clearReactivateTimeout(e),this.checkableElements.delete(e)}async executeCallbackAsync(e,t){this.updateHitCounters(t),this.eventEmitter.emit({type:"callbackInvoked",timestamp:Date.now(),elementData:e,hitType:t});let i=performance.now(),r,o=null;try{await e.callback(e),r="success"}catch(s){o=s instanceof Error?s.message:String(s),r="error",console.error(`Error in callback for element ${e.name}:`,s)}this.finalizeCallback(e,t,i,r,o)}finalizeCallback(e,t,i,r,o){e.callbackInfo.lastCallbackCompletedAt=Date.now(),e.callbackInfo.isRunningCallback=!1,e.callbackInfo.isCallbackActive=!1,this.activeElementCount--,this.currentlyActiveHandler?.unobserveElement(e.element),e.callbackInfo.reactivateAfter!==1/0&&(e.callbackInfo.reactivateTimeoutId=setTimeout(()=>{this.reactivate(e.element)},e.callbackInfo.reactivateAfter));let s=this.activeElementCount===0;s&&(this.devLog("All elements unactivated, removing global listeners"),this.removeGlobalListeners()),this.eventEmitter.emit({type:"callbackCompleted",timestamp:Date.now(),elementData:e,hitType:t,elapsed:e.callbackInfo.lastCallbackRuntime=performance.now()-i,status:e.callbackInfo.lastCallbackStatus=r,errorMessage:e.callbackInfo.lastCallbackErrorMessage=o,wasLastActiveElement:s})}updateHitCounters(e){switch(e.kind){case"mouse":this._globalCallbackHits.mouse[e.subType]++;break;case"tab":this._globalCallbackHits.tab[e.subType]++;break;case"scroll":this._globalCallbackHits.scroll[e.subType]++;break;case"touch":this._globalCallbackHits.touch++;break;case"viewport":this._globalCallbackHits.viewport++;break;default:}this._globalCallbackHits.total++}async setDeviceStrategy(e){let t=this.currentDeviceStrategy;t!==e&&this.devLog(`Switching device strategy from ${t} to ${e}`),this.currentlyActiveHandler?.disconnect(),this.currentlyActiveHandler=e==="mouse"||e==="pen"?await this.getOrCreateDesktopHandler():await this.getOrCreateTouchHandler(),this.currentlyActiveHandler.connect()}initializeGlobalListeners(){this.isSetup||typeof document>"u"||(this.devLog("Initializing global listeners (pointermove, MutationObserver)"),this.setDeviceStrategy(this.currentDeviceStrategy),document.addEventListener("pointermove",this.handlePointerMove),this.domObserver=new MutationObserver(this.handleDomMutations),this.domObserver.observe(document.documentElement,{childList:!0,subtree:!0,attributes:!1}),this.isSetup=!0)}removeGlobalListeners(){typeof document>"u"||(this.isSetup=!1,this.domObserver?.disconnect(),this.domObserver=null,document.removeEventListener("pointermove",this.handlePointerMove),this.currentlyActiveHandler?.disconnect(),this.rafId&&(cancelAnimationFrame(this.rafId),this.rafId=null),this.pendingPointerEvent=null)}alterGlobalSettings(e){let t=D(this._globalSettings,e);t.positionHistorySizeChanged&&this.desktopHandler&&this.desktopHandler.trajectoryPositions.positions.resize(this._globalSettings.positionHistorySize),t.scrollPredictionChanged&&this.isUsingDesktopHandler&&this.desktopHandler&&(this._globalSettings.enableScrollPrediction?this.desktopHandler.connectScrollPredictor():this.desktopHandler.disconnectScrollPredictor()),t.tabPredictionChanged&&this.isUsingDesktopHandler&&this.desktopHandler&&(this._globalSettings.enableTabPrediction?this.desktopHandler.connectTabPredictor():this.desktopHandler.disconnectTabPredictor()),t.hitSlopChanged&&this.forceUpdateAllElementBounds(),t.touchStrategyChanged&&!this.isUsingDesktopHandler&&this.touchDeviceHandler&&this.touchDeviceHandler.setTouchPredictor(),t.changedSettings.length>0&&this.eventEmitter.emit({type:"managerSettingsChanged",timestamp:Date.now(),managerData:this.getManagerData,updatedSettings:t.changedSettings})}forceUpdateAllElementBounds(){for(let e of this.elements.values())e.isIntersectingWithViewport&&this.forceUpdateElementBounds(e)}forceUpdateElementBounds(e){let t=e.element.getBoundingClientRect(),i=v(t,e.elementBounds.hitSlop);if(!p(i,e.elementBounds.expandedRect)){let r={...e,elementBounds:{...e.elementBounds,originalRect:t,expandedRect:i}};this.elements.set(e.element,r),this.eventEmitter.emit({type:"elementDataUpdated",elementData:r,updatedProps:["bounds"]})}}devLog(e){this._globalSettings.enableManagerLogging&&console.log(`%c\u{1F6E0}\uFE0F ForesightManager: ${e}`,"color: #16a34a; font-weight: bold;")}};export{u as ForesightManager};