react-confetti-burst 1.0.0

package/dist/cjs/components.js

@@ -0,0 +1,341 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfettiButton = exports.ConfettiTrigger = void 0;
+exports.ConfettiBurst = ConfettiBurst;
+exports.ConfettiOnMount = ConfettiOnMount;
+exports.ConfettiCannon = ConfettiCannon;
+exports.Confetti = Confetti;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * React components for confetti animations
+ *
+ * Provides declarative components for easy integration of confetti
+ * effects into React applications.
+ */
+const react_1 = require("react");
+const hooks_1 = require("./hooks");
+/**
+ * Declarative confetti component that fires when active prop changes
+ *
+ * @example
+ * ```tsx
+ * const [celebrate, setCelebrate] = useState(false);
+ *
+ * return (
+ *   <>
+ *     <ConfettiBurst
+ *       active={celebrate}
+ *       origin={{ x: 500, y: 300 }}
+ *       onComplete={() => setCelebrate(false)}
+ *     />
+ *     <button onClick={() => setCelebrate(true)}>
+ *       Celebrate!
+ *     </button>
+ *   </>
+ * );
+ * ```
+ */
+function ConfettiBurst({ active, origin, triggerRef, options, onComplete, }) {
+    const { fire, fireFromElement } = (0, hooks_1.useConfetti)();
+    const hasFired = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        if (active && !hasFired.current) {
+            hasFired.current = true;
+            let handle = null;
+            if (triggerRef?.current) {
+                handle = fireFromElement(triggerRef.current, options);
+            }
+            else if (origin) {
+                handle = fire(origin, options);
+            }
+            if (handle) {
+                handle.promise.then(() => {
+                    onComplete?.();
+                });
+            }
+        }
+    }, [active, origin, triggerRef, options, fire, fireFromElement, onComplete]);
+    // Reset when active becomes false
+    (0, react_1.useEffect)(() => {
+        if (!active) {
+            hasFired.current = false;
+        }
+    }, [active]);
+    return null;
+}
+/**
+ * Invisible trigger component that fires confetti from its position
+ *
+ * @example
+ * ```tsx
+ * const triggerRef = useRef<ConfettiTriggerHandle>(null);
+ *
+ * return (
+ *   <div style={{ position: 'relative' }}>
+ *     <ConfettiTrigger ref={triggerRef} options={{ particleCount: 100 }} />
+ *     <button onClick={() => triggerRef.current?.fire()}>
+ *       Fire!
+ *     </button>
+ *   </div>
+ * );
+ * ```
+ */
+exports.ConfettiTrigger = (0, react_1.forwardRef)(({ options, style }, ref) => {
+    const containerRef = (0, react_1.useRef)(null);
+    const { fireFromElement } = (0, hooks_1.useConfetti)();
+    (0, react_1.useImperativeHandle)(ref, () => ({
+        fire: () => fireFromElement(containerRef.current, options),
+    }));
+    return ((0, jsx_runtime_1.jsx)("div", { ref: containerRef, style: {
+            position: 'absolute',
+            width: 1,
+            height: 1,
+            pointerEvents: 'none',
+            ...style,
+        }, "aria-hidden": "true" }));
+});
+exports.ConfettiTrigger.displayName = 'ConfettiTrigger';
+/**
+ * Button component that automatically fires confetti on click
+ *
+ * @example
+ * ```tsx
+ * <ConfettiButton
+ *   confettiOptions={{
+ *     particleCount: 30,
+ *     direction: { direction: 'up' }
+ *   }}
+ * >
+ *   Submit
+ * </ConfettiButton>
+ * ```
+ */
+exports.ConfettiButton = (0, react_1.forwardRef)(({ children, confettiOptions, fireOnClick = true, onClick, ...buttonProps }, forwardedRef) => {
+    const internalRef = (0, react_1.useRef)(null);
+    const { fireFromElement } = (0, hooks_1.useConfetti)();
+    // Combine refs
+    const setRef = (0, react_1.useCallback)((node) => {
+        internalRef.current = node;
+        if (typeof forwardedRef === 'function') {
+            forwardedRef(node);
+        }
+        else if (forwardedRef) {
+            forwardedRef.current = node;
+        }
+    }, [forwardedRef]);
+    const handleClick = (0, react_1.useCallback)((event) => {
+        if (fireOnClick && internalRef.current) {
+            fireFromElement(internalRef.current, confettiOptions);
+        }
+        onClick?.(event);
+    }, [fireOnClick, fireFromElement, confettiOptions, onClick]);
+    return ((0, jsx_runtime_1.jsx)("button", { ref: setRef, onClick: handleClick, ...buttonProps, children: children }));
+});
+exports.ConfettiButton.displayName = 'ConfettiButton';
+/**
+ * Component that fires confetti when mounted
+ *
+ * @example
+ * ```tsx
+ * // Fire confetti when a success page loads
+ * function SuccessPage() {
+ *   return (
+ *     <div>
+ *       <ConfettiOnMount
+ *         origin={{ x: window.innerWidth / 2, y: window.innerHeight / 3 }}
+ *         options={{ particleCount: 100 }}
+ *       />
+ *       <h1>Success!</h1>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function ConfettiOnMount({ origin, options, onComplete, delay = 0, }) {
+    const { fire } = (0, hooks_1.useConfetti)();
+    const hasFired = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        if (hasFired.current)
+            return;
+        hasFired.current = true;
+        const burstOrigin = origin ?? {
+            x: typeof window !== 'undefined' ? window.innerWidth / 2 : 0,
+            y: typeof window !== 'undefined' ? window.innerHeight / 2 : 0,
+        };
+        const timeoutId = setTimeout(() => {
+            const handle = fire(burstOrigin, options);
+            handle.promise.then(() => onComplete?.());
+        }, delay);
+        return () => clearTimeout(timeoutId);
+    }, [fire, origin, options, onComplete, delay]);
+    return null;
+}
+/**
+ * Positioned cannon component for directional confetti bursts
+ *
+ * @example
+ * ```tsx
+ * <ConfettiCannon
+ *   left="10%"
+ *   top="80%"
+ *   angle={60}
+ *   fire={shouldFire}
+ *   options={{ particleCount: 50 }}
+ * />
+ * ```
+ */
+function ConfettiCannon({ left = 0, top = 0, angle = 90, options, fire: shouldFire = false, onComplete, }) {
+    const { fire } = (0, hooks_1.useConfetti)();
+    const hasFired = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        if (!shouldFire || hasFired.current)
+            return;
+        if (typeof window === 'undefined')
+            return;
+        hasFired.current = true;
+        // Calculate position
+        const x = typeof left === 'string' && left.endsWith('%')
+            ? (parseFloat(left) / 100) * window.innerWidth
+            : typeof left === 'number'
+                ? left
+                : parseFloat(left) || 0;
+        const y = typeof top === 'string' && top.endsWith('%')
+            ? (parseFloat(top) / 100) * window.innerHeight
+            : typeof top === 'number'
+                ? top
+                : parseFloat(top) || 0;
+        const handle = fire({ x, y }, {
+            ...options,
+            direction: {
+                ...options?.direction,
+                direction: 'custom',
+                angle,
+            },
+        });
+        handle.promise.then(() => onComplete?.());
+    }, [shouldFire, left, top, angle, options, fire, onComplete]);
+    // Reset when fire becomes false
+    (0, react_1.useEffect)(() => {
+        if (!shouldFire) {
+            hasFired.current = false;
+        }
+    }, [shouldFire]);
+    return null;
+}
+function Confetti({ width, height, numberOfPieces = 200, confettiSource, initialVelocityX, initialVelocityY, recycle = true, run = true, gravity = 0.3, wind = 0, opacity = 1, drawShape, tweenDuration = 100, colors, onConfettiComplete, frameRate,
+// style and className are for API compatibility but not used in canvas
+ }) {
+    const { fire } = (0, hooks_1.useConfetti)();
+    const handleRef = (0, react_1.useRef)(null);
+    const hasStarted = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        if (!run) {
+            if (handleRef.current) {
+                handleRef.current.stop();
+                handleRef.current = null;
+            }
+            hasStarted.current = false;
+            return;
+        }
+        if (hasStarted.current)
+            return;
+        hasStarted.current = true;
+        // Calculate spawn area
+        const spawnArea = confettiSource
+            ? {
+                type: 'rect',
+                x: confettiSource.x,
+                y: confettiSource.y,
+                w: confettiSource.w ?? window.innerWidth,
+                h: confettiSource.h ?? 10,
+            }
+            : {
+                type: 'rect',
+                x: 0,
+                y: 0,
+                w: width ?? window.innerWidth,
+                h: 10,
+            };
+        // Convert velocity props
+        const velX = typeof initialVelocityX === 'number'
+            ? [initialVelocityX * 0.5, initialVelocityX * 1.5]
+            : initialVelocityX
+                ? [initialVelocityX.min, initialVelocityX.max]
+                : [4, 10];
+        const velY = typeof initialVelocityY === 'number'
+            ? [initialVelocityY * 0.5, initialVelocityY * 1.5]
+            : initialVelocityY
+                ? [initialVelocityY.min, initialVelocityY.max]
+                : [10, 30];
+        // Start the continuous confetti
+        const centerX = (width ?? window.innerWidth) / 2;
+        const centerY = 0;
+        handleRef.current = fire({ x: centerX, y: centerY }, {
+            particleCount: numberOfPieces,
+            particle: {
+                colors: colors ?? ['#ff0000', '#00ff00', '#0000ff', '#ffff00', '#ff00ff', '#00ffff'],
+                opacity: [opacity * 0.8, opacity],
+                shapes: ['square', 'circle', 'rectangle'],
+                drawShape,
+            },
+            physics: {
+                gravity: gravity * 10, // Scale to match react-confetti
+                wind: wind * 5,
+                windVariation: velX[1] - velX[0], // Use horizontal velocity as wind variation
+            },
+            direction: {
+                velocity: velY,
+            },
+            mode: 'continuous',
+            spawnArea,
+            continuous: {
+                recycle,
+                numberOfPieces,
+                spawnRate: 30,
+                run,
+                tweenDuration,
+            },
+            canvas: {
+                width,
+                height,
+                frameRate,
+                autoResize: !width && !height,
+            },
+            onComplete: onConfettiComplete,
+        });
+        return () => {
+            if (handleRef.current) {
+                handleRef.current.stop();
+                handleRef.current = null;
+            }
+        };
+    }, [
+        run,
+        width,
+        height,
+        numberOfPieces,
+        confettiSource,
+        initialVelocityX,
+        initialVelocityY,
+        recycle,
+        gravity,
+        wind,
+        opacity,
+        drawShape,
+        tweenDuration,
+        colors,
+        onConfettiComplete,
+        frameRate,
+        fire,
+    ]);
+    // Handle recycle changes
+    (0, react_1.useEffect)(() => {
+        if (handleRef.current && !recycle) {
+            // Stop recycling - animation will end naturally
+            // This is handled in the engine
+        }
+    }, [recycle]);
+    return null;
+}
+Confetti.displayName = 'Confetti';
+//# sourceMappingURL=components.js.map

