@supermousejs/utils 2.1.1 → 2.2.0

package/dist/index.mjs

@@ -1,68 +1,61 @@
 function y(e, t, n) {
   return e + (t - e) * n;
 }
-function O(e, t, n, o) {
-  return y(e, t, 1 - Math.exp(-n * o));
+function v(e, t, n, r) {
+  return y(e, t, 1 - Math.exp(-n * r));
 }
-function _(e, t, n) {
-  const o = ((t - e) % 360 + 540) % 360 - 180;
-  return e + o * n;
+function C(e, t, n) {
+  const r = ((t - e) % 360 + 540) % 360 - 180;
+  return e + r * n;
 }
-function C(e, t) {
+function O(e, t) {
   return Math.random() * (t - e) + e;
 }
-function h(e, t, n) {
+function m(e, t, n) {
   return Math.min(Math.max(e, t), n);
 }
-function b(e, t, n = 0, o = 0) {
-  const r = e - n, i = t - o;
-  return Math.sqrt(r * r + i * i);
+function b(e, t, n = 0, r = 0) {
+  const o = e - n, c = t - r;
+  return Math.sqrt(o * o + c * c);
 }
-function m(e, t) {
+function h(e, t) {
   return Math.atan2(t, e) * (180 / Math.PI);
 }
-const x = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const j = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  angle: m,
-  clamp: h,
-  damp: O,
+  angle: h,
+  clamp: m,
+  damp: v,
   dist: b,
   lerp: y,
-  lerpAngle: _,
-  random: C
-}, Symbol.toStringTag, { value: "Module" }));
+  lerpAngle: C,
+  random: O
+}, Symbol.toStringTag, { value: "Module" })), _ = (e, t) => {
+  if (typeof document > "u" || document.getElementById(e)) return;
+  const n = document.createElement("style");
+  n.id = e, n.innerHTML = t, document.head.appendChild(n);
+}, p = /* @__PURE__ */ new WeakMap();
 function a(e, t) {
-  Object.assign(e.style, t);
+  if (typeof document > "u" || !e) return;
+  let n = p.get(e);
+  n || (n = {}, p.set(e, n));
+  for (const r in t) {
+    const o = t[r];
+    n[r] !== o && (e.style[r] = o, n[r] = o);
+  }
 }
-const p = /* @__PURE__ */ new WeakMap();
 function u(e, t, n) {
-  let o = p.get(e);
-  o || (o = {}, p.set(e, o)), o[t] !== n && (e.style[t] = n, o[t] = n);
-}
-function v(e, t, n, o = 0, r = 1, i = 1, s = 0, l = 0) {
-  e.style.transform = `
-    translate3d(${t}px, ${n}px, 0) 
-    translate(-50%, -50%) 
-    rotate(${o}deg) 
-    skew(${s}deg, ${l}deg)
-    scale(${r}, ${i})
-  `;
+  a(e, { [t]: n });
+}
+function M(e, t, n, r = 0, o = 1, c = 1, s = 0, l = 0) {
+  const i = `translate3d(${t}px, ${n}px, 0) translate(-50%, -50%) rotate(${r}deg) skew(${s}deg, ${l}deg) scale(${o}, ${c})`;
+  u(e, "transform", i);
 }
 function w(e, t = document.body) {
   const n = e.getBoundingClientRect();
   if (t !== document.body) {
-    const o = t.getBoundingClientRect(), r = n.left - o.left, i = n.top - o.top;
-    return {
-      x: r,
-      y: i,
-      width: n.width,
-      height: n.height,
-      top: i,
-      left: r,
-      right: r + n.width,
-      bottom: i + n.height,
-      toJSON: () => ({})
-    };
+    const r = t.getBoundingClientRect(), o = n.left - r.left, c = n.top - r.top;
+    return new DOMRect(o, c, n.width, n.height);
   }
   return n;
 }
@@ -78,7 +71,7 @@ function d(e = "div") {
     willChange: "transform"
   }), t;
 }
