@umituz/react-native-design-system 4.23.97 → 4.23.101

package/src/media/presentation/hooks/useMediaValidation.ts

@@ -6,7 +6,7 @@
 import { useState, useCallback } from "react";
 import { formatFileSize } from "../../infrastructure/utils/media-collection-utils";
 import type { UseMediaValidationResult } from "./multimedia.types";
-import type { MediaValidation, MediaFile } from "../../domain/entities/MultimediaFlashcardTypes";
+import type { MediaValidation, MediaFile } from "../../domain/entities/MediaAttachments";
 
 export const useMediaValidation = (): UseMediaValidationResult => {
   const [isValidating, setIsValidating] = useState(false);

package/src/media/presentation/hooks/useMultimediaFlashcard.ts

@@ -10,7 +10,7 @@ import type {
   MediaAttachment,
   MultimediaFlashcard,
   CreateMultimediaCardData,
-} from "../../domain/entities/MultimediaFlashcardTypes";
+} from "../../domain/entities/MediaAttachments";
 
 // Export individual hooks
 export { useMediaUpload } from "./useMediaUpload";

package/src/molecules/navigation/components/NavigationHeader.tsx

@@ -1,4 +1,4 @@
-import React from 'react';
+import React, { useMemo } from 'react';
 import { View, StyleSheet, TouchableOpacity } from 'react-native';
 import { AtomicText } from '../../../atoms';
 import { AtomicIcon, useIconName } from '../../../atoms';
