@umituz/react-native-design-system 2.8.42 → 2.8.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-design-system",
-  "version": "2.8.42",
+  "version": "2.8.43",
   "description": "Universal design system for React Native apps - Consolidated package with atoms, molecules, organisms, theme, typography, responsive, safe area, exception, infinite scroll, UUID, image, timezone, offline, and onboarding utilities",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/infinite-scroll/presentation/hooks/pagination.helper.ts

@@ -6,6 +6,62 @@
 import type { InfiniteScrollConfig } from "../../domain/types/infinite-scroll-config";
 import type { InfiniteScrollState } from "../../domain/types/infinite-scroll-state";
 
+/**
+ * Sleep utility for retry delay
+ */
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+/**
+ * Retry logic with exponential backoff
+ */
+export async function retryWithBackoff<T>(
+  fn: () => Promise<T>,
+  maxRetries: number,
+  baseDelay: number,
+): Promise<T> {
+  let lastError: Error | undefined;
+
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error(String(error));
+
+      if (attempt < maxRetries) {
+        const delay = baseDelay * Math.pow(2, attempt);
+        if (__DEV__) {
+          console.log(
+            `[useInfiniteScroll] Retry attempt ${attempt + 1}/${maxRetries} after ${delay}ms`,
+          );
+        }
+        await sleep(delay);
+      }
+    }
+  }
+
+  throw lastError;
+}
+
+export function createInitialState<T>(
+  initialPage: number,
+  totalItems?: number,
+): InfiniteScrollState<T> {
+  return {
+    items: [],
+    pages: [],
+    currentPage: initialPage,
+    cursor: null,
+    hasMore: true,
+    isLoading: true,
+    isLoadingMore: false,
+    isRefreshing: false,
+    error: null,
+    totalItems,
+  };
+}
+
 export function isCursorMode<T>(
   config: InfiniteScrollConfig<T>,
 ): config is Extract<InfiniteScrollConfig<T>, { paginationMode: "cursor" }> {

package/src/infinite-scroll/presentation/hooks/useInfiniteScroll.ts

@@ -13,7 +13,13 @@ import { useState, useCallback, useEffect, useRef } from "react";
 import type { InfiniteScrollConfig } from "../../domain/types/infinite-scroll-config";
 import type { InfiniteScrollState } from "../../domain/types/infinite-scroll-state";
 import type { UseInfiniteScrollReturn } from "../../domain/types/infinite-scroll-return";
-import { loadData, loadMoreData, isCursorMode } from "./pagination.helper";
+import {
+  loadData,
+  loadMoreData,
+  isCursorMode,
+  createInitialState,
+  retryWithBackoff,
+} from "./pagination.helper";
 
 const DEFAULT_CONFIG = {
   pageSize: 20,
@@ -24,62 +30,6 @@ const DEFAULT_CONFIG = {
   retryDelay: 1000,
 };
 
-function createInitialState<T>(
-  initialPage: number,
-  totalItems?: number,
-): InfiniteScrollState<T> {
-  return {
-    items: [],
-    pages: [],
-    currentPage: initialPage,
-    cursor: null,
-    hasMore: true,
-    isLoading: true,
-    isLoadingMore: false,
-    isRefreshing: false,
-    error: null,
-    totalItems,
-  };
-}
-
-/**
- * Sleep utility for retry delay
- */
-function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-/**
- * Retry logic with exponential backoff
- */
-async function retryWithBackoff<T>(
-  fn: () => Promise<T>,
-  maxRetries: number,
-  baseDelay: number,
-): Promise<T> {
-  let lastError: Error | undefined;
-
-  for (let attempt = 0; attempt <= maxRetries; attempt++) {
-    try {
-      return await fn();
-    } catch (error) {
-      lastError = error instanceof Error ? error : new Error(String(error));
-
-      if (attempt < maxRetries) {
-        const delay = baseDelay * Math.pow(2, attempt);
-        if (__DEV__) {
-          console.log(
-            `[useInfiniteScroll] Retry attempt ${attempt + 1}/${maxRetries} after ${delay}ms`,
-          );
-        }
-        await sleep(delay);
-      }
-    }
-  }
-
-  throw lastError;
-}
-
 export function useInfiniteScroll<T>(
   config: InfiniteScrollConfig<T>,
 ): UseInfiniteScrollReturn<T> {
@@ -125,20 +75,16 @@ export function useInfiniteScroll<T>(
   const loadInitial = useCallback(async () => {
     if (isLoadingRef.current) return;
     isLoadingRef.current = true;
-
     cancelPendingRequests();
 
-    if (isMountedRef.current) {
-      setState((prev) => ({ ...prev, isLoading: true, error: null }));
-    }
+    if (isMountedRef.current) setState((prev) => ({ ...prev, isLoading: true, error: null }));
 
     const startTime = __DEV__ ? performance.now() : 0;
 
     try {
       const newState = await retryWithBackoff(
         async () => {
-          const result = await loadData(config, initialPage, pageSize, totalItems);
-          return result;
+          return await loadData(config, initialPage, pageSize, totalItems);
         },
         maxRetries,
         retryDelay,
@@ -146,7 +92,6 @@ export function useInfiniteScroll<T>(
 
       if (isMountedRef.current) {
         setState(newState);
-
         if (__DEV__) {
           const duration = performance.now() - startTime;
           console.log(
@@ -157,18 +102,9 @@ export function useInfiniteScroll<T>(
       }
     } catch (error) {
       if (isMountedRef.current) {
-        const errorMessage =
-          error instanceof Error ? error.message : "Failed to load data";
-
-        setState((prev) => ({
-          ...prev,
-          isLoading: false,
-          error: errorMessage,
-        }));
-
-        if (__DEV__) {
-          console.error("[useInfiniteScroll] Load initial failed:", errorMessage);
-        }
+        const errorMessage = error instanceof Error ? error.message : "Failed to load data";
+        setState((prev) => ({ ...prev, isLoading: false, error: errorMessage }));
+        if (__DEV__) console.error("[useInfiniteScroll] Load initial failed:", errorMessage);
       }
     } finally {
       isLoadingRef.current = false;
@@ -181,25 +117,20 @@ export function useInfiniteScroll<T>(
       !state.hasMore ||
       state.isLoadingMore ||
       state.isLoading
-    ) {
+    )
       return;
-    }
 
     if (isCursorMode(config) && !state.cursor) return;
 
     isLoadingRef.current = true;
-
-    if (isMountedRef.current) {
-      setState((prev) => ({ ...prev, isLoadingMore: true, error: null }));
-    }
+    if (isMountedRef.current) setState((prev) => ({ ...prev, isLoadingMore: true, error: null }));
 
     const startTime = __DEV__ ? performance.now() : 0;
 
     try {
       const updates = await retryWithBackoff(
         async () => {
-          const result = await loadMoreData(config, state, pageSize);
-          return result;
+          return await loadMoreData(config, state, pageSize);
         },
         maxRetries,
         retryDelay,
@@ -207,30 +138,19 @@ export function useInfiniteScroll<T>(
 
       if (isMountedRef.current) {
         setState((prev) => ({ ...prev, ...updates }));
-
         if (__DEV__) {
           const duration = performance.now() - startTime;
-          const newItemsCount = updates.items?.length || 0;
           console.log(
             `[useInfiniteScroll] Load more completed in ${duration.toFixed(2)}ms`,
-            `Loaded ${newItemsCount} items, total: ${updates.items?.length || 0}`,
+            `Loaded ${updates.items?.length || 0} items`,
           );
         }
       }
     } catch (error) {
       if (isMountedRef.current) {
-        const errorMessage =
-          error instanceof Error ? error.message : "Failed to load more items";
-
-        setState((prev) => ({
-          ...prev,
-          isLoadingMore: false,
-          error: errorMessage,
-        }));
-
-        if (__DEV__) {
-          console.error("[useInfiniteScroll] Load more failed:", errorMessage);
-        }
+        const errorMessage = error instanceof Error ? error.message : "Failed to load more items";
+        setState((prev) => ({ ...prev, isLoadingMore: false, error: errorMessage }));
+        if (__DEV__) console.error("[useInfiniteScroll] Load more failed:", errorMessage);
       }
     } finally {
       isLoadingRef.current = false;
@@ -240,20 +160,16 @@ export function useInfiniteScroll<T>(
   const refresh = useCallback(async () => {
     if (isLoadingRef.current) return;
     isLoadingRef.current = true;
-
     cancelPendingRequests();
 
-    if (isMountedRef.current) {
-      setState((prev) => ({ ...prev, isRefreshing: true, error: null }));
-    }
+    if (isMountedRef.current) setState((prev) => ({ ...prev, isRefreshing: true, error: null }));
 
     const startTime = __DEV__ ? performance.now() : 0;
 
     try {
       const newState = await retryWithBackoff(
         async () => {
-          const result = await loadData(config, initialPage, pageSize, totalItems);
-          return result;
+          return await loadData(config, initialPage, pageSize, totalItems);
         },
         maxRetries,
         retryDelay,
@@ -261,7 +177,6 @@ export function useInfiniteScroll<T>(
 
       if (isMountedRef.current) {
         setState(newState);
-
         if (__DEV__) {
           const duration = performance.now() - startTime;
           console.log(
@@ -272,18 +187,9 @@ export function useInfiniteScroll<T>(
       }
     } catch (error) {
       if (isMountedRef.current) {
-        const errorMessage =
-          error instanceof Error ? error.message : "Failed to refresh data";
-
-        setState((prev) => ({
-          ...prev,
-          isRefreshing: false,
-          error: errorMessage,
-        }));
-
-        if (__DEV__) {
-          console.error("[useInfiniteScroll] Refresh failed:", errorMessage);
-        }
+        const errorMessage = error instanceof Error ? error.message : "Failed to refresh data";
+        setState((prev) => ({ ...prev, isRefreshing: false, error: errorMessage }));
+        if (__DEV__) console.error("[useInfiniteScroll] Refresh failed:", errorMessage);
       }
     } finally {
       isLoadingRef.current = false;
@@ -294,34 +200,17 @@ export function useInfiniteScroll<T>(
     isLoadingRef.current = false;
     cancelPendingRequests();
     setState(createInitialState<T>(initialPage, totalItems));
-
-    if (__DEV__) {
-      console.log("[useInfiniteScroll] State reset");
-    }
+    if (__DEV__) console.log("[useInfiniteScroll] State reset");
   }, [initialPage, totalItems, cancelPendingRequests]);
 
   useEffect(() => {
-    if (autoLoad) {
-      loadInitial();
-    }
-
+    if (autoLoad) loadInitial();
     return () => {
-      // Cleanup on config change
-      if (__DEV__) {
-        console.log("[useInfiniteScroll] Config changed, cleaning up");
-      }
+      if (__DEV__) console.log("[useInfiniteScroll] Config changed, cleaning up");
     };
   }, [autoLoad, loadInitial]);
 
-  const canLoadMore =
-    state.hasMore && !state.isLoadingMore && !state.isLoading;
+  const canLoadMore = state.hasMore && !state.isLoadingMore && !state.isLoading;
 
-  return {
-    items: state.items,
-    state,
-    loadMore,
-    refresh,
-    reset,
-    canLoadMore,
-  };
+  return { items: state.items, state, loadMore, refresh, reset, canLoadMore };
 }

package/src/tanstack/domain/repositories/BaseRepository.ts

@@ -35,43 +35,16 @@
  * ```
  */
 
-import type { QueryClient } from '@tanstack/react-query';
+import type { QueryClient, QueryKey } from '@tanstack/react-query';
 import { getGlobalQueryClient } from '../../infrastructure/config/QueryClientSingleton';
-import type { CacheConfig } from '../types/CacheStrategy';
 import { CacheStrategies } from '../../infrastructure/config/QueryClientConfig';
-
-export interface CreateParams<TVariables> {
-  variables: TVariables;
-}
-
-export interface UpdateParams<TVariables> {
-  id: string | number;
-  variables: TVariables;
-}
-
-export interface ListParams {
-  page?: number;
-  limit?: number;
-  filter?: Record<string, unknown>;
-}
-
-export interface RepositoryOptions {
-  /**
-   * Cache strategy for queries
-   * @default CacheStrategies.PUBLIC_DATA
-   */
-  cacheStrategy?: CacheConfig;
-
-  /**
-   * Stale time override
-   */
-  staleTime?: number;
-
-  /**
-   * GC time override
-   */
-  gcTime?: number;
-}
+import { createQueryKeyFactory } from '../utils/QueryKeyFactory';
+import type {
+  CreateParams,
+  UpdateParams,
+  ListParams,
+  RepositoryOptions,
+} from './RepositoryTypes';
 
 /**
  * Base repository for CRUD operations
@@ -91,13 +64,7 @@ export abstract class BaseRepository<
   /**
    * Query key factory for this repository
    */
-  public readonly keys: {
-    all: () => readonly [string];
-    lists: () => readonly [string, 'list'];
-    list: (params: ListParams) => readonly [string, 'list', ListParams];
-    details: () => readonly [string, 'detail'];
-    detail: (id: string | number) => readonly [string, 'detail', string | number];
-  };
+  public readonly keys: ReturnType<typeof createQueryKeyFactory>;
 
   constructor(resource: string, options: RepositoryOptions = {}) {
     this.resource = resource;
@@ -106,13 +73,7 @@ export abstract class BaseRepository<
       ...options,
     };
 
-    this.keys = {
-      all: () => [this.resource] as const,
-      lists: () => [this.resource, 'list'] as const,
-      list: (params: ListParams) => [this.resource, 'list', params] as const,
-      details: () => [this.resource, 'detail'] as const,
-      detail: (id: string | number) => [this.resource, 'detail', id] as const,
-    };
+    this.keys = createQueryKeyFactory(this.resource);
   }
 
   /**
@@ -162,11 +123,11 @@ export abstract class BaseRepository<
    */
   async queryAll(params?: ListParams): Promise<TData[]> {
     const client = this.getClient();
-    const queryKey = params ? this.keys.list(params) : this.keys.lists();
+    const queryKey = params ? this.keys.list(params as Record<string, unknown>) : this.keys.lists();
     const cacheOptions = this.getCacheOptions();
 
     return client.fetchQuery({
-      queryKey,
+      queryKey: queryKey as QueryKey,
       queryFn: () => this.fetchAll(params),
       ...cacheOptions,
     });
@@ -182,7 +143,7 @@ export abstract class BaseRepository<
 
     try {
       return client.fetchQuery({
-        queryKey,
+        queryKey: queryKey as QueryKey,
         queryFn: () => this.fetchById(id),
         ...cacheOptions,
       });
@@ -196,11 +157,11 @@ export abstract class BaseRepository<
    */
   async prefetchAll(params?: ListParams): Promise<void> {
     const client = this.getClient();
-    const queryKey = params ? this.keys.list(params) : this.keys.lists();
+    const queryKey = params ? this.keys.list(params as Record<string, unknown>) : this.keys.lists();
     const cacheOptions = this.getCacheOptions();
 
     await client.prefetchQuery({
-      queryKey,
+      queryKey: queryKey as QueryKey,
       queryFn: () => this.fetchAll(params),
       ...cacheOptions,
     });
@@ -215,7 +176,7 @@ export abstract class BaseRepository<
     const cacheOptions = this.getCacheOptions();
 
     await client.prefetchQuery({
-      queryKey,
+      queryKey: queryKey as QueryKey,
       queryFn: () => this.fetchById(id),
       ...cacheOptions,
     });

package/src/tanstack/domain/repositories/RepositoryTypes.ts

@@ -0,0 +1,39 @@
+/**
+ * Repository Types
+ * Interfaces for data repository operations
+ */
+
+import type { CacheConfig } from '../types/CacheStrategy';
+
+export interface CreateParams<TVariables> {
+  variables: TVariables;
+}
+
+export interface UpdateParams<TVariables> {
+  id: string | number;
+  variables: TVariables;
+}
+
+export interface ListParams {
+  page?: number;
+  limit?: number;
+  filter?: Record<string, unknown>;
+}
+
+export interface RepositoryOptions {
+  /**
+   * Cache strategy for queries
+   * @default CacheStrategies.PUBLIC_DATA
+   */
+  cacheStrategy?: CacheConfig;
+
+  /**
+   * Stale time override
+   */
+  staleTime?: number;
+
+  /**
+   * GC time override
+   */
+  gcTime?: number;
+}

package/src/tanstack/index.ts

@@ -62,13 +62,13 @@ export {
 } from './domain/utils/ErrorHelpers';
 
 // Domain - Repositories
-export {
-  BaseRepository,
-  type CreateParams,
-  type UpdateParams,
-  type ListParams,
-  type RepositoryOptions,
-} from './domain/repositories/BaseRepository';
+export { BaseRepository } from './domain/repositories/BaseRepository';
+export type {
+  CreateParams,
+  UpdateParams,
+  ListParams,
+  RepositoryOptions,
+} from './domain/repositories/RepositoryTypes';
 
 export { RepositoryFactory } from './domain/repositories/RepositoryFactory';
 
@@ -95,12 +95,12 @@ export {
 } from './infrastructure/config/QueryClientSingleton';
 
 // Infrastructure - Monitoring
-export {
-  DevMonitor,
-  type QueryMetrics,
-  type CacheStats as QueryCacheStats,
-  type DevMonitorOptions,
-} from './infrastructure/monitoring/DevMonitor';
+export { DevMonitor } from './infrastructure/monitoring/DevMonitor';
+export type {
+  QueryMetrics,
+  CacheStats as QueryCacheStats,
+  DevMonitorOptions,
+} from './infrastructure/monitoring/DevMonitor.types';
 
 // Infrastructure - Providers
 export { TanstackProvider, type TanstackProviderProps } from './infrastructure/providers/TanstackProvider';

package/src/tanstack/infrastructure/monitoring/DevMonitor.ts

@@ -7,43 +7,8 @@
  */
 
 import type { Query, QueryClient } from '@tanstack/react-query';
-
-export interface QueryMetrics {
-  queryKey: readonly unknown[];
-  fetchCount: number;
-  totalFetchTime: number;
-  averageFetchTime: number;
-  slowFetchCount: number;
-  lastFetchTime: number | null;
-}
-
-export interface CacheStats {
-  totalQueries: number;
-  activeQueries: number;
-  cachedQueries: number;
-  staleQueries: number;
-  inactiveQueries: number;
-}
-
-export interface DevMonitorOptions {
-  /**
-   * Threshold for slow query detection (in ms)
-   * @default 1000
-   */
-  slowQueryThreshold?: number;
-
-  /**
-   * Enable console logging
-   * @default true
-   */
-  enableLogging?: boolean;
-
-  /**
-   * Log interval for stats (in ms)
-   * @default 30000 (30 seconds)
-   */
-  statsLogInterval?: number;
-}
+import type { QueryMetrics, CacheStats, DevMonitorOptions } from './DevMonitor.types';
+import { DevMonitorLogger } from './DevMonitorLogger';
 
 class DevMonitorClass {
   private metrics: Map<string, QueryMetrics> = new Map();
@@ -67,12 +32,9 @@ class DevMonitorClass {
 
   private init(): void {
     if (!this.isEnabled) return;
-
     if (this.options.enableLogging) {
-      
-      console.log('[TanStack DevMonitor] Monitoring initialized');
+      DevMonitorLogger.logInit();
     }
-
     this.startStatsLogging();
   }
 
@@ -106,12 +68,8 @@ class DevMonitorClass {
 
     if (fetchTime > this.options.slowQueryThreshold) {
       metrics.slowFetchCount++;
-
       if (this.options.enableLogging) {
-        
-        console.warn(
-          `[TanStack DevMonitor] Slow query detected: ${queryKeyString} (${fetchTime}ms)`,
-        );
+        DevMonitorLogger.logSlowQuery(queryKeyString, fetchTime);
       }
     }
   }
@@ -123,14 +81,12 @@ class DevMonitorClass {
     if (!this.isEnabled) return;
 
     this.queryClient = queryClient;
-
     queryClient.getQueryCache().subscribe((query) => {
       this.trackQuery(query as unknown as Query);
     });
 
     if (this.options.enableLogging) {
-      
-      console.log('[TanStack DevMonitor] Attached to QueryClient');
+      DevMonitorLogger.logAttached();
     }
   }
 
@@ -182,40 +138,7 @@ class DevMonitorClass {
    */
   logReport(): void {
     if (!this.isEnabled || !this.options.enableLogging) return;
-
-    const stats = this.getCacheStats();
-    const slowQueries = this.getSlowQueries();
-
-    
-    console.group('[TanStack DevMonitor] Performance Report');
-
-    if (stats) {
-      
-      console.table({
-        'Total Queries': stats.totalQueries,
-        'Active Queries': stats.activeQueries,
-        'Cached Queries': stats.cachedQueries,
-        'Stale Queries': stats.staleQueries,
-        'Inactive Queries': stats.inactiveQueries,
-      });
-    }
-
-    if (slowQueries.length > 0) {
-      
-      console.warn(`Found ${slowQueries.length} slow queries:`);
-      
-      console.table(
-        slowQueries.map((m) => ({
-          queryKey: JSON.stringify(m.queryKey),
-          fetchCount: m.fetchCount,
-          avgTime: `${m.averageFetchTime.toFixed(2)}ms`,
-          slowCount: m.slowFetchCount,
-        })),
-      );
-    }
-
-    
-    console.groupEnd();
+    DevMonitorLogger.logReport(this.getCacheStats(), this.getSlowQueries());
   }
 
   /**
@@ -223,7 +146,6 @@ class DevMonitorClass {
    */
   private startStatsLogging(): void {
     if (!this.isEnabled || this.statsInterval !== null) return;
-
     this.statsInterval = setInterval(() => {
       this.logReport();
     }, this.options.statsLogInterval);
@@ -245,10 +167,8 @@ class DevMonitorClass {
   clear(): void {
     if (!this.isEnabled) return;
     this.metrics.clear();
-
     if (this.options.enableLogging) {
-      
-      console.log('[TanStack DevMonitor] Metrics cleared');
+      DevMonitorLogger.logMethodsCleared();
     }
   }
 
@@ -260,10 +180,8 @@ class DevMonitorClass {
     this.stopStatsLogging();
     this.clear();
     this.queryClient = null;
-
     if (this.options.enableLogging) {
-      
-      console.log('[TanStack DevMonitor] Reset');
+      DevMonitorLogger.logReset();
     }
   }
 }

package/src/tanstack/infrastructure/monitoring/DevMonitor.types.ts

@@ -0,0 +1,40 @@
+/**
+ * DevMonitor Types
+ */
+
+export interface QueryMetrics {
+  queryKey: readonly unknown[];
+  fetchCount: number;
+  totalFetchTime: number;
+  averageFetchTime: number;
+  slowFetchCount: number;
+  lastFetchTime: number | null;
+}
+
+export interface CacheStats {
+  totalQueries: number;
+  activeQueries: number;
+  cachedQueries: number;
+  staleQueries: number;
+  inactiveQueries: number;
+}
+
+export interface DevMonitorOptions {
+  /**
+   * Threshold for slow query detection (in ms)
+   * @default 1000
+   */
+  slowQueryThreshold?: number;
+
+  /**
+   * Enable console logging
+   * @default true
+   */
+  enableLogging?: boolean;
+
+  /**
+   * Log interval for stats (in ms)
+   * @default 30000 (30 seconds)
+   */
+  statsLogInterval?: number;
+}

package/src/tanstack/infrastructure/monitoring/DevMonitorLogger.ts

@@ -0,0 +1,58 @@
+/**
+ * DevMonitor Logger
+ * Helper for logging performance reports
+ */
+
+import type { QueryMetrics, CacheStats } from './DevMonitor.types';
+
+export class DevMonitorLogger {
+  static logInit(): void {
+    console.log('[TanStack DevMonitor] Monitoring initialized');
+  }
+
+  static logSlowQuery(queryKeyString: string, fetchTime: number): void {
+    console.warn(
+      `[TanStack DevMonitor] Slow query detected: ${queryKeyString} (${fetchTime}ms)`,
+    );
+  }
+
+  static logAttached(): void {
+    console.log('[TanStack DevMonitor] Attached to QueryClient');
+  }
+
+  static logMethodsCleared(): void {
+    console.log('[TanStack DevMonitor] Metrics cleared');
+  }
+
+  static logReset(): void {
+    console.log('[TanStack DevMonitor] Reset');
+  }
+
+  static logReport(stats: CacheStats | null, slowQueries: QueryMetrics[]): void {
+    console.group('[TanStack DevMonitor] Performance Report');
+
+    if (stats) {
+      console.table({
+        'Total Queries': stats.totalQueries,
+        'Active Queries': stats.activeQueries,
+        'Cached Queries': stats.cachedQueries,
+        'Stale Queries': stats.staleQueries,
+        'Inactive Queries': stats.inactiveQueries,
+      });
+    }
+
+    if (slowQueries.length > 0) {
+      console.warn(`Found ${slowQueries.length} slow queries:`);
+      console.table(
+        slowQueries.map((m) => ({
+          queryKey: JSON.stringify(m.queryKey),
+          fetchCount: m.fetchCount,
+          avgTime: `${m.averageFetchTime.toFixed(2)}ms`,
+          slowCount: m.slowFetchCount,
+        })),
+      );
+    }
+
+    console.groupEnd();
+  }
+}

package/src/timezone/domain/entities/Timezone.ts

@@ -1,227 +1,22 @@
-/**
- * Timezone Domain Entities
- *
- * Core timezone types and interfaces for device timezone detection
- * and date/time manipulation
- *
- * Features:
- * - Auto-detects device timezone
- * - Locale-aware date/time formatting
- * - Calendar utilities
- * - Date manipulation helpers
- *
- * Zero external dependencies - uses native Intl API
- */
-
-/**
- * Timezone information from device
- */
-export interface TimezoneInfo {
-  /** IANA timezone identifier (e.g., "America/New_York", "Europe/Istanbul") */
-  timezone: string;
-
-  /** UTC offset in minutes (negative for west, positive for east) */
-  offset: number;
-
-  /** Human-readable timezone display name */
-  displayName: string;
-}
-
-/**
- * Calendar day representation
- * Generic structure - can be extended by apps for app-specific data
- */
-export interface TimezoneCalendarDay {
-  /** Date object for this day */
-  date: Date;
-
-  /** Day of month (1-31) */
-  day: number;
-
-  /** Day of week (0 = Sunday, 6 = Saturday) */
-  dayOfWeek: number;
-
-  /** Month (0-11, 0 = January) */
-  month: number;
-
-  /** Year (e.g., 2024) */
-  year: number;
-
-  /** Whether this day is in the current month */
-  isCurrentMonth: boolean;
+import type { TimezoneInfo, TimezoneCalendarDay } from './TimezoneTypes';
+import type {
+  ITimezoneCore,
+  ITimezoneFormatting,
+  ITimezoneManipulation,
+  ITimezoneComparison,
+  ITimezoneCalendar,
+} from './TimezoneCapabilities';
 
-  /** Whether this day is today */
-  isToday: boolean;
-
-  /** ISO date string (YYYY-MM-DD) */
-  isoDate: string;
-}
+export type { TimezoneInfo, TimezoneCalendarDay };
 
 /**
  * Timezone Service Interface
- * Defines contract for timezone operations
+ * Aggregates all timezone capabilities into a single service contract
  */
-export interface ITimezoneService {
-  /** Get current device timezone (IANA identifier) */
-  getCurrentTimezone(): string;
-
-  /** Get timezone offset in minutes */
-  getTimezoneOffset(): number;
-
-  /** Get complete timezone information */
-  getTimezoneInfo(): TimezoneInfo;
-
-  /** Format date with locale support */
-  formatDate(
-    date: Date | string | number,
-    locale?: string,
-    options?: Intl.DateTimeFormatOptions,
-  ): string;
-
-  /** Format time with locale support */
-  formatTime(
-    date: Date | string | number,
-    locale?: string,
-    options?: Intl.DateTimeFormatOptions,
-  ): string;
-
-  /** Get calendar days for a month */
-  getCalendarDays(year: number, month: number): TimezoneCalendarDay[];
-
-  /** Check if date is today */
-  isToday(date: Date | string | number): boolean;
-
-  /** Check if two dates are the same day */
-  isSameDay(date1: Date | string | number, date2: Date | string | number): boolean;
-
-  /** Add days to a date */
-  addDays(date: Date | string | number, days: number): Date;
-
-  /** Get start of day (00:00:00) */
-  startOfDay(date: Date | string | number): Date;
-
-  /** Get end of day (23:59:59.999) */
-  endOfDay(date: Date | string | number): Date;
-
-  /** Format date to ISO string (YYYY-MM-DD) */
-  formatDateToString(date: Date | string | number): string;
-
-  /** Format to display date string (DD.MM.YYYY) */
-  formatToDisplayDate(date: Date | string | number): string;
-
-  /** Format to display date time string (DD.MM.YYYY HH:mm) */
-  formatToDisplayDateTime(date: Date | string | number): string;
-
-  /** Get current date as ISO string (YYYY-MM-DDTHH:mm:ss.sssZ) */
-  getCurrentISOString(): string;
-
-  /** Get current date object */
-  getNow(): Date;
-
-  /** Parse input to Date object */
-  parse(date: Date | string | number): Date;
-
-  /** Check if date is in the future */
-  isFuture(date: Date | string | number): boolean;
-
-  /** Check if date is in the past */
-  isPast(date: Date | string | number): boolean;
-
-  /** Get days until a future date (returns 0 if past) */
-  getDaysUntil(date: Date | string | number): number;
-
-  /** Get difference in days between two dates */
-  getDifferenceInDays(date1: Date | string | number, date2: Date | string | number): number;
-
-  /** Format date to ISO datetime string (YYYY-MM-DDTHH:mm:ss.sssZ) */
-  formatToISOString(date: Date | string | number): string;
-
-  /** Get list of common timezones for selection */
-  getTimezones(): TimezoneInfo[];
-
-  /** Check if date is valid */
-  isValid(date: Date | string | number): boolean;
-
-  /** Calculate age from birth date */
-  getAge(birthDate: Date | string | number): number;
-
-  /** Check if date is between two dates (inclusive) */
-  isBetween(
-    date: Date | string | number,
-    start: Date | string | number,
-    end: Date | string | number,
-  ): boolean;
-
-  /** Get earliest date from array */
-  min(dates: Array<Date | string | number>): Date;
-
-  /** Get latest date from array */
-  max(dates: Array<Date | string | number>): Date;
-
-  /** Get ISO week number (1-53) */
-  getWeek(date: Date | string | number): number;
-
-  /** Get quarter (1-4) */
-  getQuarter(date: Date | string | number): number;
-
-  /** Get timezone offset for specific timezone in minutes */
-  getTimezoneOffsetFor(timezone: string, date?: Date | string | number): number;
-
-  /** Convert date from one timezone to another */
-  convertTimezone(
-    date: Date | string | number,
-    fromTimezone: string,
-    toTimezone: string,
-  ): Date;
-
-  /** Format duration in milliseconds to human readable string */
-  formatDuration(milliseconds: number): string;
-
-  /** Check if date is on weekend */
-  isWeekend(date: Date | string | number): boolean;
-
-  /** Add business days (skip weekends) */
-  addBusinessDays(date: Date | string | number, days: number): Date;
-
-  /** Check if date is first day of month */
-  isFirstDayOfMonth(date: Date | string | number): boolean;
-
-  /** Check if date is last day of month */
-  isLastDayOfMonth(date: Date | string | number): boolean;
-
-  /** Get number of days in month */
-  getDaysInMonth(date: Date | string | number): number;
-
-  /** Get array of dates in range */
-  getDateRange(
-    start: Date | string | number,
-    end: Date | string | number,
-  ): Date[];
-
-  /** Check if two date ranges overlap */
-  areRangesOverlapping(
-    start1: Date | string | number,
-    end1: Date | string | number,
-    start2: Date | string | number,
-    end2: Date | string | number,
-  ): boolean;
-
-  /** Clamp date to range */
-  clampDate(
-    date: Date | string | number,
-    min: Date | string | number,
-    max: Date | string | number,
-  ): Date;
-
-  /** Check if two dates are same hour */
-  areSameHour(date1: Date | string | number, date2: Date | string | number): boolean;
-
-  /** Check if two dates are same minute */
-  areSameMinute(date1: Date | string | number, date2: Date | string | number): boolean;
-
-  /** Get middle of day (12:00:00) */
-  getMiddleOfDay(date: Date | string | number): Date;
+export interface ITimezoneService
+  extends ITimezoneCore,
+    ITimezoneFormatting,
+    ITimezoneManipulation,
+    ITimezoneComparison,
+    ITimezoneCalendar {}
 
-  /** Get relative time from now ("5 minutes ago", "in 2 hours") */
-  fromNow(date: Date | string | number, locale?: string): string;
-}

package/src/timezone/domain/entities/TimezoneCapabilities.ts

@@ -0,0 +1,189 @@
+import type { TimezoneInfo, TimezoneCalendarDay } from './TimezoneTypes';
+
+/**
+ * Core timezone detection and information checks
+ */
+export interface ITimezoneCore {
+  /** Get current device timezone (IANA identifier) */
+  getCurrentTimezone(): string;
+
+  /** Get timezone offset in minutes */
+  getTimezoneOffset(): number;
+
+  /** Get complete timezone information */
+  getTimezoneInfo(): TimezoneInfo;
+
+  /** Get current date as ISO string (YYYY-MM-DDTHH:mm:ss.sssZ) */
+  getCurrentISOString(): string;
+
+  /** Get current date object */
+  getNow(): Date;
+
+  /** Get list of common timezones for selection */
+  getTimezones(): TimezoneInfo[];
+
+  /** Get timezone offset for specific timezone in minutes */
+  getTimezoneOffsetFor(timezone: string, date?: Date | string | number): number;
+}
+
+/**
+ * Date and time formatting capabilities
+ */
+export interface ITimezoneFormatting {
+  /** Format date with locale support */
+  formatDate(
+    date: Date | string | number,
+    locale?: string,
+    options?: Intl.DateTimeFormatOptions,
+  ): string;
+
+  /** Format time with locale support */
+  formatTime(
+    date: Date | string | number,
+    locale?: string,
+    options?: Intl.DateTimeFormatOptions,
+  ): string;
+
+  /** Format date to ISO string (YYYY-MM-DD) */
+  formatDateToString(date: Date | string | number): string;
+
+  /** Format to display date string (DD.MM.YYYY) */
+  formatToDisplayDate(date: Date | string | number): string;
+
+  /** Format to display date time string (DD.MM.YYYY HH:mm) */
+  formatToDisplayDateTime(date: Date | string | number): string;
+
+  /** Format date to ISO datetime string (YYYY-MM-DDTHH:mm:ss.sssZ) */
+  formatToISOString(date: Date | string | number): string;
+
+  /** Format duration in milliseconds to human readable string */
+  formatDuration(milliseconds: number): string;
+
+  /** Get relative time from now ("5 minutes ago", "in 2 hours") */
+  fromNow(date: Date | string | number, locale?: string): string;
+}
+
+/**
+ * Date manipulation and calculation capabilities
+ */
+export interface ITimezoneManipulation {
+  /** Parse input to Date object */
+  parse(date: Date | string | number): Date;
+
+  /** Add days to a date */
+  addDays(date: Date | string | number, days: number): Date;
+
+  /** Get start of day (00:00:00) */
+  startOfDay(date: Date | string | number): Date;
+
+  /** Get end of day (23:59:59.999) */
+  endOfDay(date: Date | string | number): Date;
+
+  /** Get middle of day (12:00:00) */
+  getMiddleOfDay(date: Date | string | number): Date;
+
+  /** Convert date from one timezone to another */
+  convertTimezone(
+    date: Date | string | number,
+    fromTimezone: string,
+    toTimezone: string,
+  ): Date;
+
+  /** Add business days (skip weekends) */
+  addBusinessDays(date: Date | string | number, days: number): Date;
+
+  /** Clamp date to range */
+  clampDate(
+    date: Date | string | number,
+    min: Date | string | number,
+    max: Date | string | number,
+  ): Date;
+}
+
+/**
+ * Date checking and comparison capabilities
+ */
+export interface ITimezoneComparison {
+  /** Check if date is today */
+  isToday(date: Date | string | number): boolean;
+
+  /** Check if two dates are the same day */
+  isSameDay(date1: Date | string | number, date2: Date | string | number): boolean;
+
+  /** Check if date is in the future */
+  isFuture(date: Date | string | number): boolean;
+
+  /** Check if date is in the past */
+  isPast(date: Date | string | number): boolean;
+
+  /** Check if date is valid */
+  isValid(date: Date | string | number): boolean;
+
+  /** Check if date is between two dates (inclusive) */
+  isBetween(
+    date: Date | string | number,
+    start: Date | string | number,
+    end: Date | string | number,
+  ): boolean;
+
+  /** Check if date is on weekend */
+  isWeekend(date: Date | string | number): boolean;
+
+  /** Check if date is first day of month */
+  isFirstDayOfMonth(date: Date | string | number): boolean;
+
+  /** Check if date is last day of month */
+  isLastDayOfMonth(date: Date | string | number): boolean;
+
+  /** Check if two dates are same hour */
+  areSameHour(date1: Date | string | number, date2: Date | string | number): boolean;
+
+  /** Check if two dates are same minute */
+  areSameMinute(date1: Date | string | number, date2: Date | string | number): boolean;
+
+  /** Check if two date ranges overlap */
+  areRangesOverlapping(
+    start1: Date | string | number,
+    end1: Date | string | number,
+    start2: Date | string | number,
+    end2: Date | string | number,
+  ): boolean;
+}
+
+/**
+ * Advanced calendar and range capabilities
+ */
+export interface ITimezoneCalendar {
+  /** Get calendar days for a month */
+  getCalendarDays(year: number, month: number): TimezoneCalendarDay[];
+
+  /** Get days until a future date (returns 0 if past) */
+  getDaysUntil(date: Date | string | number): number;
+
+  /** Get difference in days between two dates */
+  getDifferenceInDays(date1: Date | string | number, date2: Date | string | number): number;
+
+  /** Calculate age from birth date */
+  getAge(birthDate: Date | string | number): number;
+
+  /** Get earliest date from array */
+  min(dates: Array<Date | string | number>): Date;
+
+  /** Get latest date from array */
+  max(dates: Array<Date | string | number>): Date;
+
+  /** Get ISO week number (1-53) */
+  getWeek(date: Date | string | number): number;
+
+  /** Get quarter (1-4) */
+  getQuarter(date: Date | string | number): number;
+
+  /** Get number of days in month */
+  getDaysInMonth(date: Date | string | number): number;
+
+  /** Get array of dates in range */
+  getDateRange(
+    start: Date | string | number,
+    end: Date | string | number,
+  ): Date[];
+}

package/src/timezone/domain/entities/TimezoneTypes.ts

@@ -0,0 +1,47 @@
+/**
+ * Timezone Types
+ */
+
+/**
+ * Timezone information from device
+ */
+export interface TimezoneInfo {
+  /** IANA timezone identifier (e.g., "America/New_York", "Europe/Istanbul") */
+  timezone: string;
+
+  /** UTC offset in minutes (negative for west, positive for east) */
+  offset: number;
+
+  /** Human-readable timezone display name */
+  displayName: string;
+}
+
+/**
+ * Calendar day representation
+ * Generic structure - can be extended by apps for app-specific data
+ */
+export interface TimezoneCalendarDay {
+  /** Date object for this day */
+  date: Date;
+
+  /** Day of month (1-31) */
+  day: number;
+
+  /** Day of week (0 = Sunday, 6 = Saturday) */
+  dayOfWeek: number;
+
+  /** Month (0-11, 0 = January) */
+  month: number;
+
+  /** Year (e.g., 2024) */
+  year: number;
+
+  /** Whether this day is in the current month */
+  isCurrentMonth: boolean;
+
+  /** Whether this day is today */
+  isToday: boolean;
+
+  /** ISO date string (YYYY-MM-DD) */
+  isoDate: string;
+}