-function A(e, t) {
+function R(e, t) {
   const n = d("div");
   return a(n, {
     width: `${e}px`,
@@ -87,34 +80,35 @@ function A(e, t) {
     backgroundColor: t
   }), n;
 }
-function M() {
+function T() {
   return d("div");
 }
-const j = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const z = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   applyStyles: a,
   createActor: d,
-  createCircle: A,
-  createDiv: M,
+  createCircle: R,
+  createDiv: T,
+  injectStyles: _,
   projectRect: w,
   setStyle: u,
-  setTransform: v
+  setTransform: M
 }, Symbol.toStringTag, { value: "Module" }));
-function R(e, t, n = 4e-3, o = 0.5) {
-  const r = b(e, t);
-  if (r < 0.1)
+function x(e, t, n = 4e-3, r = 0.5) {
+  const o = b(e, t);
+  if (o < 0.1)
     return { rotation: 0, scaleX: 1, scaleY: 1 };
-  const i = m(e, t), s = h(r * n, 0, o), l = 1 + s, c = 1 - s * 0.5;
+  const c = h(e, t), s = m(o * n, 0, r), l = 1 + s, i = 1 - s * 0.5;
   return {
-    rotation: i,
+    rotation: c,
     scaleX: l,
-    scaleY: c
+    scaleY: i
   };
 }
-const z = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const P = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  getVelocityDistortion: R
-}, Symbol.toStringTag, { value: "Module" })), P = {
+  getVelocityDistortion: x
+}, Symbol.toStringTag, { value: "Module" })), D = {
   /** The top-most layer. For text, tooltips, and crucial UI. */
   OVERLAY: "400",
   /** The main cursor layer. For the primary Dot/Pointer. */
@@ -123,7 +117,7 @@ const z = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   FOLLOWER: "200",
   /** The background layer. For trails, sparkles, and particles. */
   TRACE: "100"
-}, D = {
+}, L = {
   /** Good for entrance animations (starts fast, slows down) */
   EASE_OUT_EXPO: "cubic-bezier(0.16, 1, 0.3, 1)",
   /** Good for elastic/bouncy UI elements */
@@ -131,75 +125,81 @@ const z = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   /** Standard smooth movement */
   SMOOTH: "ease-out"
 };
