custom-pixi-particles 4.28.0 → 4.30.0

package/dist/lib/effects/GlitchEffect.js

@@ -0,0 +1,144 @@
+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());
+    });
+};
+import { Sprite, Texture, Ticker, Rectangle, ParticleContainer, BLEND_MODES } from 'pixi.js-legacy';
+import ParticlePool from '../ParticlePool';
+export default class GlitchEffect extends ParticleContainer {
+    constructor(sourceSprite, options = {}) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const slices = (_a = options.slices) !== null && _a !== void 0 ? _a : 15;
+        const isRGB = (_b = options.rgbSplit) !== null && _b !== void 0 ? _b : true;
+        // Max particles: slices * 3 (if RGB)
+        super(slices * (isRGB ? 3 : 1), {
+            vertices: true,
+            position: true,
+            uvs: true,
+            alpha: true,
+            tint: true,
+        });
+        this.sourceSprite = sourceSprite;
+        this.fragments = [];
+        this.currentTime = 0;
+        this.lastRefreshTime = 0;
+        this.isProcessing = false;
+        this.options = {
+            slices: slices,
+            offsetRange: (_c = options.offsetRange) !== null && _c !== void 0 ? _c : 30,
+            flickerIntensity: (_d = options.flickerIntensity) !== null && _d !== void 0 ? _d : 0.3,
+            rgbSplit: isRGB,
+            rgbOffset: (_e = options.rgbOffset) !== null && _e !== void 0 ? _e : 10,
+            duration: (_f = options.duration) !== null && _f !== void 0 ? _f : 0.5,
+            refreshRate: (_g = options.refreshRate) !== null && _g !== void 0 ? _g : 0.06,
+        };
+        this.x = sourceSprite.x;
+        this.y = sourceSprite.y;
+        this.rotation = sourceSprite.rotation;
+    }
+    prepare() {
+        const texture = this.sourceSprite.texture;
+        if (!texture || !texture.valid)
+            return;
+        const { slices, rgbSplit } = this.options;
+        const texFrame = texture.frame;
+        const sliceHeight = texFrame.height / slices;
+        const scale = this.sourceSprite.scale.x;
+        const anchorX = this.sourceSprite.anchor.x;
+        const anchorY = this.sourceSprite.anchor.y;
+        for (let i = 0; i < slices; i++) {
+            const yOffset = i * sliceHeight;
+            const fragRect = new Rectangle(texFrame.x, texFrame.y + yOffset, texFrame.width, sliceHeight);
+            const fragTex = new Texture(texture.baseTexture, fragRect);
+            const sliceSprites = [];
+            const tints = rgbSplit ? [0xFF0000, 0x00FF00, 0x0000FF] : [0xFFFFFF];
+            tints.forEach(tint => {
+                const sprite = new Sprite(fragTex);
+                sprite.anchor.set(anchorX, 0); // Anchor top-left of slice
+                sprite.scale.set(scale);
+                sprite.tint = tint;
+                if (rgbSplit)
+                    sprite.blendMode = BLEND_MODES.ADD;
+                sliceSprites.push(sprite);
+                this.addChild(sprite);
+            });
+            const p = ParticlePool.global.pop();
+            p.reset();
+            this.fragments.push({
+                sprites: sliceSprites,
+                particle: p,
+                initialY: (yOffset - (texFrame.height * anchorY)) * scale
+            });
+        }
+        this.sourceSprite.visible = false;
+    }
+    play() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.prepare();
+            this.isProcessing = true;
+            return new Promise((resolve) => {
+                this.glitchResolve = resolve;
+                Ticker.shared.add(this.update, this);
+            });
+        });
+    }
+    update() {
+        if (!this.isProcessing)
+            return;
+        const dt = Ticker.shared.deltaMS / 1000;
+        this.currentTime += dt;
+        this.lastRefreshTime += dt;
+        const shouldRefresh = this.lastRefreshTime >= this.options.refreshRate;
+        for (let i = 0; i < this.fragments.length; i++) {
+            const f = this.fragments[i];
+            if (shouldRefresh) {
+                // Calculate new random glitch state for this slice
+                const isVisible = Math.random() > (this.options.flickerIntensity * 0.5);
+                const xShift = (Math.random() - 0.5) * 2 * this.options.offsetRange;
+                f.sprites.forEach((s, index) => {
+                    s.visible = isVisible;
+                    s.y = f.initialY;
+                    // RGB channel drift
+                    let channelOffset = 0;
+                    if (this.options.rgbSplit) {
+                        channelOffset = (index - 1) * (Math.random() * this.options.rgbOffset);
+                    }
+                    s.x = xShift + channelOffset;
+                    // Randomly turn some slices into white blocks (Digital Noise)
+                    if (Math.random() > 0.98) {
+                        s.tint = 0xFFFFFF;
+                        s.texture = Texture.WHITE;
+                    }
+                });
+            }
+        }
+        if (shouldRefresh)
+            this.lastRefreshTime = 0;
+        if (this.currentTime >= this.options.duration) {
+            this.finish();
+        }
+    }
+    finish() {
+        var _a;
+        this.isProcessing = false;
+        Ticker.shared.remove(this.update, this);
+        this.sourceSprite.visible = true;
+        (_a = this.glitchResolve) === null || _a === void 0 ? void 0 : _a.call(this);
+    }
+    static glitch(sprite_1) {
+        return __awaiter(this, arguments, void 0, function* (sprite, options = {}) {
+            if (!sprite.parent)
+                return;
+            const effect = new GlitchEffect(sprite, options);
+            const index = sprite.parent.getChildIndex(sprite);
+            sprite.parent.addChildAt(effect, index);
+            yield effect.play();
+            effect.destroy({ children: true });
+        });
+    }
+}
+//# sourceMappingURL=GlitchEffect.js.map

