premium-react-loaders 2.3.1 → 3.1.0

package/dist/components/skeleton/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/skeleton/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/skeleton/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/components/smart/FormFieldLoader.d.ts

@@ -0,0 +1,22 @@
+import { FormFieldLoaderProps } from '../../types';
+/**
+ * FormFieldLoader - Loading state for form inputs
+ *
+ * Specialized loader for form fields that maintains layout during loading,
+ * with support for various input types, labels, and validation messages.
+ *
+ * @example
+ * ```tsx
+ * <FormFieldLoader fieldType="text" showLabel showRequired />
+ * <FormFieldLoader
+ *   fieldType="select"
+ *   labelWidth={120}
+ *   fieldWidth="100%"
+ *   showLabel
+ *   showValidation
+ * />
+ * <FormFieldLoader fieldType="textarea" fieldHeight={120} />
+ * ```
+ */
+export declare const FormFieldLoader: import('react').ForwardRefExoticComponent<FormFieldLoaderProps & import('react').RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=FormFieldLoader.d.ts.map

package/dist/components/smart/FormFieldLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFieldLoader.d.ts","sourceRoot":"","sources":["../../../src/components/smart/FormFieldLoader.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAInD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,iHAyK3B,CAAC"}

package/dist/components/smart/index.d.ts

@@ -0,0 +1,2 @@
+export { FormFieldLoader } from './FormFieldLoader';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/smart/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/smart/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/components/text/LoadingText.d.ts

@@ -0,0 +1,16 @@
+import { LoadingTextProps } from '../../types';
+/**
+ * LoadingText - Animated loading text with ellipsis
+ *
+ * Customizable "Loading..." text with various animation styles.
+ *
+ * @example
+ * ```tsx
+ * <LoadingText />
+ * <LoadingText text="Please wait" animation="fade" />
+ * <LoadingText text="Processing" dotCount={4} color="#3b82f6" />
+ * <LoadingText animation="bounce" fontSize={18} />
+ * ```
+ */
+export declare const LoadingText: import('react').ForwardRefExoticComponent<LoadingTextProps & import('react').RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=LoadingText.d.ts.map

package/dist/components/text/LoadingText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingText.d.ts","sourceRoot":"","sources":["../../../src/components/text/LoadingText.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQ/C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,6GAiLvB,CAAC"}

package/dist/components/text/index.d.ts

@@ -0,0 +1,2 @@
+export { LoadingText } from './LoadingText';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/text/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/hooks/index.d.ts

@@ -1,5 +1,11 @@
 export { useLoader } from './useLoader';
 export { useEnhancedLoader } from './useEnhancedLoader';
+export { useLoadingOrchestrator } from './useLoadingOrchestrator';
+export { useLoadingAnalytics } from './useLoadingAnalytics';
+export { useSmartLoader } from './useSmartLoader';
 export type { UseLoaderOptions as BasicUseLoaderOptions, UseLoaderReturn as BasicUseLoaderReturn } from './useLoader';
 export type { UseLoaderOptions, UseLoaderReturn, LoadingStatus, LoadingHistoryEntry, RetryConfig } from '../types/hooks';
+export type { LoadingTask, LoadingTaskStatus, OrchestratorOptions, UseLoadingOrchestratorReturn, } from './useLoadingOrchestrator';
+export type { LoadingSession, LoadingMetrics, AnalyticsOptions, UseLoadingAnalyticsReturn, } from './useLoadingAnalytics';
+export type { ConnectionSpeed, SmartLoaderOptions, UseSmartLoaderReturn, } from './useSmartLoader';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,YAAY,EAAE,gBAAgB,IAAI,qBAAqB,EAAE,eAAe,IAAI,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtH,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,gBAAgB,IAAI,qBAAqB,EAAE,eAAe,IAAI,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtH,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzH,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/hooks/useLoadingAnalytics.d.ts

