@umituz/react-native-settings 4.23.84 → 4.23.86

package/src/presentation/screens/types/SettingsConfig.ts

@@ -21,6 +21,7 @@ import type {
   SubscriptionConfig,
   WalletConfig,
   GamificationItemConfig,
+  VideoTutorialConfig,
 } from "./UserFeatureConfig";
 
 /**
@@ -133,10 +134,16 @@ export interface SettingsConfig {
 
   /**
    * Gamification settings configuration
-   * @default false
+   * @default 'auto'
    */
   gamification?: FeatureVisibility | GamificationItemConfig;
 
+  /**
+   * Video tutorial settings configuration
+   * @default 'auto'
+   */
+  videoTutorial?: FeatureVisibility | VideoTutorialConfig;
+
   /**
    * Custom empty state text when no settings are available
    */

package/src/presentation/screens/types/UserFeatureConfig.ts

@@ -161,3 +161,23 @@ export interface GamificationItemConfig {
   achievementsCount?: number;
 }
 
+/**
+ * Video Tutorial Settings Configuration
+ */
+export interface VideoTutorialConfig {
+  /** Enable video tutorial feature */
+  enabled?: FeatureVisibility;
+  /** Custom title for the video tutorial section */
+  title?: string;
+  /** Custom label for the video tutorial item */
+  description?: string;
+  /** Custom icon name (Ionicons) */
+  icon?: string;
+  /** Custom section title for grouping */
+  sectionTitle?: string;
+  /** Handler to open video tutorial screen */
+  onPress?: () => void;
+  /** Navigation route for video tutorial screen */
+  route?: string;
+}
+

package/src/presentation/screens/types/index.ts

@@ -21,6 +21,7 @@ export type {
   SubscriptionConfig,
   WalletConfig,
   GamificationItemConfig,
+  VideoTutorialConfig,
 } from "./UserFeatureConfig";
 export type { GamificationSettingsConfig as GamificationConfig } from "../../../domains/gamification";
 export type { SettingsConfig } from "./SettingsConfig";

package/src/presentation/screens/utils/normalizeConfig.ts

@@ -18,6 +18,7 @@ import type {
   SubscriptionConfig,
   WalletConfig,
   GamificationItemConfig,
+  VideoTutorialConfig,
   SettingsConfig,
 } from "../types";
 
@@ -74,6 +75,10 @@ export interface NormalizedConfig {
     enabled: boolean;
     config?: GamificationItemConfig;
   };
+  videoTutorial: {
+    enabled: boolean;
+    config?: VideoTutorialConfig;
+  };
 }
 
 /**
@@ -121,6 +126,7 @@ export function normalizeSettingsConfig(
     faqs: normalizeConfigValue(config?.faqs, false),
     subscription: normalizeConfigValue(config?.subscription, false),
     wallet: normalizeConfigValue(config?.wallet, false),
-    gamification: normalizeConfigValue(config?.gamification, false),
+    gamification: normalizeConfigValue(config?.gamification, "auto"),
+    videoTutorial: normalizeConfigValue(config?.videoTutorial, "auto"),
   };
 }

package/src/presentation/utils/accountConfigUtils.ts

@@ -0,0 +1,67 @@
+/**
+ * Account Configuration Utilities
+ *
+ * Helper functions for creating account screen configurations.
+ */
+
+import type { AccountScreenConfig } from "@umituz/react-native-auth";
+
+export interface CreateAccountConfigParams {
+  displayName?: string;
+  userId?: string;
+  photoURL?: string;
+  isAnonymous?: boolean;
+  avatarUrl?: string;
+  onSignIn: () => void;
+  onLogout: () => Promise<void>;
+  onDeleteAccount: () => Promise<void>;
+  t: (key: string) => string;
+}
+
+/**
+ * Create account screen configuration
+ */
+export function createAccountConfig(params: CreateAccountConfigParams): AccountScreenConfig {
+  const {
+    displayName,
+    userId,
+    photoURL,
+    isAnonymous,
+    avatarUrl,
+    onSignIn,
+    onLogout,
+    onDeleteAccount,
+    t,
+  } = params;
+
+  const anonymous = isAnonymous ?? true;
+
+  return {
+    profile: {
+      displayName: displayName || t("settings.profile.anonymousName"),
+      userId: userId ?? undefined,
+      isAnonymous: anonymous,
+      avatarUrl: avatarUrl ?? photoURL ?? undefined,
+      benefits: anonymous ? [
+        t("settings.profile.benefits.saveHistory"),
+        t("settings.profile.benefits.syncDevices"),
+        t("settings.profile.benefits.cloudSync"),
+        t("settings.profile.benefits.secureBackup"),
+      ] : undefined,
+    },
+    isAnonymous: anonymous,
+    editProfileText: t("settings.account.editProfile"),
+    onSignIn,
+    accountActions: {
+      onLogout,
+      onDeleteAccount,
+      logoutText: t("settings.account.logout"),
+      logoutConfirmTitle: t("settings.account.logoutConfirmTitle"),
+      logoutConfirmMessage: t("settings.account.logoutConfirmMessage"),
+      cancelText: t("common.cancel"),
+      deleteAccountText: t("settings.account.deleteAccount"),
+      deleteConfirmTitle: t("settings.account.deleteConfirmTitle"),
+      deleteConfirmMessage: t("settings.account.deleteConfirmMessage"),
+    },
+  };
+}