package/dist/lib/effects/GlitchEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlitchEffect.js","sourceRoot":"","sources":["../../../src/lib/effects/GlitchEffect.ts"],"names":[],"mappings":"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"}

package/dist/lib/effects/MagneticAssemblyEffect.d.ts

@@ -0,0 +1,27 @@
+import { Sprite, ParticleContainer } from 'pixi.js-legacy';
+export type AssemblyMode = 'random-scatter' | 'from-center' | 'off-screen' | 'vortex';
+export interface IMagneticAssemblyOptions {
+    gridCols?: number;
+    gridRows?: number;
+    duration?: number;
+    easing?: string;
+    scatterRange?: number;
+    stagger?: number;
+    mode?: AssemblyMode;
+    startAlpha?: number;
+}
+export default class MagneticAssemblyEffect extends ParticleContainer {
+    private sourceSprite;
+    private fragments;
+    private isProcessing;
+    private options;
+    private currentTime;
+    private assemblyResolve?;
+    constructor(sourceSprite: Sprite, options?: IMagneticAssemblyOptions);
+    private prepare;
+    assemble(): Promise<void>;
+    private update;
+    private applyEasing;
+    private finish;
+    static assemble(sprite: Sprite, options?: IMagneticAssemblyOptions): Promise<void>;
+}

package/dist/lib/effects/MagneticAssemblyEffect.js

