Merge pull request #6 from ishansasika/release/v2.3.1-docs-fix-and-useloader-improvements

Release/v2.3.1 docs fix and useloader improvements

Author: ishansasika

CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.3.1] - 2025-01-14
+
+### Added
+- **useEnhancedLoader**: Added `toggleLoading()` function for toggling loading state
+- **useEnhancedLoader**: Added `setLoading(boolean)` function for direct state control
+- These additions make useEnhancedLoader API-consistent with the basic useLoader hook
+
+### Fixed
+- **Documentation**: Updated component count from 28 to 29 across all documentation
+- **Documentation**: Updated category count from 7 to 8 across all documentation
+- **Storybook Introduction**: Added missing Transition category section
+
 ## [2.3.0] - 2025-01-13
 
 ### Added

README.md

@@ -1,6 +1,6 @@
 # Premium React Loaders
 
-A comprehensive collection of **28 premium, production-ready loading components** for React applications. Built with TypeScript and custom CSS for maximum flexibility and zero configuration.
+A comprehensive collection of **29 premium, production-ready loading components** for React applications. Built with TypeScript and custom CSS for maximum flexibility and zero configuration.
 
 [![npm version](https://img.shields.io/npm/v/premium-react-loaders.svg)](https://www.npmjs.com/package/premium-react-loaders)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
@@ -11,11 +11,11 @@ A comprehensive collection of **28 premium, production-ready loading components*
 
 📚 **[Storybook Documentation](https://docs.premium-react-loaders.ishansasika.dev/)** - Detailed component documentation and examples
 
-See all 28 components in action with interactive examples and customization options.
+See all 29 components in action with interactive examples and customization options.
 
 ## Features
 
-- **28 Premium Components** across 7 categories (Skeleton, Spinner, Progress, Pulse, Overlay, Button, Status)
+- **29 Premium Components** across 8 categories (Skeleton, Spinner, Progress, Pulse, Overlay, Button, Status, Transition)
 - **Global Theming** - ThemeProvider for app-wide customization ✨ *New in v2.1.0*
 - **Smart Loading UX** - useLoader hook with delay, minDuration, and autoHide ✨ *New in v2.1.0*
 - **Enhanced CSS Variables** - Comprehensive theming with dark mode support ✨ *New in v2.1.0*

package.json

@@ -1,6 +1,6 @@
 {
   "name": "premium-react-loaders",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Premium, production-ready loading components for React with TypeScript",
   "author": "Ishan Karunaratne",
   "license": "MIT",

src/hooks/useEnhancedLoader.ts

@@ -368,6 +368,25 @@ export function useEnhancedLoader(options: UseLoaderOptions = {}): UseLoaderRetu
     setHistory([]);
   }, []);
 
+  const toggleLoading = useCallback(() => {
+    if (loading) {
+      stopLoading();
+    } else {
+      startLoading();
+    }
+  }, [loading, startLoading, stopLoading]);
+
+  const setLoading = useCallback(
+    (value: boolean) => {
+      if (value) {
+        startLoading();
+      } else {
+        stopLoading();
+      }
+    },
+    [startLoading, stopLoading]
+  );
+
   return {
     loading,
     isVisible,
@@ -377,6 +396,8 @@ export function useEnhancedLoader(options: UseLoaderOptions = {}): UseLoaderRetu
     history,
     startLoading,
     stopLoading,
+    toggleLoading,
+    setLoading,
     setError,
     retry,
     reset,

src/types/hooks.ts

@@ -115,6 +115,12 @@ export interface UseLoaderReturn {
   /** Stop loading with success */
   stopLoading: () => void;
 
+  /** Toggle loading state */
+  toggleLoading: () => void;
+
+  /** Set loading state directly */
+  setLoading: (loading: boolean) => void;
+
   /** Stop loading with error */
   setError: (error: Error) => void;
 

stories/Introduction.mdx

@@ -8,7 +8,7 @@ Welcome to **Premium React Loaders** - a comprehensive collection of production-
 
 ## Features
 
-- **28 Premium Components** across 7 categories
+- **29 Premium Components** across 8 categories
 - **Full TypeScript Support** with exported type definitions
 - **Zero Configuration** - no Tailwind or build setup required
 - **Tree-shakeable** - only bundle what you use
@@ -67,6 +67,10 @@ Animated success and error indicators:
 Full-screen or container-relative loader overlays:
 - LoaderOverlay
 
+### Transition (1 component) ✨ New in v2.3.0
+Smooth transitions between loading and loaded states:
+- LoaderTransition (with fade, slide, scale animations)
+
 ## Installation
 
 ```bash