premium-react-loaders 2.2.0 → 2.3.1

package/dist/types/hooks.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Loading state status
+ */
+export type LoadingStatus = 'idle' | 'loading' | 'success' | 'error';
+/**
+ * Retry strategy configuration
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts */
+    maxRetries?: number;
+    /** Initial delay in milliseconds before first retry */
+    initialDelay?: number;
+    /** Maximum delay in milliseconds between retries */
+    maxDelay?: number;
+    /** Exponential backoff multiplier (default: 2) */
+    backoffMultiplier?: number;
+    /** Function to determine if error should trigger a retry */
+    shouldRetry?: (error: Error, attemptNumber: number) => boolean;
+}
+/**
+ * Enhanced useLoader hook options
+ */
+export interface UseLoaderOptions {
+    /** Delay in milliseconds before showing loader */
+    delay?: number;
+    /** Minimum duration in milliseconds to show loader once visible */
+    minDuration?: number;
+    /** Auto-hide loader after specified milliseconds */
+    autoHide?: number;
+    /** Enable fade transition */
+    transition?: boolean | number;
+    /** Retry configuration */
+    retry?: RetryConfig;
+    /** Debounce delay in milliseconds for startLoading calls */
+    debounce?: number;
+    /** Throttle delay in milliseconds for startLoading calls */
+    throttle?: number;
+    /** Callback when loading starts */
+    onLoadingStart?: () => void;
+    /** Callback when loading completes successfully */
+    onSuccess?: () => void;
+    /** Callback when loading fails */
+    onError?: (error: Error) => void;
+    /** Success display duration in milliseconds before resetting */
+    successDuration?: number;
+    /** Error display duration in milliseconds before resetting */
+    errorDuration?: number;
+}
+/**
+ * Loading state history entry
+ */
+export interface LoadingHistoryEntry {
+    /** Timestamp when loading started */
+    startTime: number;
+    /** Timestamp when loading ended */
+    endTime?: number;
+    /** Duration in milliseconds (if ended) */
+    duration?: number;
+    /** Final status of this loading session */
+    status: LoadingStatus;
+    /** Error if status is 'error' */
+    error?: Error;
+    /** Number of retry attempts made */
+    retryCount?: number;
+}
+/**
+ * Enhanced useLoader hook return value
+ */
+export interface UseLoaderReturn {
+    /** Current loading state */
+    loading: boolean;
+    /** Whether loader should be visible (respects delay and minDuration) */
+    isVisible: boolean;
+    /** Current status (idle, loading, success, error) */
+    status: LoadingStatus;
+    /** Current error if any */
+    error: Error | null;
+    /** Number of current retry attempt (0 if not retrying) */
+    retryAttempt: number;
+    /** Loading history */
+    history: LoadingHistoryEntry[];
+    /** Start loading */
+    startLoading: () => void;
+    /** 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;
+    /** Manually retry the last failed operation */
+    retry: () => void;
+    /** Reset to idle state */
+    reset: () => void;
+    /** Clear history */
+    clearHistory: () => void;
+}
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAE9B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAE5B,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAEvB,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2CAA2C;IAC3C,MAAM,EAAE,aAAa,CAAC;IAEtB,iCAAiC;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IAEjB,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAC;IAEnB,qDAAqD;IACrD,MAAM,EAAE,aAAa,CAAC;IAEtB,2BAA2B;IAC3B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IAErB,sBAAsB;IACtB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAE/B,oBAAoB;IACpB,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB,gCAAgC;IAChC,WAAW,EAAE,MAAM,IAAI,CAAC;IAExB,2BAA2B;IAC3B,aAAa,EAAE,MAAM,IAAI,CAAC;IAE1B,iCAAiC;IACjC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAEvC,8BAA8B;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC,+CAA+C;IAC/C,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB,oBAAoB;IACpB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B"}

package/dist/types/index.d.ts

@@ -6,4 +6,6 @@ export * from './pulse';
 export * from './overlay';
 export * from './button';
 export * from './status';
+export * from './transition';
+export * from './hooks';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC"}

package/dist/types/transition.d.ts

@@ -0,0 +1,34 @@
+import { ReactNode } from 'react';
+import { BaseLoaderProps } from './common';
+/**
+ * Transition animation type
+ */
+export type TransitionType = 'fade' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right' | 'scale' | 'none';
+/**
+ * Transition timing function
+ */
+export type TransitionTiming = 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'linear' | 'spring';
+/**
+ * LoaderTransition component props
+ */
+export interface LoaderTransitionProps extends Omit<BaseLoaderProps, 'size' | 'color' | 'secondaryColor' | 'speed' | 'reverse'> {
+    /** Whether currently in loading state */
+    loading: boolean;
+    /** Loading content to show (skeleton, spinner, etc.) */
+    loadingContent: ReactNode;
+    /** Actual content to show when loaded */
+    children: ReactNode;
+    /** Type of transition animation */
+    transitionType?: TransitionType;
+    /** Duration of transition in milliseconds */
+    duration?: number;
+    /** Timing function for the transition */
+    timing?: TransitionTiming;
+    /** Whether to keep the loading content mounted (improves performance for repeated loads) */
+    keepMounted?: boolean;
+    /** Delay before starting the transition out (prevents flash on quick loads) */
+    exitDelay?: number;
+    /** Whether to show loading content on first render */
+    appearOnMount?: boolean;
+}
+//# sourceMappingURL=transition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transition.d.ts","sourceRoot":"","sources":["../../src/types/transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAElH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErG;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,GAAG,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAAC;IAC7H,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IAEjB,wDAAwD;IACxD,cAAc,EAAE,SAAS,CAAC;IAE1B,yCAAyC;IACzC,QAAQ,EAAE,SAAS,CAAC;IAEpB,mCAAmC;IACnC,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B,4FAA4F;IAC5F,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/package.json

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