@tsparticles/shape-emoji 3.0.0-beta.5

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,75 @@
+[![banner](https://particles.js.org/images/banner2.png)](https://particles.js.org)
+
+# tsParticles Emoji Shape
+
+[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/@tsparticles/shape-emoji/badge)](https://www.jsdelivr.com/package/npm/@tsparticles/shape-emoji)
+[![npmjs](https://badge.fury.io/js/@tsparticles/shape-emoji.svg)](https://www.npmjs.com/package/@tsparticles/shape-emoji)
+[![npmjs](https://img.shields.io/npm/dt/@tsparticles/shape-emoji)](https://www.npmjs.com/package/@tsparticles/shape-emoji) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
+
+[tsParticles](https://github.com/tsparticles/tsparticles) additional emoji shape.
+
+## How to use it
+
+### CDN / Vanilla JS / jQuery
+
+The CDN/Vanilla version JS has one required file in vanilla configuration:
+
+Including the `tsparticles.shape.emoji.min.js` file will export the function to load the shape:
+
+```javascript
+loadEmojiShape;
+```
+
+### Usage
+
+Once the scripts are loaded you can set up `tsParticles` and the shape like this:
+
+```javascript
+(async () => {
+  await loadEmojiShape(tsParticles);
+
+  await tsParticles.load({
+    id: "tsparticles",
+    options: {
+      /* options */
+      /* here you can use particles.shape.type: "emoji" */
+    },
+  });
+})();
+```
+
+### ESM / CommonJS
+
+This package is compatible also with ES or CommonJS modules, firstly this needs to be installed, like this:
+
+```shell
+$ npm install @tsparticles/shape-emoji
+```
+
+or
+
+```shell
+$ yarn add @tsparticles/shape-emoji
+```
+
+Then you need to import it in the app, like this:
+
+```javascript
+const { tsParticles } = require("@tsparticles/engine");
+const { loadEmojiShape } = require("@tsparticles/shape-emoji");
+
+(async () => {
+  await loadEmojiShape(tsParticles);
+})();
+```
+
+or
+
+```javascript
+import { tsParticles } from "@tsparticles/engine";
+import { loadEmojiShape } from "@tsparticles/shape-emoji";
+
+(async () => {
+  await loadEmojiShape(tsParticles);
+})();
+```

package/browser/EmojiDrawer.js

@@ -0,0 +1,68 @@
+import { executeOnSingleOrMultiple, getRangeMax, isInArray, itemFromSingleOrMultiple, loadFont, } from "@tsparticles/engine";
+export const validTypes = ["emoji"];
+const defaultFont = '"Twemoji Mozilla", Apple Color Emoji, "Segoe UI Emoji", "Noto Color Emoji", "EmojiOne Color"';
+export class EmojiDrawer {
+    constructor() {
+        this._emojiShapeDict = new Map();
+    }
+    destroy() {
+        for (const [, emojiData] of this._emojiShapeDict) {
+            emojiData?.close();
+        }
+    }
+    draw(data) {
+        const { context, particle, radius, opacity } = data, emojiData = particle.emojiData;
+        if (!emojiData) {
+            return;
+        }
+        context.globalAlpha = opacity;
+        context.drawImage(emojiData, -radius, -radius, radius * 2, radius * 2);
+        context.globalAlpha = 1;
+    }
+    async init(container) {
+        const options = container.actualOptions;
+        if (validTypes.find((t) => isInArray(t, options.particles.shape.type))) {
+            const promises = [loadFont(defaultFont)], shapeOptions = validTypes
+                .map((t) => options.particles.shape.options[t])
+                .find((t) => !!t);
+            if (shapeOptions) {
+                executeOnSingleOrMultiple(shapeOptions, (shape) => {
+                    shape.font && promises.push(loadFont(shape.font));
+                });
+            }
+            await Promise.all(promises);
+        }
+    }
+    particleDestroy(particle) {
+        delete particle.emojiData;
+    }
+    particleInit(container, particle) {
+        if (!particle.emojiData) {
+            const shapeData = particle.shapeData;
+            if (!shapeData?.value) {
+                return;
+            }
+            const emoji = itemFromSingleOrMultiple(shapeData.value, particle.randomIndexData), font = shapeData.font ?? defaultFont;
+            if (!emoji) {
+                return;
+            }
+            const key = `${emoji}_${font}`, existingData = this._emojiShapeDict.get(key);
+            if (existingData) {
+                particle.emojiData = existingData;
+                return;
+            }
+            const canvasSize = getRangeMax(particle.size.value) * 2, canvas = new OffscreenCanvas(canvasSize, canvasSize);
+            const context = canvas.getContext("2d");
+            if (!context) {
+                return;
+            }
+            context.font = `400 ${getRangeMax(particle.size.value) * 2}px ${font}`;
+            context.textBaseline = "middle";
+            context.textAlign = "center";
+            context.fillText(emoji, getRangeMax(particle.size.value), getRangeMax(particle.size.value));
+            const emojiData = canvas.transferToImageBitmap();
+            this._emojiShapeDict.set(key, emojiData);
+            particle.emojiData = emojiData;
+        }
+    }
+}

package/browser/EmojiParticle.js

@@ -0,0 +1 @@
+export {};

package/browser/IEmojiShape.js

@@ -0,0 +1 @@
+export {};

package/browser/index.js

@@ -0,0 +1,4 @@
+import { EmojiDrawer, validTypes } from "./EmojiDrawer.js";
+export async function loadEmojiShape(engine, refresh = true) {
+    await engine.addShape(validTypes, new EmojiDrawer(), refresh);
+}

package/browser/package.json

@@ -0,0 +1 @@
+{ "type": "module" }

package/cjs/EmojiDrawer.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmojiDrawer = exports.validTypes = void 0;
+const engine_1 = require("@tsparticles/engine");
+exports.validTypes = ["emoji"];
+const defaultFont = '"Twemoji Mozilla", Apple Color Emoji, "Segoe UI Emoji", "Noto Color Emoji", "EmojiOne Color"';
+class EmojiDrawer {
+    constructor() {
+        this._emojiShapeDict = new Map();
+    }
+    destroy() {
+        for (const [, emojiData] of this._emojiShapeDict) {
+            emojiData?.close();
+        }
+    }
+    draw(data) {
+        const { context, particle, radius, opacity } = data, emojiData = particle.emojiData;
+        if (!emojiData) {
+            return;
+        }
+        context.globalAlpha = opacity;
+        context.drawImage(emojiData, -radius, -radius, radius * 2, radius * 2);
+        context.globalAlpha = 1;
+    }
+    async init(container) {
+        const options = container.actualOptions;
+        if (exports.validTypes.find((t) => (0, engine_1.isInArray)(t, options.particles.shape.type))) {
+            const promises = [(0, engine_1.loadFont)(defaultFont)], shapeOptions = exports.validTypes
+                .map((t) => options.particles.shape.options[t])
+                .find((t) => !!t);
+            if (shapeOptions) {
+                (0, engine_1.executeOnSingleOrMultiple)(shapeOptions, (shape) => {
+                    shape.font && promises.push((0, engine_1.loadFont)(shape.font));
+                });
+            }
+            await Promise.all(promises);
+        }
+    }
+    particleDestroy(particle) {
+        delete particle.emojiData;
+    }
+    particleInit(container, particle) {
+        if (!particle.emojiData) {
+            const shapeData = particle.shapeData;
+            if (!shapeData?.value) {
+                return;
+            }
+            const emoji = (0, engine_1.itemFromSingleOrMultiple)(shapeData.value, particle.randomIndexData), font = shapeData.font ?? defaultFont;
+            if (!emoji) {
+                return;
+            }
+            const key = `${emoji}_${font}`, existingData = this._emojiShapeDict.get(key);
+            if (existingData) {
+                particle.emojiData = existingData;
+                return;
+            }
+            const canvasSize = (0, engine_1.getRangeMax)(particle.size.value) * 2, canvas = new OffscreenCanvas(canvasSize, canvasSize);
+            const context = canvas.getContext("2d");
+            if (!context) {
+                return;
+            }
+            context.font = `400 ${(0, engine_1.getRangeMax)(particle.size.value) * 2}px ${font}`;
+            context.textBaseline = "middle";
+            context.textAlign = "center";
+            context.fillText(emoji, (0, engine_1.getRangeMax)(particle.size.value), (0, engine_1.getRangeMax)(particle.size.value));
+            const emojiData = canvas.transferToImageBitmap();
+            this._emojiShapeDict.set(key, emojiData);
+            particle.emojiData = emojiData;
+        }
+    }
+}
+exports.EmojiDrawer = EmojiDrawer;

package/cjs/EmojiParticle.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/IEmojiShape.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadEmojiShape = void 0;
+const EmojiDrawer_js_1 = require("./EmojiDrawer.js");
+async function loadEmojiShape(engine, refresh = true) {
+    await engine.addShape(EmojiDrawer_js_1.validTypes, new EmojiDrawer_js_1.EmojiDrawer(), refresh);
+}
+exports.loadEmojiShape = loadEmojiShape;

package/cjs/package.json

@@ -0,0 +1 @@
+{ "type": "commonjs" }

package/esm/EmojiDrawer.js

@@ -0,0 +1,68 @@
+import { executeOnSingleOrMultiple, getRangeMax, isInArray, itemFromSingleOrMultiple, loadFont, } from "@tsparticles/engine";
+export const validTypes = ["emoji"];
+const defaultFont = '"Twemoji Mozilla", Apple Color Emoji, "Segoe UI Emoji", "Noto Color Emoji", "EmojiOne Color"';
+export class EmojiDrawer {
+    constructor() {
+        this._emojiShapeDict = new Map();
+    }
+    destroy() {
+        for (const [, emojiData] of this._emojiShapeDict) {
+            emojiData?.close();
+        }
+    }
+    draw(data) {
+        const { context, particle, radius, opacity } = data, emojiData = particle.emojiData;
+        if (!emojiData) {
+            return;
+        }
+        context.globalAlpha = opacity;
+        context.drawImage(emojiData, -radius, -radius, radius * 2, radius * 2);
+        context.globalAlpha = 1;
+    }
+    async init(container) {
+        const options = container.actualOptions;
+        if (validTypes.find((t) => isInArray(t, options.particles.shape.type))) {
+            const promises = [loadFont(defaultFont)], shapeOptions = validTypes
+                .map((t) => options.particles.shape.options[t])
+                .find((t) => !!t);
+            if (shapeOptions) {
+                executeOnSingleOrMultiple(shapeOptions, (shape) => {
+                    shape.font && promises.push(loadFont(shape.font));
+                });
+            }
+            await Promise.all(promises);
+        }
+    }
+    particleDestroy(particle) {
+        delete particle.emojiData;
+    }
+    particleInit(container, particle) {
+        if (!particle.emojiData) {
+            const shapeData = particle.shapeData;
+            if (!shapeData?.value) {
+                return;
+            }
+            const emoji = itemFromSingleOrMultiple(shapeData.value, particle.randomIndexData), font = shapeData.font ?? defaultFont;
+            if (!emoji) {
+                return;
+            }
+            const key = `${emoji}_${font}`, existingData = this._emojiShapeDict.get(key);
+            if (existingData) {
+                particle.emojiData = existingData;
+                return;
+            }
+            const canvasSize = getRangeMax(particle.size.value) * 2, canvas = new OffscreenCanvas(canvasSize, canvasSize);
+            const context = canvas.getContext("2d");
+            if (!context) {
+                return;
+            }
+            context.font = `400 ${getRangeMax(particle.size.value) * 2}px ${font}`;
+            context.textBaseline = "middle";
+            context.textAlign = "center";
+            context.fillText(emoji, getRangeMax(particle.size.value), getRangeMax(particle.size.value));
+            const emojiData = canvas.transferToImageBitmap();
+            this._emojiShapeDict.set(key, emojiData);
+            particle.emojiData = emojiData;
+        }
+    }
+}

package/esm/EmojiParticle.js

@@ -0,0 +1 @@
+export {};

package/esm/IEmojiShape.js

@@ -0,0 +1 @@
+export {};

package/esm/index.js

@@ -0,0 +1,4 @@
+import { EmojiDrawer, validTypes } from "./EmojiDrawer.js";
+export async function loadEmojiShape(engine, refresh = true) {
+    await engine.addShape(validTypes, new EmojiDrawer(), refresh);
+}

package/esm/package.json

@@ -0,0 +1 @@
+{ "type": "module" }

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@tsparticles/shape-emoji",
+  "version": "3.0.0-beta.5",
+  "description": "tsParticles emoji shape",
+  "homepage": "https://particles.js.org",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tsparticles/tsparticles.git",
+    "directory": "shapes/emoji"
+  },
+  "keywords": [
+    "front-end",
+    "frontend",
+    "tsparticles",
+    "particles",
+    "particle",
+    "canvas",
+    "jsparticles",
+    "xparticles",
+    "particles-js",
+    "particles.js",
+    "particles-ts",
+    "particles.ts",
+    "typescript",
+    "javascript",
+    "animation",
+    "web",
+    "html5",
+    "web-design",
+    "webdesign",
+    "css",
+    "html",
+    "css3",
+    "animated",
+    "background",
+    "tsparticles-shape"
+  ],
+  "author": "Matteo Bruni <matteo.bruni@me.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/tsparticles/tsparticles/issues"
+  },
+  "sideEffects": false,
+  "jsdelivr": "tsparticles.shape.emoji.min.js",
+  "unpkg": "tsparticles.shape.emoji.min.js",
+  "browser": "browser/index.js",
+  "main": "cjs/index.js",
+  "module": "esm/index.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "browser": "./browser/index.js",
+      "import": "./esm/index.js",
+      "require": "./cjs/index.js",
+      "umd": "./umd/index.js",
+      "default": "./cjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@tsparticles/engine": "^3.0.0-beta.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}