@tsparticles/interaction-external-bubble 3.0.0-alpha.0

package/types/index.d.ts

@@ -0,0 +1,8 @@
+import type { Engine } from "@tsparticles/engine";
+export declare function loadExternalBubbleInteraction(engine: Engine): Promise<void>;
+export * from "./Options/Classes/BubbleBase";
+export * from "./Options/Classes/BubbleDiv";
+export * from "./Options/Classes/Bubble";
+export * from "./Options/Interfaces/IBubbleBase";
+export * from "./Options/Interfaces/IBubbleDiv";
+export * from "./Options/Interfaces/IBubble";

package/umd/Bubbler.js

@@ -0,0 +1,308 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "@tsparticles/engine", "./Options/Classes/Bubble"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.Bubbler = void 0;
+    const engine_1 = require("@tsparticles/engine");
+    const Bubble_1 = require("./Options/Classes/Bubble");
+    function calculateBubbleValue(particleValue, modeValue, optionsValue, ratio) {
+        if (modeValue >= optionsValue) {
+            const value = particleValue + (modeValue - optionsValue) * ratio;
+            return (0, engine_1.clamp)(value, particleValue, modeValue);
+        }
+        else if (modeValue < optionsValue) {
+            const value = particleValue - (optionsValue - modeValue) * ratio;
+            return (0, engine_1.clamp)(value, modeValue, particleValue);
+        }
+    }
+    class Bubbler extends engine_1.ExternalInteractorBase {
+        constructor(container) {
+            super(container);
+            if (!container.bubble) {
+                container.bubble = {};
+            }
+            this.handleClickMode = (mode) => {
+                if (mode !== "bubble") {
+                    return;
+                }
+                if (!container.bubble) {
+                    container.bubble = {};
+                }
+                container.bubble.clicking = true;
+            };
+        }
+        clear(particle, delta, force) {
+            if (particle.bubble.inRange && !force) {
+                return;
+            }
+            delete particle.bubble.div;
+            delete particle.bubble.opacity;
+            delete particle.bubble.radius;
+            delete particle.bubble.color;
+        }
+        init() {
+            const container = this.container, bubble = container.actualOptions.interactivity.modes.bubble;
+            if (!bubble) {
+                return;
+            }
+            container.retina.bubbleModeDistance = bubble.distance * container.retina.pixelRatio;
+            if (bubble.size !== undefined) {
+                container.retina.bubbleModeSize = bubble.size * container.retina.pixelRatio;
+            }
+        }
+        async interact(delta) {
+            const options = this.container.actualOptions, events = options.interactivity.events, onHover = events.onHover, onClick = events.onClick, hoverEnabled = onHover.enable, hoverMode = onHover.mode, clickEnabled = onClick.enable, clickMode = onClick.mode, divs = events.onDiv;
+            if (hoverEnabled && (0, engine_1.isInArray)("bubble", hoverMode)) {
+                this.hoverBubble(delta);
+            }
+            else if (clickEnabled && (0, engine_1.isInArray)("bubble", clickMode)) {
+                this.clickBubble(delta);
+            }
+            else {
+                (0, engine_1.divModeExecute)("bubble", divs, (selector, div) => this.singleSelectorHover(delta, selector, div));
+            }
+        }
+        isEnabled(particle) {
+            var _a;
+            const container = this.container, options = container.actualOptions, mouse = container.interactivity.mouse, events = ((_a = particle === null || particle === void 0 ? void 0 : particle.interactivity) !== null && _a !== void 0 ? _a : options.interactivity).events, divs = events.onDiv, divBubble = (0, engine_1.isDivModeEnabled)("bubble", divs);
+            if (!(divBubble || (events.onHover.enable && mouse.position) || (events.onClick.enable && mouse.clickPosition))) {
+                return false;
+            }
+            const hoverMode = events.onHover.mode;
+            const clickMode = events.onClick.mode;
+            return (0, engine_1.isInArray)("bubble", hoverMode) || (0, engine_1.isInArray)("bubble", clickMode) || divBubble;
+        }
+        loadModeOptions(options, ...sources) {
+            if (!options.bubble) {
+                options.bubble = new Bubble_1.Bubble();
+            }
+            for (const source of sources) {
+                options.bubble.load(source === null || source === void 0 ? void 0 : source.bubble);
+            }
+        }
+        reset(particle) {
+            particle.bubble.inRange = false;
+        }
+        clickBubble(delta) {
+            var _a, _b;
+            const container = this.container, options = container.actualOptions, mouseClickPos = container.interactivity.mouse.clickPosition, bubble = options.interactivity.modes.bubble;
+            if (!bubble || !mouseClickPos) {
+                return;
+            }
+            if (!container.bubble) {
+                container.bubble = {};
+            }
+            const distance = container.retina.bubbleModeDistance;
+            if (!distance || distance < 0) {
+                return;
+            }
+            const query = container.particles.quadTree.queryCircle(mouseClickPos, distance, (p) => this.isEnabled(p));
+            for (const particle of query) {
+                if (!container.bubble.clicking) {
+                    continue;
+                }
+                particle.bubble.inRange = !container.bubble.durationEnd;
+                const pos = particle.getPosition(), distMouse = (0, engine_1.getDistance)(pos, mouseClickPos), timeSpent = (new Date().getTime() - (container.interactivity.mouse.clickTime || 0)) / 1000;
+                if (timeSpent > bubble.duration) {
+                    container.bubble.durationEnd = true;
+                }
+                if (timeSpent > bubble.duration * 2) {
+                    container.bubble.clicking = false;
+                    container.bubble.durationEnd = false;
+                }
+                const sizeData = {
+                    bubbleObj: {
+                        optValue: container.retina.bubbleModeSize,
+                        value: particle.bubble.radius,
+                    },
+                    particlesObj: {
+                        optValue: (0, engine_1.getRangeMax)(particle.options.size.value) * container.retina.pixelRatio,
+                        value: particle.size.value,
+                    },
+                    type: "size",
+                };
+                this.process(particle, distMouse, timeSpent, sizeData);
+                const opacityData = {
+                    bubbleObj: {
+                        optValue: bubble.opacity,
+                        value: particle.bubble.opacity,
+                    },
+                    particlesObj: {
+                        optValue: (0, engine_1.getRangeMax)(particle.options.opacity.value),
+                        value: (_b = (_a = particle.opacity) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : 1,
+                    },
+                    type: "opacity",
+                };
+                this.process(particle, distMouse, timeSpent, opacityData);
+                if (!container.bubble.durationEnd) {
+                    if (distMouse <= distance) {
+                        this.hoverBubbleColor(particle, distMouse);
+                    }
+                    else {
+                        delete particle.bubble.color;
+                    }
+                }
+                else {
+                    delete particle.bubble.color;
+                }
+            }
+        }
+        hoverBubble(delta) {
+            const container = this.container, mousePos = container.interactivity.mouse.position, distance = container.retina.bubbleModeDistance;
+            if (!distance || distance < 0 || mousePos === undefined) {
+                return;
+            }
+            const query = container.particles.quadTree.queryCircle(mousePos, distance, (p) => this.isEnabled(p));
+            for (const particle of query) {
+                particle.bubble.inRange = true;
+                const pos = particle.getPosition(), pointDistance = (0, engine_1.getDistance)(pos, mousePos), ratio = 1 - pointDistance / distance;
+                if (pointDistance <= distance) {
+                    if (ratio >= 0 && container.interactivity.status === engine_1.mouseMoveEvent) {
+                        this.hoverBubbleSize(particle, ratio);
+                        this.hoverBubbleOpacity(particle, ratio);
+                        this.hoverBubbleColor(particle, ratio);
+                    }
+                }
+                else {
+                    this.reset(particle);
+                }
+                if (container.interactivity.status === engine_1.mouseLeaveEvent) {
+                    this.reset(particle);
+                }
+            }
+        }
+        hoverBubbleColor(particle, ratio, divBubble) {
+            const options = this.container.actualOptions;
+            const bubbleOptions = divBubble !== null && divBubble !== void 0 ? divBubble : options.interactivity.modes.bubble;
+            if (!bubbleOptions) {
+                return;
+            }
+            if (!particle.bubble.finalColor) {
+                const modeColor = bubbleOptions.color;
+                if (!modeColor) {
+                    return;
+                }
+                const bubbleColor = (0, engine_1.itemFromSingleOrMultiple)(modeColor);
+                particle.bubble.finalColor = (0, engine_1.rangeColorToHsl)(bubbleColor);
+            }
+            if (!particle.bubble.finalColor) {
+                return;
+            }
+            if (bubbleOptions.mix) {
+                particle.bubble.color = undefined;
+                const pColor = particle.getFillColor();
+                particle.bubble.color = pColor
+                    ? (0, engine_1.rgbToHsl)((0, engine_1.colorMix)(pColor, particle.bubble.finalColor, 1 - ratio, ratio))
+                    : particle.bubble.finalColor;
+            }
+            else {
+                particle.bubble.color = particle.bubble.finalColor;
+            }
+        }
+        hoverBubbleOpacity(particle, ratio, divBubble) {
+            var _a, _b, _c, _d;
+            const container = this.container, options = container.actualOptions, modeOpacity = (_a = divBubble === null || divBubble === void 0 ? void 0 : divBubble.opacity) !== null && _a !== void 0 ? _a : (_b = options.interactivity.modes.bubble) === null || _b === void 0 ? void 0 : _b.opacity;
+            if (!modeOpacity) {
+                return;
+            }
+            const optOpacity = particle.options.opacity.value;
+            const pOpacity = (_d = (_c = particle.opacity) === null || _c === void 0 ? void 0 : _c.value) !== null && _d !== void 0 ? _d : 1;
+            const opacity = calculateBubbleValue(pOpacity, modeOpacity, (0, engine_1.getRangeMax)(optOpacity), ratio);
+            if (opacity !== undefined) {
+                particle.bubble.opacity = opacity;
+            }
+        }
+        hoverBubbleSize(particle, ratio, divBubble) {
+            const container = this.container, modeSize = (divBubble === null || divBubble === void 0 ? void 0 : divBubble.size) ? divBubble.size * container.retina.pixelRatio : container.retina.bubbleModeSize;
+            if (modeSize === undefined) {
+                return;
+            }
+            const optSize = (0, engine_1.getRangeMax)(particle.options.size.value) * container.retina.pixelRatio;
+            const pSize = particle.size.value;
+            const size = calculateBubbleValue(pSize, modeSize, optSize, ratio);
+            if (size !== undefined) {
+                particle.bubble.radius = size;
+            }
+        }
+        process(particle, distMouse, timeSpent, data) {
+            const container = this.container, bubbleParam = data.bubbleObj.optValue, options = container.actualOptions, bubble = options.interactivity.modes.bubble;
+            if (!bubble || bubbleParam === undefined) {
+                return;
+            }
+            const bubbleDuration = bubble.duration, bubbleDistance = container.retina.bubbleModeDistance, particlesParam = data.particlesObj.optValue, pObjBubble = data.bubbleObj.value, pObj = data.particlesObj.value || 0, type = data.type;
+            if (!bubbleDistance || bubbleDistance < 0 || bubbleParam === particlesParam) {
+                return;
+            }
+            if (!container.bubble) {
+                container.bubble = {};
+            }
+            if (!container.bubble.durationEnd) {
+                if (distMouse <= bubbleDistance) {
+                    const obj = pObjBubble !== null && pObjBubble !== void 0 ? pObjBubble : pObj;
+                    if (obj !== bubbleParam) {
+                        const value = pObj - (timeSpent * (pObj - bubbleParam)) / bubbleDuration;
+                        if (type === "size") {
+                            particle.bubble.radius = value;
+                        }
+                        if (type === "opacity") {
+                            particle.bubble.opacity = value;
+                        }
+                    }
+                }
+                else {
+                    if (type === "size") {
+                        delete particle.bubble.radius;
+                    }
+                    if (type === "opacity") {
+                        delete particle.bubble.opacity;
+                    }
+                }
+            }
+            else if (pObjBubble) {
+                if (type === "size") {
+                    delete particle.bubble.radius;
+                }
+                if (type === "opacity") {
+                    delete particle.bubble.opacity;
+                }
+            }
+        }
+        singleSelectorHover(delta, selector, div) {
+            const container = this.container, selectors = document.querySelectorAll(selector), bubble = container.actualOptions.interactivity.modes.bubble;
+            if (!bubble || !selectors.length) {
+                return;
+            }
+            selectors.forEach((item) => {
+                const elem = item, pxRatio = container.retina.pixelRatio, pos = {
+                    x: (elem.offsetLeft + elem.offsetWidth / 2) * pxRatio,
+                    y: (elem.offsetTop + elem.offsetHeight / 2) * pxRatio,
+                }, repulseRadius = (elem.offsetWidth / 2) * pxRatio, area = div.type === "circle"
+                    ? new engine_1.Circle(pos.x, pos.y, repulseRadius)
+                    : new engine_1.Rectangle(elem.offsetLeft * pxRatio, elem.offsetTop * pxRatio, elem.offsetWidth * pxRatio, elem.offsetHeight * pxRatio), query = container.particles.quadTree.query(area, (p) => this.isEnabled(p));
+                for (const particle of query) {
+                    if (!area.contains(particle.getPosition())) {
+                        continue;
+                    }
+                    particle.bubble.inRange = true;
+                    const divs = bubble.divs;
+                    const divBubble = (0, engine_1.divMode)(divs, elem);
+                    if (!particle.bubble.div || particle.bubble.div !== elem) {
+                        this.clear(particle, delta, true);
+                        particle.bubble.div = elem;
+                    }
+                    this.hoverBubbleSize(particle, 1, divBubble);
+                    this.hoverBubbleOpacity(particle, 1, divBubble);
+                    this.hoverBubbleColor(particle, 1, divBubble);
+                }
+            });
+        }
+    }
+    exports.Bubbler = Bubbler;
+});

