react-confetti-burst 1.0.0

package/dist/types/components.d.ts

@@ -0,0 +1,219 @@
+/**
+ * React components for confetti animations
+ *
+ * Provides declarative components for easy integration of confetti
+ * effects into React applications.
+ */
+import React from 'react';
+import type { ConfettiBurstProps, ConfettiButtonProps, ExplosionHandle, BurstOrigin } from './types';
+/**
+ * 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>
+ *   </>
+ * );
+ * ```
+ */
+export declare function ConfettiBurst({ active, origin, triggerRef, options, onComplete, }: ConfettiBurstProps): null;
+/**
+ * Handle type for ConfettiTrigger ref
+ */
+export interface ConfettiTriggerHandle {
+    fire: () => ExplosionHandle | 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>
+ * );
+ * ```
+ */
+export declare const ConfettiTrigger: React.ForwardRefExoticComponent<{
+    options?: ConfettiBurstProps["options"];
+    style?: React.CSSProperties;
+} & React.RefAttributes<ConfettiTriggerHandle>>;
+/**
+ * Button component that automatically fires confetti on click
+ *
+ * @example
+ * ```tsx
+ * <ConfettiButton
+ *   confettiOptions={{
+ *     particleCount: 30,
+ *     direction: { direction: 'up' }
+ *   }}
+ * >
+ *   Submit
+ * </ConfettiButton>
+ * ```
+ */
+export declare const ConfettiButton: React.ForwardRefExoticComponent<ConfettiButtonProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Props for ConfettiOnMount component
+ */
+interface ConfettiOnMountProps {
+    origin?: BurstOrigin;
+    options?: ConfettiBurstProps['options'];
+    onComplete?: () => void;
+    delay?: number;
+}
+/**
+ * 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>
+ *   );
+ * }
+ * ```
+ */
+export declare function ConfettiOnMount({ origin, options, onComplete, delay, }: ConfettiOnMountProps): null;
+/**
+ * Props for ConfettiCannon component
+ */
+interface ConfettiCannonProps {
+    /** Position from left (percentage or pixels) */
+    left?: number | string;
+    /** Position from top (percentage or pixels) */
+    top?: number | string;
+    /** Angle in degrees (0 = right, 90 = up) */
+    angle?: number;
+    /** Confetti options */
+    options?: ConfettiBurstProps['options'];
+    /** When true, fires the cannon */
+    fire?: boolean;
+    /** Callback when animation completes */
+    onComplete?: () => void;
+}
+/**
+ * Positioned cannon component for directional confetti bursts
+ *
+ * @example
+ * ```tsx
+ * <ConfettiCannon
+ *   left="10%"
+ *   top="80%"
+ *   angle={60}
+ *   fire={shouldFire}
+ *   options={{ particleCount: 50 }}
+ * />
+ * ```
+ */
+export declare function ConfettiCannon({ left, top, angle, options, fire: shouldFire, onComplete, }: ConfettiCannonProps): null;
+/**
+ * React-confetti compatible Confetti component
+ *
+ * This component provides a drop-in replacement for react-confetti
+ * with continuous confetti that falls from the top of the screen.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage - continuous confetti
+ * <Confetti />
+ *
+ * // With options
+ * <Confetti
+ *   width={window.innerWidth}
+ *   height={window.innerHeight}
+ *   numberOfPieces={200}
+ *   recycle={true}
+ *   run={true}
+ * />
+ *
+ * // With custom draw function
+ * <Confetti
+ *   drawShape={ctx => {
+ *     ctx.beginPath();
+ *     ctx.arc(0, 0, 5, 0, Math.PI * 2);
+ *     ctx.fill();
+ *   }}
+ * />
+ * ```
+ */
+export interface ConfettiComponentProps {
+    /** Width of the canvas in pixels (default: window.innerWidth) */
+    width?: number;
+    /** Height of the canvas in pixels (default: window.innerHeight) */
+    height?: number;
+    /** Number of confetti pieces (default: 200) */
+    numberOfPieces?: number;
+    /** Spawn area for confetti pieces */
+    confettiSource?: {
+        x: number;
+        y: number;
+        w?: number;
+        h?: number;
+    };
+    /** Initial horizontal velocity range (default: [4, 10]) */
+    initialVelocityX?: number | {
+        min: number;
+        max: number;
+    };
+    /** Initial vertical velocity range (default: [10, 30]) */
+    initialVelocityY?: number | {
+        min: number;
+        max: number;
+    };
+    /** Whether to recycle confetti (default: true) */
+    recycle?: boolean;
+    /** Whether the animation is running (default: true) */
+    run?: boolean;
+    /** Gravity value (default: 0.3) */
+    gravity?: number;
+    /** Wind value (default: 0) */
+    wind?: number;
+    /** Opacity of confetti pieces (0-1, default: 1) */
+    opacity?: number;
+    /** Custom draw function */
+    drawShape?: (ctx: CanvasRenderingContext2D) => void;
+    /** Tween duration when recycle changes (ms) */
+    tweenDuration?: number;
+    /** Array of colors */
+    colors?: string[];
+    /** Callback when confetti is created */
+    onConfettiComplete?: (confetti: any) => void;
+    /** Frame rate limit */
+    frameRate?: number;
+    /** Z-index of the canvas */
+    style?: React.CSSProperties;
+    /** Class name for the canvas */
+    className?: string;
+}
+export declare function Confetti({ width, height, numberOfPieces, confettiSource, initialVelocityX, initialVelocityY, recycle, run, gravity, wind, opacity, drawShape, tweenDuration, colors, onConfettiComplete, frameRate, }: ConfettiComponentProps): null;
+export declare namespace Confetti {
+    var displayName: string;
+}
+export {};
+//# sourceMappingURL=components.d.ts.map

