@tsparticles/preset-fountain 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,205 @@
+[![banner](https://particles.js.org/images/banner3.png)](https://particles.js.org)
+
+# tsParticles Fountain Preset
+
+[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/@tsparticles/preset-fountain/badge)](https://www.jsdelivr.com/package/npm/@tsparticles/preset-fountain) [![npmjs](https://badge.fury.io/js/@tsparticles/preset-fountain.svg)](https://www.npmjs.com/package/@tsparticles/preset-fountain) [![npmjs](https://img.shields.io/npm/dt/@tsparticles/preset-fountain)](https://www.npmjs.com/package/@tsparticles/preset-fountain) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
+
+[tsParticles](https://github.com/matteobruni/tsparticles) preset creating random positioned falling colored particles
+that break when hitting the ground.
+
+[![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/fountain/images/sample.png)](https://particles.js.org/samples/presets/fountain)
+
+## 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-fountain):
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/tsparticles-engine@2/tsparticles.engine.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-opacity@2/tsparticles.updater.opacity.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/tsparticles-updater-out-modes@2/tsparticles.updater.out-modes.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-fountain@2/tsparticles.preset.fountain.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-fountain@2/tsparticles.preset.fountain.bundle.min.js"></script>
+```
+
+### Usage
+
+Once the scripts are loaded you can set up `tsParticles` like this:
+
+```javascript
+(async () => {
+  await loadFountainPreset(tsParticles); // this is required only if you are not using the bundle script
+
+  await tsParticles.load("tsparticles", {
+    preset: "fountain",
+  });
+})();
+```
+
+#### 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: "fountain",
+});
+```
+
+Like in the sample above, the circles will be replaced by squares.
+
+### React.js / Preact / Inferno
+
+_The syntax for `React.js`, `Preact` and `Inferno` 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 { loadFountainPreset } from "@tsparticles/preset-fountain";
+
+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 loadFountainPreset(engine);
+  }
+
+  render() {
+    const options = {
+      preset: "fountain",
+    };
+
+    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
+const particlesOptions = {
+  preset: "fountain",
+};
+
+async function particlesInit(engine: Engine): Promise<void> {
+  await loadFountainPreset(engine);
+}
+```
+
+### Angular
+
+```html
+<angular-particles [id]="id" [options]="particlesOptions" [particlesInit]="particlesInit"></angular-particles>
+```
+
+```ts
+const particlesOptions = {
+  preset: "fountain",
+};
+
+async function particlesInit(engine: Engine): Promise<void> {
+  await loadFountainPreset(engine);
+}
+```
+
+### Svelte
+
+```sveltehtml
+
+<Particles
+        id="tsparticles"
+        options={particlesOptions}
+        particlesInit={particlesInit}
+/>
+```
+
+```js
+let particlesOptions = {
+  preset: "fountain",
+};
+
+let particlesInit = async (engine) => {
+  await loadFountainPreset(engine);
+};
+```
+
+---
+
+```mermaid
+flowchart TD
+
+subgraph m [Movers]
+mb[Base]
+end
+
+e[tsParticles Engine] --> m
+
+subgraph pl [Plugins]
+ple[Emitters]
+end
+
+e --> pl
+
+subgraph s [Shapes]
+sc[Circle]
+end
+
+e --> s
+
+subgraph u [Updaters]
+uc[Color]
+ud[Destroy]
+uop[Opacity]
+uou[Out Modes]
+usi[Size]
+end
+
+e --> u
+
+subgraph pr [Presets]
+prfo[Fountain]
+end
+
+e --> pr
+
+mb & ple & sc & uc & ud & uop & uou & usi --> prfo
+```

package/browser/bundle.js

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

package/browser/index.js

@@ -0,0 +1,20 @@
+import { loadBaseMover } from "@tsparticles/move-base";
+import { loadCircleShape } from "@tsparticles/shape-circle";
+import { loadColorUpdater } from "@tsparticles/updater-color";
+import { loadDestroyUpdater } from "@tsparticles/updater-destroy";
+import { loadEmittersPlugin } from "@tsparticles/plugin-emitters";
+import { loadOpacityUpdater } from "@tsparticles/updater-opacity";
+import { loadOutModesUpdater } from "@tsparticles/updater-out-modes";
+import { loadSizeUpdater } from "@tsparticles/updater-size";
+import { options } from "./options";
+export async function loadFountainPreset(engine) {
+    await loadBaseMover(engine);
+    await loadCircleShape(engine);
+    await loadDestroyUpdater(engine);
+    await loadEmittersPlugin(engine);
+    await loadColorUpdater(engine);
+    await loadOpacityUpdater(engine);
+    await loadOutModesUpdater(engine);
+    await loadSizeUpdater(engine);
+    await engine.addPreset("fountain", options);
+}

package/browser/options.js

@@ -0,0 +1,90 @@
+export const options = {
+    fpsLimit: 120,
+    particles: {
+        bounce: {
+            vertical: {
+                value: {
+                    min: 0.75,
+                    max: 0.85,
+                },
+            },
+        },
+        color: {
+            value: ["#3998D0", "#2EB6AF", "#A9BD33", "#FEC73B", "#F89930", "#F45623", "#D62E32", "#EB586E", "#9952CF"],
+        },
+        number: {
+            value: 0,
+        },
+        destroy: {
+            mode: "split",
+            split: {
+                count: 2,
+                factor: {
+                    value: {
+                        min: 1.1,
+                        max: 2,
+                    },
+                },
+                rate: {
+                    value: {
+                        min: 2,
+                        max: 3,
+                    },
+                },
+            },
+        },
+        opacity: {
+            value: 0.5,
+        },
+        size: {
+            value: {
+                min: 10,
+                max: 20,
+            },
+        },
+        move: {
+            enable: true,
+            gravity: {
+                enable: true,
+                maxSpeed: 50,
+            },
+            speed: {
+                min: 10,
+                max: 20,
+            },
+            direction: "none",
+            random: false,
+            straight: false,
+            outModes: {
+                bottom: "split",
+                default: "bounce",
+                top: "none",
+            },
+            trail: {
+                enable: true,
+                fillColor: "#fff",
+                length: 3,
+            },
+        },
+    },
+    detectRetina: true,
+    background: {
+        color: "#fff",
+    },
+    emitters: {
+        direction: "top",
+        life: {
+            count: 0,
+            duration: 0.15,
+            delay: 3,
+        },
+        rate: {
+            delay: 0.1,
+            quantity: 5,
+        },
+        size: {
+            width: 0,
+            height: 0,
+        },
+    },
+};

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.loadFountainPreset = void 0;
+const _1 = require(".");
+Object.defineProperty(exports, "loadFountainPreset", { enumerable: true, get: function () { return _1.loadFountainPreset; } });
+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.loadFountainPreset)(engine_1.tsParticles);
+}))();

package/cjs/index.js

@@ -0,0 +1,35 @@
+"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.loadFountainPreset = 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 updater_destroy_1 = require("@tsparticles/updater-destroy");
+const plugin_emitters_1 = require("@tsparticles/plugin-emitters");
+const updater_opacity_1 = require("@tsparticles/updater-opacity");
+const updater_out_modes_1 = require("@tsparticles/updater-out-modes");
+const updater_size_1 = require("@tsparticles/updater-size");
+const options_1 = require("./options");
+function loadFountainPreset(engine) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield (0, move_base_1.loadBaseMover)(engine);
+        yield (0, shape_circle_1.loadCircleShape)(engine);
+        yield (0, updater_destroy_1.loadDestroyUpdater)(engine);
+        yield (0, plugin_emitters_1.loadEmittersPlugin)(engine);
+        yield (0, updater_color_1.loadColorUpdater)(engine);
+        yield (0, updater_opacity_1.loadOpacityUpdater)(engine);
+        yield (0, updater_out_modes_1.loadOutModesUpdater)(engine);
+        yield (0, updater_size_1.loadSizeUpdater)(engine);
+        yield engine.addPreset("fountain", options_1.options);
+    });
+}
+exports.loadFountainPreset = loadFountainPreset;

package/cjs/options.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.options = void 0;
+exports.options = {
+    fpsLimit: 120,
+    particles: {
+        bounce: {
+            vertical: {
+                value: {
+                    min: 0.75,
+                    max: 0.85,
+                },
+            },
+        },
+        color: {
+            value: ["#3998D0", "#2EB6AF", "#A9BD33", "#FEC73B", "#F89930", "#F45623", "#D62E32", "#EB586E", "#9952CF"],
+        },
+        number: {
+            value: 0,
+        },
+        destroy: {
+            mode: "split",
+            split: {
+                count: 2,
+                factor: {
+                    value: {
+                        min: 1.1,
+                        max: 2,
+                    },
+                },
+                rate: {
+                    value: {
+                        min: 2,
+                        max: 3,
+                    },
+                },
+            },
+        },
+        opacity: {
+            value: 0.5,
+        },
+        size: {
+            value: {
+                min: 10,
+                max: 20,
+            },
+        },
+        move: {
+            enable: true,
+            gravity: {
+                enable: true,
+                maxSpeed: 50,
+            },
+            speed: {
+                min: 10,
+                max: 20,
+            },
+            direction: "none",
+            random: false,
+            straight: false,
+            outModes: {
+                bottom: "split",
+                default: "bounce",
+                top: "none",
+            },
+            trail: {
+                enable: true,
+                fillColor: "#fff",
+                length: 3,
+            },
+        },
+    },
+    detectRetina: true,
+    background: {
+        color: "#fff",
+    },
+    emitters: {
+        direction: "top",
+        life: {
+            count: 0,
+            duration: 0.15,
+            delay: 3,
+        },
+        rate: {
+            delay: 0.1,
+            quantity: 5,
+        },
+        size: {
+            width: 0,
+            height: 0,
+        },
+    },
+};

package/esm/bundle.js

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

package/esm/index.js

@@ -0,0 +1,20 @@
+import { loadBaseMover } from "@tsparticles/move-base";
+import { loadCircleShape } from "@tsparticles/shape-circle";
+import { loadColorUpdater } from "@tsparticles/updater-color";
+import { loadDestroyUpdater } from "@tsparticles/updater-destroy";
+import { loadEmittersPlugin } from "@tsparticles/plugin-emitters";
+import { loadOpacityUpdater } from "@tsparticles/updater-opacity";
+import { loadOutModesUpdater } from "@tsparticles/updater-out-modes";
+import { loadSizeUpdater } from "@tsparticles/updater-size";
+import { options } from "./options";
+export async function loadFountainPreset(engine) {
+    await loadBaseMover(engine);
+    await loadCircleShape(engine);
+    await loadDestroyUpdater(engine);
+    await loadEmittersPlugin(engine);
+    await loadColorUpdater(engine);
+    await loadOpacityUpdater(engine);
+    await loadOutModesUpdater(engine);
+    await loadSizeUpdater(engine);
+    await engine.addPreset("fountain", options);
+}

package/esm/options.js

@@ -0,0 +1,90 @@
+export const options = {
+    fpsLimit: 120,
+    particles: {
+        bounce: {
+            vertical: {
+                value: {
+                    min: 0.75,
+                    max: 0.85,
+                },
+            },
+        },
+        color: {
+            value: ["#3998D0", "#2EB6AF", "#A9BD33", "#FEC73B", "#F89930", "#F45623", "#D62E32", "#EB586E", "#9952CF"],
+        },
+        number: {
+            value: 0,
+        },
+        destroy: {
+            mode: "split",
+            split: {
+                count: 2,
+                factor: {
+                    value: {
+                        min: 1.1,
+                        max: 2,
+                    },
+                },
+                rate: {
+                    value: {
+                        min: 2,
+                        max: 3,
+                    },
+                },
+            },
+        },
+        opacity: {
+            value: 0.5,
+        },
+        size: {
+            value: {
+                min: 10,
+                max: 20,
+            },
+        },
+        move: {
+            enable: true,
+            gravity: {
+                enable: true,
+                maxSpeed: 50,
+            },
+            speed: {
+                min: 10,
+                max: 20,
+            },
+            direction: "none",
+            random: false,
+            straight: false,
+            outModes: {
+                bottom: "split",
+                default: "bounce",
+                top: "none",
+            },
+            trail: {
+                enable: true,
+                fillColor: "#fff",
+                length: 3,
+            },
+        },
+    },
+    detectRetina: true,
+    background: {
+        color: "#fff",
+    },
+    emitters: {
+        direction: "top",
+        life: {
+            count: 0,
+            duration: 0.15,
+            delay: 3,
+        },
+        rate: {
+            delay: 0.1,
+            quantity: 5,
+        },
+        size: {
+            width: 0,
+            height: 0,
+        },
+    },
+};