@tsparticles/plugin-sounds 4.0.0-beta.1 → 4.0.0-beta.10

package/umd/SoundsPluginInstance.js

@@ -1,451 +0,0 @@
-(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", "./enums.js", "./utils.js", "./constants.js"], factory);
-    }
-})(function (require, exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.SoundsPluginInstance = void 0;
-    const engine_1 = require("@tsparticles/engine");
-    const enums_js_1 = require("./enums.js");
-    const utils_js_1 = require("./utils.js");
-    const constants_js_1 = require("./constants.js");
-    const zIndexOffset = 1, rightOffset = 1, minVolume = 0;
-    function initImage(data) {
-        const img = (0, engine_1.safeDocument)().createElement("img"), { clickCb, container, display, iconOptions, margin, options, pos, rightOffsets } = data, { width, path, style, svg } = iconOptions, defaultAccumulator = 0;
-        setIconStyle(img, pos.top + margin, pos.right -
-            (margin * (rightOffsets.length + rightOffset) + width + rightOffsets.reduce((a, b) => a + b, defaultAccumulator)), display, options.fullScreen.zIndex + zIndexOffset, width, margin, style);
-        img.src = path ?? (svg ? `data:image/svg+xml;base64,${btoa(svg)}` : "");
-        const parent = container.canvas.element?.parentNode ?? (0, engine_1.safeDocument)().body;
-        parent.append(img);
-        img.addEventListener("click", () => {
-            void clickCb();
-        });
-        return img;
-    }
-    function removeImage(image) {
-        if (!image) {
-            return;
-        }
-        image.remove();
-    }
-    function setIconStyle(icon, top, left, display, zIndex, width, margin, style) {
-        icon.style.userSelect = "none";
-        icon.style.position = "absolute";
-        icon.style.top = `${(top + margin).toString()}px`;
-        icon.style.left = `${(left - margin - width).toString()}px`;
-        icon.style.display = display;
-        icon.style.zIndex = (zIndex + zIndexOffset).toString();
-        icon.style.cssText += style;
-    }
-    class SoundsPluginInstance {
-        _audioMap;
-        _audioSources;
-        _container;
-        _engine;
-        _gain;
-        _muteImg;
-        _unmuteImg;
-        _volume;
-        _volumeDownImg;
-        _volumeUpImg;
-        constructor(container, engine) {
-            this._container = container;
-            this._engine = engine;
-            this._volume = 0;
-            this._audioSources = [];
-            this._audioMap = new Map();
-        }
-        async init() {
-            const container = this._container, options = container.actualOptions, soundsOptions = options.sounds;
-            if (!soundsOptions?.enable) {
-                return;
-            }
-            if (soundsOptions.autoPlay && (0, utils_js_1.isWindowMuted)()) {
-                const firstClickHandler = () => {
-                    removeEventListener(constants_js_1.mouseDownEvent, firstClickHandler);
-                    removeEventListener(constants_js_1.touchStartEvent, firstClickHandler);
-                    (0, utils_js_1.unmuteWindow)();
-                    void this.unmute();
-                }, listenerOptions = {
-                    capture: true,
-                    once: true,
-                };
-                addEventListener(constants_js_1.mouseDownEvent, firstClickHandler, listenerOptions);
-                addEventListener(constants_js_1.touchStartEvent, firstClickHandler, listenerOptions);
-            }
-            this._volume = soundsOptions.volume.value;
-            const events = soundsOptions.events;
-            this._audioMap = new Map();
-            for (const event of events) {
-                if (!event.audio) {
-                    continue;
-                }
-                const promises = (0, engine_1.executeOnSingleOrMultiple)(event.audio, async (audio) => {
-                    const response = await fetch(audio.source);
-                    if (!response.ok) {
-                        return;
-                    }
-                    const arrayBuffer = await response.arrayBuffer(), audioContext = this._getAudioContext(), audioBuffer = await audioContext.decodeAudioData(arrayBuffer);
-                    this._audioMap.set(audio.source, audioBuffer);
-                });
-                if (promises instanceof Promise) {
-                    await promises;
-                }
-                else {
-                    await Promise.allSettled(promises);
-                }
-            }
-        }
-        async mute() {
-            if (!this._container.muted) {
-                await this.toggleMute();
-            }
-        }
-        async start() {
-            const container = this._container, options = container.actualOptions, soundsOptions = options.sounds;
-            if (!soundsOptions?.enable || !container.canvas.element) {
-                return;
-            }
-            container.muted = true;
-            const canvas = container.canvas.element, pos = {
-                top: canvas.offsetTop,
-                right: canvas.offsetLeft + canvas.offsetWidth,
-            }, { mute, unmute, volumeDown, volumeUp } = soundsOptions.icons, margin = 10, toggleMute = async () => {
-                await this.toggleMute();
-            }, enableIcons = soundsOptions.icons.enable, display = enableIcons ? enums_js_1.ImageDisplay.Block : enums_js_1.ImageDisplay.None;
-            this._muteImg = initImage({
-                container,
-                options,
-                pos,
-                display,
-                iconOptions: mute,
-                margin,
-                rightOffsets: [volumeDown.width, volumeUp.width],
-                clickCb: toggleMute,
-            });
-            this._unmuteImg = initImage({
-                container,
-                options,
-                pos,
-                display: enums_js_1.ImageDisplay.None,
-                iconOptions: unmute,
-                margin,
-                rightOffsets: [volumeDown.width, volumeUp.width],
-                clickCb: toggleMute,
-            });
-            this._volumeDownImg = initImage({
-                container,
-                options,
-                pos,
-                display,
-                iconOptions: volumeDown,
-                margin,
-                rightOffsets: [volumeUp.width],
-                clickCb: async () => {
-                    await this.volumeDown();
-                },
-            });
-            this._volumeUpImg = initImage({
-                container,
-                options,
-                pos,
-                display,
-                iconOptions: volumeUp,
-                margin,
-                rightOffsets: [],
-                clickCb: async () => {
-                    await this.volumeUp();
-                },
-            });
-            if (!(0, utils_js_1.isWindowMuted)() && soundsOptions.autoPlay) {
-                await this.unmute();
-            }
-        }
-        stop() {
-            this._container.muted = true;
-            void (async () => {
-                await this._mute();
-                removeImage(this._muteImg);
-                removeImage(this._unmuteImg);
-                removeImage(this._volumeDownImg);
-                removeImage(this._volumeUpImg);
-            })();
-        }
-        async toggleMute() {
-            const container = this._container;
-            container.muted = !container.muted;
-            this._updateMuteIcons();
-            await this._updateMuteStatus();
-        }
-        async unmute() {
-            if (this._container.muted) {
-                await this.toggleMute();
-            }
-        }
-        async volumeDown() {
-            const container = this._container, soundsOptions = container.actualOptions.sounds;
-            if (!soundsOptions?.enable) {
-                return;
-            }
-            if (container.muted) {
-                this._volume = 0;
-            }
-            this._volume -= soundsOptions.volume.step;
-            await this._updateVolume();
-        }
-        async volumeUp() {
-            const container = this._container, soundsOptions = container.actualOptions.sounds;
-            if (!soundsOptions?.enable) {
-                return;
-            }
-            this._volume += soundsOptions.volume.step;
-            await this._updateVolume();
-        }
-        _addBuffer = audioCtx => {
-            const buffer = audioCtx.createBufferSource();
-            this._audioSources.push(buffer);
-            return buffer;
-        };
-        _addOscillator = audioCtx => {
-            const oscillator = audioCtx.createOscillator();
-            this._audioSources.push(oscillator);
-            return oscillator;
-        };
-        _getAudioContext() {
-            const container = this._container;
-            container.audioContext ??= new AudioContext();
-            return container.audioContext;
-        }
-        _initEvents = () => {
-            const container = this._container, soundsOptions = container.actualOptions.sounds;
-            if (!soundsOptions?.enable || !container.canvas.element) {
-                return;
-            }
-            for (const event of soundsOptions.events) {
-                const cb = (args) => {
-                    if (!args) {
-                        return;
-                    }
-                    void (async () => {
-                        const filterNotValid = event.filter && !event.filter(args);
-                        if (this._container !== args.container) {
-                            return;
-                        }
-                        if (!!this._container.muted || this._container.destroyed) {
-                            (0, engine_1.executeOnSingleOrMultiple)(event.event, item => {
-                                this._engine.removeEventListener(item, cb);
-                            });
-                            return;
-                        }
-                        if (filterNotValid) {
-                            return;
-                        }
-                        const defaultNoteIndex = 0;
-                        if (event.audio) {
-                            const audio = (0, engine_1.itemFromSingleOrMultiple)(event.audio);
-                            if (!audio) {
-                                return;
-                            }
-                            this._playBuffer(audio);
-                        }
-                        else if (event.melodies) {
-                            const melody = (0, engine_1.itemFromArray)(event.melodies);
-                            if (!melody) {
-                                return;
-                            }
-                            if (melody.melodies.length) {
-                                await Promise.allSettled(melody.melodies.map(m => this._playNote(m.notes, defaultNoteIndex, melody.loop)));
-                            }
-                            else {
-                                await this._playNote(melody.notes, defaultNoteIndex, melody.loop);
-                            }
-                        }
-                        else if (event.notes) {
-                            const note = (0, engine_1.itemFromArray)(event.notes);
-                            if (!note) {
-                                return;
-                            }
-                            await this._playNote([note], defaultNoteIndex, false);
-                        }
-                    })();
-                };
-                (0, engine_1.executeOnSingleOrMultiple)(event.event, item => {
-                    this._engine.addEventListener(item, cb);
-                });
-            }
-        };
-        _mute = async () => {
-            const container = this._container, audioContext = this._getAudioContext();
-            for (const source of this._audioSources) {
-                this._removeAudioSource(source);
-            }
-            if (this._gain) {
-                this._gain.disconnect();
-            }
-            await audioContext.close();
-            container.audioContext = undefined;
-            this._container.dispatchEvent(enums_js_1.SoundsEventType.mute);
-        };
-        _playBuffer = audio => {
-            const audioBuffer = this._audioMap.get(audio.source);
-            if (!audioBuffer) {
-                return;
-            }
-            const audioCtx = this._container.audioContext;
-            if (!audioCtx) {
-                return;
-            }
-            const source = this._addBuffer(audioCtx);
-            source.loop = audio.loop;
-            source.buffer = audioBuffer;
-            source.connect(this._gain ?? audioCtx.destination);
-            source.start();
-        };
-        _playFrequency = async (frequency, duration) => {
-            if (!this._gain || this._container.muted) {
-                return;
-            }
-            const audioContext = this._getAudioContext(), oscillator = this._addOscillator(audioContext);
-            oscillator.connect(this._gain);
-            oscillator.type = "sine";
-            oscillator.frequency.value = frequency;
-            oscillator.start();
-            return new Promise(resolve => {
-                setTimeout(() => {
-                    this._removeAudioSource(oscillator);
-                    resolve();
-                }, duration);
-            });
-        };
-        _playMuteSound = () => {
-            if (this._container.muted) {
-                return;
-            }
-            const audioContext = this._getAudioContext(), gain = audioContext.createGain();
-            gain.connect(audioContext.destination);
-            gain.gain.value = 0;
-            const oscillator = audioContext.createOscillator();
-            oscillator.connect(gain);
-            oscillator.type = "sine";
-            oscillator.frequency.value = 1;
-            oscillator.start();
-            setTimeout(() => {
-                oscillator.stop();
-                oscillator.disconnect();
-                gain.disconnect();
-            });
-        };
-        _playNote = async (notes, noteIdx, loop) => {
-            if (this._container.muted) {
-                return;
-            }
-            const note = notes[noteIdx];
-            if (!note) {
-                return;
-            }
-            const value = note.value, promises = (0, engine_1.executeOnSingleOrMultiple)(value, async (_, idx) => {
-                return this._playNoteValue(notes, noteIdx, idx);
-            });
-            await ((0, engine_1.isArray)(promises) ? Promise.allSettled(promises) : promises);
-            const indexOffset = 1;
-            let nextNoteIdx = noteIdx + indexOffset;
-            if (loop && nextNoteIdx >= notes.length) {
-                nextNoteIdx = nextNoteIdx % notes.length;
-            }
-            await this._playNote(notes, nextNoteIdx, loop);
-        };
-        _playNoteValue = async (notes, noteIdx, valueIdx) => {
-            const note = notes[noteIdx];
-            if (!note) {
-                return;
-            }
-            const value = (0, engine_1.itemFromSingleOrMultiple)(note.value, valueIdx, true);
-            if (!value) {
-                return;
-            }
-            try {
-                const freq = (0, utils_js_1.getNoteFrequency)(value);
-                if (!(0, engine_1.isNumber)(freq)) {
-                    return;
-                }
-                await this._playFrequency(freq, note.duration);
-            }
-            catch (e) {
-                (0, engine_1.getLogger)().error(e);
-            }
-        };
-        _removeAudioSource = source => {
-            source.stop();
-            source.disconnect();
-            const deleteCount = 1;
-            this._audioSources.splice(this._audioSources.indexOf(source), deleteCount);
-        };
-        _unmute = () => {
-            const container = this._container, options = container.actualOptions, soundsOptions = options.sounds;
-            if (!soundsOptions) {
-                return;
-            }
-            const audioContext = this._getAudioContext(), gain = audioContext.createGain();
-            gain.connect(audioContext.destination);
-            gain.gain.value = soundsOptions.volume.value / engine_1.percentDenominator;
-            this._gain = gain;
-            this._initEvents();
-            this._container.dispatchEvent(enums_js_1.SoundsEventType.unmute);
-        };
-        _updateMuteIcons = () => {
-            const container = this._container, soundsOptions = container.actualOptions.sounds;
-            if (!soundsOptions?.enable || !soundsOptions.icons.enable) {
-                return;
-            }
-            const muteImg = this._muteImg, unmuteImg = this._unmuteImg;
-            if (muteImg) {
-                muteImg.style.display = container.muted ? "block" : "none";
-            }
-            if (unmuteImg) {
-                unmuteImg.style.display = container.muted ? "none" : "block";
-            }
-        };
-        _updateMuteStatus = async () => {
-            const container = this._container, audioContext = this._getAudioContext();
-            if (container.muted) {
-                await audioContext.suspend();
-                await this._mute();
-            }
-            else {
-                await audioContext.resume();
-                this._unmute();
-                this._playMuteSound();
-            }
-        };
-        _updateVolume = async () => {
-            const container = this._container, soundsOptions = container.actualOptions.sounds;
-            if (!soundsOptions?.enable) {
-                return;
-            }
-            (0, engine_1.clamp)(this._volume, soundsOptions.volume.min, soundsOptions.volume.max);
-            let stateChanged = false;
-            if (this._volume <= minVolume && !container.muted) {
-                this._volume = 0;
-                container.muted = true;
-                stateChanged = true;
-            }
-            else if (this._volume > minVolume && container.muted) {
-                container.muted = false;
-                stateChanged = true;
-            }
-            if (stateChanged) {
-                this._updateMuteIcons();
-                await this._updateMuteStatus();
-            }
-            if (this._gain?.gain) {
-                this._gain.gain.value = this._volume / engine_1.percentDenominator;
-            }
-        };
-    }
-    exports.SoundsPluginInstance = SoundsPluginInstance;
-});