package/src/presentation/utils/screenFactory.ts

@@ -0,0 +1,87 @@
+/**
+ * Screen Factory Utilities
+ *
+ * Helper functions for creating stack screen configurations.
+ */
+
+import React from "react";
+import type { StackScreen } from "@umituz/react-native-design-system";
+import type { AdditionalScreen } from "../navigation/types";
+
+/**
+ * Create a basic stack screen configuration
+ */
+export function createStackScreen(
+  name: string,
+  componentOrChildren: React.ComponentType<any> | (() => React.ReactElement),
+  options: { headerShown?: boolean } = {}
+): StackScreen {
+  const isChildrenFunction = typeof componentOrChildren === "function" &&
+    !(componentOrChildren.prototype && componentOrChildren.prototype.isReactComponent);
+
+  if (isChildrenFunction) {
+    return {
+      name,
+      options: { headerShown: false, ...options },
+      children: componentOrChildren as () => React.ReactElement,
+    };
+  }
+  return {
+    name,
+    component: componentOrChildren as any,
+    options: { headerShown: false, ...options },
+  };
+}
+
+/**
+ * Create a screen with props
+ */
+export function createScreenWithProps<P>(
+  name: string,
+  component: React.ComponentType<P>,
+  props: P,
+  options: { headerShown?: boolean } = {}
+): StackScreen {
+  return {
+    name,
+    options: { headerShown: false, ...options },
+    children: (() => React.createElement(component, props)) as () => React.ReactElement,
+  };
+}
+
+/**
+ * Convert additional screen to stack screen
+ */
+export function convertAdditionalScreen(screen: AdditionalScreen): StackScreen {
+  const stackScreen: any = { name: screen.name };
+  if (screen.component) stackScreen.component = screen.component;
+  if (screen.children) stackScreen.children = screen.children;
+  if (screen.options) stackScreen.options = screen.options;
+  return stackScreen as StackScreen;
+}
+
+/**
+ * Create conditional screen
+ */
+export function createConditionalScreen(
+  condition: boolean,
+  screenFactory: () => StackScreen
+): StackScreen | null {
+  return condition ? screenFactory() : null;
+}
+
+/**
+ * Combine screens excluding null values
+ */
+export function combineScreens(...screens: (StackScreen | null | StackScreen[])[]): StackScreen[] {
+  const result: StackScreen[] = [];
+  for (const screen of screens) {
+    if (screen === null) continue;
+    if (Array.isArray(screen)) {
+      result.push(...screen);
+    } else {
+      result.push(screen);
+    }
+  }
+  return result;
+}

package/src/presentation/utils/userProfileUtils.ts

@@ -0,0 +1,51 @@
+/**
+ * User Profile Utilities
+ *
+ * Helper functions for creating user profile configurations.
+ */
+
+import type { UserProfileDisplay } from "../navigation/types";
+
+export interface UserProfileConfig {
+  displayName?: string;
+  userId?: string;
+  isAnonymous?: boolean;
+  avatarUrl?: string;
+}
+
+export interface CreateUserProfileParams {
+  profileData?: UserProfileConfig;
+  t: (key: string, params?: Record<string, string | number>) => string;
+  onSignIn?: () => void;
+}
+
+/**
+ * Create user profile display configuration
+ */
+export function createUserProfileDisplay(params: CreateUserProfileParams): UserProfileDisplay {
+  const { profileData, t, onSignIn } = params;
+
+  const isAnonymous = profileData?.isAnonymous ?? true;
+  const anonymousName = t("settings.profile.anonymousName");
+
+  return {
+    displayName: profileData?.displayName || anonymousName,
+    userId: profileData?.userId ?? undefined,
+    isAnonymous,
+    avatarUrl: profileData?.avatarUrl ?? undefined,
+    onPress: isAnonymous ? onSignIn : undefined,
+    accountSettingsRoute: isAnonymous ? undefined : "Account",
+  };
+}
+
+/**
+ * Create benefits list for anonymous users
+ */
+export function createAnonymousBenefits(t: (key: string) => string): string[] {
+  return [
+    t("settings.profile.benefits.saveHistory"),
+    t("settings.profile.benefits.syncDevices"),
+    t("settings.profile.benefits.cloudSync"),
+    t("settings.profile.benefits.secureBackup"),
+  ];
+}