package/dist/types/components.d.ts.map

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

package/dist/types/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/types/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"}

package/dist/types/confetti.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Functional Confetti API
+ *
+ * Provides a canvas-confetti compatible function-based API for
+ * imperative confetti control without React components.
+ *
+ * @module confetti
+ */
+import type { CanvasConfettiOptions, ConfettiCreateOptions } from './types';
+/**
+ * Main confetti function - canvas-confetti compatible API
+ *
+ * @example
+ * ```typescript
+ * // Basic confetti burst
+ * confetti();
+ *
+ * // Customized confetti
+ * confetti({
+ *   particleCount: 100,
+ *   spread: 70,
+ *   origin: { x: 0.5, y: 0.5 }
+ * });
+ *
+ * // Wait for completion
+ * await confetti({ particleCount: 200 });
+ * console.log('Confetti finished!');
+ * ```
+ *
+ * @param options - Confetti configuration options
+ * @returns Promise that resolves when animation completes
+ */
+export declare function confetti(options?: CanvasConfettiOptions): Promise<void> | null;
+export declare namespace confetti {
+    var create: (canvas: HTMLCanvasElement, globalOptions?: ConfettiCreateOptions) => ((options?: CanvasConfettiOptions) => Promise<void> | null) & {
+        reset: () => void;
+    };
+    var reset: () => void;
+    var fireworks: (options?: Partial<CanvasConfettiOptions>) => Promise<void>;
+    var schoolPride: (options?: Partial<CanvasConfettiOptions>) => void;
+    var snow: (options?: {
+        duration?: number;
+    } & Partial<CanvasConfettiOptions>) => void;
+    var burst: (origin: {
+        x: number;
+        y: number;
+    }, options?: Partial<CanvasConfettiOptions>) => Promise<void> | null;
+}
+export default confetti;
+//# sourceMappingURL=confetti.d.ts.map

