@supermousejs/vue 2.3.1 → 2.4.0

package/README.md

@@ -10,27 +10,44 @@ pnpm add @supermousejs/vue @supermousejs/core
 
 ## Usage
 
-**In `App.vue` (Root):**
+In `App.vue`/root file:
 
 ```vue
 <script setup>
 import { provideSupermouse } from "@supermousejs/vue";
 import { Dot } from "@supermousejs/dot";
 
-provideSupermouse({ smoothness: 0.15 }, [Dot({ size: 8 })]);
+const { instance, isEnabled } = provideSupermouse({ smoothness: 0.15 }, [Dot({ size: 8 })]);
 </script>
 ```
 
-**In Components:**
+And in your components:
 
 ```vue
 <script setup>
 import { useSupermouse } from "@supermousejs/vue";
 
-const mouse = useSupermouse(); // Returns Ref<Supermouse | null>
+const { instance, isEnabled } = useSupermouse();
+
+function toggleCursor() {
+  if (instance.value) {
+    if (isEnabled.value) instance.value.disable();
+    else instance.value.enable();
+  }
+}
 </script>
+
+<template>
+  <button @click="toggleCursor">{{ isEnabled ? "Disable" : "Enable" }} Cursor</button>
+</template>
 ```
 
+`provideSupermouse()` and `useSupermouse()` both return:
+
+- `instance`: A `Ref<SupermouseInstance | null>`.
+- `isEnabled`: A `Ref<boolean>` that stays in sync with `enable()` / `disable()`.
+
 ## Documentation
 