package/umd/IBubblerProcessParam.js

@@ -0,0 +1,12 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/Options/Classes/Bubble.js

@@ -0,0 +1,30 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "./BubbleBase", "./BubbleDiv", "@tsparticles/engine"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.Bubble = void 0;
+    const BubbleBase_1 = require("./BubbleBase");
+    const BubbleDiv_1 = require("./BubbleDiv");
+    const engine_1 = require("@tsparticles/engine");
+    class Bubble extends BubbleBase_1.BubbleBase {
+        load(data) {
+            super.load(data);
+            if (!data) {
+                return;
+            }
+            this.divs = (0, engine_1.executeOnSingleOrMultiple)(data.divs, (div) => {
+                const tmp = new BubbleDiv_1.BubbleDiv();
+                tmp.load(div);
+                return tmp;
+            });
+        }
+    }
+    exports.Bubble = Bubble;
+});

package/umd/Options/Classes/BubbleBase.js

@@ -0,0 +1,48 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "@tsparticles/engine"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.BubbleBase = void 0;
+    const engine_1 = require("@tsparticles/engine");
+    class BubbleBase {
+        constructor() {
+            this.distance = 200;
+            this.duration = 0.4;
+            this.mix = false;
+        }
+        load(data) {
+            if (!data) {
+                return;
+            }
+            if (data.distance !== undefined) {
+                this.distance = data.distance;
+            }
+            if (data.duration !== undefined) {
+                this.duration = data.duration;
+            }
+            if (data.mix !== undefined) {
+                this.mix = data.mix;
+            }
+            if (data.opacity !== undefined) {
+                this.opacity = data.opacity;
+            }
+            if (data.color !== undefined) {
+                const sourceColor = this.color instanceof Array ? undefined : this.color;
+                this.color = (0, engine_1.executeOnSingleOrMultiple)(data.color, (color) => {
+                    return engine_1.OptionsColor.create(sourceColor, color);
+                });
+            }
+            if (data.size !== undefined) {
+                this.size = data.size;
+            }
+        }
+    }
+    exports.BubbleBase = BubbleBase;
+});