package/dist/types/confetti.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confetti.d.ts","sourceRoot":"","sources":["../../src/confetti.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAmRjB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CA6BlF;yBA7Be,QAAQ;yBAoDd,iBAAiB,kBACV,qBAAqB,KACnC,CAAC,CAAC,OAAO,CAAC,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE;qBA+DzD,IAAI;8BAwBY,OAAO,CAAC,qBAAqB,CAAC,KAAQ,OAAO,CAAC,IAAI,CAAC;gCA8BvD,OAAO,CAAC,qBAAqB,CAAC,KAAQ,IAAI;yBAsCjD;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,KAAQ,IAAI;wBAsC1F;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,YACvB,OAAO,CAAC,qBAAqB,CAAC,KACtC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;;AAavB,eAAe,QAAQ,CAAC"}

package/dist/types/constants.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Default constants and configuration values
+ *
+ * All default values are carefully tuned for optimal visual appeal
+ * and performance across different devices and screen sizes.
+ */
+import type { ConfettiBurstConfig, ParticleConfig, PhysicsConfig, DirectionConfig, EasingFunction, EasingPreset, RGBAColor, ContinuousConfig, FireworkConfig, CanvasConfig, TrailConfig, GlowConfig, PresetConfig, PresetName, ConfettiBurstOptions } from './types';
+/**
+ * Default vibrant color palette for confetti particles
+ * Designed for high visibility on both light and dark backgrounds
+ */
+export declare const DEFAULT_COLORS: readonly string[];
+/**
+ * Default physics configuration
+ */
+export declare const DEFAULT_PHYSICS: PhysicsConfig;
+/**
+ * Default direction configuration
+ */
+export declare const DEFAULT_DIRECTION: DirectionConfig;
+/**
+ * Default particle configuration
+ */
+export declare const DEFAULT_PARTICLE: ParticleConfig;
+/**
+ * Default trail configuration
+ */
+export declare const DEFAULT_TRAIL: TrailConfig;
+/**
+ * Default glow configuration
+ */
+export declare const DEFAULT_GLOW: GlowConfig;
+/**
+ * Default continuous mode configuration
+ */
+export declare const DEFAULT_CONTINUOUS: ContinuousConfig;
+/**
+ * Default firework configuration
+ */
+export declare const DEFAULT_FIREWORK: FireworkConfig;
+/**
+ * Default canvas configuration
+ */
+export declare const DEFAULT_CANVAS: CanvasConfig;
+/**
+ * Default accessibility configuration
+ */
+export declare const DEFAULT_ACCESSIBILITY: {
+    readonly disableForReducedMotion: false;
+    readonly ariaLabel: "Confetti animation";
+    readonly ariaHidden: true;
+};
+/**
+ * Complete default configuration
+ */
+export declare const DEFAULT_CONFIG: ConfettiBurstConfig;
+/**
+ * Direction angles in degrees (0 = right, counter-clockwise)
+ */
+export declare const DIRECTION_ANGLES: Record<Exclude<import('./types').BurstDirection, 'custom' | 'radial'>, number>;
+/**
+ * Pre-calculated values for performance
+ */
+export declare const MATH_CONSTANTS: {
+    readonly DEG_TO_RAD: number;
+    readonly RAD_TO_DEG: number;
+    readonly TWO_PI: number;
+    readonly HALF_PI: number;
+};
+/**
+ * Easing functions for smooth animations
+ */
+export declare const EASING_FUNCTIONS: Record<EasingPreset, EasingFunction>;
+/**
+ * Built-in shape names (excluding custom shapes)
+ */
+type BuiltinShapeName = 'square' | 'circle' | 'rectangle' | 'triangle' | 'star' | 'line' | 'heart' | 'diamond' | 'hexagon' | 'spiral' | 'ribbon' | 'custom';
+/**
+ * Shape rendering aspect ratios
+ */
+export declare const SHAPE_ASPECT_RATIOS: Record<BuiltinShapeName, number>;
+/**
+ * Default transparent color for fallback
+ */
+export declare const TRANSPARENT_COLOR: RGBAColor;
+/**
+ * Performance tuning constants
+ */
+export declare const PERFORMANCE: {
+    /** Maximum particles before reducing quality */
+    readonly MAX_PARTICLES: 500;
+    /** Frame time budget in ms (targeting 60fps) */
+    readonly FRAME_BUDGET: 16.67;
+    /** Minimum opacity before particle is considered dead */
+    readonly MIN_OPACITY: 0.01;
+    /** Minimum size before particle is considered dead */
+    readonly MIN_SIZE: 0.5;
+    /** Device pixel ratio limit for high-DPI displays */
+    readonly MAX_DPR: 2;
+};
+/**
+ * Canvas cleanup delay in milliseconds
+ */
+export declare const CLEANUP_DELAY = 100;
+/**
+ * Star shape points configuration
+ */
+export declare const STAR_POINTS = 5;
+export declare const STAR_INNER_RATIO = 0.5;
+/**
+ * Color palettes for presets
+ */
+export declare const COLOR_PALETTES: {
+    readonly rainbow: readonly string[];
+    readonly pride: readonly ["#E40303", "#FF8C00", "#FFED00", "#008026", "#24408E", "#732982"];
+    readonly christmas: readonly ["#C41E3A", "#165B33", "#FFD700", "#FFFFFF", "#BB2528"];
+    readonly halloween: readonly ["#FF6600", "#000000", "#8B008B", "#00FF00", "#FFD700"];
+    readonly pastel: readonly ["#FFB3BA", "#FFDFBA", "#FFFFBA", "#BAFFC9", "#BAE1FF"];
+    readonly neon: readonly ["#FF00FF", "#00FFFF", "#FF0080", "#80FF00", "#FF8000"];
+    readonly gold: readonly ["#FFD700", "#DAA520", "#B8860B", "#FFC125", "#FFDF00"];
+    readonly silver: readonly ["#C0C0C0", "#A8A8A8", "#D3D3D3", "#DCDCDC", "#E8E8E8"];
+    readonly hearts: readonly ["#FF69B4", "#FF1493", "#FF007F", "#DC143C", "#FFB6C1"];
+    readonly ocean: readonly ["#006994", "#00CED1", "#20B2AA", "#48D1CC", "#87CEEB"];
+};
+/**
+ * Emoji sets for presets
+ */
+export declare const EMOJI_SETS: {
+    readonly celebration: readonly ["🎉", "🎊", "🥳", "✨", "🎈"];
+    readonly hearts: readonly ["❤️", "💕", "💖", "💗", "💓", "💘"];
+    readonly stars: readonly ["⭐", "🌟", "✨", "💫", "⚡"];
+    readonly money: readonly ["💰", "💵", "💸", "🤑", "💎"];
+    readonly christmas: readonly ["🎄", "🎅", "🎁", "❄️", "⭐"];
+    readonly halloween: readonly ["🎃", "👻", "🦇", "🕷️", "💀"];
+    readonly birthday: readonly ["🎂", "🎁", "🎈", "🎉", "🥳"];
+    readonly food: readonly ["🍕", "🍔", "🍟", "🌭", "🍿"];
+};
+/**
+ * Preset configurations for quick setup
+ */
+export declare const PRESETS: Record<PresetName, PresetConfig>;
+/**
+ * Get preset options by name
+ */
+export declare function getPreset(name: PresetName): ConfettiBurstOptions;
+export {};
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,UAAU,EACV,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAWlC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,aAapB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAItB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAYrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,WAKlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,UAKjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAMvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAWrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YASnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,mBAYnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,SAAS,EAAE,cAAc,EAAE,QAAQ,GAAG,QAAQ,CAAC,EAAE,MAAM,CAKlG,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,cAAc,CA6CxD,CAAC;AAEX;;GAEG;AACH,KAAK,gBAAgB,GACjB,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,UAAU,GACV,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAEb;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAavD,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAKtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB,gDAAgD;;IAEhD,gDAAgD;;IAEhD,yDAAyD;;IAEzD,sDAAsD;;IAEtD,qDAAqD;;CAE7C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;CAWjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;CASb,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,YAAY,CAyT3C,CAAC;AAEX;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,CAEhE"}