-function T(e, t) {
+function A(e, t) {
   return e === void 0 ? () => t : typeof e == "function" ? e : () => e;
 }
 function $(e) {
   return "create" in e && typeof e.create == "function";
 }
-function L(e, t = {}) {
-  const n = t.name || e.name, o = t.isEnabled ?? !0;
+function k(e, t = {}) {
+  const n = t.name || e.name, r = t.isEnabled ?? !0;
   if ($(e)) {
-    let r;
-    const i = [];
+    let o;
+    const c = [];
     if (e.styles)
       for (const [s, l] of Object.entries(e.styles)) {
-        const c = T(t[s], void 0), g = l;
-        i.push((E, S) => {
-          const f = c(E.state);
+        const i = A(t[s], void 0), g = l;
+        c.push((E, S) => {
+          const f = i(E.state);
           f !== void 0 && u(S, g, f);
         });
       }
     return {
       name: n,
-      isEnabled: o,
+      isEnabled: r,
       install(s) {
-        r = e.create(s), e.selector && s.registerHoverTarget(e.selector), this.isEnabled === !1 && (r.style.opacity = "0"), s.container.appendChild(r);
+        o = e.create(s), e.selector && s.registerHoverTarget(e.selector), this.isEnabled === !1 && (o.style.opacity = "0"), s.container.appendChild(o);
       },
       update(s, l) {
-        if (r) {
-          for (let c = 0; c < i.length; c++)
-            i[c](s, r);
-          e.update?.(s, r, l);
+        if (o) {
+          for (let i = 0; i < c.length; i++)
+            c[i](s, o);
+          e.update?.(s, o, l);
         }
       },
       onDisable(s) {
-        r && (u(r, "opacity", 0), e.onDisable?.(s, r));
+        o && (u(o, "opacity", 0), e.onDisable?.(s, o));
       },
       onEnable(s) {
-        r && (u(r, "opacity", 1), e.onEnable?.(s, r));
+        o && (u(o, "opacity", 1), e.onEnable?.(s, o));
       },
       destroy() {
-        r && (e.cleanup?.(r), r.remove());
+        o && (e.cleanup?.(o), o.remove());
       }
     };
   } else
     return {
       ...e,
       name: n,
-      isEnabled: o
+      isEnabled: r
     };
 }
-function k() {
-  if (console.group("🐭 Supermouse Doctor"), !Array.from(document.querySelectorAll("style")).some((o) => o.id.startsWith("supermouse-style-"))) {
-    console.warn("❌ Supermouse has not been initialized yet."), console.warn('   Please call doctor() AFTER "new Supermouse()" has run.'), console.groupEnd();
+function I() {
+  if (console.group("🐭 Supermouse Doctor"), !Array.from(document.querySelectorAll("style")).some(
+    (r) => r.id.startsWith("supermouse-style-")
+  )) {
+    console.warn("[x] Supermouse has not been initialized yet."), console.warn("   Please call doctor() after `new Supermouse()` has run."), console.groupEnd();
     return;
   }
   const t = [];
-  document.querySelectorAll('[style*="cursor"]').forEach((o) => {
-    o.getAttribute("style")?.includes("cursor: none") || t.push({
-      el: o,
+  document.querySelectorAll('[style*="cursor"]').forEach((r) => {
+    r.getAttribute("style")?.includes("cursor: none") || t.push({
+      el: r,
       reason: 'Element has inline "cursor" style. Remove it and let Supermouse handle state.'
     });
-  }), document.body.style.cursor !== "none" && console.warn('[Global] document.body.style.cursor is not "none". Ensure { hideCursor: true } is passed to Supermouse.'), t.length > 0 ? (console.warn(`Found ${t.length} potential conflicts:`), t.forEach((o) => console.warn(`[${o.reason}]`, o.el)), console.info('Tip: Avoid setting "cursor: pointer" manually. Use plugins or "rules" config instead.')) : console.log("✅ No obvious inline-style conflicts found."), console.groupEnd();
+  }), document.body.style.cursor !== "none" && console.warn(
+    '[Global] document.body.style.cursor is not "none". Ensure { hideCursor: true } is passed to Supermouse.'
+  ), t.length > 0 ? (console.warn(`Found ${t.length} potential conflicts:`), t.forEach((r) => console.warn(`[${r.reason}]`, r.el)), console.info(
+    'Tip: Avoid setting "cursor: pointer" manually. Use plugins or `rules` config instead.'
+  )) : console.log("[ok] No obvious inline-style conflicts found."), console.groupEnd();
 }
 export {
-  D as Easings,
-  P as Layers,
-  L as definePlugin,
-  k as doctor,
-  j as dom,
-  z as effects,
-  x as math,
-  T as normalize
+  L as Easings,
+  D as Layers,
+  k as definePlugin,
+  I as doctor,
+  z as dom,
+  P as effects,
+  j as math,
+  A as normalize
 };

package/dist/index.umd.js

@@ -1,7 +1 @@
-(function(l,a){typeof exports=="object"&&typeof module<"u"?a(exports):typeof define=="function"&&define.amd?define(["exports"],a):(l=typeof globalThis<"u"?globalThis:l||self,a(l.SupermouseUtils={}))})(this,(function(l){"use strict";function a(e,t,n){return e+(t-e)*n}function S(e,t,n,o){return a(e,t,1-Math.exp(-n*o))}function O(e,t,n){const o=((t-e)%360+540)%360-180;return e+o*n}function T(e,t){return Math.random()*(t-e)+e}function h(e,t,n){return Math.min(Math.max(e,t),n)}function m(e,t,n=0,o=0){const r=e-n,i=t-o;return Math.sqrt(r*r+i*i)}function b(e,t){return Math.atan2(t,e)*(180/Math.PI)}const _=Object.freeze(Object.defineProperty({__proto__:null,angle:b,clamp:h,damp:S,dist:m,lerp:a,lerpAngle:O,random:T},Symbol.toStringTag,{value:"Module"}));function f(e,t){Object.assign(e.style,t)}const p=new WeakMap;function d(e,t,n){let o=p.get(e);o||(o={},p.set(e,o)),o[t]!==n&&(e.style[t]=n,o[t]=n)}function v(e,t,n,o=0,r=1,i=1,s=0,c=0){e.style.transform=`
-    translate3d(${t}px, ${n}px, 0) 
-    translate(-50%, -50%) 
-    rotate(${o}deg) 
-    skew(${s}deg, ${c}deg)
-    scale(${r}, ${i})
-  `}function C(e,t=document.body){const n=e.getBoundingClientRect();if(t!==document.body){const o=t.getBoundingClientRect(),r=n.left-o.left,i=n.top-o.top;return{x:r,y:i,width:n.width,height:n.height,top:i,left:r,right:r+n.width,bottom:i+n.height,toJSON:()=>({})}}return n}function y(e="div"){const t=document.createElement(e);return f(t,{position:"absolute",top:"0",left:"0",pointerEvents:"none",boxSizing:"border-box",display:"block",willChange:"transform"}),t}function w(e,t){const n=y("div");return f(n,{width:`${e}px`,height:`${e}px`,borderRadius:"50%",backgroundColor:t}),n}function M(){return y("div")}const A=Object.freeze(Object.defineProperty({__proto__:null,applyStyles:f,createActor:y,createCircle:w,createDiv:M,projectRect:C,setStyle:d,setTransform:v},Symbol.toStringTag,{value:"Module"}));function R(e,t,n=.004,o=.5){const r=m(e,t);if(r<.1)return{rotation:0,scaleX:1,scaleY:1};const i=b(e,t),s=h(r*n,0,o),c=1+s,u=1-s*.5;return{rotation:i,scaleX:c,scaleY:u}}const j=Object.freeze(Object.defineProperty({__proto__:null,getVelocityDistortion:R},Symbol.toStringTag,{value:"Module"})),$={OVERLAY:"400",CURSOR:"300",FOLLOWER:"200",TRACE:"100"},z={EASE_OUT_EXPO:"cubic-bezier(0.16, 1, 0.3, 1)",ELASTIC_OUT:"cubic-bezier(0.34, 1.56, 0.64, 1)",SMOOTH:"ease-out"};function g(e,t){return e===void 0?()=>t:typeof e=="function"?e:()=>e}function P(e){return"create"in e&&typeof e.create=="function"}function L(e,t={}){const n=t.name||e.name,o=t.isEnabled??!0;if(P(e)){let r;const i=[];if(e.styles)for(const[s,c]of Object.entries(e.styles)){const u=g(t[s],void 0),U=c;i.push((k,x)=>{const E=u(k.state);E!==void 0&&d(x,U,E)})}return{name:n,isEnabled:o,install(s){r=e.create(s),e.selector&&s.registerHoverTarget(e.selector),this.isEnabled===!1&&(r.style.opacity="0"),s.container.appendChild(r)},update(s,c){if(r){for(let u=0;u<i.length;u++)i[u](s,r);e.update?.(s,r,c)}},onDisable(s){r&&(d(r,"opacity",0),e.onDisable?.(s,r))},onEnable(s){r&&(d(r,"opacity",1),e.onEnable?.(s,r))},destroy(){r&&(e.cleanup?.(r),r.remove())}}}else return{...e,name:n,isEnabled:o}}function D(){if(console.group("🐭 Supermouse Doctor"),!Array.from(document.querySelectorAll("style")).some(o=>o.id.startsWith("supermouse-style-"))){console.warn("❌ Supermouse has not been initialized yet."),console.warn('   Please call doctor() AFTER "new Supermouse()" has run.'),console.groupEnd();return}const t=[];document.querySelectorAll('[style*="cursor"]').forEach(o=>{o.getAttribute("style")?.includes("cursor: none")||t.push({el:o,reason:'Element has inline "cursor" style. Remove it and let Supermouse handle state.'})}),document.body.style.cursor!=="none"&&console.warn('[Global] document.body.style.cursor is not "none". Ensure { hideCursor: true } is passed to Supermouse.'),t.length>0?(console.warn(`Found ${t.length} potential conflicts:`),t.forEach(o=>console.warn(`[${o.reason}]`,o.el)),console.info('Tip: Avoid setting "cursor: pointer" manually. Use plugins or "rules" config instead.')):console.log("✅ No obvious inline-style conflicts found."),console.groupEnd()}l.Easings=z,l.Layers=$,l.definePlugin=L,l.doctor=D,l.dom=A,l.effects=j,l.math=_,l.normalize=g,Object.defineProperty(l,Symbol.toStringTag,{value:"Module"})}));
+(function(i,a){typeof exports=="object"&&typeof module<"u"?a(exports):typeof define=="function"&&define.amd?define(["exports"],a):(i=typeof globalThis<"u"?globalThis:i||self,a(i.SupermouseUtils={}))})(this,(function(i){"use strict";function a(e,t,n){return e+(t-e)*n}function S(e,t,n,r){return a(e,t,1-Math.exp(-n*r))}function v(e,t,n){const r=((t-e)%360+540)%360-180;return e+r*n}function O(e,t){return Math.random()*(t-e)+e}function y(e,t,n){return Math.min(Math.max(e,t),n)}function p(e,t,n=0,r=0){const o=e-n,c=t-r;return Math.sqrt(o*o+c*c)}function b(e,t){return Math.atan2(t,e)*(180/Math.PI)}const C=Object.freeze(Object.defineProperty({__proto__:null,angle:b,clamp:y,damp:S,dist:p,lerp:a,lerpAngle:v,random:O},Symbol.toStringTag,{value:"Module"})),M=(e,t)=>{if(typeof document>"u"||document.getElementById(e))return;const n=document.createElement("style");n.id=e,n.innerHTML=t,document.head.appendChild(n)},h=new WeakMap;function f(e,t){if(typeof document>"u"||!e)return;let n=h.get(e);n||(n={},h.set(e,n));for(const r in t){const o=t[r];n[r]!==o&&(e.style[r]=o,n[r]=o)}}function d(e,t,n){f(e,{[t]:n})}function T(e,t,n,r=0,o=1,c=1,s=0,u=0){const l=`translate3d(${t}px, ${n}px, 0) translate(-50%, -50%) rotate(${r}deg) skew(${s}deg, ${u}deg) scale(${o}, ${c})`;d(e,"transform",l)}function _(e,t=document.body){const n=e.getBoundingClientRect();if(t!==document.body){const r=t.getBoundingClientRect(),o=n.left-r.left,c=n.top-r.top;return new DOMRect(o,c,n.width,n.height)}return n}function m(e="div"){const t=document.createElement(e);return f(t,{position:"absolute",top:"0",left:"0",pointerEvents:"none",boxSizing:"border-box",display:"block",willChange:"transform"}),t}function w(e,t){const n=m("div");return f(n,{width:`${e}px`,height:`${e}px`,borderRadius:"50%",backgroundColor:t}),n}function R(){return m("div")}const j=Object.freeze(Object.defineProperty({__proto__:null,applyStyles:f,createActor:m,createCircle:w,createDiv:R,injectStyles:M,projectRect:_,setStyle:d,setTransform:T},Symbol.toStringTag,{value:"Module"}));function A(e,t,n=.004,r=.5){const o=p(e,t);if(o<.1)return{rotation:0,scaleX:1,scaleY:1};const c=b(e,t),s=y(o*n,0,r),u=1+s,l=1-s*.5;return{rotation:c,scaleX:u,scaleY:l}}const $=Object.freeze(Object.defineProperty({__proto__:null,getVelocityDistortion:A},Symbol.toStringTag,{value:"Module"})),z={OVERLAY:"400",CURSOR:"300",FOLLOWER:"200",TRACE:"100"},P={EASE_OUT_EXPO:"cubic-bezier(0.16, 1, 0.3, 1)",ELASTIC_OUT:"cubic-bezier(0.34, 1.56, 0.64, 1)",SMOOTH:"ease-out"};function g(e,t){return e===void 0?()=>t:typeof e=="function"?e:()=>e}function L(e){return"create"in e&&typeof e.create=="function"}function D(e,t={}){const n=t.name||e.name,r=t.isEnabled??!0;if(L(e)){let o;const c=[];if(e.styles)for(const[s,u]of Object.entries(e.styles)){const l=g(t[s],void 0),x=u;c.push((I,U)=>{const E=l(I.state);E!==void 0&&d(U,x,E)})}return{name:n,isEnabled:r,install(s){o=e.create(s),e.selector&&s.registerHoverTarget(e.selector),this.isEnabled===!1&&(o.style.opacity="0"),s.container.appendChild(o)},update(s,u){if(o){for(let l=0;l<c.length;l++)c[l](s,o);e.update?.(s,o,u)}},onDisable(s){o&&(d(o,"opacity",0),e.onDisable?.(s,o))},onEnable(s){o&&(d(o,"opacity",1),e.onEnable?.(s,o))},destroy(){o&&(e.cleanup?.(o),o.remove())}}}else return{...e,name:n,isEnabled:r}}function k(){if(console.group("🐭 Supermouse Doctor"),!Array.from(document.querySelectorAll("style")).some(r=>r.id.startsWith("supermouse-style-"))){console.warn("[x] Supermouse has not been initialized yet."),console.warn("   Please call doctor() after `new Supermouse()` has run."),console.groupEnd();return}const t=[];document.querySelectorAll('[style*="cursor"]').forEach(r=>{r.getAttribute("style")?.includes("cursor: none")||t.push({el:r,reason:'Element has inline "cursor" style. Remove it and let Supermouse handle state.'})}),document.body.style.cursor!=="none"&&console.warn('[Global] document.body.style.cursor is not "none". Ensure { hideCursor: true } is passed to Supermouse.'),t.length>0?(console.warn(`Found ${t.length} potential conflicts:`),t.forEach(r=>console.warn(`[${r.reason}]`,r.el)),console.info('Tip: Avoid setting "cursor: pointer" manually. Use plugins or `rules` config instead.')):console.log("[ok] No obvious inline-style conflicts found."),console.groupEnd()}i.Easings=P,i.Layers=z,i.definePlugin=D,i.doctor=k,i.dom=j,i.effects=$,i.math=C,i.normalize=g,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})}));

package/dist/layers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Standard Z-Index layers for the Supermouse ecosystem.
+ * Relative to the Supermouse Container.
+ */
+export declare const Layers: {
+    /** The top-most layer. For text, tooltips, and crucial UI. */
+    readonly OVERLAY: "400";
+    /** The main cursor layer. For the primary Dot/Pointer. */
+    readonly CURSOR: "300";
+    /** The secondary layer. For Rings, brackets, or followers. */
+    readonly FOLLOWER: "200";
+    /** The background layer. For trails, sparkles, and particles. */
+    readonly TRACE: "100";
+};
+//# sourceMappingURL=layers.d.ts.map

package/dist/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,MAAM;IACjB,8DAA8D;;IAG9D,0DAA0D;;IAG1D,8DAA8D;;IAG9D,iEAAiE;;CAEzD,CAAC"}

package/dist/math.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Linear Interpolation between two values.
+ */
+export declare function lerp(start: number, end: number, factor: number): number;
+/**
+ * Frame-rate independent damping (Time-based Lerp).
+ * Ensures smooth animation consistent across 60hz, 120hz, etc.
+ *
+ * @param a Current value
+ * @param b Target value
+ * @param lambda Smoothing factor (approx 1-20). Higher is faster.
+ * @param dt Delta time in seconds (not milliseconds)
+ */
+export declare function damp(a: number, b: number, lambda: number, dt: number): number;
+/**
+ * Linear Interpolation between two angles in degrees, taking the shortest path.
+ * Handles wrap-around at 360 degrees.
+ */
+export declare function lerpAngle(start: number, end: number, factor: number): number;
+/**
+ * Returns a random number between min and max.
+ * Usage: math.random(10, 20) -> 14.5
+ */
+export declare function random(min: number, max: number): number;
+/**
+ * Constrains a value between a minimum and maximum.
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Calculates the distance (hypotenuse) between two points (or magnitude of a vector).
+ * If x2/y2 are omitted, calculates magnitude of vector x1/y1.
+ */
+export declare function dist(x1: number, y1: number, x2?: number, y2?: number): number;
+/**
+ * Calculates the angle in degrees between two points (or vector direction).
+ */
+export declare function angle(x: number, y: number): number;
+//# sourceMappingURL=math.d.ts.map

package/dist/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../src/math.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,GAAE,MAAU,EAAE,EAAE,GAAE,MAAU,GAAG,MAAM,CAInF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/options.d.ts

@@ -0,0 +1,11 @@
+import { MouseState, ValueOrGetter } from '../../core/src';
+/**
+ * Returns a function that always resolves the option value.
+ * Eliminates 'typeof' checks inside the render loop by normalizing
+ * static values into getter functions during initialization.
+ *
+ * @param option The option passed by the user
+ * @param defaultValue Fallback value
+ */
+export declare function normalize<T>(option: ValueOrGetter<T> | undefined, defaultValue: T): (state: MouseState) => T;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEpE;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,EACpC,YAAY,EAAE,CAAC,GACd,CAAC,KAAK,EAAE,UAAU,KAAK,CAAC,CAQ1B"}

package/dist/plugin.d.ts

@@ -0,0 +1,34 @@
+import { Supermouse, SupermousePlugin } from '../../core/src';
+export interface BasePluginOptions {
+    name?: string;
+    isEnabled?: boolean;
+}
+interface LogicConfig {
+    name: string;
+    priority?: number;
+    install?: (app: Supermouse) => void;
+    update?: (app: Supermouse, deltaTime: number) => void;
+    destroy?: (app: Supermouse) => void;
+    onEnable?: (app: Supermouse) => void;
+    onDisable?: (app: Supermouse) => void;
+    create?: never;
+}
+interface VisualConfig<E extends HTMLElement, O extends object> {
+    name: string;
+    /** Automatically register this attribute selector */
+    selector?: string;
+    /** Create and return the DOM Element */
+    create: (app: Supermouse) => E;
+    /** Map option keys to CSS properties */
+    styles?: Partial<Record<keyof O, keyof CSSStyleDeclaration>>;
+    /** Update loop with access to the element */
+    update?: (app: Supermouse, element: E, deltaTime: number) => void;
+    onEnable?: (app: Supermouse, element: E) => void;
+    onDisable?: (app: Supermouse, element: E) => void;
+    cleanup?: (element: E) => void;
+    destroy?: never;
+}
+export declare function definePlugin<E extends HTMLElement, O extends BasePluginOptions>(config: VisualConfig<E, O>, userOptions?: O): SupermousePlugin;
+export declare function definePlugin(config: LogicConfig, userOptions?: BasePluginOptions): SupermousePlugin;
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAIvE,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IAEtC,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB;AAGD,UAAU,YAAY,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,MAAM;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,MAAM,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,CAAC,CAAC;IAC/B,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,mBAAmB,CAAC,CAAC,CAAC;IAC7D,6CAA6C;IAC7C,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IACjD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB;AAYD,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,iBAAiB,EAC7E,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,WAAW,CAAC,EAAE,CAAC,GACd,gBAAgB,CAAC;AAGpB,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,WAAW,CAAC,EAAE,iBAAiB,GAC9B,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supermousejs/utils",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "main": "dist/index.umd.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -27,10 +27,10 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@supermousejs/core": "2.0.5"
+    "@supermousejs/core": "2.1.0"
   },
   "devDependencies": {
-    "@supermousejs/core": "2.0.5"
+    "@supermousejs/core": "2.1.0"
   },
   "scripts": {
     "build": "vite build"

package/src/css.ts

@@ -1,11 +1,11 @@
-/**
- * Common cubic-bezier easing strings for CSS transitions.
- */
-export const Easings = {
-  /** Good for entrance animations (starts fast, slows down) */
-  EASE_OUT_EXPO: 'cubic-bezier(0.16, 1, 0.3, 1)',
-  /** Good for elastic/bouncy UI elements */
-  ELASTIC_OUT: 'cubic-bezier(0.34, 1.56, 0.64, 1)',
-  /** Standard smooth movement */
-  SMOOTH: 'ease-out',
-} as const;
+/**
+ * Common cubic-bezier easing strings for CSS transitions.
+ */
+export const Easings = {
+  /** Good for entrance animations (starts fast, slows down) */
+  EASE_OUT_EXPO: "cubic-bezier(0.16, 1, 0.3, 1)",
+  /** Good for elastic/bouncy UI elements */
+  ELASTIC_OUT: "cubic-bezier(0.34, 1.56, 0.64, 1)",
+  /** Standard smooth movement */
+  SMOOTH: "ease-out"
+} as const;

package/src/doctor.ts

@@ -1,49 +1,47 @@
-
-/**
- * Supermouse Doctor
- * A diagnostic utility to find common CSS conflicts that cause "Double Cursor" glitches.
- */
-export function doctor() {
-  console.group('🐭 Supermouse Doctor');
-
-  // 0. Check Initialization
-  // Supermouse injects a style tag with an ID starting with 'supermouse-style-'
-  const hasInitialized = Array.from(document.querySelectorAll('style')).some(s => s.id.startsWith('supermouse-style-'));
-  
-  if (!hasInitialized) {
-    console.warn('❌ Supermouse has not been initialized yet.');
-    console.warn('   Please call doctor() AFTER "new Supermouse()" has run.');
-    console.groupEnd();
-    return;
-  }
-
-  const issues: { el: Element, reason: string }[] = [];
-
-  // 1. Check for Inline Styles (Hard Overrides)
-  const inlineCursor = document.querySelectorAll('[style*="cursor"]');
-  inlineCursor.forEach(el => {
-    // Ignore the supermouse container itself (usually has cursor: none)
-    if (el.getAttribute('style')?.includes('cursor: none')) return;
-    
-    issues.push({ 
-      el, 
-      reason: 'Element has inline "cursor" style. Remove it and let Supermouse handle state.' 
-    });
-  });
-
-  // 2. Check Global Body State
-  if (document.body.style.cursor !== 'none') {
-    console.warn('[Global] document.body.style.cursor is not "none". Ensure { hideCursor: true } is passed to Supermouse.');
-  }
-
-  // 3. Report
-  if (issues.length > 0) {
-    console.warn(`Found ${issues.length} potential conflicts:`);
-    issues.forEach(i => console.warn(`[${i.reason}]`, i.el));
-    console.info('Tip: Avoid setting "cursor: pointer" manually. Use plugins or "rules" config instead.');
-  } else {
-    console.log('✅ No obvious inline-style conflicts found.');
-  }
-
-  console.groupEnd();
-}
+/**
+ * A diagnostic utility to find common CSS conflicts that cause cursor glitches.
+ */
+export function doctor() {
+  console.group("🐭 Supermouse Doctor");
+
+  const hasInitialized = Array.from(document.querySelectorAll("style")).some((s) =>
+    s.id.startsWith("supermouse-style-")
+  );
+
+  if (!hasInitialized) {
+    console.warn("[x] Supermouse has not been initialized yet.");
+    console.warn("   Please call doctor() after `new Supermouse()` has run.");
+    console.groupEnd();
+    return;
+  }
+
+  const issues: { el: Element; reason: string }[] = [];
+
+  const inlineCursor = document.querySelectorAll('[style*="cursor"]');
+  inlineCursor.forEach((el) => {
+    if (el.getAttribute("style")?.includes("cursor: none")) return;
+
+    issues.push({
+      el,
+      reason: 'Element has inline "cursor" style. Remove it and let Supermouse handle state.'
+    });
+  });
+
+  if (document.body.style.cursor !== "none") {
+    console.warn(
+      '[Global] document.body.style.cursor is not "none". Ensure { hideCursor: true } is passed to Supermouse.'
+    );
+  }
+
+  if (issues.length > 0) {
+    console.warn(`Found ${issues.length} potential conflicts:`);
+    issues.forEach((i) => console.warn(`[${i.reason}]`, i.el));
+    console.info(
+      'Tip: Avoid setting "cursor: pointer" manually. Use plugins or `rules` config instead.'
+    );
+  } else {
+    console.log("[ok] No obvious inline-style conflicts found.");
+  }
+
+  console.groupEnd();
+}