@@ -20,7 +20,7 @@ export const NavigationHeader: React.FC<NavigationHeaderProps> = ({
   const insets = useSafeAreaInsets();
   const arrowLeftIcon = useIconName('arrowLeft');
 
-  const styles = StyleSheet.create({
+  const styles = useMemo(() => StyleSheet.create({
     container: {
       paddingTop: insets.top,
       paddingHorizontal: tokens.spacing.md,
@@ -45,7 +45,7 @@ export const NavigationHeader: React.FC<NavigationHeaderProps> = ({
       flex: 1,
       textAlign: 'left',
     },
-  });
+  }), [tokens, insets]);
 
   return (
     <View style={styles.container}>

package/src/molecules/navigation/utils/AppNavigation.ts

@@ -40,7 +40,7 @@ export const navigate = (name: string, params?: object): void => {
     if (__DEV__) {
     }
     if (navigationRef?.isReady()) {
-        navigationRef.navigate(name as never, params as never);
+        navigationRef.navigate(name, params);
     }
 };
 
@@ -54,10 +54,10 @@ export const navigateNested = (navigatorName: string, screenName: string, params
     if (__DEV__) {
     }
     if (navigationRef?.isReady()) {
-        navigationRef.navigate(navigatorName as never, {
+        navigationRef.navigate(navigatorName, {
             screen: screenName,
             params,
-        } as never);
+        });
     }
 };
 

package/src/offline/index.ts

@@ -14,6 +14,7 @@ export type {
 
 // Store
 export { useOfflineStore } from './infrastructure/storage/OfflineStore';
+export { useOfflineConfigStore } from './infrastructure/storage/OfflineConfigStore';
 
 // Hooks
 export { useOffline, configureOffline } from './presentation/hooks/useOffline';

package/src/offline/infrastructure/storage/OfflineConfigStore.ts

@@ -0,0 +1,34 @@
+/**
+ * Offline Config Store
+ * Centralized configuration for offline functionality
+ * Replaces module-level mutable state with Zustand store
+ */
+
+import { create } from 'zustand';
+import type { OfflineConfig } from '../../types';
+
+interface OfflineConfigStore {
+  config: OfflineConfig;
+  setConfig: (config: OfflineConfig) => void;
+  mergeConfig: (partialConfig: OfflineConfig) => void;
+  reset: () => void;
+}
+
+export const useOfflineConfigStore = create<OfflineConfigStore>((set) => ({
+  config: {},
+
+  setConfig: (config) => set({ config }),
+
+  mergeConfig: (partialConfig) => set((state) => ({
+    config: { ...state.config, ...partialConfig }
+  })),
+
+  reset: () => set({ config: {} }),
+}));
+
+/**
+ * Get current config (for non-React contexts)
+ */
+export const getOfflineConfig = (): OfflineConfig => {
+  return useOfflineConfigStore.getState().config;
+};

package/src/offline/presentation/hooks/useOffline.ts

@@ -10,6 +10,7 @@ import type { NetworkState as ExpoNetworkState } from 'expo-network';
 import type { NetworkState, OfflineConfig } from '../../types';
 import { useOfflineStore } from '../../infrastructure/storage/OfflineStore';
 import { networkEvents } from '../../infrastructure/events/NetworkEvents';
+import { useOfflineConfigStore } from '../../infrastructure/storage/OfflineConfigStore';
 
 /**
  * Convert expo-network state to our internal format
@@ -21,14 +22,17 @@ const toNetworkState = (state: ExpoNetworkState): NetworkState => ({
   details: null,
 });
 
-let globalConfig: OfflineConfig = {};
-
+/**
+ * Configure offline settings globally
+ * This is a facade over the config store for backward compatibility
+ */
 export const configureOffline = (config: OfflineConfig): void => {
-  globalConfig = config;
+  useOfflineConfigStore.getState().setConfig(config);
 };
 
 export const useOffline = (config?: OfflineConfig) => {
   const store = useOfflineStore();
+  const globalConfig = useOfflineConfigStore((state) => state.config);
   const isInitialized = useRef(false);
   const previousStateRef = useRef<NetworkState | null>(null);
   const isMountedRef = useRef(true);
@@ -36,7 +40,7 @@ export const useOffline = (config?: OfflineConfig) => {
   // Memoize merged config to prevent unnecessary effect re-runs
   const mergedConfig = useMemo(
     () => ({ ...globalConfig, ...config }),
-    [config]
+    [globalConfig, config]
   );
 
   const handleNetworkStateChange = useCallback((state: ExpoNetworkState) => {

package/src/storage/domain/utils/devUtils.ts

@@ -9,27 +9,3 @@ export const isDev = (): boolean => {
   return __DEV__;
 };
 
-/**
- * Log warning in development mode only
- * All logs are disabled
- */
-export const devWarn = (_message: string, ..._args: unknown[]): void => {
-  // Disabled
-};
-
-/**
- * Log error in development mode only
- * All logs are disabled
- */
-export const devError = (_message: string, ..._args: unknown[]): void => {
-  // Disabled
-};
-
-/**
- * Log info in development mode only
- * All logs are disabled
- */
-export const devLog = (_message: string, ..._args: unknown[]): void => {
-  // Disabled
-};
-

package/src/storage/index.ts

@@ -82,7 +82,7 @@ export { TIME_MS, DEFAULT_TTL, CACHE_VERSION } from './domain/constants/CacheDef
 // DOMAIN LAYER - Development Utilities
 // =============================================================================
 
-export { isDev, devWarn, devError, devLog } from './domain/utils/devUtils';
+export { isDev } from './domain/utils/devUtils';
 
 // =============================================================================
 // DOMAIN LAYER - Store Types

package/src/storage/infrastructure/adapters/StorageService.ts

@@ -6,7 +6,6 @@
  */
 
 import AsyncStorage from '@react-native-async-storage/async-storage';
-import { devWarn } from '../../domain/utils/devUtils';
 import type { StateStorage } from '../../domain/types/Store';
 
 /**
@@ -17,9 +16,7 @@ export const storageService: StateStorage = {
   getItem: async (name: string): Promise<string | null> => {
     try {
       return await AsyncStorage.getItem(name);
-    } catch (error) {
-      const errorMessage = `StorageService: Failed to get item "${name}"`;
-      devWarn(errorMessage, error);
+    } catch (_error) {
       return null;
     }
   },
@@ -27,18 +24,16 @@ export const storageService: StateStorage = {
   setItem: async (name: string, value: string): Promise<void> => {
     try {
       await AsyncStorage.setItem(name, value);
-    } catch (error) {
-      const errorMessage = `StorageService: Failed to set item "${name}"`;
-      devWarn(errorMessage, error);
+    } catch (_error) {
+      // Silent failure
     }
   },
 
   removeItem: async (name: string): Promise<void> => {
     try {
       await AsyncStorage.removeItem(name);
-    } catch (error) {
-      const errorMessage = `StorageService: Failed to remove item "${name}"`;
-      devWarn(errorMessage, error);
+    } catch (_error) {
+      // Silent failure
     }
   },
 };

package/src/storage/infrastructure/repositories/BaseStorageOperations.ts

@@ -14,7 +14,6 @@ import {
   StorageSerializationError,
   StorageDeserializationError,
 } from '../../domain/errors/StorageError';
-import { devWarn } from '../../domain/utils/devUtils';
 
 /**
  * Base storage operations implementation
@@ -37,7 +36,7 @@ export class BaseStorageOperations {
       } catch (parseError) {
         return failure(new StorageDeserializationError(key, parseError), defaultValue);
       }
-    } catch (error) {
+    } catch (_error) {
       return failure(new StorageReadError(key, error), defaultValue);
     }
   }
@@ -56,7 +55,7 @@ export class BaseStorageOperations {
 
       await AsyncStorage.setItem(key, serialized);
       return success(value);
-    } catch (error) {
+    } catch (_error) {
       return failure(new StorageWriteError(key, error));
     }
   }
@@ -68,7 +67,7 @@ export class BaseStorageOperations {
     try {
       await AsyncStorage.removeItem(key);
       return success(undefined);
-    } catch (error) {
+    } catch (_error) {
       return failure(new StorageDeleteError(key, error));
     }
   }
@@ -80,9 +79,7 @@ export class BaseStorageOperations {
     try {
       const value = await AsyncStorage.getItem(key);
       return value !== null;
-    } catch (error) {
-      const errorMessage = `BaseStorageOperations: Failed to check if key "${key}" exists`;
-      devWarn(errorMessage, error);
+    } catch (_error) {
       return false;
     }
   }
@@ -94,7 +91,7 @@ export class BaseStorageOperations {
     try {
       await AsyncStorage.clear();
       return success(undefined);
-    } catch (error) {
+    } catch (_error) {
       return failure(new StorageDeleteError('ALL_KEYS', error));
     }
   }

package/src/storage/presentation/hooks/CacheStorageOperations.ts

@@ -7,7 +7,6 @@
 import { storageRepository } from '../../infrastructure/repositories/AsyncStorageRepository';
 import type { CachedValue } from '../../domain/entities/CachedValue';
 import { createCachedValue } from '../../domain/entities/CachedValue';
-import { devWarn } from '../../domain/utils/devUtils';
 import { isValidCachedValue } from '../../domain/utils/ValidationUtils';
 
 export interface CacheStorageOptions {
@@ -56,16 +55,11 @@ export class CacheStorageOperations {
           return parsed as CachedValue<T>;
         }
 
-        if (__DEV__) {
-          devWarn(`CacheStorageOperations: Invalid cached data structure for key "${key}"`);
-        }
-
         return null;
       }
 
       return null;
-    } catch (error) {
-      devWarn(`CacheStorageOperations: Failed to load cache for key "${key}"`, error);
+    } catch (_error) {
       return null;
     }
   }
@@ -85,8 +79,8 @@ export class CacheStorageOperations {
     try {
       const cached = createCachedValue(value, ttl || 0, version);
       await storageRepository.setString(key, JSON.stringify(cached));
-    } catch (error) {
-      devWarn(`CacheStorageOperations: Failed to save cache for key "${key}"`, error);
+    } catch (_error) {
+      // Silent failure
     }
   }
 
@@ -98,8 +92,8 @@ export class CacheStorageOperations {
 
     try {
       await storageRepository.removeItem(key);
-    } catch (error) {
-      devWarn(`CacheStorageOperations: Failed to clear cache for key "${key}"`, error);
+    } catch (_error) {
+      // Silent failure
     }
   }
 }

package/src/storage/presentation/hooks/useStore.ts

@@ -3,14 +3,22 @@
  * Helper for creating stores in components
  */
 
-import { useMemo, useRef } from 'react';
+import { useMemo } from 'react';
 import { createStore } from '../../domain/factories/StoreFactory';
 import type { StoreConfig } from '../../domain/types/Store';
 
 export function useStore<T extends object>(config: StoreConfig<T>) {
-  // Config objesini stabilize et - sadece name değiştiğinde yeni store oluştur
-  const configRef = useRef(config);
-  configRef.current = config;
-  const store = useMemo(() => createStore(configRef.current), [config.name]);
+  // Stabilize entire config to track all property changes
+  const stableConfig = useMemo(
+    () => config,
+    [
+      config.name,
+      config.version,
+      config.persist,
+      config.storage,
+    ]
+  );
+
+  const store = useMemo(() => createStore(stableConfig), [stableConfig]);
   return store;
 }

package/src/utilities/sharing/presentation/hooks/useSharing.ts

@@ -8,7 +8,7 @@
  * @layer presentation/hooks
  */
 
-import { useState, useCallback, useEffect } from 'react';
+import { useState, useCallback, useEffect, useMemo } from 'react';
 import { SharingService } from '../../infrastructure/services/SharingService';
 import type { ShareOptions } from '../../domain/entities/Share';
 
@@ -140,7 +140,7 @@ export const useSharing = () => {
     []
   );
 
-  return {
+  return useMemo(() => ({
     // Functions
     share,
     shareWithAutoType,
@@ -150,5 +150,5 @@ export const useSharing = () => {
     isAvailable,
     isSharing,
     error,
-  };
+  }), [share, shareWithAutoType, shareMultiple, isAvailable, isSharing, error]);
 };

package/src/layouts/ScreenLayout/ScreenLayout.example.tsx

@@ -1,92 +0,0 @@
-/**
- * Enhanced ScreenLayout Example
- * 
- * This demonstrates the recommended usage of ScreenLayout with SafeAreaProvider
- */
-
-import React from 'react';
-import { View, Text } from 'react-native';
-import {
-    SafeAreaProvider,
-    ScreenLayout,
-    ScreenHeader,
-    AtomicButton,
-    AtomicText
-} from '../../index';
-
-// 1. Wrap your app root with SafeAreaProvider
-export function App() {
-    return (
-        <SafeAreaProvider>
-            <View />
-        </SafeAreaProvider>
-    );
-}
-
-// 2. Use ScreenLayout in your screens
-export function HomeScreen() {
-    return (
-        <ScreenLayout
-            // Safe area edges - default is ['top']
-            edges={['top']}
-            // Enable scrolling - default is true
-            scrollable={true}
-            // Optional header
-            header={
-                <ScreenHeader
-                    title="Home"
-                />
-            }
-            // Optional footer
-            footer={
-                <View style={{ padding: 16 }}>
-                    <AtomicButton onPress={() => console.log('Action')}>
-                        Action Button
-                    </AtomicButton>
-                </View>
-            }
-        >
-            <AtomicText type="headlineLarge">Welcome to Home</AtomicText>
-            <AtomicText type="bodyMedium">
-                This screen uses ScreenLayout with default safe area configuration.
-            </AtomicText>
-        </ScreenLayout>
-    );
-}
-
-// 3. Modal screen example with different safe area edges
-export function ModalScreen() {
-    return (
-        <ScreenLayout
-            // Full safe area for modals
-            edges={['top', 'bottom']}
-            scrollable={false}
-        >
-            <AtomicText type="headlineMedium">Modal Content</AtomicText>
-        </ScreenLayout>
-    );
-}
-
-// 4. Screen with custom scroll behavior
-export function CustomScrollScreen() {
-    return (
-        <ScreenLayout scrollable={false}>
-            {/* Your custom scroll component */}
-            <View />
-        </ScreenLayout>
-    );
-}
-
-// 5. Using safe area hooks directly
-import { useContentSafeAreaPadding, useSafeAreaInsets } from '../../index';
-
-export function CustomComponent() {
-    const insets = useSafeAreaInsets();
-    const { paddingBottom } = useContentSafeAreaPadding();
-
-    return (
-        <View style={{ paddingTop: insets.top, paddingBottom }}>
-            <Text>Custom Safe Area Usage</Text>
-        </View>
-    );
-}

package/src/media/domain/entities/CardMultimedia.types.README.md

@@ -1,129 +0,0 @@
-# CardMultimedia Types
-
-## Purpose
-Type definitions for flashcard-specific media operations. These types define the contract for media attachment, generation, and management within the card-based learning system.
-
-## File Location
-`src/domain/entities/CardMultimedia.types.ts`
-
-## Strategy
-- Define the contract for card-specific media operations
-- Provide type-safe interfaces for flashcard media attachments
-- Support AI-powered media generation for educational content
-- Enable comprehensive media validation and optimization
-- Maintain clear separation between card media and general media types
-- Support upload progress tracking and compression
-- Facilitate media download management for offline learning
-
-## Forbidden
-- **DO NOT** use these types for general-purpose media operations (use Multimedia types instead)
-- **DO NOT** include UI components or presentation logic in type definitions
-- **DO NOT** add business logic or implementation details to interfaces
-- **DO NOT** create circular dependencies with other domain types
-- **DO NOT** use `any` type or loose type definitions
-- **DO NOT** modify existing type properties - extend interfaces for new features
-- **DO NOT** assume specific storage backend or cloud provider
-- **DO NOT** hardcode validation limits in type definitions
-- **DO NOT** mix card media types with general multimedia types
-
-## Rules
-1. All card media types must be exported from this file
-2. Type definitions must be framework-agnostic
-3. Card media IDs must use "card_media_" prefix for uniqueness
-4. Position types must explicitly define front/back/both placement
-5. File size fields must use bytes as unit
-6. Duration fields must use seconds as unit
-7. Date fields must use ISO 8601 format
-8. All generation requests must include input validation
-9. Compression quality must be between 0.1 and 1.0
-10. Upload progress must be tracked from 0-100
-11. Validation results must separate errors, warnings, and recommendations
-12. Service interfaces must return Promises for all async operations
-13. Media type arrays must be automatically calculated, not manually set
-14. Download status must be tracked per attachment
-15. Estimated size must represent total of all attachments
-
-## AI Agent Guidelines
-
-When working with CardMultimedia types:
-
-1. **Type Selection**: Use CardMediaAttachment for flashcard-specific media operations
-2. **Generation Requests**: Always specify input parameters and options explicitly
-3. **Validation**: Validate media files before upload and after generation
-4. **Progress Tracking**: Monitor upload progress for user feedback
-5. **Compression**: Apply compression options before upload to reduce bandwidth
-6. **Download Management**: Check isDownloaded status before displaying media
-7. **Position Logic**: Respect position field for front/back/both placement
-8. **Size Estimation**: Calculate total size for all media before batch operations
-9. **Error Handling**: Parse validation errors and warnings for user feedback
-10. **Cost Tracking**: Monitor creditsUsed for AI generation operations
-
-### Key Types Reference
-
-- **CardMediaType**: "image" | "audio" | "video" - Media type classification for cards
-- **CardMediaPosition**: "front" | "back" | "both" - Display placement on card faces
-- **CardMediaAttachment**: Core interface for individual media items with metadata
-- **CardMultimediaFlashcard**: Card entity with computed media properties
-- **CardMediaGenerationRequest**: Input specification for AI media generation
-- **CardMediaGenerationResult**: Output with cost tracking and performance metrics
-- **CardMediaUploadProgress**: Real-time upload status tracking
-- **CardMediaCompressionOptions**: Quality and size optimization settings
-- **CardMediaValidation**: Comprehensive validation with recommendations
-- **CardMultimediaFlashcardService**: Service interface for media operations
-
-### Type Usage Patterns
-
-1. **CardMediaAttachment**: Individual media item with position, URL, and metadata
-2. **CardMultimediaFlashcard**: Card with computed properties (hasMedia, mediaType, isDownloaded)
-3. **CardMediaGenerationRequest**: Three generation types (text_to_image, text_to_audio, image_search)
-4. **CardMediaValidation**: Separate errors (blocking) from warnings and recommendations
-
-### Validation Rules
-
-1. Validate file size against upload limits before processing
-2. Check MIME type matches CardMediaType
-3. Ensure dimensions are within supported ranges
-4. Verify URIs are properly formatted and accessible
-5. Validate duration for audio/video files
-6. Check compression quality is within 0.1-1.0 range
-7. Ensure generation prompts are non-empty strings
-8. Validate language codes for audio generation (e.g., "tr-TR", "en-US")
-
-### Service Interface Guidelines
-
-When implementing CardMultimediaFlashcardService:
-
-1. **uploadMedia**: Accept file with optional compression, return attachment with URL
-2. **generateMedia**: Process AI generation request, track credits and timing
-3. **validateMedia**: Return comprehensive validation with errors, warnings, recommendations
-4. **optimizeMedia**: Apply compression to existing attachment, preserve metadata
-5. **deleteMedia**: Remove attachment and update card associations
-6. **getMediaUrl**: Return accessible URL for downloaded or remote media
-7. **downloadMedia**: Fetch remote media to local storage, update isDownloaded status
-
-### Generation Type Specifics
-
-1. **text_to_image**: Requires prompt, style (realistic/cartoon/artistic), quality, format
-2. **text_to_audio**: Requires text, language, voice (male/female/neutral), format
-3. **image_search**: Requires prompt, maxResults (no quality/format options)
-
-### Position Logic
-
-1. **front**: Media displayed only on card front face
-2. **back**: Media displayed only on card back face
-3. **both**: Media displayed on both card faces (e.g., background image)
-
-### Download Management
-
-1. Check isDownloaded before displaying media offline
-2. Use localPath for offline access when available
-3. Fall back to URL when media not downloaded
-4. Track estimatedSize for storage management
-5. Implement downloadMedia for offline caching
-
-## Dependencies
-
-- No external dependencies
-- References domain types from Media.ts for base media concepts
-- Must be usable by infrastructure and presentation layers without additional dependencies
-- Service interfaces require async operation support