@supermousejs/core 2.0.4 → 2.1.0

package/dist/index.mjs

@@ -3,8 +3,8 @@ class c {
   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 s = d++;
-    this.id = `supermouse-style-${s}`, this.scopeClass = `supermouse-scope-${s}`;
+    const i = d++;
+    this.id = `supermouse-style-${i}`, this.scopeClass = `supermouse-scope-${i}`;
     const n = t === document.body;
     this.element = document.createElement("div"), Object.assign(this.element.style, {
       position: n ? "fixed" : "absolute",
@@ -18,15 +18,14 @@ class c {
       transition: "opacity 0.15s ease"
     }), n || 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");
   }
-  /** The container element appended to the document. Plugins must append here. */
+  container;
+  hideNativeCursor;
+  /** The container element appended to the document. */
   element;
   styleTag;
   id;
   scopeClass;
-  // Cache to prevent redundant DOM updates
   currentCursorState = null;
-  // Defaults for CSS hiding. We must override user-agent styles on these elements
-  // to prevent the native cursor from popping through.
   selectors = /* @__PURE__ */ new Set([
     "a",
     "button",
@@ -37,16 +36,13 @@ class c {
     "[tabindex]"
   ]);
   /**
-   * Adds a new CSS selector to the "Hide Native Cursor" list.
-   * Called by `Supermouse` (and subsequently plugins) during install to ensure 
+   * Adds a new CSS selector to the Hide Native Cursor list.
+   * Called by `Supermouse` (and subsequently plugins) during install to ensure
    * the native cursor is hidden on their specific interactive targets.
    */
   addSelector(t) {
     this.selectors.add(t), this.hideNativeCursor && this.updateCursorCSS();
   }
-  /**
-   * Controls the opacity of the entire stage (all custom cursor elements).
-   */
   setVisibility(t) {
     this.element.style.opacity = t ? "1" : "0";
   }
@@ -63,7 +59,7 @@ class c {
       this.styleTag.innerText = "";
       return;
     }
-    const e = t.map((s) => `.${this.scopeClass} ${s}`).join(", ");
+    const e = t.map((i) => `.${this.scopeClass} ${i}`).join(", ");
     this.styleTag.innerText = `
       ${e} {
         cursor: none !important;
@@ -75,24 +71,23 @@ class c {
   }
 }
 class p {
-  constructor(t, e, s, n) {
-    this.state = t, this.options = e, this.getHoverSelector = s, this.onEnableChange = n, this.checkDeviceCapability(), this.checkMotionPreference(), this.bindEvents();
+  constructor(t, e, i, n) {
+    this.state = t, this.options = e, this.getHoverSelector = i, this.onEnableChange = n, this.checkDeviceCapability(), this.checkMotionPreference(), this.bindEvents();
   }
+  state;
+  options;
+  getHoverSelector;
+  onEnableChange;
   mediaQueryList;
   mediaQueryHandler;
   motionQuery;
   /**
-   * Master switch for input processing. 
+   * Master switch for input processing.
    * Toggled by `Supermouse.enable()`/`disable()` or automatically by device capability checks.
    */
   isEnabled = !0;
   /**
-   * Performance Optimization:
-   * We cache the resolved InteractionState for every element we encounter in a WeakMap.
-   */
-  interactionCache = /* @__PURE__ */ new WeakMap();
-  /**
-   * Automatically disables the custom cursor on devices without fine pointer control (e.g. phones/tablets).
+   * Automatically disables the custom cursor on devices without fine pointer control.
    * Relies on `matchMedia('(pointer: fine)')`.
    */
   checkDeviceCapability() {
@@ -105,108 +100,95 @@ class p {
    * If true, the core physics engine will switch to instant snapping (high damping) to avoid motion sickness.
    */
   checkMotionPreference() {
-    this.motionQuery = window.matchMedia("(prefer-reduced-motion: reduce)"), this.state.reducedMotion = this.motionQuery.matches, this.motionQuery.addEventListener("change", (t) => {
+    this.motionQuery = window.matchMedia("(prefers-reduced-motion: reduce)"), this.state.reducedMotion = this.motionQuery.matches, this.motionQuery.addEventListener("change", (t) => {
       this.state.reducedMotion = t.matches;
     });
   }
   updateEnabledState(t) {
     this.isEnabled = t, this.onEnableChange(t);
   }
-  // --- Interaction Parsing ---
-  /**
-   * Scrapes the DOM element for metadata to populate `state.interaction`.
-   * 
-   * **Strategy:**
-   * 1. Check WeakMap cache.
-   * 2. Apply config-based `rules`.
-   * 3. Scrape `dataset` (supermouse*).
-   * 4. Cache result.
-   */
   parseDOMInteraction(t) {
     if (this.options.resolveInteraction) {
       this.state.interaction = this.options.resolveInteraction(t);
       return;
     }
-    if (this.interactionCache.has(t)) {
-      this.state.interaction = this.interactionCache.get(t);
-      return;
-    }
     const e = {};
     if (this.options.rules)
-      for (const [n, i] of Object.entries(this.options.rules))
-        t.matches(n) && Object.assign(e, i);
-    const s = t.dataset;
-    for (const n in s)
+      for (const [n, s] of Object.entries(this.options.rules))
+        t.matches(n) && Object.assign(e, s);
+    const i = t.dataset;
+    for (const n in i)
       if (n.startsWith("supermouse")) {
-        const i = n.slice(10);
-        if (i) {
-          const l = i.charAt(0).toLowerCase() + i.slice(1), r = s[n];
-          e[l] = r === "" ? !0 : r;
+        const s = n.slice(10);
+        if (s) {
+          const r = s.charAt(0).toLowerCase() + s.slice(1), a = i[n];
+          a !== void 0 && (e[r] = a === "" ? !0 : a);
         }
       }
-    this.interactionCache.set(t, e), this.state.interaction = e;
+    this.state.interaction = e;
   }
-  // --- Handlers ---
-  // Unified Pointer Event Handler
-  handleMove = (t) => {
+  handleMove(t) {
     if (!this.isEnabled || this.options.autoDisableOnMobile && t.pointerType === "touch") return;
-    let e = t.clientX, s = t.clientY;
+    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, s -= n.top;
+      e -= n.left, i -= n.top;
     }
-    this.state.pointer.x = e, this.state.pointer.y = s, this.state.hasReceivedInput || (this.state.hasReceivedInput = !0, this.state.target.x = this.state.smooth.x = e, this.state.target.y = this.state.smooth.y = s);
-  };
-  handleDown = () => {
+    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 = () => {
+  }
+  handleUp() {
     this.isEnabled && (this.state.isDown = !1);
-  };
-  handleMouseOver = (t) => {
+  }
+  handleMouseOver(t) {
     if (!this.isEnabled) return;
     const e = t.target;
     if (e.closest("[data-supermouse-ignore]")) {
       this.state.isNative = !0;
       return;
     }
-    const s = this.getHoverSelector(), n = e.closest(s);
+    const i = this.getHoverSelector(), n = e.closest(i);
     n && (this.state.isHover = !0, this.state.hoverTarget = n, this.parseDOMInteraction(this.state.hoverTarget));
-    const i = this.options.ignoreOnNative;
-    if (i) {
-      const l = i === !0 || i === "auto" || i === "tag", r = i === !0 || i === "auto" || i === "css";
+    const s = this.options.ignoreOnNative;
+    if (s) {
+      const r = s === !0 || s === "auto" || s === "tag", a = s === !0 || s === "auto" || s === "css";
       let h = !1;
-      if (l) {
-        const a = e.localName;
-        (a === "input" || a === "textarea" || a === "select" || e.isContentEditable) && (h = !0);
+      if (r) {
+        const l = e.localName;
+        (l === "input" || l === "textarea" || l === "select" || e.isContentEditable) && (h = !0);
       }
-      if (!h && r) {
-        const a = window.getComputedStyle(e).cursor;
-        ["default", "auto", "pointer", "none", "inherit"].includes(a) || (h = !0);
+      if (!h && a) {
+        const l = window.getComputedStyle(e).cursor;
+        ["default", "auto", "pointer", "none", "inherit"].includes(l) || (h = !0);
       }
       h && (this.state.isNative = !0);
     }
-  };
-  handleMouseOut = (t) => {
+  }
+  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 = () => {
+  }
+  handleWindowLeave() {
     this.options.hideOnLeave && (this.state.hasReceivedInput = !1);
-  };
+  }
+  clearHover() {
+    this.state.isHover = !1, this.state.hoverTarget = null, this.state.isNative = !1;
+  }
   bindEvents() {
-    window.addEventListener("pointermove", this.handleMove, { passive: !0 }), window.addEventListener("pointerdown", this.handleDown, { passive: !0 }), window.addEventListener("pointerup", this.handleUp), document.addEventListener("mouseover", this.handleMouseOver), document.addEventListener("mouseout", this.handleMouseOut), document.addEventListener("mouseleave", this.handleWindowLeave);
+    window.addEventListener("pointermove", this.handleMove.bind(this), { passive: !0 }), window.addEventListener("pointerdown", this.handleDown.bind(this), { passive: !0 }), window.addEventListener("pointerup", this.handleUp.bind(this)), document.addEventListener("mouseover", this.handleMouseOver.bind(this)), document.addEventListener("mouseout", this.handleMouseOut.bind(this)), document.addEventListener("mouseleave", this.handleWindowLeave.bind(this));
   }
   destroy() {
-    this.mediaQueryList && this.mediaQueryHandler && this.mediaQueryList.removeEventListener("change", this.mediaQueryHandler), window.removeEventListener("pointermove", this.handleMove), window.removeEventListener("pointerdown", this.handleDown), window.removeEventListener("pointerup", this.handleUp), document.removeEventListener("mouseover", this.handleMouseOver), document.removeEventListener("mouseout", this.handleMouseOut), document.removeEventListener("mouseleave", this.handleWindowLeave);
+    this.mediaQueryList && this.mediaQueryHandler && this.mediaQueryList.removeEventListener("change", this.mediaQueryHandler), this.motionQuery && (this.motionQuery.onchange = null), window.removeEventListener("pointermove", this.handleMove), window.removeEventListener("pointerdown", this.handleDown), window.removeEventListener("pointerup", this.handleUp), document.removeEventListener("mouseover", this.handleMouseOver), document.removeEventListener("mouseout", this.handleMouseOut), document.removeEventListener("mouseleave", this.handleWindowLeave);
   }
 }
 function v(o, t, e) {
   return o + (t - o) * e;
 }
-function u(o, t, e, s) {
-  return v(o, t, 1 - Math.exp(-e * s));
+function u(o, t, e, i) {
+  return v(o, t, 1 - Math.exp(-e * i));
 }
 function f(o, t) {
   return Math.atan2(t, o) * (180 / Math.PI);
@@ -220,34 +202,15 @@ const g = [
   "[data-cursor]"
 ];
 class y {
-  /** The current version of Supermouse.js */
-  static version = "2.0.4";
-  version = "2.0.4";
-  /**
-   * The Single Source of Truth.
-   * 
-   * This object is shared by reference. `Input` writes to it; `Supermouse` physics reads/writes to it;
-   * Plugins read/write to it.
-   */
+  static version = "2.1.0";
+  version = "2.1.0";
   state;
   /**
    * Configuration options.
    */
   options;
-  /**
-   * Registry of active plugins.
-   * @internal Use `use()`, `enablePlugin()`, or `disablePlugin()` to interact with this.
-   */
   plugins = [];
-  /**
-   * The Stage System responsible for the DOM container and CSS injection.
-   * @internal
-   */
   stage;
-  /**
-   * The Input System responsible for event listeners.
-   * @internal
-   */
   input;
   rafId = 0;
   lastTime = 0;
@@ -255,7 +218,7 @@ class y {
   hoverSelectors;
   /**
    * Creates a new Supermouse instance.
-   * 
+   *
    * @param options - Global configuration options.
    * @throws Will throw if running in a non-browser environment (window/document undefined).
    */
@@ -329,20 +292,10 @@ class y {
     const e = this.getPlugin(t);
     e && (e.isEnabled === !1 ? this.enablePlugin(t) : this.disablePlugin(t));
   }
-  /**
-   * Registers a CSS selector as an "Interactive Target".
-   * 
-   * When the mouse hovers over an element matching this selector:
-   * 1. `state.isHover` becomes `true`.
-   * 2. `state.hoverTarget` is set to the element.
-   * 3. The `Stage` system injects CSS to hide the native cursor for this element (if `hideCursor: true`).
-   * 
-   * @param selector - A valid CSS selector string (e.g., `.my-button`, `[data-trigger]`).
-   */
   registerHoverTarget(t) {
     this.hoverSelectors.has(t) || (this.hoverSelectors.add(t), this.stage.addSelector(t));
   }
-  /** 
+  /**
    * The fixed container element where plugins should append their DOM nodes.
    */
   get container() {
@@ -350,8 +303,7 @@ class y {
   }
   /**
    * Manually override the native cursor visibility.
-   * Useful for drag-and-drop operations, modals, or special UI states.
-   * 
+   *
    * @param type 'auto' (Show Native), 'none' (Hide Native), or null (Resume Auto-detection)
    */
   setCursor(t) {
@@ -360,32 +312,19 @@ class y {
   init() {
     this.options.autoStart && this.startLoop();
   }
-  /** 
-   * Starts the update loop and enables input listeners.
-   * Hides the native cursor if configured.
-   */
   enable() {
     this.input.isEnabled = !0, this.stage.setNativeCursor("none");
   }
-  /** 
-   * Stops the update loop, disables listeners, and restores the native cursor. 
-   * Resets internal state positions to off-screen.
-   */
   disable() {
     this.input.isEnabled = !1, this.stage.setNativeCursor("auto"), this.resetPosition();
   }
   /**
    * Registers a new plugin.
-   * 
-   * @remarks
-   * Plugins are sorted by `priority` immediately after registration.
-   * - **Negative Priority (< 0)**: Logic plugins (run before physics).
-   * - **Positive Priority (>= 0)**: Visual plugins (run after physics).
-   * 
+   *
    * @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, s) => (e.priority || 0) - (s.priority || 0)), t.install?.(this), this);
+    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);
   }
   resetPosition() {
     const t = { x: -100, y: -100 };
@@ -396,9 +335,7 @@ class y {
   }
   /**
    * Manually steps the animation loop.
-   * Useful when integrating with external game loops (e.g., Three.js, PixiJS) where
-   * you want to disable the internal RAF and drive `Supermouse` from your own ticker.
-   * 
+   *
    * @param time Current timestamp in milliseconds.
    */
   step(t) {
@@ -408,40 +345,42 @@ class y {
     if (t.isEnabled !== !1)
       try {
         t.update?.(this, e);
-      } catch (s) {
-        console.error(`[Supermouse] Plugin '${t.name}' crashed and has been disabled.`, s), t.isEnabled = !1, t.onDisable?.(this);
+      } catch (i) {
+        console.error(`[Supermouse] Plugin '${t.name}' crashed and has been disabled.`, i), t.isEnabled = !1;
+        try {
+          t.onDisable?.(this);
+        } catch {
+        }
       }
   }
   /**
-   * The Heartbeat.
    * Runs on every animation frame.
    */
   tick = (t) => {
-    const e = t - this.lastTime, s = Math.min(e / 1e3, 0.1);
-    this.lastTime = 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 n = this.input.isEnabled && !this.state.isNative && this.state.hasReceivedInput;
     if (this.stage.setVisibility(n), this.input.isEnabled && this.options.hideCursor) {
-      let i = "auto";
-      this.state.forcedCursor !== null ? i = this.state.forcedCursor : i = this.state.isNative || !this.state.hasReceivedInput ? "auto" : "none", this.stage.setNativeCursor(i);
+      let s = "auto";
+      this.state.forcedCursor !== null ? s = this.state.forcedCursor : s = this.state.isNative || !this.state.hasReceivedInput ? "auto" : "none", this.stage.setNativeCursor(s);
     }
     if (this.input.isEnabled) {
       this.state.target.x = this.state.pointer.x, this.state.target.y = this.state.pointer.y;
-      for (let a = 0; a < this.plugins.length; a++)
-        this.runPluginSafe(this.plugins[a], e);
-      const i = this.options.smoothness, l = this.state.reducedMotion ? 1e3 : 1 / i * 2;
-      this.state.smooth.x = u(this.state.smooth.x, this.state.target.x, l, s), this.state.smooth.y = u(this.state.smooth.y, this.state.target.y, l, s);
-      const r = this.state.target.x - this.state.smooth.x, h = this.state.target.y - this.state.smooth.y;
-      this.state.velocity.x = r, this.state.velocity.y = h, (Math.abs(r) > 0.1 || Math.abs(h) > 0.1) && (this.state.angle = f(r, h));
+      for (let h = 0; h < this.plugins.length; h++)
+        this.runPluginSafe(this.plugins[h], e);
+      const s = this.state.reducedMotion ? 1e3 : 1 / this.options.smoothness * 2;
+      this.state.smooth.x = u(this.state.smooth.x, this.state.target.x, s, i), this.state.smooth.y = u(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 = f(r, a));
     } else {
       this.state.smooth.x = -100, this.state.smooth.y = -100, this.state.pointer.x = -100, this.state.pointer.y = -100, this.state.velocity.x = 0, this.state.velocity.y = 0;
-      for (let i = 0; i < this.plugins.length; i++)
-        this.runPluginSafe(this.plugins[i], e);
+      for (let s = 0; s < this.plugins.length; s++)
+        this.runPluginSafe(this.plugins[s], e);
     }
     this.options.autoStart && this.isRunning && (this.rafId = requestAnimationFrame(this.tick));
   };
-  /** 
+  /**
    * Destroys the instance.
-   * Stops the loop, removes all DOM elements, removes all event listeners, and calls destroy on all plugins.
    */
   destroy() {
     this.isRunning = !1, cancelAnimationFrame(this.rafId), this.input.destroy(), this.stage.destroy(), this.plugins.forEach((t) => t.destroy?.(this)), this.plugins = [];

package/dist/index.umd.js

@@ -1,5 +1,5 @@
-(function(u,d){typeof exports=="object"&&typeof module<"u"?d(exports):typeof define=="function"&&define.amd?define(["exports"],d):(u=typeof globalThis<"u"?globalThis:u||self,d(u.SupermouseCore={}))})(this,(function(u){"use strict";let d=0;class f{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 s=d++;this.id=`supermouse-style-${s}`,this.scopeClass=`supermouse-scope-${s}`;const n=t===document.body;this.element=document.createElement("div"),Object.assign(this.element.style,{position:n?"fixed":"absolute",top:"0",left:"0",width:"100%",height:"100%",pointerEvents:"none",zIndex:"9999",opacity:"1",transition:"opacity 0.15s ease"}),n||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")}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(s=>`.${this.scopeClass} ${s}`).join(", ");this.styleTag.innerText=`
+(function(l,u){typeof exports=="object"&&typeof module<"u"?u(exports):typeof define=="function"&&define.amd?define(["exports"],u):(l=typeof globalThis<"u"?globalThis:l||self,u(l.SupermouseCore={}))})(this,(function(l){"use strict";let u=0;class f{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=u++;this.id=`supermouse-style-${i}`,this.scopeClass=`supermouse-scope-${i}`;const n=t===document.body;this.element=document.createElement("div"),Object.assign(this.element.style,{position:n?"fixed":"absolute",top:"0",left:"0",width:"100%",height:"100%",pointerEvents:"none",zIndex:"9999",opacity:"1",transition:"opacity 0.15s ease"}),n||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=`
       ${e} {
         cursor: none !important;
       }
-    `}destroy(){this.element.remove(),this.styleTag.remove(),this.container.style.cursor="",this.container.classList.remove(this.scopeClass)}}class v{constructor(t,e,s,n){this.state=t,this.options=e,this.getHoverSelector=s,this.onEnableChange=n,this.checkDeviceCapability(),this.checkMotionPreference(),this.bindEvents()}mediaQueryList;mediaQueryHandler;motionQuery;isEnabled=!0;interactionCache=new WeakMap;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))}checkMotionPreference(){this.motionQuery=window.matchMedia("(prefer-reduced-motion: reduce)"),this.state.reducedMotion=this.motionQuery.matches,this.motionQuery.addEventListener("change",t=>{this.state.reducedMotion=t.matches})}updateEnabledState(t){this.isEnabled=t,this.onEnableChange(t)}parseDOMInteraction(t){if(this.options.resolveInteraction){this.state.interaction=this.options.resolveInteraction(t);return}if(this.interactionCache.has(t)){this.state.interaction=this.interactionCache.get(t);return}const e={};if(this.options.rules)for(const[n,i]of Object.entries(this.options.rules))t.matches(n)&&Object.assign(e,i);const s=t.dataset;for(const n in s)if(n.startsWith("supermouse")){const i=n.slice(10);if(i){const l=i.charAt(0).toLowerCase()+i.slice(1),r=s[n];e[l]=r===""?!0:r}}this.interactionCache.set(t,e),this.state.interaction=e}handleMove=t=>{if(!this.isEnabled||this.options.autoDisableOnMobile&&t.pointerType==="touch")return;let e=t.clientX,s=t.clientY;if(this.options.container&&this.options.container!==document.body){const n=this.options.container.getBoundingClientRect();e-=n.left,s-=n.top}this.state.pointer.x=e,this.state.pointer.y=s,this.state.hasReceivedInput||(this.state.hasReceivedInput=!0,this.state.target.x=this.state.smooth.x=e,this.state.target.y=this.state.smooth.y=s)};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 s=this.getHoverSelector(),n=e.closest(s);n&&(this.state.isHover=!0,this.state.hoverTarget=n,this.parseDOMInteraction(this.state.hoverTarget));const i=this.options.ignoreOnNative;if(i){const l=i===!0||i==="auto"||i==="tag",r=i===!0||i==="auto"||i==="css";let h=!1;if(l){const a=e.localName;(a==="input"||a==="textarea"||a==="select"||e.isContentEditable)&&(h=!0)}if(!h&&r){const a=window.getComputedStyle(e).cursor;["default","auto","pointer","none","inherit"].includes(a)||(h=!0)}h&&(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)};bindEvents(){window.addEventListener("pointermove",this.handleMove,{passive:!0}),window.addEventListener("pointerdown",this.handleDown,{passive:!0}),window.addEventListener("pointerup",this.handleUp),document.addEventListener("mouseover",this.handleMouseOver),document.addEventListener("mouseout",this.handleMouseOut),document.addEventListener("mouseleave",this.handleWindowLeave)}destroy(){this.mediaQueryList&&this.mediaQueryHandler&&this.mediaQueryList.removeEventListener("change",this.mediaQueryHandler),window.removeEventListener("pointermove",this.handleMove),window.removeEventListener("pointerdown",this.handleDown),window.removeEventListener("pointerup",this.handleUp),document.removeEventListener("mouseover",this.handleMouseOver),document.removeEventListener("mouseout",this.handleMouseOut),document.removeEventListener("mouseleave",this.handleWindowLeave)}}function m(o,t,e){return o+(t-o)*e}function c(o,t,e,s){return m(o,t,1-Math.exp(-e*s))}function g(o,t){return Math.atan2(t,o)*(180/Math.PI)}const p=["a","button","input","textarea","[data-hover]","[data-cursor]"];class y{static version="2.0.4";version="2.0.4";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(p),this.stage=new f(this.options.container,!!this.options.hideCursor),this.hoverSelectors.forEach(e=>this.stage.addSelector(e)),this.input=new v(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,s)=>(e.priority||0)-(s.priority||0)),t.install?.(this),this)}resetPosition(){const t={x:-100,y:-100};this.state.pointer={...t},this.state.target={...t},this.state.smooth={...t},this.state.velocity={x:0,y:0},this.state.angle=0,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(s){console.error(`[Supermouse] Plugin '${t.name}' crashed and has been disabled.`,s),t.isEnabled=!1,t.onDisable?.(this)}}tick=t=>{const e=t-this.lastTime,s=Math.min(e/1e3,.1);this.lastTime=t;const n=this.input.isEnabled&&!this.state.isNative&&this.state.hasReceivedInput;if(this.stage.setVisibility(n),this.input.isEnabled&&this.options.hideCursor){let i="auto";this.state.forcedCursor!==null?i=this.state.forcedCursor:i=this.state.isNative||!this.state.hasReceivedInput?"auto":"none",this.stage.setNativeCursor(i)}if(this.input.isEnabled){this.state.target.x=this.state.pointer.x,this.state.target.y=this.state.pointer.y;for(let a=0;a<this.plugins.length;a++)this.runPluginSafe(this.plugins[a],e);const i=this.options.smoothness,l=this.state.reducedMotion?1e3:1/i*2;this.state.smooth.x=c(this.state.smooth.x,this.state.target.x,l,s),this.state.smooth.y=c(this.state.smooth.y,this.state.target.y,l,s);const r=this.state.target.x-this.state.smooth.x,h=this.state.target.y-this.state.smooth.y;this.state.velocity.x=r,this.state.velocity.y=h,(Math.abs(r)>.1||Math.abs(h)>.1)&&(this.state.angle=g(r,h))}else{this.state.smooth.x=-100,this.state.smooth.y=-100,this.state.pointer.x=-100,this.state.pointer.y=-100,this.state.velocity.x=0,this.state.velocity.y=0;for(let i=0;i<this.plugins.length;i++)this.runPluginSafe(this.plugins[i],e)}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=[]}}u.DEFAULT_HOVER_SELECTORS=p,u.Supermouse=y,Object.defineProperty(u,Symbol.toStringTag,{value:"Module"})}));
+    `}destroy(){this.element.remove(),this.styleTag.remove(),this.container.style.cursor="",this.container.classList.remove(this.scopeClass)}}class v{constructor(t,e,i,n){this.state=t,this.options=e,this.getHoverSelector=i,this.onEnableChange=n,this.checkDeviceCapability(),this.checkMotionPreference(),this.bindEvents()}state;options;getHoverSelector;onEnableChange;mediaQueryList;mediaQueryHandler;motionQuery;isEnabled=!0;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))}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})}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[n,s]of Object.entries(this.options.rules))t.matches(n)&&Object.assign(e,s);const i=t.dataset;for(const n in i)if(n.startsWith("supermouse")){const s=n.slice(10);if(s){const r=s.charAt(0).toLowerCase()+s.slice(1),a=i[n];a!==void 0&&(e[r]=a===""?!0:a)}}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 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("[data-supermouse-ignore]")){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){const r=s===!0||s==="auto"||s==="tag",a=s===!0||s==="auto"||s==="css";let h=!1;if(r){const d=e.localName;(d==="input"||d==="textarea"||d==="select"||e.isContentEditable)&&(h=!0)}if(!h&&a){const d=window.getComputedStyle(e).cursor;["default","auto","pointer","none","inherit"].includes(d)||(h=!0)}h&&(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(){window.addEventListener("pointermove",this.handleMove.bind(this),{passive:!0}),window.addEventListener("pointerdown",this.handleDown.bind(this),{passive:!0}),window.addEventListener("pointerup",this.handleUp.bind(this)),document.addEventListener("mouseover",this.handleMouseOver.bind(this)),document.addEventListener("mouseout",this.handleMouseOut.bind(this)),document.addEventListener("mouseleave",this.handleWindowLeave.bind(this))}destroy(){this.mediaQueryList&&this.mediaQueryHandler&&this.mediaQueryList.removeEventListener("change",this.mediaQueryHandler),this.motionQuery&&(this.motionQuery.onchange=null),window.removeEventListener("pointermove",this.handleMove),window.removeEventListener("pointerdown",this.handleDown),window.removeEventListener("pointerup",this.handleUp),document.removeEventListener("mouseover",this.handleMouseOver),document.removeEventListener("mouseout",this.handleMouseOut),document.removeEventListener("mouseleave",this.handleWindowLeave)}}function m(o,t,e){return o+(t-o)*e}function c(o,t,e,i){return m(o,t,1-Math.exp(-e*i))}function g(o,t){return Math.atan2(t,o)*(180/Math.PI)}const p=["a","button","input","textarea","[data-hover]","[data-cursor]"];class y{static version="2.1.0";version="2.1.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(p),this.stage=new f(this.options.container,!!this.options.hideCursor),this.hoverSelectors.forEach(e=>this.stage.addSelector(e)),this.input=new v(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)}resetPosition(){const t={x:-100,y:-100};this.state.pointer={...t},this.state.target={...t},this.state.smooth={...t},this.state.velocity={x:0,y:0},this.state.angle=0,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{}}}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)}if(this.input.isEnabled){this.state.target.x=this.state.pointer.x,this.state.target.y=this.state.pointer.y;for(let h=0;h<this.plugins.length;h++)this.runPluginSafe(this.plugins[h],e);const s=this.state.reducedMotion?1e3:1/this.options.smoothness*2;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);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)>.1||Math.abs(a)>.1)&&(this.state.angle=g(r,a))}else{this.state.smooth.x=-100,this.state.smooth.y=-100,this.state.pointer.x=-100,this.state.pointer.y=-100,this.state.velocity.x=0,this.state.velocity.y=0;for(let s=0;s<this.plugins.length;s++)this.runPluginSafe(this.plugins[s],e)}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=[]}}l.DEFAULT_HOVER_SELECTORS=p,l.Supermouse=y,Object.defineProperty(l,Symbol.toStringTag,{value:"Module"})}));

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@supermousejs/core",
-  "version": "2.0.4",
+  "version": "2.1.0",
+  "description": "The core physics engine and state manager for Supermouse.",
   "main": "dist/index.umd.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -20,6 +21,15 @@
     "javascript",
     "web"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Whitestar14/supermouse-js.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/Whitestar14/supermouse-js/issues"
+  },
+  "homepage": "https://github.com/Whitestar14/supermouse-js/tree/main/packages/core#readme",
   "dependencies": {},
   "devDependencies": {},
   "exports": {