package/umd/Options/Classes/BubbleDiv.js

@@ -0,0 +1,40 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "./BubbleBase", "@tsparticles/engine"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.BubbleDiv = void 0;
+    const BubbleBase_1 = require("./BubbleBase");
+    const engine_1 = require("@tsparticles/engine");
+    class BubbleDiv extends BubbleBase_1.BubbleBase {
+        constructor() {
+            super();
+            this.selectors = [];
+        }
+        get ids() {
+            return (0, engine_1.executeOnSingleOrMultiple)(this.selectors, (t) => t.replace("#", ""));
+        }
+        set ids(value) {
+            this.selectors = (0, engine_1.executeOnSingleOrMultiple)(value, (t) => `#${t}`);
+        }
+        load(data) {
+            super.load(data);
+            if (!data) {
+                return;
+            }
+            if (data.ids !== undefined) {
+                this.ids = data.ids;
+            }
+            if (data.selectors !== undefined) {
+                this.selectors = data.selectors;
+            }
+        }
+    }
+    exports.BubbleDiv = BubbleDiv;
+});

package/umd/Options/Classes/BubbleOptions.js

@@ -0,0 +1,12 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/Options/Interfaces/IBubble.js

@@ -0,0 +1,12 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/Options/Interfaces/IBubbleBase.js

