react-confetti-burst 1.0.0

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

package/dist/cjs/hooks.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * React hooks for confetti animations
+ *
+ * Provides convenient React hooks for triggering confetti bursts
+ * with proper lifecycle management and cleanup.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useConfetti = useConfetti;
+exports.useConfettiTrigger = useConfettiTrigger;
+exports.useConfettiOnCondition = useConfettiOnCondition;
+exports.useConfettiSequence = useConfettiSequence;
+exports.useConfettiCenter = useConfettiCenter;
+const react_1 = require("react");
+const confetti_engine_1 = require("./confetti-engine");
+/**
+ * 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 });
+ * };
+ * ```
+ */
+function useConfetti() {
+    const [isActive, setIsActive] = (0, react_1.useState)(false);
+    const activeHandles = (0, react_1.useRef)(new Set());
+    // Cleanup on unmount
+    (0, react_1.useEffect)(() => {
+        return () => {
+            activeHandles.current.forEach(handle => handle.stop());
+            activeHandles.current.clear();
+        };
+    }, []);
+    /**
+     * Fires confetti from a point
+     */
+    const fire = (0, react_1.useCallback)((origin, options) => {
+        const handle = (0, confetti_engine_1.createConfettiExplosion)(origin, options);
+        activeHandles.current.add(handle);
+        setIsActive(true);
+        handle.promise.then(() => {
+            activeHandles.current.delete(handle);
+            if (activeHandles.current.size === 0) {
+                setIsActive(false);
+            }
+        });
+        return handle;
+    }, []);
+    /**
+     * Fires confetti from an element's center
+     */
+    const fireFromElementCallback = (0, react_1.useCallback)((element, options) => {
+        if (!element)
+            return null;
+        const handle = (0, confetti_engine_1.fireFromElement)(element, options);
+        if (handle) {
+            activeHandles.current.add(handle);
+            setIsActive(true);
+            handle.promise.then(() => {
+                activeHandles.current.delete(handle);
+                if (activeHandles.current.size === 0) {
+                    setIsActive(false);
+                }
+            });
+        }
+        return handle;
+    }, []);
+    /**
+     * Stops all active animations
+     */
+    const stopAll = (0, react_1.useCallback)(() => {
+        activeHandles.current.forEach(handle => handle.stop());
+        activeHandles.current.clear();
+        setIsActive(false);
+    }, []);
+    /**
+     * Pauses all active animations
+     */
+    const pauseAll = (0, react_1.useCallback)(() => {
+        activeHandles.current.forEach(handle => handle.pause());
+    }, []);
+    /**
+     * Resumes all paused animations
+     */
+    const resumeAll = (0, react_1.useCallback)(() => {
+        activeHandles.current.forEach(handle => handle.resume());
+    }, []);
+    /**
+     * Gets the currently active handles
+     */
+    const getActiveHandles = (0, react_1.useCallback)(() => {
+        return Array.from(activeHandles.current);
+    }, []);
+    return {
+        fire,
+        fireFromElement: fireFromElementCallback,
+        isActive,
+        stopAll,
+        pauseAll,
+        resumeAll,
+        getActiveHandles,
+    };
+}
+/**
+ * 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>
+ * );
+ * ```
+ */
+function useConfettiTrigger(options) {
+    const ref = (0, react_1.useRef)(null);
+    const { fireFromElement: fireFromEl, isActive } = useConfetti();
+    const fire = (0, react_1.useCallback)(() => {
+        return fireFromEl(ref.current, options);
+    }, [fireFromEl, options]);
+    return { ref, fire, isActive };
+}
+/**
+ * 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 });
+ * ```
+ */
+function useConfettiOnCondition(condition, origin, options) {
+    const hasFired = (0, react_1.useRef)(false);
+    const { fire } = useConfetti();
+    (0, react_1.useEffect)(() => {
+        if (condition && !hasFired.current) {
+            hasFired.current = true;
+            fire(origin, options);
+        }
+    }, [condition, fire, origin, options]);
+    // Reset when condition becomes false
+    (0, react_1.useEffect)(() => {
+        if (!condition) {
+            hasFired.current = false;
+        }
+    }, [condition]);
+}
+/**
+ * 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 },
+ * ]);
+ * ```
+ */
+function useConfettiSequence(bursts) {
+    const { fire, isActive, stopAll } = useConfetti();
+    const timeouts = (0, react_1.useRef)([]);
+    const cancel = (0, react_1.useCallback)(() => {
+        timeouts.current.forEach(id => clearTimeout(id));
+        timeouts.current = [];
+        stopAll();
+    }, [stopAll]);
+    const start = (0, react_1.useCallback)(() => {
+        cancel(); // Clear any existing sequence
+        bursts.forEach(({ origin, options, delay }) => {
+            const timeoutId = window.setTimeout(() => {
+                fire(origin, options);
+            }, delay);
+            timeouts.current.push(timeoutId);
+        });
+    }, [bursts, fire, cancel]);
+    // Cleanup on unmount
+    (0, react_1.useEffect)(() => {
+        return () => {
+            timeouts.current.forEach(id => clearTimeout(id));
+        };
+    }, []);
+    return { start, isActive, cancel };
+}
+/**
+ * Hook for viewport-centered confetti
+ *
+ * @param options - Confetti configuration options
+ * @returns Fire function for center-screen confetti
+ */
+function useConfettiCenter(options) {
+    const { fire: baseFire, isActive } = useConfetti();
+    const fire = (0, react_1.useCallback)(() => {
+        const centerOrigin = {
+            x: window.innerWidth / 2,
+            y: window.innerHeight / 2,
+        };
+        return baseFire(centerOrigin, {
+            ...options,
+            direction: { direction: 'radial' },
+        });
+    }, [baseFire, options]);
+    return { fire, isActive };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/cjs/hooks.js.map

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

package/dist/cjs/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * react-confetti-burst
+ *
+ * A high-performance, zero-dependency React confetti component
+ * with directional bursts using the native Canvas API.
+ * Exceeds the feature set of both react-confetti and canvas-confetti.
+ *
+ * @packageDocumentation
+ */
+/**
+ * ============================================================================
+ * FEATURE RELEASE FLAGS
+ * ============================================================================
+ *
+ * Uncomment features as they are released:
+ *
+ * v1.0.0 - Basic Usage (ConfettiButton, useConfetti, basic confetti())
+ * v1.1.0 - React Hooks (useConfettiTrigger, useConfettiSequence, useConfettiCenter)
+ * v1.2.0 - Built-in Presets (16 presets)
+ * v1.3.0 - canvas-confetti API (confetti.create, confetti.reset)
+ * v1.4.0 - Custom Shapes (shapeFromPath, shapeFromText, shapesFromEmoji)
+ * v1.5.0 - Advanced Effects (trails, glow, fireworks, continuous mode)
+ * v1.6.0 - Full Feature Set
+ *
+ * ============================================================================
+ */
+export type { Point, Vector2D, RGBAColor, GradientColor, ColorInput, ParticleShape, BurstDirection, EasingFunction, EasingPreset, PhysicsConfig, DirectionConfig, ParticleConfig, ConfettiBurstConfig, ConfettiBurstOptions, BurstOrigin, ParticleState, AnimationState, CanvasContext, ExplosionHandle, UseConfettiReturn, ConfettiBurstProps, ConfettiButtonProps, } from './types';
+export { DEFAULT_COLORS, DEFAULT_PHYSICS, DEFAULT_DIRECTION, DEFAULT_PARTICLE, DEFAULT_CONFIG, DIRECTION_ANGLES, EASING_FUNCTIONS, COLOR_PALETTES, } from './constants';
+export { ConfettiEngine, createConfettiExplosion, fireFromElement, getActiveAnimationCount, forceCleanup, } from './confetti-engine';
+export { useConfetti, } from './hooks';
+export { ConfettiBurst, ConfettiButton, } from './components';
+export { parseColor, rgbaToString, randomInRange, randomInt, randomFromArray, clamp, lerp, degToRad, radToDeg, getDirectionAngle, getElementCenter, mergeConfig, isBrowser, } from './utils';
+export { confetti, confetti as default } from './confetti';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;GAgBG;AAOH,YAAY,EAEV,KAAK,EACL,QAAQ,EACR,SAAS,EACT,aAAa,EACb,UAAU,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EAGZ,aAAa,EACb,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EAGX,aAAa,EACb,cAAc,EACd,aAAa,EAGb,eAAe,EACf,iBAAiB,EAGjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,eAAe,EACf,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,QAAQ,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * react-confetti-burst
+ *
+ * A high-performance, zero-dependency React confetti component
+ * with directional bursts using the native Canvas API.
+ * Exceeds the feature set of both react-confetti and canvas-confetti.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.confetti = exports.isBrowser = exports.mergeConfig = exports.getElementCenter = exports.getDirectionAngle = exports.radToDeg = exports.degToRad = exports.lerp = exports.clamp = exports.randomFromArray = exports.randomInt = exports.randomInRange = exports.rgbaToString = exports.parseColor = exports.ConfettiButton = exports.ConfettiBurst = exports.useConfetti = exports.forceCleanup = exports.getActiveAnimationCount = exports.fireFromElement = exports.createConfettiExplosion = exports.ConfettiEngine = exports.COLOR_PALETTES = exports.EASING_FUNCTIONS = exports.DIRECTION_ANGLES = exports.DEFAULT_CONFIG = exports.DEFAULT_PARTICLE = exports.DEFAULT_DIRECTION = exports.DEFAULT_PHYSICS = exports.DEFAULT_COLORS = void 0;
+// Basic Constants
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "DEFAULT_COLORS", { enumerable: true, get: function () { return constants_1.DEFAULT_COLORS; } });
+Object.defineProperty(exports, "DEFAULT_PHYSICS", { enumerable: true, get: function () { return constants_1.DEFAULT_PHYSICS; } });
+Object.defineProperty(exports, "DEFAULT_DIRECTION", { enumerable: true, get: function () { return constants_1.DEFAULT_DIRECTION; } });
+Object.defineProperty(exports, "DEFAULT_PARTICLE", { enumerable: true, get: function () { return constants_1.DEFAULT_PARTICLE; } });
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return constants_1.DEFAULT_CONFIG; } });
+Object.defineProperty(exports, "DIRECTION_ANGLES", { enumerable: true, get: function () { return constants_1.DIRECTION_ANGLES; } });
+Object.defineProperty(exports, "EASING_FUNCTIONS", { enumerable: true, get: function () { return constants_1.EASING_FUNCTIONS; } });
+Object.defineProperty(exports, "COLOR_PALETTES", { enumerable: true, get: function () { return constants_1.COLOR_PALETTES; } });
+// Core engine (Basic)
+var confetti_engine_1 = require("./confetti-engine");
+Object.defineProperty(exports, "ConfettiEngine", { enumerable: true, get: function () { return confetti_engine_1.ConfettiEngine; } });
+Object.defineProperty(exports, "createConfettiExplosion", { enumerable: true, get: function () { return confetti_engine_1.createConfettiExplosion; } });
+Object.defineProperty(exports, "fireFromElement", { enumerable: true, get: function () { return confetti_engine_1.fireFromElement; } });
+Object.defineProperty(exports, "getActiveAnimationCount", { enumerable: true, get: function () { return confetti_engine_1.getActiveAnimationCount; } });
+Object.defineProperty(exports, "forceCleanup", { enumerable: true, get: function () { return confetti_engine_1.forceCleanup; } });
+// Basic React hooks
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "useConfetti", { enumerable: true, get: function () { return hooks_1.useConfetti; } });
+// Basic React components
+var components_1 = require("./components");
+Object.defineProperty(exports, "ConfettiBurst", { enumerable: true, get: function () { return components_1.ConfettiBurst; } });
+Object.defineProperty(exports, "ConfettiButton", { enumerable: true, get: function () { return components_1.ConfettiButton; } });
+// Basic Utility functions
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "parseColor", { enumerable: true, get: function () { return utils_1.parseColor; } });
+Object.defineProperty(exports, "rgbaToString", { enumerable: true, get: function () { return utils_1.rgbaToString; } });
+Object.defineProperty(exports, "randomInRange", { enumerable: true, get: function () { return utils_1.randomInRange; } });
+Object.defineProperty(exports, "randomInt", { enumerable: true, get: function () { return utils_1.randomInt; } });
+Object.defineProperty(exports, "randomFromArray", { enumerable: true, get: function () { return utils_1.randomFromArray; } });
+Object.defineProperty(exports, "clamp", { enumerable: true, get: function () { return utils_1.clamp; } });
+Object.defineProperty(exports, "lerp", { enumerable: true, get: function () { return utils_1.lerp; } });
+Object.defineProperty(exports, "degToRad", { enumerable: true, get: function () { return utils_1.degToRad; } });
+Object.defineProperty(exports, "radToDeg", { enumerable: true, get: function () { return utils_1.radToDeg; } });
+Object.defineProperty(exports, "getDirectionAngle", { enumerable: true, get: function () { return utils_1.getDirectionAngle; } });
+Object.defineProperty(exports, "getElementCenter", { enumerable: true, get: function () { return utils_1.getElementCenter; } });
+Object.defineProperty(exports, "mergeConfig", { enumerable: true, get: function () { return utils_1.mergeConfig; } });
+Object.defineProperty(exports, "isBrowser", { enumerable: true, get: function () { return utils_1.isBrowser; } });
+// Basic Functional API
+var confetti_1 = require("./confetti");
+Object.defineProperty(exports, "confetti", { enumerable: true, get: function () { return confetti_1.confetti; } });
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return confetti_1.confetti; } });
+// ============================================================================
+// v1.1.0 - REACT HOOKS (Uncomment when releasing)
+// ============================================================================
+/*
+export {
+  useConfettiTrigger,
+  useConfettiOnCondition,
+  useConfettiSequence,
+  useConfettiCenter,
+} from './hooks';
+
+export {
+  ConfettiTrigger,
+} from './components';
+
+export type { ConfettiTriggerHandle } from './components';
+*/
+// ============================================================================
+// v1.2.0 - BUILT-IN PRESETS (Uncomment when releasing)
+// ============================================================================
+/*
+export type {
+  PresetName,
+  PresetConfig,
+} from './types';
+
+export {
+  PRESETS,
+  getPreset,
+} from './constants';
+*/
+// ============================================================================
+// v1.3.0 - CANVAS-CONFETTI API (Uncomment when releasing)
+// ============================================================================
+/*
+export type {
+  NormalizedOrigin,
+  AccessibilityConfig,
+  CanvasConfettiOptions,
+  ConfettiCreateOptions,
+  CanvasConfig,
+  ConfettiProps,
+} from './types';
+
+export {
+  DEFAULT_CANVAS,
+  DEFAULT_ACCESSIBILITY,
+} from './constants';
+
+export {
+  ConfettiOnMount,
+  ConfettiCannon,
+  Confetti,
+} from './components';
+
+export type { ConfettiComponentProps } from './components';
+*/
+// ============================================================================
+// v1.4.0 - CUSTOM SHAPES (Uncomment when releasing)
+// ============================================================================
+/*
+export type {
+  DrawContext,
+  CustomDrawFunction,
+  PathShape,
+  TextShape,
+  CustomShape,
+  ShapeInput,
+  PathBounds,
+} from './types';
+
+export {
+  EMOJI_SETS,
+} from './constants';
+
+export {
+  shapeFromPath,
+  shapeFromText,
+  shapeFromImage,
+  shapesFromEmoji,
+  pathShapes,
+  emojiShapes,
+} from './shapes';
+
+export type {
+  ShapeFromPathOptions,
+  ShapeFromTextOptions,
+} from './shapes';
+*/
+// ============================================================================
+// v1.5.0 - ADVANCED EFFECTS (Uncomment when releasing)
+// ============================================================================
+/*
+export type {
+  EffectMode,
+  SpawnArea,
+  TrailConfig,
+  GlowConfig,
+  ImageParticle,
+  ContinuousConfig,
+  FireworkConfig,
+} from './types';
+
+export {
+  DEFAULT_TRAIL,
+  DEFAULT_GLOW,
+  DEFAULT_CONTINUOUS,
+  DEFAULT_FIREWORK,
+} from './constants';
+*/
+// ============================================================================
+// v1.6.0 - PARTICLE UTILITIES (Uncomment when releasing)
+// ============================================================================
+/*
+export {
+  createParticle,
+  updateParticle,
+  renderParticle,
+  areAllParticlesInactive,
+  countActiveParticles,
+  loadImage,
+  clearImageCache,
+} from './particle';
+*/
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA2DH,kBAAkB;AAClB,yCASqB;AARnB,2GAAA,cAAc,OAAA;AACd,4GAAA,eAAe,OAAA;AACf,8GAAA,iBAAiB,OAAA;AACjB,6GAAA,gBAAgB,OAAA;AAChB,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA;AAChB,6GAAA,gBAAgB,OAAA;AAChB,2GAAA,cAAc,OAAA;AAGhB,sBAAsB;AACtB,qDAM2B;AALzB,iHAAA,cAAc,OAAA;AACd,0HAAA,uBAAuB,OAAA;AACvB,kHAAA,eAAe,OAAA;AACf,0HAAA,uBAAuB,OAAA;AACvB,+GAAA,YAAY,OAAA;AAGd,oBAAoB;AACpB,iCAEiB;AADf,oGAAA,WAAW,OAAA;AAGb,yBAAyB;AACzB,2CAGsB;AAFpB,2GAAA,aAAa,OAAA;AACb,4GAAA,cAAc,OAAA;AAGhB,0BAA0B;AAC1B,iCAciB;AAbf,mGAAA,UAAU,OAAA;AACV,qGAAA,YAAY,OAAA;AACZ,sGAAA,aAAa,OAAA;AACb,kGAAA,SAAS,OAAA;AACT,wGAAA,eAAe,OAAA;AACf,8FAAA,KAAK,OAAA;AACL,6FAAA,IAAI,OAAA;AACJ,iGAAA,QAAQ,OAAA;AACR,iGAAA,QAAQ,OAAA;AACR,0GAAA,iBAAiB,OAAA;AACjB,yGAAA,gBAAgB,OAAA;AAChB,oGAAA,WAAW,OAAA;AACX,kGAAA,SAAS,OAAA;AAGX,uBAAuB;AACvB,uCAA2D;AAAlD,oGAAA,QAAQ,OAAA;AAAE,mGAAA,QAAQ,OAAW;AAEtC,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAE/E;;;;;;;;;;;;;EAaE;AAEF,+EAA+E;AAC/E,uDAAuD;AACvD,+EAA+E;AAE/E;;;;;;;;;;EAUE;AAEF,+EAA+E;AAC/E,0DAA0D;AAC1D,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;EAsBE;AAEF,+EAA+E;AAC/E,oDAAoD;AACpD,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BE;AAEF,+EAA+E;AAC/E,uDAAuD;AACvD,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;EAiBE;AAEF,+EAA+E;AAC/E,yDAAyD;AACzD,+EAA+E;AAE/E;;;;;;;;;;EAUE"}

