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

package/cjs/Bubbler.js

@@ -0,0 +1,309 @@
+"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.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;
+        }
+    }
+    interact(delta) {
+        return __awaiter(this, void 0, void 0, function* () {
+            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/cjs/IBubblerProcessParam.js

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

package/cjs/Options/Classes/Bubble.js

@@ -0,0 +1,20 @@
+"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/cjs/Options/Classes/BubbleBase.js

@@ -0,0 +1,38 @@
+"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/cjs/Options/Classes/BubbleDiv.js

@@ -0,0 +1,30 @@
+"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/cjs/Options/Classes/BubbleOptions.js

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

package/cjs/Options/Interfaces/IBubble.js

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

package/cjs/Options/Interfaces/IBubbleBase.js

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

package/cjs/Options/Interfaces/IBubbleDiv.js

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

package/cjs/ProcessBubbleType.js

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

package/cjs/Types.js

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

package/cjs/index.js

@@ -0,0 +1,39 @@
+"use strict";
+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);
+};
+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.loadExternalBubbleInteraction = void 0;
+const Bubbler_1 = require("./Bubbler");
+function loadExternalBubbleInteraction(engine) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield 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);