@@ -0,0 +1,12 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/Options/Interfaces/IBubbleDiv.js

@@ -0,0 +1,12 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/ProcessBubbleType.js

@@ -0,0 +1,12 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/Types.js

@@ -0,0 +1,12 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/index.js

@@ -0,0 +1,38 @@
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "./Bubbler", "./Options/Classes/BubbleBase", "./Options/Classes/BubbleDiv", "./Options/Classes/Bubble", "./Options/Interfaces/IBubbleBase", "./Options/Interfaces/IBubbleDiv", "./Options/Interfaces/IBubble"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.loadExternalBubbleInteraction = void 0;
+    const Bubbler_1 = require("./Bubbler");
+    async function loadExternalBubbleInteraction(engine) {
+        await engine.addInteractor("externalBubble", (container) => new Bubbler_1.Bubbler(container));
+    }
+    exports.loadExternalBubbleInteraction = loadExternalBubbleInteraction;
+    __exportStar(require("./Options/Classes/BubbleBase"), exports);
+    __exportStar(require("./Options/Classes/BubbleDiv"), exports);
+    __exportStar(require("./Options/Classes/Bubble"), exports);
+    __exportStar(require("./Options/Interfaces/IBubbleBase"), exports);
+    __exportStar(require("./Options/Interfaces/IBubbleDiv"), exports);
+    __exportStar(require("./Options/Interfaces/IBubble"), exports);
+});