@supermousejs/trail 2.1.1 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @supermousejs/trail
 
+## 2.3.0
+
+### Patch Changes
+
+- Updated dependencies [f6f44b2]
+  - @supermousejs/core@2.2.0
+  - @supermousejs/utils@2.3.0
+
+## 2.2.1
+
+### Patch Changes
+
+- a72f5a3: bugfix: fixed a type declaration issue from missing `return` keyword with the Trail package export
+
+## 2.2.0
+
+### Patch Changes
+
+- 6d70c18: remove legacy package and update supermouse domain in readme
+- 14fb5b6: Updated tsconfig to be reference-compliant with core, utils and zoetrope when required
+- Updated dependencies [6d70c18]
+- Updated dependencies [2590af3]
+- Updated dependencies [14fb5b6]
+- Updated dependencies [9fe1a7b]
+- Updated dependencies [9fa6ece]
+  - @supermousejs/core@2.1.0
+  - @supermousejs/utils@2.2.0
+
 ## 2.1.1
 
 ### Patch Changes

package/LICENSE.md

@@ -1,21 +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.
+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

@@ -1,28 +1,30 @@
-# @supermousejs/trail
-
-Generates a procedural particle trail that follows the cursor.
-
-## Installation
-
-```bash
-pnpm add @supermousejs/trail
-```
-
-## Usage
-
-```ts
-import { Supermouse } from '@supermousejs/core';
-import { Trail } from '@supermousejs/trail';
-
-const app = new Supermouse();
-
-app.use(Trail({
-  length: 10,      // Number of segments
-  size: 6,         // Particle size
-  color: '#ff00ff'
-}));
-```
-
-## Documentation
-
-Full documentation and interactive playground available at [supermouse](https://supermouse.vercel.app) or [check out the repo](https://github.com/Whitestar14/supermouse-js).
+# @supermousejs/trail
+
+Generates a procedural particle trail that follows the cursor.
+
+## Installation
+
+```bash
+pnpm add @supermousejs/trail
+```
+
+## Usage
+
+```ts
+import { Supermouse } from "@supermousejs/core";
+import { Trail } from "@supermousejs/trail";
+
+const app = new Supermouse();
+
+app.use(
+  Trail({
+    length: 10, // Number of segments
+    size: 6, // Particle size
+    color: "#ff00ff"
+  })
+);
+```
+
+## Documentation
+
+Full documentation and interactive playground available at [supermouse](https://supermouse.js.org) or [check out the repo](https://github.com/Whitestar14/supermouse-js).

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { SupermousePlugin } from '../../core/src/index.ts';
-import { ValueOrGetter } from '../../core/src/index.ts';
+import { SupermousePlugin } from '../packages/core/src';
+import { ValueOrGetter } from '../packages/core/src';
 
 export declare const Trail: (options?: TrailOptions) => SupermousePlugin;
 

package/dist/index.mjs

@@ -1,27 +1,31 @@
 import { normalize as d, definePlugin as p, dom as o, Layers as z } from "@supermousejs/utils";
 const C = (s = {}) => {
-  const l = s.length || 10, f = d(s.size, 6), m = d(s.color, "#ff00ff"), a = [], r = [];
-  return p({
-    name: s.name || "trail",
-    create: () => {
-      const t = o.createActor("div");
-      t.style.zIndex = z.TRACE;
-      for (let n = 0; n < l; n++) {
-        const e = o.createCircle(0, "#000");
-        e.style.position = "absolute", e.style.opacity = String(1 - n / l), t.appendChild(e), a.push(e), r.push({ x: -100, y: -100 });
+  const l = s.length || 10, f = d(s.size, 6), m = d(s.color, "#ff00ff"), a = [], n = [];
+  return p(
+    {
+      name: s.name || "trail",
+      create: () => {
+        a.length = 0, n.length = 0;
+        const t = o.createActor("div");
+        t.style.zIndex = z.TRACE;
+        for (let r = 0; r < l; r++) {
+          const e = o.createCircle(0, "#000");
+          e.style.position = "absolute", e.style.opacity = String(1 - r / l), t.appendChild(e), a.push(e), n.push({ x: -100, y: -100 });
+        }
+        return t;
+      },
+      update: (t) => {
+        const { x: r, y: e } = t.state.smooth;
+        n.pop(), n.unshift({ x: r, y: e });
+        const u = f(t.state), g = m(t.state);
+        a.forEach((c, i) => {
+          const h = n[i], x = 1 - i / l, y = u * x;
+          o.setStyle(c, "width", `${y}px`), o.setStyle(c, "height", `${y}px`), o.setStyle(c, "backgroundColor", g), o.setTransform(c, h.x, h.y);
+        });
       }
-      return t;
     },
-    update: (t) => {
-      const { x: n, y: e } = t.state.smooth;
-      r.pop(), r.unshift({ x: n, y: e });
-      const u = f(t.state), x = m(t.state);
-      a.forEach((c, i) => {
-        const h = r[i], g = 1 - i / l, y = u * g;
-        o.setStyle(c, "width", `${y}px`), o.setStyle(c, "height", `${y}px`), o.setStyle(c, "backgroundColor", x), o.setTransform(c, h.x, h.y);
-      });
-    }
-  }, s);
+    s
+  );
 };
 export {
   C as Trail

package/dist/index.umd.js

@@ -1 +1 @@
-(function(t,e){typeof exports=="object"&&typeof module<"u"?e(exports,require("@supermousejs/utils")):typeof define=="function"&&define.amd?define(["exports","@supermousejs/utils"],e):(t=typeof globalThis<"u"?globalThis:t||self,e(t.SupermouseTrail={},t.SupermouseUtils))})(this,(function(t,e){"use strict";const u=(s={})=>{const d=s.length||10,y=e.normalize(s.size,6),h=e.normalize(s.color,"#ff00ff"),a=[],c=[];return e.definePlugin({name:s.name||"trail",create:()=>{const o=e.dom.createActor("div");o.style.zIndex=e.Layers.TRACE;for(let r=0;r<d;r++){const n=e.dom.createCircle(0,"#000");n.style.position="absolute",n.style.opacity=String(1-r/d),o.appendChild(n),a.push(n),c.push({x:-100,y:-100})}return o},update:o=>{const{x:r,y:n}=o.state.smooth;c.pop(),c.unshift({x:r,y:n});const p=y(o.state),S=h(o.state);a.forEach((i,f)=>{const l=c[f],x=1-f/d,m=p*x;e.dom.setStyle(i,"width",`${m}px`),e.dom.setStyle(i,"height",`${m}px`),e.dom.setStyle(i,"backgroundColor",S),e.dom.setTransform(i,l.x,l.y)})}},s)};t.Trail=u,Object.defineProperty(t,Symbol.toStringTag,{value:"Module"})}));
+(function(t,e){typeof exports=="object"&&typeof module<"u"?e(exports,require("@supermousejs/utils")):typeof define=="function"&&define.amd?define(["exports","@supermousejs/utils"],e):(t=typeof globalThis<"u"?globalThis:t||self,e(t.SupermouseTrail={},t.SupermouseUtils))})(this,(function(t,e){"use strict";const u=(s={})=>{const d=s.length||10,h=e.normalize(s.size,6),y=e.normalize(s.color,"#ff00ff"),a=[],r=[];return e.definePlugin({name:s.name||"trail",create:()=>{a.length=0,r.length=0;const o=e.dom.createActor("div");o.style.zIndex=e.Layers.TRACE;for(let c=0;c<d;c++){const n=e.dom.createCircle(0,"#000");n.style.position="absolute",n.style.opacity=String(1-c/d),o.appendChild(n),a.push(n),r.push({x:-100,y:-100})}return o},update:o=>{const{x:c,y:n}=o.state.smooth;r.pop(),r.unshift({x:c,y:n});const p=h(o.state),S=y(o.state);a.forEach((i,l)=>{const f=r[l],g=1-l/d,m=p*g;e.dom.setStyle(i,"width",`${m}px`),e.dom.setStyle(i,"height",`${m}px`),e.dom.setStyle(i,"backgroundColor",S),e.dom.setTransform(i,f.x,f.y)})}},s)};t.Trail=u,Object.defineProperty(t,Symbol.toStringTag,{value:"Module"})}));

package/meta.json

@@ -1,15 +1,32 @@
-
-{
-  "id": "trail",
-  "name": "Trail",
-  "package": "@supermousejs/trail",
-  "description": "Generates procedural particles that trail behind your motion.",
-  "code": "app.use(Trail({ length: 12, color: '#f0f' }));",
-  "recipeId": "ghost-trail",
-  "icon": "trail",
-  "options": [
-    { "name": "length", "type": "number", "default": "10", "description": "Number of trail segments.", "reactive": false },
-    { "name": "size", "type": "number", "default": "6", "description": "Size of trail particles.", "reactive": true },
-    { "name": "color", "type": "string", "default": "'#ff00ff'", "description": "Color of segments.", "reactive": true }
-  ]
-}
+{
+  "id": "trail",
+  "name": "Trail",
+  "package": "@supermousejs/trail",
+  "description": "Generates procedural particles that trail behind your motion.",
+  "code": "app.use(Trail({ length: 12, color: '#f0f' }));",
+  "recipeId": "ghost-trail",
+  "icon": "trail",
+  "options": [
+    {
+      "name": "length",
+      "type": "number",
+      "default": "10",
+      "description": "Number of trail segments.",
+      "reactive": false
+    },
+    {
+      "name": "size",
+      "type": "number",
+      "default": "6",
+      "description": "Size of trail particles.",
+      "reactive": true
+    },
+    {
+      "name": "color",
+      "type": "string",
+      "default": "'#ff00ff'",
+      "description": "Color of segments.",
+      "reactive": true
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supermousejs/trail",
-  "version": "2.1.1",
+  "version": "2.3.0",
   "main": "dist/index.umd.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -8,13 +8,13 @@
   "url": "https://github.com/Whitestar14/supermouse-js",
   "license": "MIT",
   "dependencies": {
-    "@supermousejs/utils": "2.1.1"
+    "@supermousejs/utils": "2.3.0"
   },
   "devDependencies": {
-    "@supermousejs/core": "2.0.5"
+    "@supermousejs/core": "2.2.0"
   },
   "peerDependencies": {
-    "@supermousejs/core": "2.0.5"
+    "@supermousejs/core": "2.2.0"
   },
   "repository": {
     "type": "git",

package/src/index.ts

@@ -1,61 +1,66 @@
-import type { ValueOrGetter } from '@supermousejs/core';
-import { definePlugin, normalize, dom, Layers } from '@supermousejs/utils';
-
-export interface TrailOptions {
-  name?: string;
-  isEnabled?: boolean;
-  length?: number;
-  size?: ValueOrGetter<number>;
-  color?: ValueOrGetter<string>;
-}
-
-export const Trail = (options: TrailOptions = {}) => {
-  const length = options.length || 10;
-  const getSize = normalize(options.size, 6);
-  const getColor = normalize(options.color, '#ff00ff');
-  
-  const segments: HTMLDivElement[] = [];
-  const history: { x: number, y: number }[] = [];
-
-  return definePlugin<HTMLDivElement, TrailOptions>({
-    name: options.name || 'trail',
-    
-    create: () => {
-      const container = dom.createActor('div') as HTMLDivElement;
-      container.style.zIndex = Layers.TRACE;
-      
-      for(let i=0; i<length; i++) {
-        const d = dom.createCircle(0, '#000');
-        d.style.position = 'absolute';
-        d.style.opacity = String(1 - (i / length));
-        container.appendChild(d);
-        segments.push(d);
-        history.push({ x: -100, y: -100 });
-      }
-      return container;
-    },
-
-    update: (app) => {
-      const { x, y } = app.state.smooth;
-      
-      // Shift history
-      history.pop();
-      history.unshift({ x, y });
-      
-      const baseSize = getSize(app.state);
-      const color = getColor(app.state);
-
-      segments.forEach((seg, i) => {
-        const pos = history[i];
-        const scale = 1 - (i / length);
-        const size = baseSize * scale;
-        
-        dom.setStyle(seg, 'width', `${size}px`);
-        dom.setStyle(seg, 'height', `${size}px`);
-        dom.setStyle(seg, 'backgroundColor', color);
-        
-        dom.setTransform(seg, pos.x, pos.y);
-      });
-    }
-  }, options);
-};
+import type { ValueOrGetter, Supermouse } from "@supermousejs/core";
+import { definePlugin, normalize, dom, Layers } from "@supermousejs/utils";
+
+export interface TrailOptions {
+  name?: string;
+  isEnabled?: boolean;
+  length?: number;
+  size?: ValueOrGetter<number>;
+  color?: ValueOrGetter<string>;
+}
+
+export const Trail = (options: TrailOptions = {}) => {
+  const length = options.length || 10;
+  const getSize = normalize(options.size, 6);
+  const getColor = normalize(options.color, "#ff00ff");
+
+  const segments: HTMLDivElement[] = [];
+  const history: { x: number; y: number }[] = [];
+
+  return definePlugin<HTMLDivElement, TrailOptions>(
+    {
+      name: options.name || "trail",
+
+      create: () => {
+        segments.length = 0;
+        history.length = 0;
+        const container = dom.createActor("div") as HTMLDivElement;
+        container.style.zIndex = Layers.TRACE;
+
+        for (let i = 0; i < length; i++) {
+          const d = dom.createCircle(0, "#000");
+          d.style.position = "absolute";
+          d.style.opacity = String(1 - i / length);
+          container.appendChild(d);
+          segments.push(d);
+          history.push({ x: -100, y: -100 });
+        }
+        return container;
+      },
+
+      update: (app: Supermouse) => {
+        const { x, y } = app.state.smooth;
+
+        // Shift history
+        history.pop();
+        history.unshift({ x, y });
+
+        const baseSize = getSize(app.state);
+        const color = getColor(app.state);
+
+        segments.forEach((seg, i) => {
+          const pos = history[i];
+          const scale = 1 - i / length;
+          const size = baseSize * scale;
+
+          dom.setStyle(seg, "width", `${size}px`);
+          dom.setStyle(seg, "height", `${size}px`);
+          dom.setStyle(seg, "backgroundColor", color);
+
+          dom.setTransform(seg, pos.x, pos.y);
+        });
+      }
+    },
+    options
+  );
+};

package/tsconfig.json

@@ -1,18 +1,4 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "include": [
-    "src"
-  ],
-  "compilerOptions": {
-    "outDir": "dist",
-    "baseUrl": ".",
-    "paths": {
-      "@supermousejs/core": [
-        "../core/src/index.ts"
-      ],
-      "@supermousejs/utils": [
-        "../utils/src/index.ts"
-      ]
-    }
-  }
-}
+{
+  "extends": "../../tsconfig.plugin.json",
+  "include": ["src"]
+}

package/vite.config.ts

@@ -1,22 +1,23 @@
-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: 'SupermouseTrail',
-      fileName: (format) => format === 'es' ? 'index.mjs' : 'index.umd.js',
-    },
-    rollupOptions: {
-      external: ['@supermousejs/core', '@supermousejs/utils'],
-      output: {
-        globals: {
-          '@supermousejs/core': 'SupermouseCore'
-        , '@supermousejs/utils': 'SupermouseUtils'}
-      }
-    }
-  },
-  plugins: [dts({ rollupTypes: true })]
-});
+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: "SupermouseTrail",
+      fileName: (format) => (format === "es" ? "index.mjs" : "index.umd.js")
+    },
+    rollupOptions: {
+      external: ["@supermousejs/core", "@supermousejs/utils"],
+      output: {
+        globals: {
+          "@supermousejs/core": "SupermouseCore",
+          "@supermousejs/utils": "SupermouseUtils"
+        }
+      }
+    }
+  },
+  plugins: [dts({ rollupTypes: true })]
+});