package/umd/constants.js

@@ -1,14 +0,0 @@
-(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 });
-    exports.touchStartEvent = exports.mouseDownEvent = void 0;
-    exports.mouseDownEvent = "pointerdown", exports.touchStartEvent = "touchstart";
-});

package/umd/enums.js

@@ -1,23 +0,0 @@
-(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 });
-    exports.ImageDisplay = exports.SoundsEventType = void 0;
-    var SoundsEventType;
-    (function (SoundsEventType) {
-        SoundsEventType["mute"] = "soundsMuted";
-        SoundsEventType["unmute"] = "soundsUnmuted";
-    })(SoundsEventType || (exports.SoundsEventType = SoundsEventType = {}));
-    var ImageDisplay;
-    (function (ImageDisplay) {
-        ImageDisplay["Block"] = "block";
-        ImageDisplay["None"] = "none";
-    })(ImageDisplay || (exports.ImageDisplay = ImageDisplay = {}));
-});

package/umd/index.js

@@ -1,54 +0,0 @@
-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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-(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";
-    var __syncRequire = typeof module === "object" && typeof module.exports === "object";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.loadSoundsPlugin = loadSoundsPlugin;
-    async function loadSoundsPlugin(engine) {
-        engine.checkVersion("4.0.0-beta.1");
-        await engine.pluginManager.register(async (e) => {
-            const { SoundsPlugin } = await (__syncRequire ? Promise.resolve().then(() => __importStar(require("./SoundsPlugin.js"))) : new Promise((resolve_1, reject_1) => { require(["./SoundsPlugin.js"], resolve_1, reject_1); }).then(__importStar));
-            e.pluginManager.addPlugin(new SoundsPlugin(e));
-        });
-    }
-});

