supermousejs 2.1.0

package/CHANGELOG.md

@@ -0,0 +1,42 @@
+# supermousejs
+
+## 2.1.0
+
+### Minor Changes
+
+- 0a1652d: fixed build architecture and updated plugin metadata
+
+### Patch Changes
+
+- Updated dependencies [0a1652d]
+  - @supermousejs/ring@2.1.0
+  - @supermousejs/dot@2.1.0
+
+## 2.0.2
+
+### Patch Changes
+
+- Fixed export options causing build failure
+
+## 2.0.1
+
+### Patch Changes
+
+- 993dc67: Updated supemousejs packages with proper author, license and url descriptors to repo
+- Updated dependencies [993dc67]
+  - @supermousejs/core@2.0.4
+  - @supermousejs/ring@2.0.4
+  - @supermousejs/dot@2.0.4
+
+## 2.0.0
+
+### Major Changes
+
+- Initialized Supermousejs canon package
+
+### Patch Changes
+
+- Updated dependencies
+  - @supermousejs/core@2.0.3
+  - @supermousejs/dot@2.0.3
+  - @supermousejs/ring@2.0.3

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sijibomi Olusunmbola
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# supermousejs
+
+The official all-in-one bundle for **Supermouse v2**.
+
+This package provides a convenient, unscoped entry point for the Supermouse ecosystem. It bundles `@supermousejs/core` with the standard `Dot` and `Ring` plugins.
+
+## Installation
+
+```bash
+pnpm add supermousejs
+```
+or
+```bash
+npm install supermousejs
+```
+
+## Usage
+
+```ts
+import Supermouse, { Dot, Ring } from 'supermousejs';
+
+const mouse = new Supermouse({
+  smoothness: 0.15
+});
+
+mouse.use(Dot({ size: 8 }));
+mouse.use(Ring({ size: 24 }));
+```
+
+## Why use this over scoped packages?
+
+If you prefer clean import paths or are using a CDN (like unpkg) and want a single file that "just works" with the standard cursor look, this is the package for you.
+
+For advanced users or those looking to minimize bundle size, we recommend using the modular packages:
+`@supermousejs/core`, `@supermousejs/dot`, etc.
+
+## Documentation
+
+Full documentation and interactive playground available at [supermouse](https://supermouse.vercel.app) or [check out the repo](https://github.com/Whitestar14/supermouse-js).

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { Dot } from '@supermousejs/dot';
+import { Ring } from '@supermousejs/ring';
+
+export { Dot }
+
+export { Ring }
+
+
+export * from "@supermousejs/core";
+
+export { }

package/dist/index.mjs

@@ -0,0 +1,627 @@
+let C = 0;
+class x {
+  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 o = C++;
+    this.id = `supermouse-style-${o}`, this.scopeClass = `supermouse-scope-${o}`;
+    const i = t === document.body;
+    this.element = document.createElement("div"), Object.assign(this.element.style, {
+      position: i ? "fixed" : "absolute",
+      top: "0",
+      left: "0",
+      width: "100%",
+      height: "100%",
+      pointerEvents: "none",
+      zIndex: "9999",
+      opacity: "1",
+      transition: "opacity 0.15s ease"
+    }), i || 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((o) => `.${this.scopeClass} ${o}`).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);
+  }
+}
+let w = class {
+  constructor(t, e, o, i) {
+    this.state = t, this.options = e, this.getHoverSelector = o, this.onEnableChange = i, 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 [i, n] of Object.entries(this.options.rules))
+        t.matches(i) && Object.assign(e, n);
+    const o = t.dataset;
+    for (const i in o)
+      if (i.startsWith("supermouse")) {
+        const n = i.slice(10);
+        if (n) {
+          const a = n.charAt(0).toLowerCase() + n.slice(1), r = o[i];
+          e[a] = 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, o = t.clientY;
+    if (this.options.container && this.options.container !== document.body) {
+      const i = this.options.container.getBoundingClientRect();
+      e -= i.left, o -= i.top;
+    }
+    this.state.pointer.x = e, this.state.pointer.y = o, this.state.hasReceivedInput || (this.state.hasReceivedInput = !0, this.state.target.x = this.state.smooth.x = e, this.state.target.y = this.state.smooth.y = o);
+  };
+  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 o = this.getHoverSelector(), i = e.closest(o);
+    i && (this.state.isHover = !0, this.state.hoverTarget = i, this.parseDOMInteraction(this.state.hoverTarget));
+    const n = this.options.ignoreOnNative;
+    if (n) {
+      const a = n === !0 || n === "auto" || n === "tag", r = n === !0 || n === "auto" || n === "css";
+      let h = !1;
+      if (a) {
+        const l = e.localName;
+        (l === "input" || l === "textarea" || l === "select" || e.isContentEditable) && (h = !0);
+      }
+      if (!h && r) {
+        const l = window.getComputedStyle(e).cursor;
+        ["default", "auto", "pointer", "none", "inherit"].includes(l) || (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 L(s, t, e) {
+  return s + (t - s) * e;
+}
+function f(s, t, e, o) {
+  return L(s, t, 1 - Math.exp(-e * o));
+}
+function M(s, t) {
+  return Math.atan2(t, s) * (180 / Math.PI);
+}
+const T = [
+  "a",
+  "button",
+  "input",
+  "textarea",
+  "[data-hover]",
+  "[data-cursor]"
+];
+class N {
+  /** 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.
+   */
+  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(T), this.stage = new x(this.options.container, !!this.options.hideCursor), this.hoverSelectors.forEach((e) => this.stage.addSelector(e)), this.input = new w(
+      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, o) => (e.priority || 0) - (o.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 (o) {
+        console.error(`[Supermouse] Plugin '${t.name}' crashed and has been disabled.`, o), t.isEnabled = !1, t.onDisable?.(this);
+      }
+  }
+  /**
+   * The Heartbeat.
+   * Runs on every animation frame.
+   */
+  tick = (t) => {
+    const e = t - this.lastTime, o = Math.min(e / 1e3, 0.1);
+    this.lastTime = t;
+    const i = this.input.isEnabled && !this.state.isNative && this.state.hasReceivedInput;
+    if (this.stage.setVisibility(i), this.input.isEnabled && this.options.hideCursor) {
+      let n = "auto";
+      this.state.forcedCursor !== null ? n = this.state.forcedCursor : n = this.state.isNative || !this.state.hasReceivedInput ? "auto" : "none", this.stage.setNativeCursor(n);
+    }
+    if (this.input.isEnabled) {
+      this.state.target.x = this.state.pointer.x, this.state.target.y = this.state.pointer.y;
+      for (let l = 0; l < this.plugins.length; l++)
+        this.runPluginSafe(this.plugins[l], e);
+      const n = this.options.smoothness, a = this.state.reducedMotion ? 1e3 : 1 / n * 2;
+      this.state.smooth.x = f(this.state.smooth.x, this.state.target.x, a, o), this.state.smooth.y = f(this.state.smooth.y, this.state.target.y, a, o);
+      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 = M(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 n = 0; n < this.plugins.length; n++)
+        this.runPluginSafe(this.plugins[n], 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 = [];
+  }
+}
+function y(s, t) {
+  Object.assign(s.style, t);
+}
+const b = /* @__PURE__ */ new WeakMap();
+function g(s, t, e) {
+  let o = b.get(s);
+  o || (o = {}, b.set(s, o)), o[t] !== e && (s.style[t] = e, o[t] = e);
+}
+function O(s, t, e, o = 0, i = 1, n = 1, a = 0, r = 0) {
+  s.style.transform = `
+    translate3d(${t}px, ${e}px, 0) 
+    translate(-50%, -50%) 
+    rotate(${o}deg) 
+    skew(${a}deg, ${r}deg)
+    scale(${i}, ${n})
+  `;
+}
+function $(s, t = document.body) {
+  const e = s.getBoundingClientRect();
+  if (t !== document.body) {
+    const o = t.getBoundingClientRect(), i = e.left - o.left, n = e.top - o.top;
+    return {
+      x: i,
+      y: n,
+      width: e.width,
+      height: e.height,
+      top: n,
+      left: i,
+      right: i + e.width,
+      bottom: n + e.height,
+      toJSON: () => ({})
+    };
+  }
+  return e;
+}
+function v(s = "div") {
+  const t = document.createElement(s);
+  return y(t, {
+    position: "absolute",
+    top: "0",
+    left: "0",
+    pointerEvents: "none",
+    boxSizing: "border-box",
+    display: "block",
+    willChange: "transform"
+  }), t;
+}
+function R(s, t) {
+  const e = v("div");
+  return y(e, {
+    width: `${s}px`,
+    height: `${s}px`,
+    borderRadius: "50%",
+    backgroundColor: t
+  }), e;
+}
+function P() {
+  return v("div");
+}
+const c = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  applyStyles: y,
+  createActor: v,
+  createCircle: R,
+  createDiv: P,
+  projectRect: $,
+  setStyle: g,
+  setTransform: O
+}, Symbol.toStringTag, { value: "Module" })), E = {
+  /** The main cursor layer. For the primary Dot/Pointer. */
+  CURSOR: "300",
+  /** The secondary layer. For Rings, brackets, or followers. */
+  FOLLOWER: "200"
+};
+function u(s, t) {
+  return s === void 0 ? () => t : typeof s == "function" ? s : () => s;
+}
+function D(s) {
+  return "create" in s && typeof s.create == "function";
+}
+function S(s, t = {}) {
+  const e = t.name || s.name, o = t.isEnabled ?? !0;
+  if (D(s)) {
+    let i;
+    const n = [];
+    if (s.styles)
+      for (const [a, r] of Object.entries(s.styles)) {
+        const h = u(t[a], void 0), l = r;
+        n.push((d, m) => {
+          const p = h(d.state);
+          p !== void 0 && g(m, l, p);
+        });
+      }
+    return {
+      name: e,
+      isEnabled: o,
+      install(a) {
+        i = s.create(a), s.selector && a.registerHoverTarget(s.selector), this.isEnabled === !1 && (i.style.opacity = "0"), a.container.appendChild(i);
+      },
+      update(a, r) {
+        if (i) {
+          for (let h = 0; h < n.length; h++)
+            n[h](a, i);
+          s.update?.(a, i, r);
+        }
+      },
+      onDisable(a) {
+        i && (g(i, "opacity", 0), s.onDisable?.(a, i));
+      },
+      onEnable(a) {
+        i && (g(i, "opacity", 1), s.onEnable?.(a, i));
+      },
+      destroy() {
+        i && (s.cleanup?.(i), i.remove());
+      }
+    };
+  } else
+    return {
+      ...s,
+      name: e,
+      isEnabled: o
+    };
+}
+const k = (s = {}) => {
+  const t = "#750c7e", e = s.hideOnShape ?? !0, o = u(s.size, 8), i = u(s.color, t), n = u(s.opacity, 1);
+  return S({
+    name: "dot",
+    selector: "[data-supermouse-color]",
+    create: (a) => {
+      const r = o(a.state), h = i(a.state), l = c.createCircle(r, h);
+      return c.applyStyles(l, {
+        zIndex: s.zIndex || E.CURSOR,
+        mixBlendMode: s.mixBlendMode || "difference",
+        transition: "background-color 0.2s ease, opacity 0.2s ease"
+      }), l;
+    },
+    styles: {},
+    update: (a, r) => {
+      const h = o(a.state);
+      c.setStyle(r, "width", `${h}px`), c.setStyle(r, "height", `${h}px`);
+      const l = a.state.interaction.color;
+      l ? c.setStyle(r, "backgroundColor", l) : c.setStyle(r, "backgroundColor", i(a.state));
+      let d = n(a.state);
+      e && a.state.shape && (d = 0), c.setStyle(r, "opacity", String(d));
+      const { x: m, y: p } = a.state.target;
+      c.setTransform(r, m, p);
+    }
+  }, s);
+}, H = (s = {}) => {
+  const t = u(s.size, 20), e = u(s.color, "#ffffff"), o = u(s.borderWidth, 2), i = u(s.opacity, 1);
+  return S({
+    name: s.name || "ring",
+    selector: "[data-supermouse-color]",
+    create: (n) => {
+      const a = c.createCircle(t(n.state), "transparent");
+      return c.applyStyles(a, {
+        zIndex: E.FOLLOWER,
+        mixBlendMode: s.mixBlendMode || "difference",
+        borderStyle: "solid",
+        transition: "opacity 0.2s ease",
+        boxSizing: "border-box"
+      }), a;
+    },
+    update: (n, a) => {
+      const r = t(n.state);
+      let h = e(n.state);
+      n.state.interaction.color && (h = n.state.interaction.color), c.setStyle(a, "width", `${r}px`), c.setStyle(a, "height", `${r}px`), c.setStyle(a, "borderRadius", "50%"), c.setStyle(a, "borderColor", h), c.setStyle(a, "borderWidth", `${o(n.state)}px`), c.setStyle(a, "opacity", String(i(n.state)));
+      const { x: l, y: d } = n.state.smooth;
+      c.setTransform(a, l, d);
+    }
+  }, s);
+};
+export {
+  T as DEFAULT_HOVER_SELECTORS,
+  k as Dot,
+  H as Ring,
+  N as Supermouse
+};

package/dist/index.umd.js

@@ -0,0 +1,11 @@
+(function(u,g){typeof exports=="object"&&typeof module<"u"?g(exports):typeof define=="function"&&define.amd?define(["exports"],g):(u=typeof globalThis<"u"?globalThis:u||self,g(u.Supermouse={}))})(this,(function(u){"use strict";let g=0;class T{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 o=g++;this.id=`supermouse-style-${o}`,this.scopeClass=`supermouse-scope-${o}`;const i=t===document.body;this.element=document.createElement("div"),Object.assign(this.element.style,{position:i?"fixed":"absolute",top:"0",left:"0",width:"100%",height:"100%",pointerEvents:"none",zIndex:"9999",opacity:"1",transition:"opacity 0.15s ease"}),i||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(o=>`.${this.scopeClass} ${o}`).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)}}let L=class{constructor(t,e,o,i){this.state=t,this.options=e,this.getHoverSelector=o,this.onEnableChange=i,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[i,n]of Object.entries(this.options.rules))t.matches(i)&&Object.assign(e,n);const o=t.dataset;for(const i in o)if(i.startsWith("supermouse")){const n=i.slice(10);if(n){const a=n.charAt(0).toLowerCase()+n.slice(1),r=o[i];e[a]=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,o=t.clientY;if(this.options.container&&this.options.container!==document.body){const i=this.options.container.getBoundingClientRect();e-=i.left,o-=i.top}this.state.pointer.x=e,this.state.pointer.y=o,this.state.hasReceivedInput||(this.state.hasReceivedInput=!0,this.state.target.x=this.state.smooth.x=e,this.state.target.y=this.state.smooth.y=o)};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 o=this.getHoverSelector(),i=e.closest(o);i&&(this.state.isHover=!0,this.state.hoverTarget=i,this.parseDOMInteraction(this.state.hoverTarget));const n=this.options.ignoreOnNative;if(n){const a=n===!0||n==="auto"||n==="tag",r=n===!0||n==="auto"||n==="css";let h=!1;if(a){const l=e.localName;(l==="input"||l==="textarea"||l==="select"||e.isContentEditable)&&(h=!0)}if(!h&&r){const l=window.getComputedStyle(e).cursor;["default","auto","pointer","none","inherit"].includes(l)||(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(s,t,e){return s+(t-s)*e}function S(s,t,e,o){return M(s,t,1-Math.exp(-e*o))}function O(s,t){return Math.atan2(t,s)*(180/Math.PI)}const E=["a","button","input","textarea","[data-hover]","[data-cursor]"];class ${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(E),this.stage=new T(this.options.container,!!this.options.hideCursor),this.hoverSelectors.forEach(e=>this.stage.addSelector(e)),this.input=new L(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,o)=>(e.priority||0)-(o.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(o){console.error(`[Supermouse] Plugin '${t.name}' crashed and has been disabled.`,o),t.isEnabled=!1,t.onDisable?.(this)}}tick=t=>{const e=t-this.lastTime,o=Math.min(e/1e3,.1);this.lastTime=t;const i=this.input.isEnabled&&!this.state.isNative&&this.state.hasReceivedInput;if(this.stage.setVisibility(i),this.input.isEnabled&&this.options.hideCursor){let n="auto";this.state.forcedCursor!==null?n=this.state.forcedCursor:n=this.state.isNative||!this.state.hasReceivedInput?"auto":"none",this.stage.setNativeCursor(n)}if(this.input.isEnabled){this.state.target.x=this.state.pointer.x,this.state.target.y=this.state.pointer.y;for(let l=0;l<this.plugins.length;l++)this.runPluginSafe(this.plugins[l],e);const n=this.options.smoothness,a=this.state.reducedMotion?1e3:1/n*2;this.state.smooth.x=S(this.state.smooth.x,this.state.target.x,a,o),this.state.smooth.y=S(this.state.smooth.y,this.state.target.y,a,o);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=O(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 n=0;n<this.plugins.length;n++)this.runPluginSafe(this.plugins[n],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=[]}}function f(s,t){Object.assign(s.style,t)}const C=new WeakMap;function m(s,t,e){let o=C.get(s);o||(o={},C.set(s,o)),o[t]!==e&&(s.style[t]=e,o[t]=e)}function R(s,t,e,o=0,i=1,n=1,a=0,r=0){s.style.transform=`
+    translate3d(${t}px, ${e}px, 0) 
+    translate(-50%, -50%) 
+    rotate(${o}deg) 
+    skew(${a}deg, ${r}deg)
+    scale(${i}, ${n})
+  `}function P(s,t=document.body){const e=s.getBoundingClientRect();if(t!==document.body){const o=t.getBoundingClientRect(),i=e.left-o.left,n=e.top-o.top;return{x:i,y:n,width:e.width,height:e.height,top:n,left:i,right:i+e.width,bottom:n+e.height,toJSON:()=>({})}}return e}function v(s="div"){const t=document.createElement(s);return f(t,{position:"absolute",top:"0",left:"0",pointerEvents:"none",boxSizing:"border-box",display:"block",willChange:"transform"}),t}function D(s,t){const e=v("div");return f(e,{width:`${s}px`,height:`${s}px`,borderRadius:"50%",backgroundColor:t}),e}function I(){return v("div")}const c=Object.freeze(Object.defineProperty({__proto__:null,applyStyles:f,createActor:v,createCircle:D,createDiv:I,projectRect:P,setStyle:m,setTransform:R},Symbol.toStringTag,{value:"Module"})),x={CURSOR:"300",FOLLOWER:"200"};function d(s,t){return s===void 0?()=>t:typeof s=="function"?s:()=>s}function N(s){return"create"in s&&typeof s.create=="function"}function w(s,t={}){const e=t.name||s.name,o=t.isEnabled??!0;if(N(s)){let i;const n=[];if(s.styles)for(const[a,r]of Object.entries(s.styles)){const h=d(t[a],void 0),l=r;n.push((p,b)=>{const y=h(p.state);y!==void 0&&m(b,l,y)})}return{name:e,isEnabled:o,install(a){i=s.create(a),s.selector&&a.registerHoverTarget(s.selector),this.isEnabled===!1&&(i.style.opacity="0"),a.container.appendChild(i)},update(a,r){if(i){for(let h=0;h<n.length;h++)n[h](a,i);s.update?.(a,i,r)}},onDisable(a){i&&(m(i,"opacity",0),s.onDisable?.(a,i))},onEnable(a){i&&(m(i,"opacity",1),s.onEnable?.(a,i))},destroy(){i&&(s.cleanup?.(i),i.remove())}}}else return{...s,name:e,isEnabled:o}}const k=(s={})=>{const t="#750c7e",e=s.hideOnShape??!0,o=d(s.size,8),i=d(s.color,t),n=d(s.opacity,1);return w({name:"dot",selector:"[data-supermouse-color]",create:a=>{const r=o(a.state),h=i(a.state),l=c.createCircle(r,h);return c.applyStyles(l,{zIndex:s.zIndex||x.CURSOR,mixBlendMode:s.mixBlendMode||"difference",transition:"background-color 0.2s ease, opacity 0.2s ease"}),l},styles:{},update:(a,r)=>{const h=o(a.state);c.setStyle(r,"width",`${h}px`),c.setStyle(r,"height",`${h}px`);const l=a.state.interaction.color;l?c.setStyle(r,"backgroundColor",l):c.setStyle(r,"backgroundColor",i(a.state));let p=n(a.state);e&&a.state.shape&&(p=0),c.setStyle(r,"opacity",String(p));const{x:b,y}=a.state.target;c.setTransform(r,b,y)}},s)},H=(s={})=>{const t=d(s.size,20),e=d(s.color,"#ffffff"),o=d(s.borderWidth,2),i=d(s.opacity,1);return w({name:s.name||"ring",selector:"[data-supermouse-color]",create:n=>{const a=c.createCircle(t(n.state),"transparent");return c.applyStyles(a,{zIndex:x.FOLLOWER,mixBlendMode:s.mixBlendMode||"difference",borderStyle:"solid",transition:"opacity 0.2s ease",boxSizing:"border-box"}),a},update:(n,a)=>{const r=t(n.state);let h=e(n.state);n.state.interaction.color&&(h=n.state.interaction.color),c.setStyle(a,"width",`${r}px`),c.setStyle(a,"height",`${r}px`),c.setStyle(a,"borderRadius","50%"),c.setStyle(a,"borderColor",h),c.setStyle(a,"borderWidth",`${o(n.state)}px`),c.setStyle(a,"opacity",String(i(n.state)));const{x:l,y:p}=n.state.smooth;c.setTransform(a,l,p)}},s)};u.DEFAULT_HOVER_SELECTORS=E,u.Dot=k,u.Ring=H,u.Supermouse=$,Object.defineProperty(u,Symbol.toStringTag,{value:"Module"})}));

package/meta.json

@@ -0,0 +1,8 @@
+{
+  "id": "supermousejs",
+  "name": "Supermouse JS (Standard)",
+  "package": "supermousejs",
+  "description": "The official unscoped bundle for v2. Quickest way to get started with the standard Dot & Ring setup.",
+  "code": "import Supermouse, { Dot, Ring } from 'supermousejs';\n\nconst app = new Supermouse();\napp.use(Dot()).use(Ring());",
+  "icon": "dot"
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "supermousejs",
+  "version": "2.1.0",
+  "description": "The official all-in-one bundle for Supermouse.js v2. High-performance, modular cursor engine.",
+  "main": "dist/index.umd.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "url": "https://github.com/Whitestar14/supermouse-js",
+  "keywords": [
+    "cursor",
+    "pointer",
+    "mouse",
+    "animation",
+    "supermouse",
+    "supermousejs"
+  ],
+  "author": "O.S David",
+  "license": "MIT",
+  "dependencies": {
+    "@supermousejs/dot": "2.1.0",
+    "@supermousejs/ring": "2.1.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.umd.js"
+    }
+  },
+  "peerDependencies": {
+    "@supermousejs/core": "2.0.4"
+  },
+  "devDependencies": {
+    "@supermousejs/core": "2.0.4"
+  },
+  "scripts": {
+    "build": "vite build"
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from '@supermousejs/core';
+export { Dot } from '@supermousejs/dot';
+export { Ring } from '@supermousejs/ring';

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "include": ["src"],
+  "compilerOptions": {
+    "outDir": "dist",
+    "baseUrl": ".",
+  }
+}

package/vite.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig } from 'vite';
+import dts from 'vite-plugin-dts';
+import path from 'path';
+
+export default defineConfig({
+  build: {
+    lib: {
+      entry: path.resolve(__dirname, 'src/index.ts'),
+      name: 'Supermouse',
+      fileName: (format) => format === 'es' ? 'index.mjs' : 'index.umd.js',
+    },
+    rollupOptions: {
+      external: [],
+      output: {
+        globals: {}
+      }
+    }
+  },
+  plugins: [dts({ rollupTypes: true })]
+});