package/dist/cjs/particle.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Particle class for confetti animation
+ *
+ * Represents a single confetti particle with all physics properties
+ * and methods for updating and rendering.
+ */
+import type { ParticleState, ParticleShape, PhysicsConfig, ImageParticle, TrailConfig, GlowConfig, ColorInput, CustomDrawFunction } from './types';
+/**
+ * Loads an image and caches it
+ */
+export declare function loadImage(src: string): Promise<HTMLImageElement>;
+/**
+ * Clears the image cache
+ */
+export declare function clearImageCache(): void;
+/**
+ * Creates a new particle state object
+ */
+export declare function createParticle(x: number, y: number, angle: number, velocity: number, colors: readonly ColorInput[], shapes: readonly ParticleShape[], sizeRange: readonly [number, number], opacityRange: readonly [number, number], lifespan: number, rotationSpeed: number, options?: {
+    images?: readonly ImageParticle[];
+    tiltRange?: readonly [number, number];
+    spinSpeedRange?: readonly [number, number];
+    depth3D?: number;
+}): ParticleState;
+/**
+ * Updates a particle's physics state
+ */
+export declare function updateParticle(particle: ParticleState, deltaTime: number, physics: PhysicsConfig, fadeOut: boolean, scaleDown: boolean, trailConfig?: Partial<TrailConfig>, canvasHeight?: number): void;
+/**
+ * Renders a particle to a canvas context
+ */
+export declare function renderParticle(ctx: CanvasRenderingContext2D, particle: ParticleState, options?: {
+    trailConfig?: Partial<TrailConfig>;
+    glowConfig?: Partial<GlowConfig>;
+    customDraw?: CustomDrawFunction;
+    elapsed?: number;
+}): void;
+/**
+ * Checks if all particles in an array are inactive
+ */
+export declare function areAllParticlesInactive(particles: readonly ParticleState[]): boolean;
+/**
+ * Counts active particles
+ */
+export declare function countActiveParticles(particles: readonly ParticleState[]): number;
+/**
+ * Resets the particle ID counter (useful for testing)
+ */
+export declare function resetParticleIdCounter(): void;
+//# sourceMappingURL=particle.d.ts.map

package/dist/cjs/particle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle.d.ts","sourceRoot":"","sources":["../../src/particle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAEb,aAAa,EACb,aAAa,EACb,WAAW,EACX,UAAU,EACV,UAAU,EAEV,kBAAkB,EACnB,MAAM,SAAS,CAAC;AA+BjB;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAchE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,aAAa,CAgDf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,OAAO,EAClB,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAClC,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CA2FN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,wBAAwB,EAC7B,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,IAAI,CAuFN;AA4ND;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAEpF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAEhF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}