package/umd/types.js

@@ -1,12 +0,0 @@
-(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/utils.js

@@ -1,48 +0,0 @@
-(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 });
-    exports.unmuteWindow = exports.isWindowMuted = void 0;
-    exports.getNoteFrequency = getNoteFrequency;
-    const notes = new Map();
-    notes.set("C", [16.35, 32.7, 65.41, 130.81, 261.63, 523.25, 1046.5, 2093.0, 4186.01]);
-    notes.set("Db", [17.32, 34.65, 69.3, 138.59, 277.18, 554.37, 1108.73, 2217.46, 4434.92]);
-    notes.set("D", [18.35, 36.71, 73.42, 146.83, 293.66, 587.33, 1174.66, 2349.32, 4698.63]);
-    notes.set("Eb", [19.45, 38.89, 77.78, 155.56, 311.13, 622.25, 1244.51, 2489.02, 4978.03]);
-    notes.set("E", [20.6, 41.2, 82.41, 164.81, 329.63, 659.25, 1318.51, 2637.02, 5274.04]);
-    notes.set("F", [21.83, 43.65, 87.31, 174.61, 349.23, 698.46, 1396.91, 2793.83, 5587.65]);
-    notes.set("Gb", [23.12, 46.25, 92.5, 185.0, 369.99, 739.99, 1479.98, 2959.96, 5919.91]);
-    notes.set("G", [24.5, 49.0, 98.0, 196.0, 392.0, 783.99, 1567.98, 3135.96, 6271.93]);
-    notes.set("Ab", [25.96, 51.91, 103.83, 207.65, 415.3, 830.61, 1661.22, 3322.44, 6644.88]);
-    notes.set("A", [27.5, 55.0, 110.0, 220.0, 440.0, 880.0, 1760.0, 3520.0, 7040.0]);
-    notes.set("Bb", [29.14, 58.27, 116.54, 233.08, 466.16, 932.33, 1864.66, 3729.31, 7458.62]);
-    notes.set("B", [30.87, 61.74, 123.47, 246.94, 493.88, 987.77, 1975.53, 3951.07, 7902.13]);
-    notes.set("pause", [0]);
-    function getNoteFrequency(note) {
-        const regex = /(([A-G]b?)(\d))|pause/i, result = regex.exec(note), groupKey = 2, defaultMatchKey = 0, innerGroupKey = 3;
-        if (!result?.length) {
-            return;
-        }
-        const noteKey = result[groupKey] ?? result[defaultMatchKey], noteItem = notes.get(noteKey);
-        if (!noteItem) {
-            return;
-        }
-        return noteItem[parseInt(result[innerGroupKey] ?? "0")];
-    }
-    let muted = true;
-    const isWindowMuted = () => {
-        return muted;
-    };
-    exports.isWindowMuted = isWindowMuted;
-    const unmuteWindow = () => {
-        muted = false;
-    };
-    exports.unmuteWindow = unmuteWindow;
-});