@@ -0,0 +1,186 @@
+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());
+    });
+};
+import { Sprite, Texture, Ticker, Rectangle, ParticleContainer } from 'pixi.js-legacy';
+import ParticlePool from '../ParticlePool';
+import Random from '../util/Random';
+export default class MagneticAssemblyEffect extends ParticleContainer {
+    constructor(sourceSprite, options = {}) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        const cols = (_a = options.gridCols) !== null && _a !== void 0 ? _a : 10;
+        const rows = (_b = options.gridRows) !== null && _b !== void 0 ? _b : 10;
+        super(cols * rows, {
+            vertices: true,
+            position: true,
+            uvs: true,
+            alpha: true,
+            rotation: true,
+        });
+        this.sourceSprite = sourceSprite;
+        this.fragments = [];
+        this.isProcessing = false;
+        this.currentTime = 0;
+        this.options = {
+            gridCols: cols,
+            gridRows: rows,
+            duration: (_c = options.duration) !== null && _c !== void 0 ? _c : 2.0,
+            easing: (_d = options.easing) !== null && _d !== void 0 ? _d : 'back.out',
+            scatterRange: (_e = options.scatterRange) !== null && _e !== void 0 ? _e : 500,
+            stagger: (_f = options.stagger) !== null && _f !== void 0 ? _f : 0.5,
+            mode: (_g = options.mode) !== null && _g !== void 0 ? _g : 'random-scatter',
+            startAlpha: (_h = options.startAlpha) !== null && _h !== void 0 ? _h : 0,
+        };
+        // Match source sprite transform
+        this.x = sourceSprite.x;
+        this.y = sourceSprite.y;
+        this.rotation = sourceSprite.rotation;
+    }
+    prepare() {
+        const texture = this.sourceSprite.texture;
+        if (!texture || !texture.valid)
+            return;
+        const { gridCols, gridRows, scatterRange, mode, stagger } = this.options;
+        const texFrame = texture.frame;
+        const stepW = texFrame.width / gridCols;
+        const stepH = texFrame.height / gridRows;
+        const scale = this.sourceSprite.scale.x;
+        const anchorX = this.sourceSprite.anchor.x;
+        const anchorY = this.sourceSprite.anchor.y;
+        for (let row = 0; row < gridRows; row++) {
+            for (let col = 0; col < gridCols; col++) {
+                const x1 = Math.floor(col * stepW);
+                const y1 = Math.floor(row * stepH);
+                // Create sub-texture
+                const fragRect = new Rectangle(texFrame.x + x1, texFrame.y + y1, stepW, stepH);
+                const fragTex = new Texture(texture.baseTexture, fragRect);
+                const sprite = new Sprite(fragTex);
+                sprite.anchor.set(0.5);
+                sprite.scale.set(scale);
+                sprite.alpha = this.options.startAlpha;
+                // Destination: The original spot in the sprite
+                const dx = (x1 - (texFrame.width * anchorX) + stepW / 2) * scale;
+                const dy = (y1 - (texFrame.height * anchorY) + stepH / 2) * scale;
+                // Starting point logic
+                let sx = 0, sy = 0;
+                switch (mode) {
+                    case 'from-center':
+                        sx = 0;
+                        sy = 0;
+                        break;
+                    case 'off-screen':
+                        sx = Math.random() > 0.5 ? scatterRange : -scatterRange;
+                        sy = Random.uniform(-scatterRange, scatterRange);
+                        break;
+                    case 'vortex':
+                        const angle = Math.random() * Math.PI * 2;
+                        sx = Math.cos(angle) * scatterRange;
+                        sy = Math.sin(angle) * scatterRange;
+                        break;
+                    case 'random-scatter':
+                    default:
+                        sx = dx + Random.uniform(-scatterRange, scatterRange);
+                        sy = dy + Random.uniform(-scatterRange, scatterRange);
+                        break;
+                }
+                const p = ParticlePool.global.pop();
+                p.reset();
+                // Stagger logic: pieces start at different times based on position or random
+                const delay = ((row * gridCols + col) / (gridCols * gridRows)) * stagger;
+                this.fragments.push({
+                    sprite, particle: p,
+                    startX: sx, startY: sy,
+                    destX: dx, destY: dy,
+                    delay
+                });
+                this.addChild(sprite);
+            }
+        }
+        this.sourceSprite.visible = false;
+    }
+    assemble() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.prepare();
+            this.isProcessing = true;
+            return new Promise((resolve) => {
+                this.assemblyResolve = resolve;
+                Ticker.shared.add(this.update, this);
+            });
+        });
+    }
+    update() {
+        if (!this.isProcessing)
+            return;
+        const dt = Ticker.shared.deltaMS / 1000;
+        this.currentTime += dt;
+        let finished = 0;
+        for (let i = 0; i < this.fragments.length; i++) {
+            const f = this.fragments[i];
+            // Calculate individual progress based on delay
+            let p = (this.currentTime - f.delay) / (this.options.duration - f.delay);
+            p = Math.max(0, Math.min(1, p));
+            if (p > 0) {
+                const easedP = this.applyEasing(p, this.options.easing);
+                f.sprite.x = f.startX + (f.destX - f.startX) * easedP;
+                f.sprite.y = f.startY + (f.destY - f.startY) * easedP;
+                f.sprite.alpha = Math.max(this.options.startAlpha, p);
+                // Slight rotation adjustment to make it look "magnetic"
+                if (this.options.easing.includes('back')) {
+                    f.sprite.rotation = (1 - easedP) * 0.5;
+                }
+            }
+            else {
+                f.sprite.x = f.startX;
+                f.sprite.y = f.startY;
+            }
+            if (p >= 1)
+                finished++;
+        }
+        if (finished === this.fragments.length) {
+            this.finish();
+        }
+    }
+    applyEasing(t, type) {
+        switch (type) {
+            case 'power1.inOut': return t < 0.5 ? 2 * t * t : 1 - Math.pow(-2 * t + 2, 2) / 2;
+            case 'bounce.out':
+                const n1 = 7.5625, d1 = 2.75;
+                if (t < 1 / d1)
+                    return n1 * t * t;
+                else if (t < 2 / d1)
+                    return n1 * (t -= 1.5 / d1) * t + 0.75;
+                else if (t < 2.5 / d1)
+                    return n1 * (t -= 2.25 / d1) * t + 0.9375;
+                else
+                    return n1 * (t -= 2.625 / d1) * t + 0.984375;
+            case 'back.out':
+                const c1 = 1.70158, c3 = c1 + 1;
+                return 1 + c3 * Math.pow(t - 1, 3) + c1 * Math.pow(t - 1, 2);
+            default: return t; // linear
+        }
+    }
+    finish() {
+        var _a;
+        this.isProcessing = false;
+        Ticker.shared.remove(this.update, this);
+        this.sourceSprite.visible = true; // Restore original
+        (_a = this.assemblyResolve) === null || _a === void 0 ? void 0 : _a.call(this);
+    }
+    static assemble(sprite_1) {
+        return __awaiter(this, arguments, void 0, function* (sprite, options = {}) {
+            if (!sprite.parent)
+                return;
+            const effect = new MagneticAssemblyEffect(sprite, options);
+            const index = sprite.parent.getChildIndex(sprite);
+            sprite.parent.addChildAt(effect, index);
+            yield effect.assemble();
+            effect.destroy({ children: true });
+        });
+    }
+}
+//# sourceMappingURL=MagneticAssemblyEffect.js.map