@@ -0,0 +1,101 @@
+export interface LoadingSession {
+    /** Session start timestamp */
+    startTime: number;
+    /** Session end timestamp */
+    endTime?: number;
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Whether the loading was successful */
+    success?: boolean;
+    /** Whether the user abandoned (navigated away) */
+    abandoned?: boolean;
+}
+export interface LoadingMetrics {
+    /** Total number of loading sessions */
+    totalSessions: number;
+    /** Average loading duration in milliseconds */
+    averageDuration: number;
+    /** Longest loading time in milliseconds */
+    maxDuration: number;
+    /** Shortest loading time in milliseconds */
+    minDuration: number;
+    /** Success rate (0-1) */
+    successRate: number;
+    /** User abandonment rate (0-1) */
+    abandonmentRate: number;
+    /** All sessions data */
+    sessions: LoadingSession[];
+}
+export interface AnalyticsOptions {
+    /** Track user interactions during loading */
+    trackInteractions?: boolean;
+    /** Callback when metrics are updated */
+    onMetricsUpdate?: (metrics: LoadingMetrics) => void;
+    /** Local storage key for persisting metrics */
+    storageKey?: string;
+    /** Maximum number of sessions to store */
+    maxSessions?: number;
+}
+export interface UseLoadingAnalyticsReturn {
+    /** Current metrics */
+    metrics: LoadingMetrics;
+    /** Start tracking a loading session */
+    startTracking: () => void;
+    /** Stop tracking and mark as success or failure */
+    stopTracking: (success: boolean) => void;
+    /** Record user abandonment */
+    recordAbandonment: () => void;
+    /** Clear all metrics */
+    clearMetrics: () => void;
+    /** Export metrics as JSON */
+    exportMetrics: () => LoadingMetrics;
+    /** Whether currently tracking */
+    isTracking: boolean;
+}
+/**
+ * useLoadingAnalytics - Track loading performance and user experience
+ *
+ * Monitors loading sessions, calculates performance metrics, and tracks user behavior
+ * like abandonment. Useful for optimizing loading UX and identifying bottlenecks.
+ *
+ * @param options - Configuration options
+ * @returns Metrics and tracking control functions
+ *
+ * @example
+ * ```tsx
+ * function AnalyticsDemo() {
+ *   const {
+ *     metrics,
+ *     startTracking,
+ *     stopTracking,
+ *     isTracking,
+ *   } = useLoadingAnalytics({
+ *     storageKey: 'my-app-loading-metrics',
+ *     onMetricsUpdate: (metrics) => {
+ *       console.log('Average load time:', metrics.averageDuration, 'ms');
+ *       console.log('Success rate:', (metrics.successRate * 100).toFixed(1), '%');
+ *     },
+ *   });
+ *
+ *   const loadData = async () => {
+ *     startTracking();
+ *     try {
+ *       await fetchData();
+ *       stopTracking(true);
+ *     } catch (error) {
+ *       stopTracking(false);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <p>Total sessions: {metrics.totalSessions}</p>
+ *       <p>Avg duration: {metrics.averageDuration.toFixed(0)}ms</p>
+ *       <p>Success rate: {(metrics.successRate * 100).toFixed(1)}%</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useLoadingAnalytics(options?: AnalyticsOptions): UseLoadingAnalyticsReturn;
+//# sourceMappingURL=useLoadingAnalytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLoadingAnalytics.d.ts","sourceRoot":"","sources":["../../src/hooks/useLoadingAnalytics.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wCAAwC;IACxC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IACpD,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,uCAAuC;IACvC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,mDAAmD;IACnD,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,8BAA8B;IAC9B,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,wBAAwB;IACxB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,cAAc,CAAC;IACpC,iCAAiC;IACjC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,gBAAqB,GAC7B,yBAAyB,CA0L3B"}

package/dist/hooks/useLoadingOrchestrator.d.ts

@@ -0,0 +1,104 @@
+export type LoadingTaskStatus = 'pending' | 'loading' | 'success' | 'error';
+export interface LoadingTask {
+    /** Unique identifier for the task */
+    id: string;
+    /** Human-readable label */
+    label: string;
+    /** Current status */
+    status: LoadingTaskStatus;
+    /** Task dependencies (IDs of tasks that must complete first) */
+    dependsOn?: string[];
+    /** Progress percentage (0-100) */
+    progress?: number;
+    /** Error object if task failed */
+    error?: Error;
+}
+export interface OrchestratorOptions {
+    /** Execution mode: parallel or sequential */
+    mode?: 'parallel' | 'sequential';
+    /** Stop all tasks on first error */
+    stopOnError?: boolean;
+    /** Callback when a task starts */
+    onTaskStart?: (taskId: string) => void;
+    /** Callback when a task completes successfully */
+    onTaskComplete?: (taskId: string) => void;
+    /** Callback when a task fails */
+    onTaskError?: (taskId: string, error: Error) => void;
+    /** Callback when all tasks complete */
+    onAllComplete?: () => void;
+}
+export interface UseLoadingOrchestratorReturn {
+    /** Current state of all tasks */
+    tasks: LoadingTask[];
+    /** Start a specific task */
+    startTask: (taskId: string) => Promise<void>;
+    /** Mark a task as complete */
+    completeTask: (taskId: string) => void;
+    /** Mark a task as failed */
+    failTask: (taskId: string, error: Error) => void;
+    /** Update progress for a task */
+    updateProgress: (taskId: string, progress: number) => void;
+    /** Reset all tasks to pending */
+    resetTasks: () => void;
+    /** Overall progress (0-100) */
+    overallProgress: number;
+    /** Whether all tasks are complete */
+    allComplete: boolean;
+    /** Whether any task has errors */
+    hasErrors: boolean;
+}
+/**
+ * useLoadingOrchestrator - Manage multiple loading states with dependencies
+ *
+ * Coordinates multiple loading tasks with dependency management, progress tracking,
+ * and execution control (parallel or sequential).
+ *
+ * @param initialTasks - Array of loading tasks
+ * @param options - Configuration options
+ * @returns Task state and control functions
+ *
+ * @example
+ * ```tsx
+ * function DataLoader() {
+ *   const {
+ *     tasks,
+ *     startTask,
+ *     completeTask,
+ *     failTask,
+ *     updateProgress,
+ *     overallProgress,
+ *   } = useLoadingOrchestrator(
+ *     [
+ *       { id: 'auth', label: 'Authenticating...', status: 'pending' },
+ *       { id: 'data', label: 'Fetching data...', status: 'pending', dependsOn: ['auth'] },
+ *       { id: 'render', label: 'Rendering...', status: 'pending', dependsOn: ['data'] },
+ *     ],
+ *     {
+ *       mode: 'sequential',
+ *       onAllComplete: () => console.log('All done!'),
+ *     }
+ *   );
+ *
+ *   const loadAll = async () => {
+ *     await startTask('auth');
+ *     // ... perform auth
+ *     completeTask('auth');
+ *
+ *     await startTask('data');
+ *     // ... fetch data
+ *     completeTask('data');
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <ProgressBar value={overallProgress} />
+ *       {tasks.map(task => (
+ *         <div key={task.id}>{task.label}: {task.status}</div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useLoadingOrchestrator(initialTasks: LoadingTask[], options?: OrchestratorOptions): UseLoadingOrchestratorReturn;
+//# sourceMappingURL=useLoadingOrchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLoadingOrchestrator.d.ts","sourceRoot":"","sources":["../../src/hooks/useLoadingOrchestrator.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACjC,oCAAoC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kCAAkC;IAClC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kDAAkD;IAClD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,iCAAiC;IACjC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACrD,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,4BAA4B;IAC3C,iCAAiC;IACjC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,4BAA4B;IAC5B,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,8BAA8B;IAC9B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,4BAA4B;IAC5B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjD,iCAAiC;IACjC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,iCAAiC;IACjC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,WAAW,EAAE,EAC3B,OAAO,GAAE,mBAAwB,GAChC,4BAA4B,CA0J9B"}

package/dist/hooks/useSmartLoader.d.ts

@@ -0,0 +1,98 @@
+export type ConnectionSpeed = 'slow' | 'medium' | 'fast';
+export interface SmartLoaderOptions {
+    /** Auto-detect slow connections and adjust behavior */
+    adaptToConnection?: boolean;
+    /** Show estimated progress based on historical data */
+    estimateProgress?: boolean;
+    /** Automatically retry on failure */
+    autoRetry?: boolean;
+    /** Maximum retry attempts */
+    maxRetries?: number;
+    /** Use intelligent delay based on connection speed */
+    intelligentDelay?: boolean;
+    /** Callback when loading starts */
+    onLoadingStart?: () => void;
+    /** Callback when loading completes */
+    onLoadingComplete?: () => void;
+    /** Callback on retry */
+    onRetry?: (attempt: number) => void;
+}
+export interface UseSmartLoaderReturn {
+    /** Current loading state */
+    loading: boolean;
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** Estimated time remaining in seconds */
+    estimatedTimeRemaining: number;
+    /** Detected connection speed */
+    connectionSpeed: ConnectionSpeed;
+    /** Whether loader should be shown (accounts for intelligent delay) */
+    shouldShowLoader: boolean;
+    /** Current retry attempt */
+    retryAttempt: number;
+    /** Start loading */
+    startLoading: () => void;
+    /** Stop loading */
+    stopLoading: (success?: boolean) => void;
+    /** Update progress manually */
+    updateProgress: (value: number) => void;
+    /** Retry the operation */
+    retry: () => void;
+}
+/**
+ * useSmartLoader - Intelligent loader with adaptive UX
+ *
+ * Combines multiple smart loading features: connection detection, progress estimation,
+ * intelligent delays, and automatic retry logic for optimal user experience.
+ *
+ * @param options - Configuration options
+ * @returns Smart loading state and controls
+ *
+ * @example
+ * ```tsx
+ * function SmartDataLoader() {
+ *   const {
+ *     loading,
+ *     progress,
+ *     estimatedTimeRemaining,
+ *     connectionSpeed,
+ *     shouldShowLoader,
+ *     startLoading,
+ *     stopLoading,
+ *     updateProgress,
+ *   } = useSmartLoader({
+ *     adaptToConnection: true,
+ *     estimateProgress: true,
+ *     autoRetry: true,
+ *     maxRetries: 3,
+ *     intelligentDelay: true,
+ *   });
+ *
+ *   const loadData = async () => {
+ *     startLoading();
+ *     try {
+ *       const data = await fetchData((progress) => {
+ *         updateProgress(progress);
+ *       });
+ *       stopLoading(true);
+ *     } catch (error) {
+ *       stopLoading(false);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <>
+ *       {shouldShowLoader && (
+ *         <div>
+ *           <ProgressBar value={progress} />
+ *           <p>Connection: {connectionSpeed}</p>
+ *           <p>ETA: {estimatedTimeRemaining}s</p>
+ *         </div>
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export declare function useSmartLoader(options?: SmartLoaderOptions): UseSmartLoaderReturn;
+//# sourceMappingURL=useSmartLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSmartLoader.d.ts","sourceRoot":"","sources":["../../src/hooks/useSmartLoader.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gCAAgC;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,sEAAsE;IACtE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,mBAAmB;IACnB,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,+BAA+B;IAC/B,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,kBAAuB,GAC/B,oBAAoB,CA6OtB"}

package/dist/index.cjs

@@ -14,26 +14,46 @@ const SkeletonList = require("./index12.cjs");
 const SkeletonTable = require("./index13.cjs");
 const SkeletonPage = require("./index14.cjs");
 const SkeletonForm = require("./index15.cjs");
-const SpinnerCircle = require("./index16.cjs");
-const SpinnerRing = require("./index17.cjs");
-const SpinnerDots = require("./index18.cjs");
-const SpinnerBars = require("./index19.cjs");
-const SpinnerGrid = require("./index20.cjs");
-const SpinnerWave = require("./index21.cjs");
-const SpinnerPulse = require("./index22.cjs");
-const ProgressBar = require("./index23.cjs");
-const ProgressCircle = require("./index24.cjs");
-const ProgressRing = require("./index25.cjs");
-const ProgressSteps = require("./index26.cjs");
-const PulseDots = require("./index27.cjs");
-const PulseWave = require("./index28.cjs");
-const PulseBars = require("./index29.cjs");
-const TypingIndicator = require("./index30.cjs");
-const LoaderOverlay = require("./index31.cjs");
-const ButtonSpinner = require("./index32.cjs");
-const SuccessCheckmark = require("./index33.cjs");
-const ErrorIndicator = require("./index34.cjs");
-const LoaderTransition = require("./index35.cjs");
+const SmartSkeleton = require("./index16.cjs");
+const DataTableSkeleton = require("./index17.cjs");
+const SpinnerCircle = require("./index18.cjs");
+const SpinnerRing = require("./index19.cjs");
+const SpinnerDots = require("./index20.cjs");
+const SpinnerBars = require("./index21.cjs");
+const SpinnerGrid = require("./index22.cjs");
+const SpinnerWave = require("./index23.cjs");
+const SpinnerPulse = require("./index24.cjs");
+const ProgressBar = require("./index25.cjs");
+const ProgressCircle = require("./index26.cjs");
+const ProgressRing = require("./index27.cjs");
+const ProgressSteps = require("./index28.cjs");
+const PulseDots = require("./index29.cjs");
+const PulseWave = require("./index30.cjs");
+const PulseBars = require("./index31.cjs");
+const TypingIndicator = require("./index32.cjs");
+const LoaderOverlay = require("./index33.cjs");
+const ButtonSpinner = require("./index34.cjs");
+const SuccessCheckmark = require("./index35.cjs");
+const ErrorIndicator = require("./index36.cjs");
+const LoaderTransition = require("./index37.cjs");
+const ShimmerBox = require("./index38.cjs");
+const ShimmerText = require("./index39.cjs");
+const ShimmerButton = require("./index40.cjs");
+const OrbitDots = require("./index41.cjs");
+const OrbitRings = require("./index42.cjs");
+const AtomLoader = require("./index43.cjs");
+const BouncingDots = require("./index44.cjs");
+const BouncingBalls = require("./index45.cjs");
+const InfinityLoader = require("./index46.cjs");
+const MobiusLoader = require("./index47.cjs");
+const LoadingText = require("./index48.cjs");
+const CubeSpinner = require("./index49.cjs");
+const FlipCard = require("./index50.cjs");
+const PlaneRotate = require("./index51.cjs");
+const Helix = require("./index52.cjs");
+const PerspectiveRing = require("./index53.cjs");
+const FormFieldLoader = require("./index54.cjs");
+const LiveRegion = require("./index55.cjs");
 const version = "2.1.0";
 exports.cn = classNames.cn;
 exports.getAnimationDuration = colors.getAnimationDuration;
@@ -50,6 +70,8 @@ exports.SkeletonList = SkeletonList.SkeletonList;
 exports.SkeletonTable = SkeletonTable.SkeletonTable;
 exports.SkeletonPage = SkeletonPage.SkeletonPage;
 exports.SkeletonForm = SkeletonForm.SkeletonForm;
+exports.SmartSkeleton = SmartSkeleton.SmartSkeleton;
+exports.DataTableSkeleton = DataTableSkeleton.DataTableSkeleton;
 exports.SpinnerCircle = SpinnerCircle.SpinnerCircle;
 exports.SpinnerRing = SpinnerRing.SpinnerRing;
 exports.SpinnerDots = SpinnerDots.SpinnerDots;
@@ -70,4 +92,22 @@ exports.ButtonSpinner = ButtonSpinner.ButtonSpinner;
 exports.SuccessCheckmark = SuccessCheckmark.SuccessCheckmark;
 exports.ErrorIndicator = ErrorIndicator.ErrorIndicator;
 exports.LoaderTransition = LoaderTransition.LoaderTransition;
+exports.ShimmerBox = ShimmerBox.ShimmerBox;
+exports.ShimmerText = ShimmerText.ShimmerText;
+exports.ShimmerButton = ShimmerButton.ShimmerButton;
+exports.OrbitDots = OrbitDots.OrbitDots;
+exports.OrbitRings = OrbitRings.OrbitRings;
+exports.AtomLoader = AtomLoader.AtomLoader;
+exports.BouncingDots = BouncingDots.BouncingDots;
+exports.BouncingBalls = BouncingBalls.BouncingBalls;
+exports.InfinityLoader = InfinityLoader.InfinityLoader;
+exports.MobiusLoader = MobiusLoader.MobiusLoader;
+exports.LoadingText = LoadingText.LoadingText;
+exports.CubeSpinner = CubeSpinner.CubeSpinner;
+exports.FlipCard = FlipCard.FlipCard;
+exports.PlaneRotate = PlaneRotate.PlaneRotate;
+exports.Helix = Helix.Helix;
+exports.PerspectiveRing = PerspectiveRing.PerspectiveRing;
+exports.FormFieldLoader = FormFieldLoader.FormFieldLoader;
+exports.LiveRegion = LiveRegion.LiveRegion;
 exports.version = version;

package/dist/index.js

@@ -12,32 +12,68 @@ import { SkeletonList } from "./index12.js";
 import { SkeletonTable } from "./index13.js";
 import { SkeletonPage } from "./index14.js";
 import { SkeletonForm } from "./index15.js";
-import { SpinnerCircle } from "./index16.js";
-import { SpinnerRing } from "./index17.js";
-import { SpinnerDots } from "./index18.js";
-import { SpinnerBars } from "./index19.js";
-import { SpinnerGrid } from "./index20.js";
-import { SpinnerWave } from "./index21.js";
-import { SpinnerPulse } from "./index22.js";
-import { ProgressBar } from "./index23.js";
-import { ProgressCircle } from "./index24.js";
-import { ProgressRing } from "./index25.js";
-import { ProgressSteps } from "./index26.js";
-import { PulseDots } from "./index27.js";
-import { PulseWave } from "./index28.js";
-import { PulseBars } from "./index29.js";
-import { TypingIndicator } from "./index30.js";
-import { LoaderOverlay } from "./index31.js";
-import { ButtonSpinner } from "./index32.js";
-import { SuccessCheckmark } from "./index33.js";
-import { ErrorIndicator } from "./index34.js";
-import { LoaderTransition } from "./index35.js";
+import { SmartSkeleton } from "./index16.js";
+import { DataTableSkeleton } from "./index17.js";
+import { SpinnerCircle } from "./index18.js";
+import { SpinnerRing } from "./index19.js";
+import { SpinnerDots } from "./index20.js";
+import { SpinnerBars } from "./index21.js";
+import { SpinnerGrid } from "./index22.js";
+import { SpinnerWave } from "./index23.js";
+import { SpinnerPulse } from "./index24.js";
+import { ProgressBar } from "./index25.js";
+import { ProgressCircle } from "./index26.js";
+import { ProgressRing } from "./index27.js";
+import { ProgressSteps } from "./index28.js";
+import { PulseDots } from "./index29.js";
+import { PulseWave } from "./index30.js";
+import { PulseBars } from "./index31.js";
+import { TypingIndicator } from "./index32.js";
+import { LoaderOverlay } from "./index33.js";
+import { ButtonSpinner } from "./index34.js";
+import { SuccessCheckmark } from "./index35.js";
+import { ErrorIndicator } from "./index36.js";
+import { LoaderTransition } from "./index37.js";
+import { ShimmerBox } from "./index38.js";
+import { ShimmerText } from "./index39.js";
+import { ShimmerButton } from "./index40.js";
+import { OrbitDots } from "./index41.js";
+import { OrbitRings } from "./index42.js";
+import { AtomLoader } from "./index43.js";
+import { BouncingDots } from "./index44.js";
+import { BouncingBalls } from "./index45.js";
+import { InfinityLoader } from "./index46.js";
+import { MobiusLoader } from "./index47.js";
+import { LoadingText } from "./index48.js";
+import { CubeSpinner } from "./index49.js";
+import { FlipCard } from "./index50.js";
+import { PlaneRotate } from "./index51.js";
+import { Helix } from "./index52.js";
+import { PerspectiveRing } from "./index53.js";
+import { FormFieldLoader } from "./index54.js";
+import { LiveRegion } from "./index55.js";
 const version = "2.1.0";
 export {
+  AtomLoader,
+  BouncingBalls,
+  BouncingDots,
   ButtonSpinner,
+  CubeSpinner,
+  DataTableSkeleton,
   ErrorIndicator,
+  FlipCard,
+  FormFieldLoader,
+  Helix,
+  InfinityLoader,
+  LiveRegion,
   LoaderOverlay,
   LoaderTransition,
+  LoadingText,
+  MobiusLoader,
+  OrbitDots,
+  OrbitRings,
+  PerspectiveRing,
+  PlaneRotate,
   ProgressBar,
   ProgressCircle,
   ProgressRing,
@@ -45,6 +81,9 @@ export {
   PulseBars,
   PulseDots,
   PulseWave,
+  ShimmerBox,
+  ShimmerButton,
+  ShimmerText,
   Skeleton,
   SkeletonAvatar,
   SkeletonCard,
@@ -54,6 +93,7 @@ export {
   SkeletonPage,
   SkeletonTable,
   SkeletonText,
+  SmartSkeleton,
   SpinnerBars,
   SpinnerCircle,
   SpinnerDots,

package/dist/index10.cjs

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
 const react = require("react");
 const Skeleton = require("./index7.cjs");
-const hooks = require("./index36.cjs");
+const hooks = require("./index56.cjs");
 const SkeletonImage = react.forwardRef(
   ({
     width = "100%",

package/dist/index10.js

@@ -1,7 +1,7 @@
 import { jsx } from "react/jsx-runtime";
 import { forwardRef } from "react";
 import { Skeleton } from "./index7.js";
-import { useLoaderVisibility } from "./index36.js";
+import { useLoaderVisibility } from "./index56.js";
 const SkeletonImage = forwardRef(
   ({
     width = "100%",

package/dist/index11.cjs

@@ -4,7 +4,7 @@ const jsxRuntime = require("react/jsx-runtime");
 const react = require("react");
 const Skeleton = require("./index7.cjs");
 const SkeletonAvatar = require("./index9.cjs");
-const hooks = require("./index36.cjs");
+const hooks = require("./index56.cjs");
 const classNames = require("./index3.cjs");
 const SkeletonCard = react.forwardRef(
   ({

package/dist/index11.js

@@ -2,7 +2,7 @@ import { jsxs, jsx } from "react/jsx-runtime";
 import { forwardRef } from "react";
 import { Skeleton } from "./index7.js";
 import { SkeletonAvatar } from "./index9.js";
-import { useLoaderVisibility } from "./index36.js";
+import { useLoaderVisibility } from "./index56.js";
 import { cn } from "./index3.js";
 const SkeletonCard = forwardRef(
   ({