@umituz/react-native-design-system 2.5.37 → 2.5.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-design-system",
-  "version": "2.5.37",
+  "version": "2.5.41",
   "description": "Universal design system for React Native apps - Consolidated package with atoms, molecules, organisms, theme, typography, responsive and safe area utilities",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/atoms/AtomicIcon.tsx

@@ -129,8 +129,13 @@ export const AtomicIcon: React.FC<AtomicIconProps> = React.memo(({
       ? getSemanticColor(color, tokens)
       : tokens.colors.textPrimary;
 
-  // Validate icon - use fallback silently if invalid
-  const iconName = name && name in Ionicons.glyphMap ? name : FALLBACK_ICON;
+  // Validate icon - use fallback and log warning in DEV if invalid
+  const isInvalidIcon = name && !(name in Ionicons.glyphMap);
+  const iconName = name && !isInvalidIcon ? name : FALLBACK_ICON;
+
+  if (__DEV__ && isInvalidIcon) {
+    console.warn(`[DesignSystem] Invalid icon name: "${name}". Falling back to "${FALLBACK_ICON}"`);
+  }
 
   const iconElement = svgPath ? (
     <Svg
@@ -197,6 +202,4 @@ const styles = StyleSheet.create({
   },
 });
 
-// Legacy type alias for backward compatibility
-export type IconProps = AtomicIconProps;
 

package/src/index.ts

@@ -23,6 +23,7 @@ export {
   useTheme,
   useThemedStyles,
   useThemedStyleSheet,
+  DesignSystemProvider,
   lightColors,
   darkColors,
   getColorPalette,

package/src/layouts/ScreenLayout/ScreenLayout.tsx

@@ -173,7 +173,7 @@ export const ScreenLayout: React.FC<ScreenLayoutProps> = ({
       flex: 1,
       width: '100%',
       maxWidth: finalMaxWidth,
-      alignSelf: 'center',
+      alignSelf: 'flex-start',
     },
     content: {
       flex: 1,

package/src/theme/index.ts

@@ -71,6 +71,12 @@ export { useTheme } from './infrastructure/stores/themeStore';
 export { useThemedStyles, useThemedStyleSheet } from './hooks/useThemedStyles';
 export { useCommonStyles } from './hooks/useCommonStyles';
 
+// =============================================================================
+// PROVIDER
+// =============================================================================
+
+export { DesignSystemProvider } from './infrastructure/providers/DesignSystemProvider';
+
 // =============================================================================
 // THEME OBJECTS
 // =============================================================================

package/src/theme/infrastructure/providers/DesignSystemProvider.tsx

@@ -0,0 +1,110 @@
+import React, { useEffect, useState, ReactNode } from 'react';
+import { ActivityIndicator, View, StyleSheet } from 'react-native';
+import { useThemeStore } from '../stores/themeStore';
+import { useDesignSystemTheme } from '../globalThemeStore';
+import type { CustomThemeColors } from '../../core/CustomColors';
+
+declare const __DEV__: boolean;
+
+interface DesignSystemProviderProps {
+  /** App content */
+  children: ReactNode;
+  /** Custom theme colors to override defaults */
+  customColors?: CustomThemeColors;
+  /** Show loading indicator while initializing (default: false) */
+  showLoadingIndicator?: boolean;
+  /** Custom loading component */
+  loadingComponent?: ReactNode;
+  /** Callback when initialization completes */
+  onInitialized?: () => void;
+  /** Callback when initialization fails */
+  onError?: (error: unknown) => void;
+}
+
+/**
+ * DesignSystemProvider
+ * 
+ * Initializes theme store and applies custom colors.
+ * Wrap your app with this provider to enable design system features.
+ * 
+ * Features:
+ * - Auto-initializes theme from storage
+ * - Supports custom color overrides
+ * - Optional loading state
+ * - Error handling
+ * 
+ * Usage:
+ * ```tsx
+ * import { DesignSystemProvider } from '@umituz/react-native-design-system';
+ * 
+ * export default function App() {
+ *   return (
+ *     <DesignSystemProvider
+ *       customColors={{ primary: '#FF6B6B' }}
+ *       showLoadingIndicator
+ *     >
+ *       <YourApp />
+ *     </DesignSystemProvider>
+ *   );
+ * }
+ * ```
+ */
+export const DesignSystemProvider: React.FC<DesignSystemProviderProps> = ({
+  children,
+  customColors,
+  showLoadingIndicator = false,
+  loadingComponent,
+  onInitialized,
+  onError,
+}: DesignSystemProviderProps) => {
+  const [isInitialized, setIsInitialized] = useState(false);
+  const initialize = useThemeStore((state) => state.initialize);
+  const setCustomColors = useDesignSystemTheme((state) => state.setCustomColors);
+
+  useEffect(() => {
+    if (__DEV__) console.log('[DesignSystemProvider] Initializing...');
+    
+    // Apply custom colors if provided
+    if (customColors) {
+      if (__DEV__) console.log('[DesignSystemProvider] Applying custom colors');
+      setCustomColors(customColors);
+    }
+
+    // Initialize theme store
+    initialize()
+      .then(() => {
+        if (__DEV__) console.log('[DesignSystemProvider] Initialized successfully');
+        setIsInitialized(true);
+        onInitialized?.();
+      })
+      .catch((error) => {
+        if (__DEV__) console.error('[DesignSystemProvider] Initialization failed:', error);
+        setIsInitialized(true); // Still render app even on error
+        onError?.(error);
+      });
+  }, [initialize, customColors, setCustomColors, onInitialized, onError]);
+
+  // Show loading indicator if requested and not yet initialized
+  if (showLoadingIndicator && !isInitialized) {
+    if (loadingComponent) {
+      return <>{loadingComponent}</>;
+    }
+    
+    return (
+      <View style={styles.loadingContainer}>
+        <ActivityIndicator size="large" />
+      </View>
+    );
+  }
+
+  return <>{children}</>;
+};
+
+const styles = StyleSheet.create({
+  loadingContainer: {
+    flex: 1,
+    justifyContent: 'center',
+    alignItems: 'center',
+    backgroundColor: '#000000',
+  },
+});

package/src/theme/infrastructure/stores/themeStore.ts

@@ -34,13 +34,15 @@ interface ThemeActions {
  *
  * Usage:
  * ```typescript
- * import { useTheme } from '@umituz/react-native-design-system-theme';
+ * import { useTheme } from '@umituz/react-native-design-system';
  *
  * const MyComponent = () => {
  *   const { theme, themeMode, setThemeMode, toggleTheme } = useTheme();
  *   // ...
  * };
  * ```
+ * 
+ * NOTE: Make sure to wrap your app with DesignSystemProvider for auto-initialization
  */
 export const useTheme = createStore<ThemeState, ThemeActions>({
   name: 'theme-store',
@@ -107,8 +109,8 @@ export const useTheme = createStore<ThemeState, ThemeActions>({
   }),
 });
 
-
-
+// Export internal store for DesignSystemProvider
+export const useThemeStore = useTheme;