-Full documentation and interactive playground available at [supermouse](https://supermouse.js.org) or [check out the repo](https://github.com/Whitestar14/supermouse-js).
+Full documentation and interactive playground: [supermouse.js.org](https://supermouse.js.org)
+Repository: [github.com/Whitestar14/supermouse-js](https://github.com/Whitestar14/supermouse-js)

package/dist/index.mjs

@@ -1,24 +1,37 @@
-import { shallowRef as u, onMounted as i, onUnmounted as l, provide as p, inject as m } from "vue";
-import { Supermouse as a } from "@supermousejs/core";
-const r = /* @__PURE__ */ Symbol("Supermouse");
-function f(o = {}, s = []) {
-  const e = u(null);
-  return i(() => {
-    if (e.value) return;
-    const n = new a(o);
-    s.forEach((t) => n.use(t)), e.value = n;
-  }), l(() => {
-    e.value && (e.value.destroy(), e.value = null);
-  }), p(r, e), e;
+import { shallowRef as s, ref as t, onMounted as m, onUnmounted as d, provide as f, inject as v } from "vue";
+import { Supermouse as b } from "@supermousejs/core";
+import { Supermouse as h } from "@supermousejs/core";
+const l = /* @__PURE__ */ Symbol("Supermouse");
+function x(o = {}, a = []) {
+  const n = s(null), u = t(!0);
+  m(() => {
+    if (n.value) return;
+    const e = new b(o);
+    a.forEach((p) => e.use(p));
+    const i = e.enable.bind(e), c = e.disable.bind(e);
+    e.enable = () => {
+      i(), u.value = !0;
+    }, e.disable = () => {
+      c(), u.value = !1;
+    }, n.value = e;
+  }), d(() => {
+    n.value && (n.value.destroy(), n.value = null, u.value = !0);
+  });
+  const r = { instance: n, isEnabled: u };
+  return f(l, r), r;
 }
-function v() {
-  const o = m(r);
+function w() {
+  const o = v(l);
   return o || (console.warn(
     "[Supermouse] No instance provided. Ensure provideSupermouse() is called in a parent component."
-  ), u(null));
+  ), {
+    instance: s(null),
+    isEnabled: t(!0)
+  });
 }
 export {
-  r as SupermouseKey,
-  f as provideSupermouse,
-  v as useSupermouse
+  h as Supermouse,
+  l as SupermouseKey,
+  x as provideSupermouse,
+  w as useSupermouse
 };

package/dist/index.umd.js

@@ -1 +1 @@
-(function(e,u){typeof exports=="object"&&typeof module<"u"?u(exports,require("vue"),require("@supermousejs/core")):typeof define=="function"&&define.amd?define(["exports","vue","@supermousejs/core"],u):(e=typeof globalThis<"u"?globalThis:e||self,u(e.SupermouseVue={},e.Vue,e.SupermouseCore))})(this,(function(e,u,i){"use strict";const r=Symbol("Supermouse");function t(n={},d=[]){const o=u.shallowRef(null);return u.onMounted(()=>{if(o.value)return;const s=new i.Supermouse(n);d.forEach(m=>s.use(m)),o.value=s}),u.onUnmounted(()=>{o.value&&(o.value.destroy(),o.value=null)}),u.provide(r,o),o}function p(){const n=u.inject(r);return n||(console.warn("[Supermouse] No instance provided. Ensure provideSupermouse() is called in a parent component."),u.shallowRef(null))}e.SupermouseKey=r,e.provideSupermouse=t,e.useSupermouse=p,Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})}));
+(function(u,e){typeof exports=="object"&&typeof module<"u"?e(exports,require("vue"),require("@supermousejs/core")):typeof define=="function"&&define.amd?define(["exports","vue","@supermousejs/core"],e):(u=typeof globalThis<"u"?globalThis:u||self,e(u.SupermouseVue={},u.Vue,u.SupermouseCore))})(this,(function(u,e,i){"use strict";const t=Symbol("Supermouse");function d(r={},a=[]){const o=e.shallowRef(null),s=e.ref(!0);e.onMounted(()=>{if(o.value)return;const n=new i.Supermouse(r);a.forEach(m=>n.use(m));const c=n.enable.bind(n),f=n.disable.bind(n);n.enable=()=>{c(),s.value=!0},n.disable=()=>{f(),s.value=!1},o.value=n}),e.onUnmounted(()=>{o.value&&(o.value.destroy(),o.value=null,s.value=!0)});const l={instance:o,isEnabled:s};return e.provide(t,l),l}function p(){const r=e.inject(t);return r||(console.warn("[Supermouse] No instance provided. Ensure provideSupermouse() is called in a parent component."),{instance:e.shallowRef(null),isEnabled:e.ref(!0)})}Object.defineProperty(u,"Supermouse",{enumerable:!0,get:()=>i.Supermouse}),u.SupermouseKey=t,u.provideSupermouse=d,u.useSupermouse=p,Object.defineProperty(u,Symbol.toStringTag,{value:"Module"})}));

package/dist/vue/src/index.d.ts

@@ -1,19 +1,23 @@
 import { Ref, InjectionKey } from 'vue';
-import { Supermouse, SupermouseOptions, SupermousePlugin } from '../packages/core/src';
-export declare const SupermouseKey: InjectionKey<Ref<Supermouse | null>>;
+import { SupermouseOptions, SupermousePlugin, SupermouseInstance } from '../packages/core/src';
+export interface SupermouseContext {
+    instance: Ref<SupermouseInstance | null>;
+    isEnabled: Ref<boolean>;
+}
+export declare const SupermouseKey: InjectionKey<SupermouseContext>;
 /**
  * Initializes a Supermouse instance, handles its lifecycle, and provides it to the component tree.
- * Use this in your root component (e.g., App.vue).
+ * Also exposes a reactive `isEnabled` ref that stays in sync with the instance's enable/disable state.
  *
  * @param options Core configuration options
  * @param plugins Array of plugins to install immediately
  */
-export declare function provideSupermouse(options?: SupermouseOptions, plugins?: SupermousePlugin[]): Ref<Supermouse | null>;
+export declare function provideSupermouse(options?: SupermouseOptions, plugins?: SupermousePlugin[]): SupermouseContext;
 /**
- * Injects the global Supermouse instance from a parent component.
- * @returns A Ref containing the Supermouse instance or null if not provided.
- * @warn Make sure to call provideSupermouse() in a parent component, otherwise this will return null.
+ * Injects the global Supermouse context (instance + reactive isEnabled).
+ * @returns The context, or a default empty context if not provided.
  */
-export declare function useSupermouse(): Ref<Supermouse | null>;
-export type { Supermouse };
+export declare function useSupermouse(): SupermouseContext;
+export { Supermouse } from '../packages/core/src';
+export type { SupermouseInstance, SupermouseOptions, SupermousePlugin } from '../packages/core/src';
 //# sourceMappingURL=index.d.ts.map

package/dist/vue/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,GAAG,EACR,KAAK,YAAY,EAClB,MAAM,KAAK,CAAC;AACb,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE/F,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAAwB,CAAC;AAExF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,iBAAsB,EAC/B,OAAO,GAAE,gBAAgB,EAAO,GAC/B,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAqBxB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAStD;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,GAAG,EACR,KAAK,YAAY,EAClB,MAAM,KAAK,CAAC;AAEb,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAElG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACzC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,iBAAiB,CAAwB,CAAC;AAEnF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,iBAAsB,EAC/B,OAAO,GAAE,gBAAgB,EAAO,GAC/B,iBAAiB,CAsCnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,iBAAiB,CAYjD;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@supermousejs/vue",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "main": "dist/index.umd.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "description": "Vue 3 integration for Supermouse",
   "files": [
     "dist",
     "README.md"
@@ -13,11 +14,11 @@
   "license": "MIT",
   "peerDependencies": {
     "vue": "^3.2.0",
-    "@supermousejs/core": "2.3.0"
+    "@supermousejs/core": "2.4.0"
   },
   "devDependencies": {
     "vue": "^3.2.0",
-    "@supermousejs/core": "2.3.0"
+    "@supermousejs/core": "2.4.0"
   },
   "repository": {
     "type": "git",