package/dist/cjs/components.js.map

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

package/dist/cjs/confetti-engine.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Confetti Engine - Core Canvas-based animation system
+ *
+ * This module provides the main confetti animation engine that manages
+ * particle creation, physics updates, and rendering using the Canvas API.
+ *
+ * Features:
+ * - High-performance requestAnimationFrame loop
+ * - Automatic DPR (Device Pixel Ratio) handling
+ * - Directional burst support
+ * - Continuous/recycle mode (like react-confetti)
+ * - Firework mode with secondary explosions
+ * - Spawn area support
+ * - Memory-efficient particle pooling
+ * - Automatic cleanup
+ */
+import type { ConfettiBurstOptions, BurstOrigin, ExplosionHandle } from './types';
+/**
+ * Main confetti engine class
+ */
+export declare class ConfettiEngine {
+    private particles;
+    private config;
+    private origin;
+    private canvasContext;
+    private animationFrameId;
+    private lastFrameTime;
+    private lastSpawnTime;
+    private isRunning;
+    private isPaused;
+    private deferred;
+    private mode;
+    private spawnArea?;
+    private continuousConfig;
+    private fireworkConfig;
+    private canvasConfig;
+    private drawShape?;
+    private frameInterval;
+    private lastRenderTime;
+    constructor(origin: BurstOrigin, options?: ConfettiBurstOptions);
+    /**
+     * Starts the confetti animation
+     */
+    start(): ExplosionHandle;
+    /**
+     * Creates particles for the burst
+     */
+    private createParticles;
+    /**
+     * Spawns particles for continuous mode
+     */
+    private spawnParticles;
+    /**
+     * Launches a firework
+     */
+    private launchFirework;
+    /**
+     * Triggers a firework explosion at a position
+     */
+    private explodeFirework;
+    /**
+     * Main animation loop
+     */
+    private animate;
+    /**
+     * Stops the animation immediately
+     */
+    stop(): void;
+    /**
+     * Pauses the animation
+     */
+    pause(): void;
+    /**
+     * Resumes a paused animation
+     */
+    resume(): void;
+    /**
+     * Called when animation completes naturally
+     */
+    private complete;
+    /**
+     * Cleans up resources
+     */
+    private cleanup;
+    /**
+     * Adds more particles to the animation
+     */
+    addParticles(count: number): void;
+    /**
+     * Clears all particles
+     */
+    clear(): void;
+    /**
+     * Gets current particle count
+     */
+    getParticleCount(): number;
+    /**
+     * Gets the current state
+     */
+    getState(): 'running' | 'paused' | 'stopped';
+    /**
+     * Creates the explosion handle for external control
+     */
+    private createHandle;
+}
+/**
+ * Creates and starts a confetti explosion
+ */
+export declare function createConfettiExplosion(origin: BurstOrigin, options?: ConfettiBurstOptions): ExplosionHandle;
+/**
+ * Fires confetti from an element's center
+ */
+export declare function fireFromElement(element: HTMLElement | null, options?: ConfettiBurstOptions): ExplosionHandle | null;
+/**
+ * Gets the current number of active animations
+ */
+export declare function getActiveAnimationCount(): number;
+/**
+ * Forces cleanup of all resources
+ */
+export declare function forceCleanup(): void;
+//# sourceMappingURL=confetti-engine.d.ts.map

package/dist/cjs/confetti-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confetti-engine.d.ts","sourceRoot":"","sources":["../../src/confetti-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAEV,oBAAoB,EACpB,WAAW,EAGX,eAAe,EAOhB,MAAM,SAAS,CAAC;AAoKjB;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,QAAQ,CAA0B;IAG1C,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAAC,CAAqB;IACvC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,cAAc,CAAa;gBAEvB,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAkB/D;;OAEG;IACH,KAAK,IAAI,eAAe;IA6CxB;;OAEG;IACH,OAAO,CAAC,eAAe;IA+CvB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0DtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA4CtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgCvB;;OAEG;IACH,OAAO,CAAC,OAAO,CAkHb;IAEF;;OAEG;IACH,IAAI,IAAI,IAAI;IAYZ;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,CAAC,QAAQ;IAMhB;;OAEG;IACH,OAAO,CAAC,OAAO;IAaf;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAgCjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,QAAQ,IAAI,SAAS,GAAG,QAAQ,GAAG,SAAS;IAM5C;;OAEG;IACH,OAAO,CAAC,YAAY;CAYrB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,eAAe,CAGjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,GAAG,IAAI,EAC3B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,eAAe,GAAG,IAAI,CAYxB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAOnC"}