@tsparticles/preset-firefly 3.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Matteo Bruni
+
+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,211 @@
+[![banner](https://particles.js.org/images/banner3.png)](https://particles.js.org)
+
+# tsParticles Firefly Preset
+
+[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/@tsparticles/preset-firefly/badge)](https://www.jsdelivr.com/package/npm/@tsparticles/preset-firefly) [![npmjs](https://badge.fury.io/js/@tsparticles/preset-firefly.svg)](https://www.npmjs.com/package/@tsparticles/preset-firefly) [![npmjs](https://img.shields.io/npm/dt/@tsparticles/preset-firefly)](https://www.npmjs.com/package/@tsparticles/preset-firefly) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
+
+[tsParticles](https://github.com/matteobruni/tsparticles) preset for a mouse trail made with small fading particles like
+little fireflies.
+
+[![Slack](https://particles.js.org/images/slack.png)](https://join.slack.com/t/tsparticles/shared_invite/enQtOTcxNTQxNjQ4NzkxLWE2MTZhZWExMWRmOWI5MTMxNjczOGE1Yjk0MjViYjdkYTUzODM3OTc5MGQ5MjFlODc4MzE0N2Q1OWQxZDc1YzI) [![Discord](https://particles.js.org/images/discord.png)](https://discord.gg/hACwv45Hme) [![Telegram](https://particles.js.org/images/telegram.png)](https://t.me/tsparticles)
+
+[![tsParticles Product Hunt](https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=186113&theme=light)](https://www.producthunt.com/posts/tsparticles?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-tsparticles") <a href="https://www.buymeacoffee.com/matteobruni"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a beer&emoji=🍺&slug=matteobruni&button_colour=5F7FFF&font_colour=ffffff&font_family=Arial&outline_colour=000000&coffee_colour=FFDD00"></a>
+
+## Sample
+
+[![demo](https://raw.githubusercontent.com/matteobruni/tsparticles/main/presets/firefly/images/sample.png)](https://particles.js.org/samples/presets/firefly)
+
+## How to use it
+
+### CDN / Vanilla JS / jQuery
+
+The first step is installing [tsParticles](https://github.com/matteobruni/tsparticles) following the instructions for
+vanilla javascript in the main project [here](https://github.com/matteobruni/tsparticles)
+
+Once installed you need one more script to be included in your page (or you can download that
+from [jsDelivr](https://www.jsdelivr.com/package/npm/@tsparticles/preset-firefly):
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/tsparticles-engine@2/tsparticles.engine.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/tsparticles-interaction-external-trail@2/tsparticles.interaction.external.trail.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/tsparticles-move-base@2/tsparticles.move.base.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/tsparticles-plugin-emitters@2/tsparticles.plugin.emitters.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/tsparticles-shape-circle@2/tsparticles.shape.circle.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/tsparticles-updater-color@2/tsparticles.updater.color.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/tsparticles-updater-life@2/tsparticles.updater.life.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/tsparticles-updater-opacity@2/tsparticles.updater.opacity.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/tsparticles-updater-size@2/tsparticles.updater.size.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@tsparticles/preset-firefly@2/tsparticles.preset.firefly.min.js"></script>
+```
+
+This script **MUST** be placed after the `tsParticles` one.
+
+#### Bundle
+
+A bundled script can also be used, this will include every needed plugin needed by the preset.
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/@tsparticles/preset-firefly@2/tsparticles.preset.firefly.bundle.min.js"></script>
+```
+
+### Usage
+
+Once the scripts are loaded you can set up `tsParticles` like this:
+
+```javascript
+(async () => {
+  await loadFireflyPreset(tsParticles); // this is required only if you are not using the bundle script
+
+  await tsParticles.load("tsparticles", {
+    preset: "firefly",
+  });
+})();
+```
+
+#### Customization
+
+**Important ⚠️**
+You can override all the options defining the properties like in any standard `tsParticles` installation.
+
+```javascript
+tsParticles.load("tsparticles", {
+  particles: {
+    shape: {
+      type: "square", // starting from v2, this require the square shape script
+    },
+  },
+  preset: "firefly",
+});
+```
+
+Like in the sample above, the circles will be replaced by squares.
+
+### React.js / Preact / react-particles
+
+_The syntax for `React.js`, `Preact` and `@tsparticles/react` is the same_.
+
+This sample uses the class component syntax, but you can use hooks as well (if the library supports it).
+
+```typescript jsx
+import Particles from "react-particles";
+import type { Engine } from "tsparticles-engine";
+import { loadFireflyPreset } from "@tsparticles/preset-firefly";
+
+export class ParticlesContainer extends React.PureComponent<IProps> {
+  // this customizes the component tsParticles installation
+  async customInit(engine: Engine): Promise<void> {
+    // this adds the preset to tsParticles, you can safely use the
+    await loadFireflyPreset(engine);
+  }
+
+  render() {
+    const options = {
+      preset: "firefly",
+    };
+
+    return <Particles options={options} init={this.customInit} />;
+  }
+}
+```
+
+### Vue (2.x and 3.x)
+
+_The syntax for `Vue.js 2.x` and `3.x` is the same_
+
+```vue
+<Particles id="tsparticles" :particlesInit="particlesInit" :options="particlesOptions" />
+```
+
+```ts
+let particlesOptions = {
+  preset: "firefly",
+};
+
+async function particlesInit(engine: Engine): Promise<void> {
+  await loadFireflyPreset(engine);
+}
+```
+
+### Angular
+
+```html
+<angular-particles [id]="id" [options]="particlesOptions" [particlesInit]="particlesInit"></angular-particles>
+```
+
+```ts
+const particlesOptions = {
+  preset: "firefly",
+};
+
+async function particlesInit(engine: Engine): Promise<void> {
+  await loadFireflyPreset(engine);
+}
+```
+
+### Svelte
+
+```sveltehtml
+
+<Particles
+        id="tsparticles"
+        options={particlesOptions}
+        particlesInit="{particlesInit}"
+/>
+```
+
+```js
+let particlesOptions = {
+  preset: "firefly",
+};
+
+let particlesInit = async (engine) => {
+  await loadFireflyPreset(main);
+};
+```
+
+---
+
+```mermaid
+flowchart TD
+
+subgraph i [Interactions]
+
+subgraph ie [Externals]
+iet[Trail]
+end
+
+end
+
+i --> ie
+
+e[tsParticles Engine] --> i
+
+subgraph m [Movers]
+mb[Base]
+end
+
+e --> m
+
+subgraph s [Shapes]
+sc[Circle]
+end
+
+e --> s
+
+subgraph u [Updaters]
+uc[Color]
+uop[Opacity]
+uou[Out Modes]
+usi[Size]
+end
+
+e --> u
+
+subgraph pr [Presets]
+prff[Firefly]
+end
+
+e --> pr
+
+iet & mb & sc & uc & uop & uou & usi --> prff
+```

package/browser/bundle.js

@@ -0,0 +1,6 @@
+import { loadFireflyPreset } from ".";
+import { tsParticles } from "@tsparticles/engine";
+(async () => {
+    await loadFireflyPreset(tsParticles);
+})();
+export { loadFireflyPreset, tsParticles };

package/browser/index.js

@@ -0,0 +1,18 @@
+import { loadBaseMover } from "@tsparticles/move-base";
+import { loadCircleShape } from "@tsparticles/shape-circle";
+import { loadColorUpdater } from "@tsparticles/updater-color";
+import { loadExternalTrailInteraction } from "@tsparticles/interaction-external-trail";
+import { loadLifeUpdater } from "@tsparticles/updater-life";
+import { loadOpacityUpdater } from "@tsparticles/updater-opacity";
+import { loadSizeUpdater } from "@tsparticles/updater-size";
+import { options } from "./options";
+export async function loadFireflyPreset(engine) {
+    await loadBaseMover(engine);
+    await loadExternalTrailInteraction(engine);
+    await loadCircleShape(engine);
+    await loadColorUpdater(engine);
+    await loadLifeUpdater(engine);
+    await loadOpacityUpdater(engine);
+    await loadSizeUpdater(engine);
+    await engine.addPreset("firefly", options);
+}

package/browser/options.js

@@ -0,0 +1,60 @@
+export const options = {
+    fullScreen: {
+        enable: true,
+        zIndex: -1,
+    },
+    fpsLimit: 120,
+    particles: {
+        number: {
+            value: 0,
+        },
+        color: {
+            value: "#fff",
+        },
+        life: {
+            duration: {
+                value: 5,
+                sync: false,
+            },
+            count: 1,
+        },
+        opacity: {
+            value: { min: 0.1, max: 1 },
+            animation: {
+                enable: true,
+                speed: 3,
+            },
+        },
+        size: {
+            value: {
+                min: 3,
+                max: 6,
+            },
+        },
+        move: {
+            enable: true,
+            speed: 3,
+            random: false,
+            size: true,
+        },
+    },
+    interactivity: {
+        events: {
+            onHover: {
+                enable: true,
+                mode: "trail",
+            },
+            resize: true,
+        },
+        modes: {
+            trail: {
+                delay: 0.5,
+                pauseOnStop: true,
+                quantity: 4,
+            },
+        },
+    },
+    background: {
+        color: "#000",
+    },
+};

package/cjs/bundle.js

@@ -0,0 +1,19 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tsParticles = exports.loadFireflyPreset = void 0;
+const _1 = require(".");
+Object.defineProperty(exports, "loadFireflyPreset", { enumerable: true, get: function () { return _1.loadFireflyPreset; } });
+const engine_1 = require("@tsparticles/engine");
+Object.defineProperty(exports, "tsParticles", { enumerable: true, get: function () { return engine_1.tsParticles; } });
+(() => __awaiter(void 0, void 0, void 0, function* () {
+    yield (0, _1.loadFireflyPreset)(engine_1.tsParticles);
+}))();

package/cjs/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFireflyPreset = void 0;
+const move_base_1 = require("@tsparticles/move-base");
+const shape_circle_1 = require("@tsparticles/shape-circle");
+const updater_color_1 = require("@tsparticles/updater-color");
+const interaction_external_trail_1 = require("@tsparticles/interaction-external-trail");
+const updater_life_1 = require("@tsparticles/updater-life");
+const updater_opacity_1 = require("@tsparticles/updater-opacity");
+const updater_size_1 = require("@tsparticles/updater-size");
+const options_1 = require("./options");
+function loadFireflyPreset(engine) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield (0, move_base_1.loadBaseMover)(engine);
+        yield (0, interaction_external_trail_1.loadExternalTrailInteraction)(engine);
+        yield (0, shape_circle_1.loadCircleShape)(engine);
+        yield (0, updater_color_1.loadColorUpdater)(engine);
+        yield (0, updater_life_1.loadLifeUpdater)(engine);
+        yield (0, updater_opacity_1.loadOpacityUpdater)(engine);
+        yield (0, updater_size_1.loadSizeUpdater)(engine);
+        yield engine.addPreset("firefly", options_1.options);
+    });
+}
+exports.loadFireflyPreset = loadFireflyPreset;

package/cjs/options.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.options = void 0;
+exports.options = {
+    fullScreen: {
+        enable: true,
+        zIndex: -1,
+    },
+    fpsLimit: 120,
+    particles: {
+        number: {
+            value: 0,
+        },
+        color: {
+            value: "#fff",
+        },
+        life: {
+            duration: {
+                value: 5,
+                sync: false,
+            },
+            count: 1,
+        },
+        opacity: {
+            value: { min: 0.1, max: 1 },
+            animation: {
+                enable: true,
+                speed: 3,
+            },
+        },
+        size: {
+            value: {
+                min: 3,
+                max: 6,
+            },
+        },
+        move: {
+            enable: true,
+            speed: 3,
+            random: false,
+            size: true,
+        },
+    },
+    interactivity: {
+        events: {
+            onHover: {
+                enable: true,
+                mode: "trail",
+            },
+            resize: true,
+        },
+        modes: {
+            trail: {
+                delay: 0.5,
+                pauseOnStop: true,
+                quantity: 4,
+            },
+        },
+    },
+    background: {
+        color: "#000",
+    },
+};

package/esm/bundle.js

@@ -0,0 +1,6 @@
+import { loadFireflyPreset } from ".";
+import { tsParticles } from "@tsparticles/engine";
+(async () => {
+    await loadFireflyPreset(tsParticles);
+})();
+export { loadFireflyPreset, tsParticles };

package/esm/index.js

@@ -0,0 +1,18 @@
+import { loadBaseMover } from "@tsparticles/move-base";
+import { loadCircleShape } from "@tsparticles/shape-circle";
+import { loadColorUpdater } from "@tsparticles/updater-color";
+import { loadExternalTrailInteraction } from "@tsparticles/interaction-external-trail";
+import { loadLifeUpdater } from "@tsparticles/updater-life";
+import { loadOpacityUpdater } from "@tsparticles/updater-opacity";
+import { loadSizeUpdater } from "@tsparticles/updater-size";
+import { options } from "./options";
+export async function loadFireflyPreset(engine) {
+    await loadBaseMover(engine);
+    await loadExternalTrailInteraction(engine);
+    await loadCircleShape(engine);
+    await loadColorUpdater(engine);
+    await loadLifeUpdater(engine);
+    await loadOpacityUpdater(engine);
+    await loadSizeUpdater(engine);
+    await engine.addPreset("firefly", options);
+}

package/esm/options.js

@@ -0,0 +1,60 @@
+export const options = {
+    fullScreen: {
+        enable: true,
+        zIndex: -1,
+    },
+    fpsLimit: 120,
+    particles: {
+        number: {
+            value: 0,
+        },
+        color: {
+            value: "#fff",
+        },
+        life: {
+            duration: {
+                value: 5,
+                sync: false,
+            },
+            count: 1,
+        },
+        opacity: {
+            value: { min: 0.1, max: 1 },
+            animation: {
+                enable: true,
+                speed: 3,
+            },
+        },
+        size: {
+            value: {
+                min: 3,
+                max: 6,
+            },
+        },
+        move: {
+            enable: true,
+            speed: 3,
+            random: false,
+            size: true,
+        },
+    },
+    interactivity: {
+        events: {
+            onHover: {
+                enable: true,
+                mode: "trail",
+            },
+            resize: true,
+        },
+        modes: {
+            trail: {
+                delay: 0.5,
+                pauseOnStop: true,
+                quantity: 4,
+            },
+        },
+    },
+    background: {
+        color: "#000",
+    },
+};

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@tsparticles/preset-firefly",
+  "version": "3.0.0-alpha.1",
+  "description": "tsParticles firefly preset",
+  "homepage": "https://particles.js.org",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/matteobruni/tsparticles.git",
+    "directory": "presets/firefly"
+  },
+  "keywords": [
+    "front-end",
+    "frontend",
+    "tsparticles",
+    "particles.js",
+    "particlesjs",
+    "particles",
+    "particle",
+    "canvas",
+    "jsparticles",
+    "xparticles",
+    "particles-js",
+    "particles-bg",
+    "particles-bg-vue",
+    "particles-ts",
+    "particles.ts",
+    "react-particles-js",
+    "react-particles.js",
+    "react-particles",
+    "react",
+    "reactjs",
+    "vue-particles",
+    "ngx-particles",
+    "angular-particles",
+    "particleground",
+    "vue",
+    "vuejs",
+    "preact",
+    "preactjs",
+    "jquery",
+    "angularjs",
+    "angular",
+    "typescript",
+    "javascript",
+    "animation",
+    "web",
+    "html5",
+    "web-design",
+    "webdesign",
+    "css",
+    "html",
+    "css3",
+    "animated",
+    "background",
+    "confetti",
+    "canvas",
+    "fireworks",
+    "fireworks-js",
+    "confetti-js",
+    "confettijs",
+    "fireworksjs",
+    "canvas-confetti",
+    "@tsparticles/preset"
+  ],
+  "author": "Matteo Bruni <matteo.bruni@me.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/matteobruni/tsparticles/issues"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/matteobruni"
+    },
+    {
+      "type": "buymeacoffee",
+      "url": "https://www.buymeacoffee.com/matteobruni"
+    }
+  ],
+  "main": "cjs/index.js",
+  "jsdelivr": "tsparticles.preset.firefly.min.js",
+  "unpkg": "tsparticles.preset.firefly.min.js",
+  "module": "esm/index.js",
+  "types": "types/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tsparticles/engine": "^3.0.0-alpha.1",
+    "@tsparticles/interaction-external-trail": "^3.0.0-alpha.1",
+    "@tsparticles/move-base": "^3.0.0-alpha.1",
+    "@tsparticles/shape-circle": "^3.0.0-alpha.1",
+    "@tsparticles/updater-color": "^3.0.0-alpha.1",
+    "@tsparticles/updater-life": "^3.0.0-alpha.1",
+    "@tsparticles/updater-opacity": "^3.0.0-alpha.1",
+    "@tsparticles/updater-size": "^3.0.0-alpha.1"
+  }
+}