@supermousejs/magnetic 2.2.0 → 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @supermousejs/magnetic
2
2
 
3
- A **Logic Plugin** that attracts the cursor to interactive elements.
3
+ Attracts the cursor to interactive elements using physics-based magnetism.
4
4
 
5
5
  ## Installation
6
6
 
@@ -8,28 +8,25 @@ A **Logic Plugin** that attracts the cursor to interactive elements.
8
8
  pnpm add @supermousejs/magnetic
9
9
  ```
10
10
 
11
- ## Usage
11
+ ## Magnetic
12
+
13
+ Attracts the cursor to interactive elements using physics-based magnetism.
14
+
15
+ ### Usage
12
16
 
13
17
  ```ts
14
18
  import { Supermouse } from "@supermousejs/core";
15
19
  import { Magnetic } from "@supermousejs/magnetic";
16
-
17
20
  const app = new Supermouse();
18
-
19
- // Priority is handled automatically (-10)
20
- app.use(
21
- Magnetic({
22
- attraction: 0.3, // Strength (0-1)
23
- distance: 100 // Capture radius in px
24
- })
25
- );
21
+ app.use(Magnetic({ attraction: 0.4, distance: 100 }));
26
22
  ```
27
23
 
28
- **HTML:**
24
+ ### Options
29
25
 
30
- ```html
31
- <button data-supermouse-magnetic="true">Magnetic Button</button>
32
- ```
26
+ | Name | Type | Default | Description |
27
+ | --- | --- | --- | --- |
28
+ | attraction | number | 0.3 | Strength of the pull (0-1). |
29
+ | distance | number | 100 | Radius in pixels where attraction begins. |
33
30
 
34
31
  ## Documentation
35
32
 
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { SupermousePlugin } from '../../core/src';
2
- import { ValueOrGetter } from '../../core/src';
1
+ import { SupermousePlugin } from '../packages/core/src';
2
+ import { ValueOrGetter } from '../packages/core/src';
3
3
 
4
4
  export declare const Magnetic: (options?: MagneticOptions) => SupermousePlugin;
5
5
 
package/package.json CHANGED
@@ -1,20 +1,24 @@
1
1
  {
2
2
  "name": "@supermousejs/magnetic",
3
- "version": "2.2.0",
3
+ "version": "2.3.1",
4
4
  "main": "dist/index.umd.js",
5
5
  "module": "dist/index.mjs",
6
6
  "types": "dist/index.d.ts",
7
+ "files": [
8
+ "dist",
9
+ "README.md"
10
+ ],
7
11
  "author": "O.S David",
8
12
  "url": "https://github.com/Whitestar14/supermouse-js",
9
13
  "license": "MIT",
10
14
  "dependencies": {
11
- "@supermousejs/utils": "2.2.0"
15
+ "@supermousejs/utils": "2.3.1"
12
16
  },
13
17
  "devDependencies": {
14
- "@supermousejs/core": "2.1.0"
18
+ "@supermousejs/core": "2.3.0"
15
19
  },
16
20
  "peerDependencies": {
17
- "@supermousejs/core": "2.1.0"
21
+ "@supermousejs/core": "2.3.0"
18
22
  },
19
23
  "repository": {
20
24
  "type": "git",
package/CHANGELOG.md DELETED
@@ -1,82 +0,0 @@
1
- # @supermousejs/magnetic
2
-
3
- ## 2.2.0
4
-
5
- ### Patch Changes
6
-
7
- - 6d70c18: remove legacy package and update supermouse domain in readme
8
- - 14fb5b6: Updated tsconfig to be reference-compliant with core, utils and zoetrope when required
9
- - Updated dependencies [6d70c18]
10
- - Updated dependencies [2590af3]
11
- - Updated dependencies [14fb5b6]
12
- - Updated dependencies [9fe1a7b]
13
- - Updated dependencies [9fa6ece]
14
- - @supermousejs/core@2.1.0
15
- - @supermousejs/utils@2.2.0
16
-
17
- ## 2.1.1
18
-
19
- ### Patch Changes
20
-
21
- - 67f771b: Add relevant npm metadata to package.json file
22
- - Updated dependencies [67f771b]
23
- - @supermousejs/utils@2.1.1
24
- - @supermousejs/core@2.0.5
25
-
26
- ## 2.1.0
27
-
28
- ### Minor Changes
29
-
30
- - 0a1652d: fixed build architecture and updated plugin metadata
31
-
32
- ### Patch Changes
33
-
34
- - Updated dependencies [0a1652d]
35
- - @supermousejs/utils@2.1.0
36
-
37
- ## 2.0.4
38
-
39
- ### Patch Changes
40
-
41
- - 993dc67: Updated supemousejs packages with proper author, license and url descriptors to repo
42
- - Updated dependencies [993dc67]
43
- - @supermousejs/utils@2.0.4
44
- - @supermousejs/core@2.0.4
45
-
46
- ## 2.0.3
47
-
48
- ### Patch Changes
49
-
50
- - Updated dependencies
51
- - @supermousejs/core@2.0.3
52
- - @supermousejs/utils@2.0.3
53
-
54
- ## 2.0.2
55
-
56
- ### Patch Changes
57
-
58
- - ae219a0: Update READMEs with correct link to documentation
59
- - Updated dependencies [ae219a0]
60
- - @supermousejs/utils@2.0.2
61
- - @supermousejs/core@2.0.2
62
-
63
- ## 2.0.1
64
-
65
- ### Patch Changes
66
-
67
- - Add minimal README.md files to packages
68
- - Updated dependencies
69
- - @supermousejs/utils@2.0.1
70
- - @supermousejs/core@2.0.1
71
-
72
- ## 2.0.0
73
-
74
- ### Major Changes
75
-
76
- - Initial v2.0.0 release
77
-
78
- ### Patch Changes
79
-
80
- - Updated dependencies
81
- - @supermousejs/utils@2.0.0
82
- - @supermousejs/core@2.0.0
package/meta.json DELETED
@@ -1,25 +0,0 @@
1
- {
2
- "id": "magnetic",
3
- "name": "Magnetic",
4
- "package": "@supermousejs/magnetic",
5
- "description": "Attracts the cursor to interactive elements using physics-based magnetism.",
6
- "code": "app.use(Magnetic({ attraction: 0.4, distance: 100 }));",
7
- "recipeId": "magnetic-button",
8
- "icon": "magnetic",
9
- "options": [
10
- {
11
- "name": "attraction",
12
- "type": "number",
13
- "default": "0.3",
14
- "description": "Strength of the pull (0-1).",
15
- "reactive": true
16
- },
17
- {
18
- "name": "distance",
19
- "type": "number",
20
- "default": "100",
21
- "description": "Radius in pixels where attraction begins.",
22
- "reactive": true
23
- }
24
- ]
25
- }
package/src/index.ts DELETED
@@ -1,59 +0,0 @@
1
- import type { ValueOrGetter } from "@supermousejs/core";
2
- import { definePlugin, normalize, math, dom } from "@supermousejs/utils";
3
-
4
- export interface MagneticOptions {
5
- name?: string;
6
- isEnabled?: boolean;
7
- attraction?: ValueOrGetter<number>;
8
- distance?: ValueOrGetter<number>;
9
- }
10
-
11
- export const Magnetic = (options: MagneticOptions = {}) => {
12
- let lastTarget: HTMLElement | null = null;
13
- const magnetCenter = { x: 0, y: 0 };
14
- let isActive = false;
15
-
16
- const getAttraction = normalize(options.attraction, 0.3);
17
- const getDistance = normalize(options.distance, 100);
18
-
19
- return definePlugin(
20
- {
21
- name: "magnetic",
22
- priority: -10,
23
-
24
- install(app) {
25
- app.registerHoverTarget("[data-supermouse-magnetic]");
26
- },
27
-
28
- update(app) {
29
- const target = app.state.hoverTarget;
30
- const val = app.state.interaction.magnetic;
31
- const isMagnetic = val === true || val === "true" || (typeof val === "number" && val > 0);
32
-
33
- if (isMagnetic && target !== lastTarget) {
34
- lastTarget = target!;
35
- const rect = dom.projectRect(target!, app.container);
36
- magnetCenter.x = rect.left + rect.width / 2;
37
- magnetCenter.y = rect.top + rect.height / 2;
38
- isActive = true;
39
- } else if (!isMagnetic && lastTarget) {
40
- lastTarget = null;
41
- isActive = false;
42
- }
43
-
44
- if (isActive && lastTarget) {
45
- const { x, y } = app.state.pointer;
46
- const dist = math.dist(x, y, magnetCenter.x, magnetCenter.y);
47
- const range = getDistance(app.state);
48
-
49
- if (dist < range) {
50
- const attraction = typeof val === "number" ? val : getAttraction(app.state);
51
- app.state.target.x = math.lerp(x, magnetCenter.x, attraction);
52
- app.state.target.y = math.lerp(y, magnetCenter.y, attraction);
53
- }
54
- }
55
- }
56
- },
57
- options
58
- );
59
- };
package/tsconfig.json DELETED
@@ -1,4 +0,0 @@
1
- {
2
- "extends": "../../tsconfig.plugin.json",
3
- "include": ["src"]
4
- }
package/vite.config.ts DELETED
@@ -1,23 +0,0 @@
1
- import { defineConfig } from "vite";
2
- import dts from "vite-plugin-dts";
3
- import path from "path";
4
-
5
- export default defineConfig({
6
- build: {
7
- lib: {
8
- entry: path.resolve(__dirname, "src/index.ts"),
9
- name: "SupermouseMagnetic",
10
- fileName: (format) => (format === "es" ? "index.mjs" : "index.umd.js")
11
- },
12
- rollupOptions: {
13
- external: ["@supermousejs/core", "@supermousejs/utils"],
14
- output: {
15
- globals: {
16
- "@supermousejs/core": "SupermouseCore",
17
- "@supermousejs/utils": "SupermouseUtils"
18
- }
19
- }
20
- }
21
- },
22
- plugins: [dts({ rollupTypes: true })]
23
- });