package/dist/types/hooks.d.ts

@@ -0,0 +1,94 @@
+/**
+ * React hooks for confetti animations
+ *
+ * Provides convenient React hooks for triggering confetti bursts
+ * with proper lifecycle management and cleanup.
+ */
+import type { ConfettiBurstOptions, BurstOrigin, ExplosionHandle, UseConfettiReturn } from './types';
+/**
+ * Main hook for triggering confetti animations
+ *
+ * @returns Object with fire functions and state
+ *
+ * @example
+ * ```tsx
+ * const { fire, isActive } = useConfetti();
+ *
+ * const handleClick = (e) => {
+ *   fire({ x: e.clientX, y: e.clientY });
+ * };
+ * ```
+ */
+export declare function useConfetti(): UseConfettiReturn;
+/**
+ * Hook for confetti triggered by a ref element
+ *
+ * @param options - Confetti configuration options
+ * @returns Ref to attach to trigger element and fire function
+ *
+ * @example
+ * ```tsx
+ * const { ref, fire } = useConfettiTrigger();
+ *
+ * return (
+ *   <button ref={ref} onClick={fire}>
+ *     Celebrate!
+ *   </button>
+ * );
+ * ```
+ */
+export declare function useConfettiTrigger<T extends HTMLElement = HTMLElement>(options?: ConfettiBurstOptions): {
+    ref: React.RefObject<T>;
+    fire: () => ExplosionHandle | null;
+    isActive: boolean;
+};
+/**
+ * Hook for auto-firing confetti when a condition becomes true
+ *
+ * @param condition - When true, fires confetti
+ * @param origin - Origin point for the burst
+ * @param options - Confetti configuration options
+ *
+ * @example
+ * ```tsx
+ * const [isComplete, setIsComplete] = useState(false);
+ *
+ * useConfettiOnCondition(isComplete, { x: 500, y: 300 });
+ * ```
+ */
+export declare function useConfettiOnCondition(condition: boolean, origin: BurstOrigin, options?: ConfettiBurstOptions): void;
+/**
+ * Hook for sequencing multiple confetti bursts
+ *
+ * @param bursts - Array of burst configurations with delays
+ * @returns Start function and active state
+ *
+ * @example
+ * ```tsx
+ * const { start, isActive } = useConfettiSequence([
+ *   { origin: { x: 100, y: 100 }, delay: 0 },
+ *   { origin: { x: 300, y: 100 }, delay: 200 },
+ *   { origin: { x: 500, y: 100 }, delay: 400 },
+ * ]);
+ * ```
+ */
+export declare function useConfettiSequence(bursts: Array<{
+    origin: BurstOrigin;
+    options?: ConfettiBurstOptions;
+    delay: number;
+}>): {
+    start: () => void;
+    isActive: boolean;
+    cancel: () => void;
+};
+/**
+ * Hook for viewport-centered confetti
+ *
+ * @param options - Confetti configuration options
+ * @returns Fire function for center-screen confetti
+ */
+export declare function useConfettiCenter(options?: ConfettiBurstOptions): {
+    fire: () => ExplosionHandle;
+    isActive: boolean;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/types/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAOjB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,IAAI,iBAAiB,CAmG/C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACpE,OAAO,CAAC,EAAE,oBAAoB,GAC7B;IACD,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;CACnB,CASA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,IAAI,CAiBN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,GACD;IACD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CA6BA;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG;IACjE,IAAI,EAAE,MAAM,eAAe,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;CACnB,CAeA"}