package/dist/lib/effects/MagneticAssemblyEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MagneticAssemblyEffect.js","sourceRoot":"","sources":["../../../src/lib/effects/MagneticAssemblyEffect.ts"],"names":[],"mappings":"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"}

package/dist/lib/effects/MeltEffect.d.ts

@@ -0,0 +1,27 @@
+import { Sprite, Container } from 'pixi.js-legacy';
+export interface IMeltEffectOptions {
+    gridCols?: number;
+    gridRows?: number;
+    gravity?: number;
+    viscosity?: number;
+    horizontalSpread?: number;
+    duration?: number;
+    blurAmount?: number;
+    threshold?: number;
+}
+export default class MeltEffect extends Container {
+    private sourceSprite;
+    private fragments;
+    private isProcessing;
+    private options;
+    private meltResolve?;
+    private pContainer;
+    private currentTime;
+    constructor(sourceSprite: Sprite, options?: IMeltEffectOptions);
+    private prepare;
+    start(): Promise<void>;
+    private update;
+    private removeFragment;
+    private finish;
+    static melt(sprite: Sprite, options?: IMeltEffectOptions): Promise<void>;
+}

package/dist/lib/effects/MeltEffect.js

@@ -0,0 +1,188 @@
+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());
+    });
+};
+import { Sprite, Texture, Ticker, Rectangle, ParticleContainer, Filter, Container } from 'pixi.js-legacy';
+import ParticlePool from '../ParticlePool';
+import Random from '../util/Random';
+// Simple blur shader (box blur)
+const blurFrag = `
+  precision mediump float;
+  varying vec2 vTextureCoord;
+  uniform sampler2D uSampler;
+  uniform float uBlur;
+  
+  void main(void) {
+    vec4 sum = vec4(0.0);
+    float blurAmount = uBlur * 0.01; // Scale blur amount
+    
+    // Sample 9 pixels in a 3x3 grid
+    for(int i = -1; i <= 1; i++) {
+      for(int j = -1; j <= 1; j++) {
+        vec2 offset = vec2(float(i), float(j)) * blurAmount;
+        sum += texture2D(uSampler, vTextureCoord + offset);
+      }
+    }
+    
+    gl_FragColor = sum / 9.0;
+  }
+`;
+// Simple threshold shader to create the "Metaball" effect
+const thresholdFrag = `
+  varying vec2 vTextureCoord;
+  uniform sampler2D uSampler;
+  uniform float threshold;
+  void main(void) {
+    vec4 color = texture2D(uSampler, vTextureCoord);
+    if (color.a > threshold) {
+       color.a = 1.0;
+    } else {
+       color.a = 0.0;
+    }
+    gl_FragColor = color;
+  }
+`;
+export default class MeltEffect extends Container {
+    constructor(sourceSprite, options = {}) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        super();
+        this.sourceSprite = sourceSprite;
+        this.fragments = [];
+        this.isProcessing = false;
+        this.currentTime = 0;
+        const cols = (_a = options.gridCols) !== null && _a !== void 0 ? _a : 15;
+        const rows = (_b = options.gridRows) !== null && _b !== void 0 ? _b : 15;
+        this.options = {
+            gridCols: cols,
+            gridRows: rows,
+            gravity: (_c = options.gravity) !== null && _c !== void 0 ? _c : 1200,
+            viscosity: (_d = options.viscosity) !== null && _d !== void 0 ? _d : 0.98,
+            horizontalSpread: (_e = options.horizontalSpread) !== null && _e !== void 0 ? _e : 50,
+            duration: (_f = options.duration) !== null && _f !== void 0 ? _f : 2.5,
+            blurAmount: (_g = options.blurAmount) !== null && _g !== void 0 ? _g : 6,
+            threshold: (_h = options.threshold) !== null && _h !== void 0 ? _h : 0.5,
+        };
+        // We use a internal ParticleContainer so we can apply filters to it
+        this.pContainer = new ParticleContainer(cols * rows, {
+            vertices: true,
+            position: true,
+            uvs: true,
+            alpha: true,
+            tint: true,
+        });
+        this.addChild(this.pContainer);
+        this.x = sourceSprite.x;
+        this.y = sourceSprite.y;
+        this.rotation = sourceSprite.rotation;
+        // Apply the Metaball Hook: Blur + Threshold
+        const blurFilter = new Filter(undefined, blurFrag, {
+            uBlur: this.options.blurAmount
+        });
+        const thresholdFilter = new Filter(undefined, thresholdFrag, {
+            threshold: this.options.threshold
+        });
+        this.pContainer.filters = [blurFilter, thresholdFilter];
+    }
+    prepare() {
+        const texture = this.sourceSprite.texture;
+        if (!texture || !texture.valid)
+            return;
+        const { gridCols, gridRows, horizontalSpread } = this.options;
+        const texFrame = texture.frame;
+        const stepW = texFrame.width / gridCols;
+        const stepH = texFrame.height / gridRows;
+        const scale = this.sourceSprite.scale.x;
+        const anchorX = this.sourceSprite.anchor.x;
+        const anchorY = this.sourceSprite.anchor.y;
+        for (let row = 0; row < gridRows; row++) {
+            for (let col = 0; col < gridCols; col++) {
+                const x1 = Math.floor(col * stepW);
+                const y1 = Math.floor(row * stepH);
+                const fragRect = new Rectangle(texFrame.x + x1, texFrame.y + y1, stepW, stepH);
+                const fragTex = new Texture(texture.baseTexture, fragRect);
+                const sprite = new Sprite(fragTex);
+                sprite.anchor.set(0.5);
+                sprite.scale.set(scale);
+                const lx = (x1 - (texFrame.width * anchorX) + stepW / 2) * scale;
+                const ly = (y1 - (texFrame.height * anchorY) + stepH / 2) * scale;
+                const p = ParticlePool.global.pop();
+                p.reset();
+                p.x = lx;
+                p.y = ly;
+                // High gravity, low horizontal velocity
+                p.velocity.set(Random.uniform(-horizontalSpread, horizontalSpread), Random.uniform(0, 50));
+                this.fragments.push({ sprite, particle: p });
+                this.pContainer.addChild(sprite);
+            }
+        }
+        this.sourceSprite.visible = false;
+    }
+    start() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.prepare();
+            this.isProcessing = true;
+            return new Promise((resolve) => {
+                this.meltResolve = resolve;
+                Ticker.shared.add(this.update, this);
+            });
+        });
+    }
+    update() {
+        if (!this.isProcessing)
+            return;
+        const dt = Ticker.shared.deltaMS / 1000;
+        this.currentTime += dt;
+        for (let i = this.fragments.length - 1; i >= 0; i--) {
+            const f = this.fragments[i];
+            const p = f.particle;
+            // Gravity and Viscosity
+            p.velocity.y += this.options.gravity * dt;
+            p.velocity.x *= this.options.viscosity;
+            p.velocity.y *= this.options.viscosity;
+            p.x += p.velocity.x * dt;
+            p.y += p.velocity.y * dt;
+            f.sprite.x = p.x;
+            f.sprite.y = p.y;
+            // Gradually shrink fragments so the liquid "dries up"
+            const lifeRatio = 1 - (this.currentTime / this.options.duration);
+            f.sprite.scale.set(this.sourceSprite.scale.x * lifeRatio);
+            if (lifeRatio <= 0) {
+                this.removeFragment(i);
+            }
+        }
+        if (this.fragments.length === 0) {
+            this.finish();
+        }
+    }
+    removeFragment(index) {
+        const f = this.fragments[index];
+        if (f.particle)
+            ParticlePool.global.push(f.particle);
+        this.pContainer.removeChild(f.sprite);
+        f.sprite.destroy();
+        this.fragments.splice(index, 1);
+    }
+    finish() {
+        var _a;
+        this.isProcessing = false;
+        Ticker.shared.remove(this.update, this);
+        (_a = this.meltResolve) === null || _a === void 0 ? void 0 : _a.call(this);
+    }
+    static melt(sprite_1) {
+        return __awaiter(this, arguments, void 0, function* (sprite, options = {}) {
+            if (!sprite.parent)
+                return;
+            const effect = new MeltEffect(sprite, options);
+            const index = sprite.parent.getChildIndex(sprite);
+            sprite.parent.addChildAt(effect, index);
+            yield effect.start();
+            effect.destroy({ children: true });
+        });
+    }
+}
+//# sourceMappingURL=MeltEffect.js.map

