@supermousejs/core 2.0.0

package/dist/index.mjs

@@ -0,0 +1,453 @@
+let d = 0;
+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 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");
+  }
+  /** The container element appended to the document. Plugins must append here. */
+  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",
+    "input",
+    "textarea",
+    "select",
+    '[role="button"]',
+    "[tabindex]"
+  ]);
+  /**
+   * 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";
+  }
+  /**
+   * Toggles the visibility of the native cursor via CSS injection.
+   * @param type 'none' to hide, 'auto' to show.
+   */
+  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 = `
+      ${e} {
+        cursor: none !important;
+      }
+    `;
+  }
+  destroy() {
+    this.element.remove(), this.styleTag.remove(), this.container.style.cursor = "", this.container.classList.remove(this.scopeClass);
+  }
+}
+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();
+  }
+  mediaQueryList;
+  mediaQueryHandler;
+  motionQuery;
+  /**
+   * 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).
+   * Relies on `matchMedia('(pointer: fine)')`.
+   */
+  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));
+  }
+  /**
+   * Checks for `prefers-reduced-motion`.
+   * 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.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)
+      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;
+  }
+  // --- Handlers ---
+  // Unified Pointer Event Handler
+  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 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 f(o, t) {
+  return Math.atan2(t, o) * (180 / Math.PI);
+}
+const g = [
+  "a",
+  "button",
+  "input",
+  "textarea",
+  "[data-hover]",
+  "[data-cursor]"
+];
+class y {
+  /** The current version of Supermouse.js */
+  static version = "2.0.0";
+  version = "2.0.0";
+  /**
+   * 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.
+   */
+  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;
+  isRunning = !1;
+  hoverSelectors;
+  /**
+   * Creates a new Supermouse instance.
+   * 
+   * @param options - Global configuration options.
+   * @throws Will throw if running in a non-browser environment (window/document undefined).
+   */
+  constructor(t = {}) {
+    this.options = {
+      smoothness: 0.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(g), this.stage = new c(this.options.container, !!this.options.hideCursor), this.hoverSelectors.forEach((e) => this.stage.addSelector(e)), this.input = new p(
+      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();
+  }
+  /**
+   * Retrieves a registered plugin instance by its unique name.
+   */
+  getPlugin(t) {
+    return this.plugins.find((e) => e.name === t);
+  }
+  /**
+   * Returns whether the cursor system is currently enabled (processing input).
+   */
+  get isEnabled() {
+    return this.input.isEnabled;
+  }
+  /**
+   * Enables a specific plugin by name.
+   * Triggers the `onEnable` lifecycle hook of the plugin.
+   */
+  enablePlugin(t) {
+    const e = this.getPlugin(t);
+    e && e.isEnabled === !1 && (e.isEnabled = !0, e.onEnable?.(this));
+  }
+  /**
+   * Disables a specific plugin by name.
+   * Triggers the `onDisable` lifecycle hook.
+   */
+  disablePlugin(t) {
+    const e = this.getPlugin(t);
+    e && e.isEnabled !== !1 && (e.isEnabled = !1, e.onDisable?.(this));
+  }
+  /**
+   * Toggles the enabled state of a plugin.
+   */
+  togglePlugin(t) {
+    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() {
+    return this.stage.element;
+  }
+  /**
+   * 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) {
+    this.state.forcedCursor = t;
+  }
+  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);
+  }
+  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));
+  }
+  /**
+   * 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) {
+    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);
+      }
+  }
+  /**
+   * 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 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 = 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));
+    } 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));
+  };
+  /** 
+   * 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 = [];
+  }
+}
+export {
+  g as DEFAULT_HOVER_SELECTORS,
+  y as Supermouse
+};

package/dist/index.umd.js

@@ -0,0 +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=`
+      ${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.0";version="2.0.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,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"})}));

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@supermousejs/core",
+  "version": "2.0.0",
+  "main": "dist/index.umd.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "dependencies": {},
+  "devDependencies": {},
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.umd.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest"
+  }
+}