@supermousejs/core 2.2.0 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @supermousejs/core
 
+## 2.3.0
+
+### Minor Changes
+
+- 8dc8e06: cleanup and robustness pass: better case-insensitive data-\* handling, safer plugin lifecycle behavior, more reliable cursor restoration, and a more consistent reset/update flow
+- 600de13: added `dataPrefix` option for customizable data attribute handling, added a `start()` public method to manually start the raf loop and enhanced supermouse's resistance to bugs
+
+### Patch Changes
+
+- b72e264: Renamed `setCursor` to `setNativeCursor` for simplicity and removed redundant checks on `ignoreOnNative`
+
 ## 2.2.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -28,21 +28,21 @@ export declare interface MousePosition {
 }
 
 export declare interface MouseState {
-    /** The raw position of the input pointer (mouse/touch). */
+    /** The raw position from the latest pointer event, before smoothing is applied. */
     pointer: MousePosition;
-    /** The target position the cursor logic wants to reach. */
+    /** The current goal position that the core loop is driving toward. */
     target: MousePosition;
     /** The smoothed/interpolated position used for rendering. */
     smooth: MousePosition;
-    /** The current velocity vector of the smooth position. */
+    /** The current movement vector derived from the smoothed state. */
     velocity: MousePosition;
-    /** The angle of movement in degrees. Calculated from velocity. */
+    /** The current movement angle in degrees, derived from velocity. */
     angle: number;
     /** Whether the pointer is currently pressed down. */
     isDown: boolean;
     /** Whether the pointer is currently hovering over a registered interactive element. */
     isHover: boolean;
-    /** Whether the native cursor is currently forced visible by internal logic (e.g. input elements). */
+    /** Whether the runtime has temporarily restored the native cursor due to native-input heuristics. */
     isNative: boolean;
     /**
      * If set, this overrides all auto-detection logic.
@@ -131,11 +131,11 @@ export declare class Supermouse {
      */
     get container(): HTMLDivElement;
     /**
-     * Manually override the native cursor visibility.
+     * Sets the native cursor visibility.
      *
-     * @param type 'auto' (Show Native), 'none' (Hide Native), or null (Resume Auto-detection)
+     * @param mode
      */
-    setCursor(type: "auto" | "none" | null): void;
+    setNativeCursor(mode: "hide" | "show" | "auto"): void;
     private init;
     enable(): void;
     disable(): void;
@@ -145,9 +145,13 @@ export declare class Supermouse {
      * @param plugin - The plugin object to install.
      */
     use(plugin: SupermousePlugin): this;
-    private resetCoords;
-    private resetPosition;
+    private reset;
     private startLoop;
+    /**
+     * Starts the animation loop. This is automatically called if `autoStart` is true.
+     * Plugins can call this method to resume the loop if it has been stopped.
+     */
+    start(): void;
     /**
      * Manually steps the animation loop.
      *
@@ -191,20 +195,24 @@ export declare interface SupermouseOptions {
     autoDisableOnMobile?: boolean;
     /**
      * Strategy for detecting when to fallback to the native cursor.
-     * - `true` / `'auto'`: Checks both HTML tags and CSS cursor styles (Accurate but slower).
+     * - `'auto'`: Checks both HTML tags and CSS cursor styles (Accurate but slower).
      * - `'tag'`: Checks only semantic tags like <input>, <textarea> (Fastest, prevents layout thrashing).
      * - `'css'`: Checks only computed CSS cursor styles (Slow, triggers reflow).
-     * - `false`: Never fallback to native cursor.
+     * - `null`: Never fallback to native cursor.
+     *
      * @default 'auto'
      */
-    ignoreOnNative?: boolean | NativeIgnoreStrategy;
+    ignoreOnNative?: NativeIgnoreStrategy | null;
     /**
-     * Whether to hide the native cursor via global CSS injection.
+     * Whether to hide the native cursor via scoped CSS injection on the container.
+     * When enabled, the stage toggles `cursor: none` on the configured container and
+     * on registered hover targets.
      * @default true
      */
     hideCursor?: boolean;
     /**
-     * Whether to hide the custom cursor when the mouse leaves the browser window.
+     * Whether to hide the custom cursor when the pointer leaves the browser viewport.
+     * When enabled the runtime clears the cursor back to an off-screen position to avoid stale hover state.
      * @default true
      */
     hideOnLeave?: boolean;
@@ -224,14 +232,24 @@ export declare interface SupermouseOptions {
     autoStart?: boolean;
     /**
      * Semantic rules mapping CSS selectors to interaction state.
+     * Rules are evaluated against hovered elements and merged into `state.interaction`.
+     * Matching data attributes on the same element are also read and can override or enrich the final object.
      * @example { 'button': { icon: 'pointer' } }
      */
     rules?: Record<string, InteractionState>;
     /**
      * Custom strategy to resolve interaction state from a hovered element.
-     * Overrides the default data-attribute scraping.
+     * When provided, this callback bypasses the default `rules` + `data-[prefix]-*` scraping and
+     * returns the interaction payload directly for the current hover target.
      */
     resolveInteraction?: (target: HTMLElement) => InteractionState;
+    /**
+     * The prefix used for data attributes to store hover metadata.
+     * For example, if dataPrefix is "supermouse", then the attribute would be "data-supermouse-*".
+     * This allows for multiple instances of Supermouse to coexist without conflicting data attributes.
+     * @default "supermouse"
+     */
+    dataPrefix?: string;
 }
 
 /**
@@ -246,7 +264,7 @@ export declare interface SupermousePlugin {
     isEnabled?: boolean;
     /** Called when `app.use()` is executed. */
     install?: (instance: Supermouse) => void;
-    /** Called on every animation frame. */
+    /** Called on every animation frame with the frame delta time in milliseconds. */
     update?: (instance: Supermouse, deltaTime: number) => void;
     /** Called when the plugin is removed or the app is destroyed. */
     destroy?: (instance: Supermouse) => void;
@@ -258,6 +276,7 @@ export declare interface SupermousePlugin {
 
 /**
  * Allows a property to be a static value or a function that returns the value based on state.
+ * This is primarily useful for plugin option definitions that should react to the current runtime state.
  */
 export declare type ValueOrGetter<T> = T | ((state: MouseState) => T);
 

package/dist/index.mjs

@@ -1,15 +1,13 @@
-function c(n, t, e) {
+const d = "2.3.0";
+function p(n, t, e) {
   return n + (t - n) * e;
 }
-function d(n, t, e, i) {
-  return c(n, t, 1 - Math.exp(-e * i));
-}
-function p(n, t) {
-  return Math.atan2(t, n) * (180 / Math.PI);
+function c(n, t, e, i) {
+  return p(n, t, 1 - Math.exp(-e * i));
 }
 class f {
-  constructor(t, e, i, o) {
-    this.state = t, this.options = e, this.getHoverSelector = i, this.onEnableChange = o, this.checkDeviceCapability(), this.checkMotionPreference(), this.bindEvents();
+  constructor(t, e, i, a) {
+    this.state = t, this.options = e, this.getHoverSelector = i, this.onEnableChange = a, this.dataPrefix = this.options.dataPrefix ?? "supermouse", this.normalizedDataPrefix = this.dataPrefix.toLowerCase(), this.ignoreAttribute = `data-${this.dataPrefix}-ignore`, this.checkDeviceCapability(), this.checkMotionPreference(), this.bindEvents();
   }
   state;
   options;
@@ -18,6 +16,9 @@ class f {
   mediaQueryList;
   mediaQueryHandler;
   motionQuery;
+  dataPrefix;
+  normalizedDataPrefix;
+  ignoreAttribute;
   /**
    * Master switch for input processing.
    * Toggled by `Supermouse.enable()`/`disable()` or automatically by device capability checks.
@@ -52,30 +53,30 @@ class f {
   }
   parseDOMInteraction(t) {
     if (this.options.resolveInteraction) {
-      this.state.interaction = this.options.resolveInteraction(t);
+      this.state.interaction = this.options.resolveInteraction(t) || {};
       return;
     }
     const e = {};
     if (this.options.rules)
-      for (const [o, s] of Object.entries(this.options.rules))
-        t.matches(o) && Object.assign(e, s);
-    const i = t.dataset;
-    for (const o in i)
-      if (o.startsWith("supermouse")) {
-        const s = o.slice(10);
-        if (s) {
-          const r = s.charAt(0).toLowerCase() + s.slice(1), a = i[o];
-          a !== void 0 && (e[r] = a === "" ? !0 : a);
-        }
-      }
+      for (const [s, o] of Object.entries(this.options.rules))
+        t.matches(s) && Object.assign(e, o);
+    const i = this.normalizedDataPrefix, a = this.dataPrefix.length;
+    for (const s in t.dataset) {
+      if (!s.toLowerCase().startsWith(i)) continue;
+      const o = s.slice(a);
+      if (!o) continue;
+      const r = t.dataset[s];
+      e[o[0].toLowerCase() + o.slice(1)] = r === "" ? !0 : r;
+    }
     this.state.interaction = e;
   }
   handleMove(t) {
-    if (!this.isEnabled || this.options.autoDisableOnMobile && t.pointerType === "touch") return;
+    if (!this.isEnabled || this.options.autoDisableOnMobile && t.pointerType === "touch" && !this.options.enableTouch)
+      return;
     let e = t.clientX, i = t.clientY;
     if (this.options.container && this.options.container !== document.body) {
-      const o = this.options.container.getBoundingClientRect();
-      e -= o.left, i -= o.top;
+      const a = this.options.container.getBoundingClientRect();
+      e -= a.left, i -= a.top;
     }
     this.state.pointer.x = e, this.state.pointer.y = i, this.state.hasReceivedInput || (this.state.hasReceivedInput = !0, this.state.target.x = this.state.smooth.x = e, this.state.target.y = this.state.smooth.y = i);
   }
@@ -88,25 +89,25 @@ class f {
   handleMouseOver(t) {
     if (!this.isEnabled) return;
     const e = t.target;
-    if (e.closest("[data-supermouse-ignore]")) {
+    if (e.closest(`[${this.ignoreAttribute}]`)) {
       this.state.isNative = !0;
       return;
     }
-    const i = this.getHoverSelector(), o = e.closest(i);
-    o && (this.state.isHover = !0, this.state.hoverTarget = o, this.parseDOMInteraction(this.state.hoverTarget));
+    const i = this.getHoverSelector(), a = e.closest(i);
+    a && (this.state.isHover = !0, this.state.hoverTarget = a, this.parseDOMInteraction(this.state.hoverTarget));
     const s = this.options.ignoreOnNative;
-    if (s) {
-      const r = s === !0 || s === "auto" || s === "tag", a = s === !0 || s === "auto" || s === "css";
-      let l = !1;
-      if (r) {
+    if (s && s !== null) {
+      const o = s === "auto" || s === "tag", r = s === "auto" || s === "css";
+      let u = !1;
+      if (o) {
         const h = e.localName;
-        (h === "input" || h === "textarea" || h === "select" || e.isContentEditable) && (l = !0);
+        (h === "input" || h === "textarea" || h === "select" || e.isContentEditable) && (u = !0);
       }
-      if (!l && a) {
+      if (!u && r) {
         const h = window.getComputedStyle(e).cursor;
-        ["default", "auto", "pointer", "none", "inherit"].includes(h) || (l = !0);
+        ["default", "auto", "pointer", "none", "inherit"].includes(h) || (u = !0);
       }
-      l && (this.state.isNative = !0);
+      u && (this.state.isNative = !0);
     }
   }
   handleMouseOut(t) {
@@ -115,10 +116,10 @@ class f {
     (e === this.state.hoverTarget || e.contains(this.state.hoverTarget)) && (!t.relatedTarget || !this.state.hoverTarget?.contains(t.relatedTarget)) && (this.state.isHover = !1, this.state.hoverTarget = null, this.state.interaction = {}), this.state.isNative && (this.state.isNative = !1);
   }
   handleWindowLeave() {
-    this.options.hideOnLeave && (this.state.hasReceivedInput = !1);
+    this.options.hideOnLeave && (this.state.hasReceivedInput = !1, this.state.pointer = { ...l });
   }
   clearHover() {
-    this.state.isHover = !1, this.state.hoverTarget = null, this.state.isNative = !1;
+    this.state.isHover = !1, this.state.hoverTarget = null, this.state.isNative = !1, this.state.interaction = {};
   }
   bindEvents() {
     const { signal: t } = this.abortController;
@@ -135,18 +136,19 @@ class v {
       throw new Error(`[Supermouse] Invalid container: ${t}. Must be an HTMLElement.`);
     const i = g++;
     this.id = `supermouse-style-${i}`, this.scopeClass = `supermouse-scope-${i}`;
-    const o = t === document.body;
-    this.element = document.createElement("div"), Object.assign(this.element.style, {
-      position: o ? "fixed" : "absolute",
-      top: "0",
-      left: "0",
-      width: "100%",
-      height: "100%",
+    const a = t === document.body;
+    if (this.element = document.createElement("div"), Object.assign(this.element.style, {
+      position: a ? "fixed" : "absolute",
+      inset: "0px",
       pointerEvents: "none",
       zIndex: "9999",
       opacity: "1",
       transition: "opacity 0.15s ease"
-    }), o || window.getComputedStyle(t).position === "static" && (t.style.position = "relative"), t.appendChild(this.element), this.styleTag = document.createElement("style"), this.styleTag.id = this.id, document.head.appendChild(this.styleTag), this.container.classList.add(this.scopeClass), this.hideNativeCursor && this.setNativeCursor("none");
+    }), !a) {
+      const s = window.getComputedStyle(t);
+      this.originalContainerPosition = s.position, s.position === "static" && (t.style.position = "relative");
+    }
+    this.originalContainerCursor = t.style.cursor, t.appendChild(this.element), this.styleTag = document.createElement("style"), this.styleTag.id = this.id, document.head.appendChild(this.styleTag), this.container.classList.add(this.scopeClass), this.hideNativeCursor && this.setNativeCursor("none");
   }
   container;
   hideNativeCursor;
@@ -156,6 +158,8 @@ class v {
   id;
   scopeClass;
   currentCursorState = null;
+  originalContainerPosition = "";
+  originalContainerCursor = "";
   selectors = /* @__PURE__ */ new Set([
     "a",
     "button",
@@ -197,10 +201,10 @@ class v {
     `;
   }
   destroy() {
-    this.element.remove(), this.styleTag.remove(), this.container.style.cursor = "", this.container.classList.remove(this.scopeClass);
+    this.element.remove(), this.styleTag.remove(), this.container.style.cursor = this.originalContainerCursor, this.container.classList.remove(this.scopeClass), this.container !== document.body && this.originalContainerPosition === "static" && (this.container.style.position = "");
   }
 }
-const u = { x: -100, y: -100 }, m = [
+const l = { x: -100, y: -100 }, m = [
   "a",
   "button",
   "input",
@@ -209,8 +213,8 @@ const u = { x: -100, y: -100 }, m = [
   "[data-cursor]"
 ];
 class y {
-  static version = "2.2.0";
-  version = "2.2.0";
+  static version = d;
+  version = d;
   state;
   /**
    * Configuration options.
@@ -239,8 +243,9 @@ class y {
       hideOnLeave: !0,
       autoStart: !0,
       container: document.body,
+      dataPrefix: "supermouse",
       ...t
-    }, this.options.container || (this.options.container = document.body), this.state = {
+    }, this.state = {
       pointer: { x: -100, y: -100 },
       target: { x: -100, y: -100 },
       smooth: { x: -100, y: -100 },
@@ -260,7 +265,7 @@ class y {
       this.options,
       () => Array.from(this.hoverSelectors).join(", "),
       (e) => {
-        e || this.resetPosition();
+        e || this.reset(!0);
       }
     ), this.options.plugins && this.options.plugins.forEach((e) => this.use(e)), this.init();
   }
@@ -309,12 +314,12 @@ class y {
     return this.stage.element;
   }
   /**
-   * Manually override the native cursor visibility.
+   * Sets the native cursor visibility.
    *
-   * @param type 'auto' (Show Native), 'none' (Hide Native), or null (Resume Auto-detection)
+   * @param mode
    */
-  setCursor(t) {
-    this.state.forcedCursor = t;
+  setNativeCursor(t) {
+    this.state.forcedCursor = t === "auto" ? null : t === "hide" ? "none" : "auto";
   }
   init() {
     this.options.autoStart && this.startLoop();
@@ -323,7 +328,7 @@ class y {
     this.input.isEnabled = !0, this.stage.setNativeCursor("none");
   }
   disable() {
-    this.input.isEnabled = !1, this.stage.setNativeCursor("auto"), this.resetPosition();
+    this.input.isEnabled = !1, this.stage.setNativeCursor("auto"), this.reset(!0);
   }
   /**
    * Registers a new plugin.
@@ -331,17 +336,29 @@ class y {
    * @param plugin - The plugin object to install.
    */
   use(t) {
-    return this.plugins.find((e) => e.name === t.name) ? (console.warn(`[Supermouse] Plugin "${t.name}" already installed.`), this) : (t.isEnabled === void 0 && (t.isEnabled = !0), this.plugins.push(t), this.plugins.sort((e, i) => (e.priority || 0) - (i.priority || 0)), t.install?.(this), this);
-  }
-  resetCoords() {
-    this.state.pointer = { ...u }, this.state.target = { ...u }, this.state.smooth = { ...u }, this.state.velocity = { x: 0, y: 0 }, this.state.angle = 0;
+    if (this.plugins.some((i) => i.name === t.name))
+      return console.warn(`[Supermouse] Plugin "${t.name}" already installed.`), this;
+    t.isEnabled === void 0 && (t.isEnabled = !0);
+    try {
+      t.install?.(this);
+    } catch (i) {
+      return console.error(`[Supermouse] Failed to install plugin '${t.name}'.`, i), this;
+    }
+    return this.plugins.push(t), this.plugins.sort((i, a) => (i.priority || 0) - (a.priority || 0)), this;
   }
-  resetPosition() {
-    this.resetCoords(), this.state.hasReceivedInput = !1, this.state.shape = null, this.state.interaction = {};
+  reset(t = !1) {
+    this.state.pointer = { ...l }, this.state.target = { ...l }, this.state.smooth = { ...l }, this.state.velocity = { x: 0, y: 0 }, this.state.angle = 0, t && (this.state.hasReceivedInput = !1, this.state.shape = null, this.state.interaction = {});
   }
   startLoop() {
     this.isRunning || (this.isRunning = !0, this.lastTime = performance.now(), this.tick(this.lastTime));
   }
+  /**
+   * Starts the animation loop. This is automatically called if `autoStart` is true.
+   * Plugins can call this method to resume the loop if it has been stopped.
+   */
+  start() {
+    this.startLoop();
+  }
   /**
    * Manually steps the animation loop.
    *
@@ -355,11 +372,13 @@ class y {
       try {
         t.update?.(this, e);
       } catch (i) {
-        console.error(`[Supermouse] Plugin '${t.name}' crashed and has been disabled.`, i), t.isEnabled = !1;
+        console.error(`[Supermouse] Plugin '${t.name}' crashed and has been disabled.`, i);
+        const a = this.plugins.indexOf(t);
+        a > -1 && this.plugins.splice(a, 1), t.isEnabled = !1;
         try {
-          t.onDisable?.(this);
-        } catch (o) {
-          console.error(`[Supermouse] Failed to execute onDisable for plugin '${t.name}'.`, o);
+          t.destroy?.(this), t.onDisable?.(this);
+        } catch (s) {
+          console.error(`[Supermouse] Failed to cleanup crashed plugin '${t.name}'.`, s);
         }
       }
   }
@@ -369,21 +388,21 @@ class y {
   tick = (t) => {
     const e = t - this.lastTime, i = Math.min(e / 1e3, 0.1);
     this.lastTime = t, this.state.hoverTarget && !this.state.hoverTarget.isConnected && this.input.clearHover();
-    const o = this.input.isEnabled && !this.state.isNative && this.state.hasReceivedInput;
-    if (this.stage.setVisibility(o), this.input.isEnabled && this.options.hideCursor) {
+    const a = this.input.isEnabled && !this.state.isNative && this.state.hasReceivedInput;
+    if (this.stage.setVisibility(a), this.input.isEnabled && this.options.hideCursor) {
       let s = "auto";
       this.state.forcedCursor !== null ? s = this.state.forcedCursor : s = this.state.isNative || !this.state.hasReceivedInput ? "auto" : "none", this.stage.setNativeCursor(s);
     }
-    this.input.isEnabled ? (this.state.target.x = this.state.pointer.x, this.state.target.y = this.state.pointer.y) : this.resetCoords();
+    this.input.isEnabled && this.state.hasReceivedInput ? (this.state.target.x = this.state.pointer.x, this.state.target.y = this.state.pointer.y) : this.state.target = { ...l };
     for (let s = 0; s < this.plugins.length; s++)
       this.runPluginSafe(this.plugins[s], e);
     if (this.input.isEnabled) {
       const s = this.state.reducedMotion ? 1e3 : 1 / this.options.smoothness * 2;
-      this.state.smooth.x = d(this.state.smooth.x, this.state.target.x, s, i), this.state.smooth.y = d(this.state.smooth.y, this.state.target.y, s, i);
-      const r = this.state.target.x - this.state.smooth.x, a = this.state.target.y - this.state.smooth.y;
-      this.state.velocity.x = r, this.state.velocity.y = a, (Math.abs(r) > 0.1 || Math.abs(a) > 0.1) && (this.state.angle = p(r, a));
+      this.state.smooth.x = c(this.state.smooth.x, this.state.target.x, s, i), this.state.smooth.y = c(this.state.smooth.y, this.state.target.y, s, i), this.state.velocity.x = this.state.target.x - this.state.smooth.x, this.state.velocity.y = this.state.target.y - this.state.smooth.y;
+      const { x: o, y: r } = this.state.velocity;
+      (Math.abs(o) > 0.1 || Math.abs(r) > 0.1) && (this.state.angle = Math.atan2(r, o) * (180 / Math.PI));
     }
-    this.options.autoStart && this.isRunning && (this.rafId = requestAnimationFrame(this.tick));
+    this.isRunning && (this.rafId = requestAnimationFrame(this.tick));
   };
   /**
    * Destroys the instance.

package/dist/index.umd.js

@@ -1,5 +1,5 @@
-(function(n,l){typeof exports=="object"&&typeof module<"u"?l(exports):typeof define=="function"&&define.amd?define(["exports"],l):(n=typeof globalThis<"u"?globalThis:n||self,l(n.SupermouseCore={}))})(this,(function(n){"use strict";function l(a,t,e){return a+(t-a)*e}function p(a,t,e,i){return l(a,t,1-Math.exp(-e*i))}function m(a,t){return Math.atan2(t,a)*(180/Math.PI)}class f{constructor(t,e,i,o){this.state=t,this.options=e,this.getHoverSelector=i,this.onEnableChange=o,this.checkDeviceCapability(),this.checkMotionPreference(),this.bindEvents()}state;options;getHoverSelector;onEnableChange;mediaQueryList;mediaQueryHandler;motionQuery;isEnabled=!0;abortController=new AbortController;checkDeviceCapability(){this.options.autoDisableOnMobile&&(this.mediaQueryList=window.matchMedia("(pointer: fine)"),this.updateEnabledState(this.mediaQueryList.matches),this.mediaQueryHandler=t=>{this.updateEnabledState(t.matches)},this.mediaQueryList.addEventListener("change",this.mediaQueryHandler,{signal:this.abortController.signal}))}checkMotionPreference(){this.motionQuery=window.matchMedia("(prefers-reduced-motion: reduce)"),this.state.reducedMotion=this.motionQuery.matches,this.motionQuery.addEventListener("change",t=>{this.state.reducedMotion=t.matches},{signal:this.abortController.signal})}updateEnabledState(t){this.isEnabled=t,this.onEnableChange(t)}parseDOMInteraction(t){if(this.options.resolveInteraction){this.state.interaction=this.options.resolveInteraction(t);return}const e={};if(this.options.rules)for(const[o,s]of Object.entries(this.options.rules))t.matches(o)&&Object.assign(e,s);const i=t.dataset;for(const o in i)if(o.startsWith("supermouse")){const s=o.slice(10);if(s){const h=s.charAt(0).toLowerCase()+s.slice(1),r=i[o];r!==void 0&&(e[h]=r===""?!0:r)}}this.state.interaction=e}handleMove(t){if(!this.isEnabled||this.options.autoDisableOnMobile&&t.pointerType==="touch")return;let e=t.clientX,i=t.clientY;if(this.options.container&&this.options.container!==document.body){const o=this.options.container.getBoundingClientRect();e-=o.left,i-=o.top}this.state.pointer.x=e,this.state.pointer.y=i,this.state.hasReceivedInput||(this.state.hasReceivedInput=!0,this.state.target.x=this.state.smooth.x=e,this.state.target.y=this.state.smooth.y=i)}handleDown(){this.isEnabled&&(this.state.isDown=!0)}handleUp(){this.isEnabled&&(this.state.isDown=!1)}handleMouseOver(t){if(!this.isEnabled)return;const e=t.target;if(e.closest("[data-supermouse-ignore]")){this.state.isNative=!0;return}const i=this.getHoverSelector(),o=e.closest(i);o&&(this.state.isHover=!0,this.state.hoverTarget=o,this.parseDOMInteraction(this.state.hoverTarget));const s=this.options.ignoreOnNative;if(s){const h=s===!0||s==="auto"||s==="tag",r=s===!0||s==="auto"||s==="css";let d=!1;if(h){const u=e.localName;(u==="input"||u==="textarea"||u==="select"||e.isContentEditable)&&(d=!0)}if(!d&&r){const u=window.getComputedStyle(e).cursor;["default","auto","pointer","none","inherit"].includes(u)||(d=!0)}d&&(this.state.isNative=!0)}}handleMouseOut(t){if(!this.isEnabled)return;const e=t.target;(e===this.state.hoverTarget||e.contains(this.state.hoverTarget))&&(!t.relatedTarget||!this.state.hoverTarget?.contains(t.relatedTarget))&&(this.state.isHover=!1,this.state.hoverTarget=null,this.state.interaction={}),this.state.isNative&&(this.state.isNative=!1)}handleWindowLeave(){this.options.hideOnLeave&&(this.state.hasReceivedInput=!1)}clearHover(){this.state.isHover=!1,this.state.hoverTarget=null,this.state.isNative=!1}bindEvents(){const{signal:t}=this.abortController;window.addEventListener("pointermove",this.handleMove.bind(this),{passive:!0,signal:t}),window.addEventListener("pointerdown",this.handleDown.bind(this),{passive:!0,signal:t}),window.addEventListener("pointerup",this.handleUp.bind(this),{signal:t}),document.addEventListener("mouseover",this.handleMouseOver.bind(this),{signal:t}),document.addEventListener("mouseout",this.handleMouseOut.bind(this),{signal:t}),document.addEventListener("mouseleave",this.handleWindowLeave.bind(this),{signal:t})}destroy(){this.abortController.abort()}}let b=0;class g{constructor(t=document.body,e){if(this.container=t,this.hideNativeCursor=e,!t||!(t instanceof HTMLElement))throw new Error(`[Supermouse] Invalid container: ${t}. Must be an HTMLElement.`);const i=b++;this.id=`supermouse-style-${i}`,this.scopeClass=`supermouse-scope-${i}`;const o=t===document.body;this.element=document.createElement("div"),Object.assign(this.element.style,{position:o?"fixed":"absolute",top:"0",left:"0",width:"100%",height:"100%",pointerEvents:"none",zIndex:"9999",opacity:"1",transition:"opacity 0.15s ease"}),o||window.getComputedStyle(t).position==="static"&&(t.style.position="relative"),t.appendChild(this.element),this.styleTag=document.createElement("style"),this.styleTag.id=this.id,document.head.appendChild(this.styleTag),this.container.classList.add(this.scopeClass),this.hideNativeCursor&&this.setNativeCursor("none")}container;hideNativeCursor;element;styleTag;id;scopeClass;currentCursorState=null;selectors=new Set(["a","button","input","textarea","select",'[role="button"]',"[tabindex]"]);addSelector(t){this.selectors.add(t),this.hideNativeCursor&&this.updateCursorCSS()}setVisibility(t){this.element.style.opacity=t?"1":"0"}setNativeCursor(t){!this.hideNativeCursor&&t==="none"||t!==this.currentCursorState&&(this.currentCursorState=t,t==="none"?(this.container.style.cursor="none",this.updateCursorCSS()):(this.container.style.cursor="",this.styleTag.innerText=""))}updateCursorCSS(){const t=Array.from(this.selectors);if(t.length===0){this.styleTag.innerText="";return}const e=t.map(i=>`.${this.scopeClass} ${i}`).join(", ");this.styleTag.innerText=`
+(function(a,l){typeof exports=="object"&&typeof module<"u"?l(exports):typeof define=="function"&&define.amd?define(["exports"],l):(a=typeof globalThis<"u"?globalThis:a||self,l(a.SupermouseCore={}))})(this,(function(a){"use strict";const l="2.3.0";function m(r,t,e){return r+(t-r)*e}function p(r,t,e,i){return m(r,t,1-Math.exp(-e*i))}class f{constructor(t,e,i,n){this.state=t,this.options=e,this.getHoverSelector=i,this.onEnableChange=n,this.dataPrefix=this.options.dataPrefix??"supermouse",this.normalizedDataPrefix=this.dataPrefix.toLowerCase(),this.ignoreAttribute=`data-${this.dataPrefix}-ignore`,this.checkDeviceCapability(),this.checkMotionPreference(),this.bindEvents()}state;options;getHoverSelector;onEnableChange;mediaQueryList;mediaQueryHandler;motionQuery;dataPrefix;normalizedDataPrefix;ignoreAttribute;isEnabled=!0;abortController=new AbortController;checkDeviceCapability(){this.options.autoDisableOnMobile&&(this.mediaQueryList=window.matchMedia("(pointer: fine)"),this.updateEnabledState(this.mediaQueryList.matches),this.mediaQueryHandler=t=>{this.updateEnabledState(t.matches)},this.mediaQueryList.addEventListener("change",this.mediaQueryHandler,{signal:this.abortController.signal}))}checkMotionPreference(){this.motionQuery=window.matchMedia("(prefers-reduced-motion: reduce)"),this.state.reducedMotion=this.motionQuery.matches,this.motionQuery.addEventListener("change",t=>{this.state.reducedMotion=t.matches},{signal:this.abortController.signal})}updateEnabledState(t){this.isEnabled=t,this.onEnableChange(t)}parseDOMInteraction(t){if(this.options.resolveInteraction){this.state.interaction=this.options.resolveInteraction(t)||{};return}const e={};if(this.options.rules)for(const[s,o]of Object.entries(this.options.rules))t.matches(s)&&Object.assign(e,o);const i=this.normalizedDataPrefix,n=this.dataPrefix.length;for(const s in t.dataset){if(!s.toLowerCase().startsWith(i))continue;const o=s.slice(n);if(!o)continue;const h=t.dataset[s];e[o[0].toLowerCase()+o.slice(1)]=h===""?!0:h}this.state.interaction=e}handleMove(t){if(!this.isEnabled||this.options.autoDisableOnMobile&&t.pointerType==="touch"&&!this.options.enableTouch)return;let e=t.clientX,i=t.clientY;if(this.options.container&&this.options.container!==document.body){const n=this.options.container.getBoundingClientRect();e-=n.left,i-=n.top}this.state.pointer.x=e,this.state.pointer.y=i,this.state.hasReceivedInput||(this.state.hasReceivedInput=!0,this.state.target.x=this.state.smooth.x=e,this.state.target.y=this.state.smooth.y=i)}handleDown(){this.isEnabled&&(this.state.isDown=!0)}handleUp(){this.isEnabled&&(this.state.isDown=!1)}handleMouseOver(t){if(!this.isEnabled)return;const e=t.target;if(e.closest(`[${this.ignoreAttribute}]`)){this.state.isNative=!0;return}const i=this.getHoverSelector(),n=e.closest(i);n&&(this.state.isHover=!0,this.state.hoverTarget=n,this.parseDOMInteraction(this.state.hoverTarget));const s=this.options.ignoreOnNative;if(s&&s!==null){const o=s==="auto"||s==="tag",h=s==="auto"||s==="css";let c=!1;if(o){const d=e.localName;(d==="input"||d==="textarea"||d==="select"||e.isContentEditable)&&(c=!0)}if(!c&&h){const d=window.getComputedStyle(e).cursor;["default","auto","pointer","none","inherit"].includes(d)||(c=!0)}c&&(this.state.isNative=!0)}}handleMouseOut(t){if(!this.isEnabled)return;const e=t.target;(e===this.state.hoverTarget||e.contains(this.state.hoverTarget))&&(!t.relatedTarget||!this.state.hoverTarget?.contains(t.relatedTarget))&&(this.state.isHover=!1,this.state.hoverTarget=null,this.state.interaction={}),this.state.isNative&&(this.state.isNative=!1)}handleWindowLeave(){this.options.hideOnLeave&&(this.state.hasReceivedInput=!1,this.state.pointer={...u})}clearHover(){this.state.isHover=!1,this.state.hoverTarget=null,this.state.isNative=!1,this.state.interaction={}}bindEvents(){const{signal:t}=this.abortController;window.addEventListener("pointermove",this.handleMove.bind(this),{passive:!0,signal:t}),window.addEventListener("pointerdown",this.handleDown.bind(this),{passive:!0,signal:t}),window.addEventListener("pointerup",this.handleUp.bind(this),{signal:t}),document.addEventListener("mouseover",this.handleMouseOver.bind(this),{signal:t}),document.addEventListener("mouseout",this.handleMouseOut.bind(this),{signal:t}),document.addEventListener("mouseleave",this.handleWindowLeave.bind(this),{signal:t})}destroy(){this.abortController.abort()}}let b=0;class g{constructor(t=document.body,e){if(this.container=t,this.hideNativeCursor=e,!t||!(t instanceof HTMLElement))throw new Error(`[Supermouse] Invalid container: ${t}. Must be an HTMLElement.`);const i=b++;this.id=`supermouse-style-${i}`,this.scopeClass=`supermouse-scope-${i}`;const n=t===document.body;if(this.element=document.createElement("div"),Object.assign(this.element.style,{position:n?"fixed":"absolute",inset:"0px",pointerEvents:"none",zIndex:"9999",opacity:"1",transition:"opacity 0.15s ease"}),!n){const s=window.getComputedStyle(t);this.originalContainerPosition=s.position,s.position==="static"&&(t.style.position="relative")}this.originalContainerCursor=t.style.cursor,t.appendChild(this.element),this.styleTag=document.createElement("style"),this.styleTag.id=this.id,document.head.appendChild(this.styleTag),this.container.classList.add(this.scopeClass),this.hideNativeCursor&&this.setNativeCursor("none")}container;hideNativeCursor;element;styleTag;id;scopeClass;currentCursorState=null;originalContainerPosition="";originalContainerCursor="";selectors=new Set(["a","button","input","textarea","select",'[role="button"]',"[tabindex]"]);addSelector(t){this.selectors.add(t),this.hideNativeCursor&&this.updateCursorCSS()}setVisibility(t){this.element.style.opacity=t?"1":"0"}setNativeCursor(t){!this.hideNativeCursor&&t==="none"||t!==this.currentCursorState&&(this.currentCursorState=t,t==="none"?(this.container.style.cursor="none",this.updateCursorCSS()):(this.container.style.cursor="",this.styleTag.innerText=""))}updateCursorCSS(){const t=Array.from(this.selectors);if(t.length===0){this.styleTag.innerText="";return}const e=t.map(i=>`.${this.scopeClass} ${i}`).join(", ");this.styleTag.innerText=`
       ${e} {
         cursor: none !important;
       }
-    `}destroy(){this.element.remove(),this.styleTag.remove(),this.container.style.cursor="",this.container.classList.remove(this.scopeClass)}}const c={x:-100,y:-100},v=["a","button","input","textarea","[data-hover]","[data-cursor]"];class y{static version="2.2.0";version="2.2.0";state;options;plugins=[];stage;input;rafId=0;lastTime=0;isRunning=!1;hoverSelectors;constructor(t={}){this.options={smoothness:.15,enableTouch:!1,autoDisableOnMobile:!0,ignoreOnNative:"auto",hideCursor:!0,hideOnLeave:!0,autoStart:!0,container:document.body,...t},this.options.container||(this.options.container=document.body),this.state={pointer:{x:-100,y:-100},target:{x:-100,y:-100},smooth:{x:-100,y:-100},velocity:{x:0,y:0},angle:0,isDown:!1,isHover:!1,isNative:!1,forcedCursor:null,hoverTarget:null,reducedMotion:!1,hasReceivedInput:!1,shape:null,interaction:{}},this.options.hoverSelectors?this.hoverSelectors=new Set(this.options.hoverSelectors):this.hoverSelectors=new Set(v),this.stage=new g(this.options.container,!!this.options.hideCursor),this.hoverSelectors.forEach(e=>this.stage.addSelector(e)),this.input=new f(this.state,this.options,()=>Array.from(this.hoverSelectors).join(", "),e=>{e||this.resetPosition()}),this.options.plugins&&this.options.plugins.forEach(e=>this.use(e)),this.init()}getPlugin(t){return this.plugins.find(e=>e.name===t)}get isEnabled(){return this.input.isEnabled}enablePlugin(t){const e=this.getPlugin(t);e&&e.isEnabled===!1&&(e.isEnabled=!0,e.onEnable?.(this))}disablePlugin(t){const e=this.getPlugin(t);e&&e.isEnabled!==!1&&(e.isEnabled=!1,e.onDisable?.(this))}togglePlugin(t){const e=this.getPlugin(t);e&&(e.isEnabled===!1?this.enablePlugin(t):this.disablePlugin(t))}registerHoverTarget(t){this.hoverSelectors.has(t)||(this.hoverSelectors.add(t),this.stage.addSelector(t))}get container(){return this.stage.element}setCursor(t){this.state.forcedCursor=t}init(){this.options.autoStart&&this.startLoop()}enable(){this.input.isEnabled=!0,this.stage.setNativeCursor("none")}disable(){this.input.isEnabled=!1,this.stage.setNativeCursor("auto"),this.resetPosition()}use(t){return this.plugins.find(e=>e.name===t.name)?(console.warn(`[Supermouse] Plugin "${t.name}" already installed.`),this):(t.isEnabled===void 0&&(t.isEnabled=!0),this.plugins.push(t),this.plugins.sort((e,i)=>(e.priority||0)-(i.priority||0)),t.install?.(this),this)}resetCoords(){this.state.pointer={...c},this.state.target={...c},this.state.smooth={...c},this.state.velocity={x:0,y:0},this.state.angle=0}resetPosition(){this.resetCoords(),this.state.hasReceivedInput=!1,this.state.shape=null,this.state.interaction={}}startLoop(){this.isRunning||(this.isRunning=!0,this.lastTime=performance.now(),this.tick(this.lastTime))}step(t){this.tick(t)}runPluginSafe(t,e){if(t.isEnabled!==!1)try{t.update?.(this,e)}catch(i){console.error(`[Supermouse] Plugin '${t.name}' crashed and has been disabled.`,i),t.isEnabled=!1;try{t.onDisable?.(this)}catch(o){console.error(`[Supermouse] Failed to execute onDisable for plugin '${t.name}'.`,o)}}}tick=t=>{const e=t-this.lastTime,i=Math.min(e/1e3,.1);this.lastTime=t,this.state.hoverTarget&&!this.state.hoverTarget.isConnected&&this.input.clearHover();const o=this.input.isEnabled&&!this.state.isNative&&this.state.hasReceivedInput;if(this.stage.setVisibility(o),this.input.isEnabled&&this.options.hideCursor){let s="auto";this.state.forcedCursor!==null?s=this.state.forcedCursor:s=this.state.isNative||!this.state.hasReceivedInput?"auto":"none",this.stage.setNativeCursor(s)}this.input.isEnabled?(this.state.target.x=this.state.pointer.x,this.state.target.y=this.state.pointer.y):this.resetCoords();for(let s=0;s<this.plugins.length;s++)this.runPluginSafe(this.plugins[s],e);if(this.input.isEnabled){const s=this.state.reducedMotion?1e3:1/this.options.smoothness*2;this.state.smooth.x=p(this.state.smooth.x,this.state.target.x,s,i),this.state.smooth.y=p(this.state.smooth.y,this.state.target.y,s,i);const h=this.state.target.x-this.state.smooth.x,r=this.state.target.y-this.state.smooth.y;this.state.velocity.x=h,this.state.velocity.y=r,(Math.abs(h)>.1||Math.abs(r)>.1)&&(this.state.angle=m(h,r))}this.options.autoStart&&this.isRunning&&(this.rafId=requestAnimationFrame(this.tick))};destroy(){this.isRunning=!1,cancelAnimationFrame(this.rafId),this.input.destroy(),this.stage.destroy(),this.plugins.forEach(t=>t.destroy?.(this)),this.plugins=[]}}n.DEFAULT_HOVER_SELECTORS=v,n.Input=f,n.Stage=g,n.Supermouse=y,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));
+    `}destroy(){this.element.remove(),this.styleTag.remove(),this.container.style.cursor=this.originalContainerCursor,this.container.classList.remove(this.scopeClass),this.container!==document.body&&this.originalContainerPosition==="static"&&(this.container.style.position="")}}const u={x:-100,y:-100},v=["a","button","input","textarea","[data-hover]","[data-cursor]"];class y{static version=l;version=l;state;options;plugins=[];stage;input;rafId=0;lastTime=0;isRunning=!1;hoverSelectors;constructor(t={}){this.options={smoothness:.15,enableTouch:!1,autoDisableOnMobile:!0,ignoreOnNative:"auto",hideCursor:!0,hideOnLeave:!0,autoStart:!0,container:document.body,dataPrefix:"supermouse",...t},this.state={pointer:{x:-100,y:-100},target:{x:-100,y:-100},smooth:{x:-100,y:-100},velocity:{x:0,y:0},angle:0,isDown:!1,isHover:!1,isNative:!1,forcedCursor:null,hoverTarget:null,reducedMotion:!1,hasReceivedInput:!1,shape:null,interaction:{}},this.options.hoverSelectors?this.hoverSelectors=new Set(this.options.hoverSelectors):this.hoverSelectors=new Set(v),this.stage=new g(this.options.container,!!this.options.hideCursor),this.hoverSelectors.forEach(e=>this.stage.addSelector(e)),this.input=new f(this.state,this.options,()=>Array.from(this.hoverSelectors).join(", "),e=>{e||this.reset(!0)}),this.options.plugins&&this.options.plugins.forEach(e=>this.use(e)),this.init()}getPlugin(t){return this.plugins.find(e=>e.name===t)}get isEnabled(){return this.input.isEnabled}enablePlugin(t){const e=this.getPlugin(t);e&&e.isEnabled===!1&&(e.isEnabled=!0,e.onEnable?.(this))}disablePlugin(t){const e=this.getPlugin(t);e&&e.isEnabled!==!1&&(e.isEnabled=!1,e.onDisable?.(this))}togglePlugin(t){const e=this.getPlugin(t);e&&(e.isEnabled===!1?this.enablePlugin(t):this.disablePlugin(t))}registerHoverTarget(t){this.hoverSelectors.has(t)||(this.hoverSelectors.add(t),this.stage.addSelector(t))}get container(){return this.stage.element}setNativeCursor(t){this.state.forcedCursor=t==="auto"?null:t==="hide"?"none":"auto"}init(){this.options.autoStart&&this.startLoop()}enable(){this.input.isEnabled=!0,this.stage.setNativeCursor("none")}disable(){this.input.isEnabled=!1,this.stage.setNativeCursor("auto"),this.reset(!0)}use(t){if(this.plugins.some(i=>i.name===t.name))return console.warn(`[Supermouse] Plugin "${t.name}" already installed.`),this;t.isEnabled===void 0&&(t.isEnabled=!0);try{t.install?.(this)}catch(i){return console.error(`[Supermouse] Failed to install plugin '${t.name}'.`,i),this}return this.plugins.push(t),this.plugins.sort((i,n)=>(i.priority||0)-(n.priority||0)),this}reset(t=!1){this.state.pointer={...u},this.state.target={...u},this.state.smooth={...u},this.state.velocity={x:0,y:0},this.state.angle=0,t&&(this.state.hasReceivedInput=!1,this.state.shape=null,this.state.interaction={})}startLoop(){this.isRunning||(this.isRunning=!0,this.lastTime=performance.now(),this.tick(this.lastTime))}start(){this.startLoop()}step(t){this.tick(t)}runPluginSafe(t,e){if(t.isEnabled!==!1)try{t.update?.(this,e)}catch(i){console.error(`[Supermouse] Plugin '${t.name}' crashed and has been disabled.`,i);const n=this.plugins.indexOf(t);n>-1&&this.plugins.splice(n,1),t.isEnabled=!1;try{t.destroy?.(this),t.onDisable?.(this)}catch(s){console.error(`[Supermouse] Failed to cleanup crashed plugin '${t.name}'.`,s)}}}tick=t=>{const e=t-this.lastTime,i=Math.min(e/1e3,.1);this.lastTime=t,this.state.hoverTarget&&!this.state.hoverTarget.isConnected&&this.input.clearHover();const n=this.input.isEnabled&&!this.state.isNative&&this.state.hasReceivedInput;if(this.stage.setVisibility(n),this.input.isEnabled&&this.options.hideCursor){let s="auto";this.state.forcedCursor!==null?s=this.state.forcedCursor:s=this.state.isNative||!this.state.hasReceivedInput?"auto":"none",this.stage.setNativeCursor(s)}this.input.isEnabled&&this.state.hasReceivedInput?(this.state.target.x=this.state.pointer.x,this.state.target.y=this.state.pointer.y):this.state.target={...u};for(let s=0;s<this.plugins.length;s++)this.runPluginSafe(this.plugins[s],e);if(this.input.isEnabled){const s=this.state.reducedMotion?1e3:1/this.options.smoothness*2;this.state.smooth.x=p(this.state.smooth.x,this.state.target.x,s,i),this.state.smooth.y=p(this.state.smooth.y,this.state.target.y,s,i),this.state.velocity.x=this.state.target.x-this.state.smooth.x,this.state.velocity.y=this.state.target.y-this.state.smooth.y;const{x:o,y:h}=this.state.velocity;(Math.abs(o)>.1||Math.abs(h)>.1)&&(this.state.angle=Math.atan2(h,o)*(180/Math.PI))}this.isRunning&&(this.rafId=requestAnimationFrame(this.tick))};destroy(){this.isRunning=!1,cancelAnimationFrame(this.rafId),this.input.destroy(),this.stage.destroy(),this.plugins.forEach(t=>t.destroy?.(this)),this.plugins=[]}}a.DEFAULT_HOVER_SELECTORS=v,a.Input=f,a.Stage=g,a.Supermouse=y,Object.defineProperty(a,Symbol.toStringTag,{value:"Module"})}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supermousejs/core",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "The core physics engine and state manager for Supermouse.",
   "main": "dist/index.umd.js",
   "module": "dist/index.mjs",