package/dist/lib/effects/MeltEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeltEffect.js","sourceRoot":"","sources":["../../../src/lib/effects/MeltEffect.ts"],"names":[],"mappings":"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"}

package/dist/lib/effects/ShatterEffect.d.ts

@@ -1,4 +1,4 @@
-import { Container, Sprite } from 'pixi.js-legacy';
+import { Sprite, ParticleContainer } from 'pixi.js-legacy';
 export type ShatterMode = 'radial' | 'directional' | 'swirl';
 export interface IShatterEffectOptions {
     gridCols?: number;
@@ -18,8 +18,10 @@ export interface IShatterEffectOptions {
     swirlStrength?: number;
     randomizeScale?: boolean;
     endTint?: number;
+    enableRotation?: boolean;
+    rotationStrength?: number;
 }
-export default class ShatterEffect extends Container {
+export default class ShatterEffect extends ParticleContainer {
     private sourceSprite;
     private fragments;
     private isExploded;
@@ -28,16 +30,11 @@ export default class ShatterEffect extends Container {
     private explodeResolve?;
     constructor(sourceSprite: Sprite, options?: IShatterEffectOptions);
     private createFragments;
-    /**
-     * Starts the explosion animation.
-     * @returns A promise that resolves when all fragments have faded out/died.
-     */
     Explode(): Promise<void>;
     private update;
-    private finish;
     private lerpColor;
     private removeFragment;
-    private cleanup;
+    private finish;
     destroy(options?: any): void;
     static shatter(sprite: Sprite, options?: IShatterEffectOptions): Promise<void>;
 }