@umituz/react-native-settings 5.3.37 → 5.3.38

package/dist/presentation/navigation/types.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Settings Navigation Types
+ */
+import type React from 'react';
+import type { SettingsConfig, CustomSettingsSection } from "../screens/types";
+import type { DevSettingsProps } from "../../domains/dev";
+import type { FAQCategory } from "../../domains/faqs";
+/**
+ * App Info passed from main app (APP_INFO constant)
+ */
+export interface AppInfo {
+    name: string;
+    appName?: string;
+    version: string;
+    description?: string;
+    developer?: string;
+    contactEmail?: string;
+    websiteUrl?: string;
+    websiteDisplay?: string;
+    moreAppsUrl?: string;
+    appStoreId?: string;
+    appStoreUrl?: string;
+}
+/**
+ * Legal URLs passed from main app (LEGAL_URLS constant)
+ */
+export interface LegalUrls {
+    privacy: string;
+    terms: string;
+    eula?: string;
+}
+/**
+ * Navigation param list
+ */
+export type SettingsStackParamList = {
+    SettingsMain: undefined;
+    Appearance: undefined;
+    About: undefined;
+    Legal: undefined;
+    Notifications: undefined;
+    FAQ: undefined;
+    LanguageSelection: undefined;
+    Gamification: undefined;
+    Account: undefined;
+    VideoTutorial: undefined;
+    FeatureRequest: undefined;
+    PasswordPrompt: {
+        onComplete: (password: string | null) => void;
+        title?: string;
+        message?: string;
+        confirmText?: string;
+        cancelText?: string;
+    };
+};
+/**
+ * User profile configuration
+ */
+export interface UserProfileDisplay {
+    displayName?: string;
+    userId?: string;
+    isAnonymous?: boolean;
+    avatarUrl?: string;
+    accountSettingsRoute?: string;
+    onPress?: () => void;
+    anonymousDisplayName?: string;
+    avatarServiceUrl?: string;
+}
+/**
+ * Additional screen configuration
+ */
+export interface AdditionalScreen {
+    name: string;
+    component?: React.ComponentType<unknown>;
+    children?: () => React.ReactElement;
+    options?: Record<string, unknown>;
+}
+/**
+ * FAQ Data passed from main app
+ */
+export interface FAQData {
+    categories: FAQCategory[];
+}
+/**
+ * Account configuration — auth is an optional peer dependency.
+ * Defined locally so the main package does not require @umituz/react-native-auth.
+ */
+export interface AccountConfig {
+    profile?: {
+        displayName?: string;
+        userId?: string;
+        isAnonymous?: boolean;
+        avatarUrl?: string;
+        accountSettingsRoute?: string;
+        benefits?: string[];
+    };
+    isAnonymous?: boolean;
+    editProfileText?: string;
+    onSignIn?: () => void;
+    PasswordPromptComponent?: React.ReactNode;
+    accountActions?: {
+        onLogout?: () => Promise<void>;
+        onDeleteAccount?: () => Promise<void>;
+        logoutText?: string;
+        logoutConfirmTitle?: string;
+        logoutConfirmMessage?: string;
+        cancelText?: string;
+        deleteAccountText?: string;
+        deleteConfirmTitle?: string;
+        deleteConfirmMessage?: string;
+        deleteErrorTitle?: string;
+        deleteErrorMessage?: string;
+    };
+}
+/**
+ * Settings Stack Navigator Props
+ */
+export interface SettingsStackNavigatorProps {
+    appInfo: AppInfo;
+    legalUrls: LegalUrls;
+    faqData?: FAQData;
+    config?: SettingsConfig;
+    showUserProfile?: boolean;
+    userProfile?: UserProfileDisplay;
+    accountConfig?: AccountConfig;
+    additionalScreens?: AdditionalScreen[];
+    devSettings?: DevSettingsProps;
+    customSections?: CustomSettingsSection[];
+    showHeader?: boolean;
+    /** Show close button in header (useful for modal presentation) */
+    showCloseButton?: boolean;
+    /** Custom close handler */
+    onClose?: () => void;
+    gamificationConfig?: import("../../domains/gamification").GamificationSettingsConfig;
+    videoTutorialConfig?: import("../../domains/video-tutorials").VideoTutorialsScreenProps;
+}

package/dist/presentation/navigation/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Navigation Utilities
+ */
+export { createRouteOrPressHandler } from './navigationHelpers';
+export { createNotificationTranslations, createQuietHoursTranslations, createLegalScreenProps } from './navigationTranslations';

package/dist/presentation/navigation/utils/navigationHelpers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Navigation Helper Utilities
+ * Type-safe navigation handling to eliminate type casting
+ */
+import type { SettingsStackParamList } from '../types';
+type NavigateFunction = <RouteName extends keyof SettingsStackParamList>(route: RouteName, params?: SettingsStackParamList[RouteName]) => void;
+interface RouteOrPressConfig<T extends keyof SettingsStackParamList = keyof SettingsStackParamList> {
+    route?: T;
+    onPress?: () => void;
+    fallback?: T;
+}
+export declare const createRouteOrPressHandler: <T extends keyof SettingsStackParamList>(navigate: NavigateFunction, config: RouteOrPressConfig<T>) => () => void;
+export {};

package/dist/presentation/navigation/utils/navigationTranslations.d.ts

@@ -0,0 +1,35 @@
+import type { SettingsTranslations } from "../../screens/types";
+export declare const createNotificationTranslations: (translations?: SettingsTranslations["features"]) => {
+    screenTitle: string;
+    masterToggleTitle: string;
+    masterToggleDescription: string;
+    soundTitle: string;
+    soundDescription: string;
+    vibrationTitle: string;
+    vibrationDescription: string;
+    remindersTitle: string;
+    remindersDescription: string;
+    quietHoursTitle: string;
+    quietHoursDescription: string;
+};
+export declare const createQuietHoursTranslations: (translations?: SettingsTranslations["features"]) => {
+    title: string;
+    description: string;
+    startTimeLabel: string;
+    endTimeLabel: string;
+    enabledLabel: string;
+};
+export declare const createLegalScreenProps: (translations: SettingsTranslations["features"], handlePrivacyPress: () => void, handleTermsPress: () => void, handleEulaPress: () => void) => {
+    title: string;
+    description: string;
+    documentsHeader: string;
+    privacyTitle: string;
+    privacyDescription: string;
+    termsTitle: string;
+    termsDescription: string;
+    eulaTitle: string;
+    eulaDescription: string;
+    onPrivacyPress: () => void;
+    onTermsPress: () => void;
+    onEulaPress: () => void;
+};

package/dist/presentation/screens/AppearanceScreen.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Appearance Settings Screen
+ * Advanced appearance settings with theme customization and custom colors
+ * Now uses consolidated appearance domain
+ */
+export { AppearanceScreen } from "../../domains/appearance/presentation/screens/AppearanceScreen";

package/dist/presentation/screens/SettingsScreen.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Settings Screen
+ * Presentation layer - Composition only, no business logic
+ */
+import React from "react";
+import type { SettingsConfig, CustomSettingsSection } from "./types";
+import type { DevSettingsProps } from "../../domains/dev";
+export interface SettingsScreenProps {
+    children?: React.ReactNode;
+    config?: SettingsConfig;
+    /** Show user profile header */
+    showUserProfile?: boolean;
+    /** User profile props */
+    userProfile?: {
+        displayName?: string;
+        userId?: string;
+        isAnonymous?: boolean;
+        avatarUrl?: string;
+        accountSettingsRoute?: string;
+        onPress?: () => void;
+        anonymousDisplayName?: string;
+        avatarServiceUrl?: string;
+    };
+    /** Show footer with version */
+    showFooter?: boolean;
+    /** Custom footer text (overrides appVersion) */
+    footerText?: string;
+    /** App version number from app config (e.g., "1.0.0") */
+    appVersion?: string;
+    /** Custom sections to render */
+    customSections?: CustomSettingsSection[];
+    /** Show close button in header */
+    showCloseButton?: boolean;
+    /** Custom close handler */
+    onClose?: () => void;
+    /** Feature detection options */
+    featureOptions?: {
+        notificationServiceAvailable?: boolean;
+    };
+    /** Dev settings (only shown in __DEV__ mode) */
+    devSettings?: DevSettingsProps;
+    /** Gamification configuration */
+    gamificationConfig?: import("../../domains/gamification").GamificationSettingsConfig;
+    /** Show header (default: true) */
+    showHeader?: boolean;
+    /** Password prompt modal component */
+    PasswordPromptComponent?: React.ReactNode;
+}
+export declare const SettingsScreen: React.FC<SettingsScreenProps>;

package/dist/presentation/screens/components/SettingsContent.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import type { SettingsContentProps } from "./types/SettingsContentProps";
+export declare const SettingsContent: React.FC<SettingsContentProps>;

package/dist/presentation/screens/components/SettingsHeader.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+interface SettingsHeaderProps {
+    showCloseButton?: boolean;
+    onClose?: () => void;
+    title?: string;
+}
+export declare const SettingsHeader: React.FC<SettingsHeaderProps>;
+export {};

package/dist/presentation/screens/components/sections/CustomSettingsList.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+import type { CustomSettingsSection } from "../../types";
+interface CustomSettingsListProps {
+    customSections?: CustomSettingsSection[];
+}
+export declare const CustomSettingsList: React.FC<CustomSettingsListProps>;
+export {};

package/dist/presentation/screens/components/sections/FeatureSettingsSection.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+import type { NormalizedConfig } from "../../utils/normalizeConfig";
+interface FeatureSettingsSectionProps {
+    normalizedConfig: NormalizedConfig;
+    features: {
+        appearance: boolean;
+        language: boolean;
+        notifications: boolean;
+    };
+    currentLanguage?: string;
+}
+export declare const FeatureSettingsSection: React.FC<FeatureSettingsSectionProps>;
+export {};

package/dist/presentation/screens/components/sections/IdentitySettingsSection.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+import type { NormalizedConfig } from "../../utils/normalizeConfig";
+interface IdentitySettingsSectionProps {
+    normalizedConfig: NormalizedConfig;
+    features: {
+        about: boolean;
+        legal: boolean;
+        [key: string]: boolean;
+    };
+}
+export declare const IdentitySettingsSection: React.FC<IdentitySettingsSectionProps>;
+export {};

package/dist/presentation/screens/components/sections/ProfileSectionLoader.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+export interface ProfileSectionLoaderProps {
+    userProfile?: {
+        displayName?: string;
+        userId?: string;
+        isAnonymous?: boolean;
+        avatarUrl?: string;
+        accountSettingsRoute?: string;
+        onPress?: () => void;
+        benefits?: string[];
+    };
+    translations?: {
+        anonymousName?: string;
+        signIn?: string;
+    };
+}
+export declare const ProfileSectionLoader: React.FC<ProfileSectionLoaderProps>;

package/dist/presentation/screens/components/sections/SupportSettingsSection.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+import type { NormalizedConfig } from "../../utils/normalizeConfig";
+interface SupportSettingsSectionProps {
+    features: {
+        feedback: boolean;
+        rating: boolean;
+        faqs: boolean;
+        [key: string]: boolean;
+    };
+    normalizedConfig: NormalizedConfig;
+}
+export declare const SupportSettingsSection: React.FC<SupportSettingsSectionProps>;
+export {};

package/dist/presentation/screens/components/types/SettingsContentProps.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Settings Content Component Props
+ */
+import type { NormalizedConfig } from "../../utils/normalizeConfig";
+import type { CustomSettingsSection } from "../../types";
+import type { DevSettingsProps } from "../../../../domains/dev";
+import type { GamificationSettingsConfig } from "../../../../domains/gamification";
+export interface SettingsContentFeatures {
+    [key: string]: boolean;
+    appearance: boolean;
+    language: boolean;
+    notifications: boolean;
+    about: boolean;
+    legal: boolean;
+    disclaimer: boolean;
+    userProfile: boolean;
+    feedback: boolean;
+    rating: boolean;
+    faqs: boolean;
+    subscription: boolean;
+    wallet: boolean;
+    gamification: boolean;
+    videoTutorial: boolean;
+}
+export interface SettingsContentUserProfile {
+    displayName?: string;
+    userId?: string;
+    isAnonymous?: boolean;
+    avatarUrl?: string;
+    accountSettingsRoute?: string;
+    onPress?: () => void;
+    anonymousDisplayName?: string;
+    avatarServiceUrl?: string;
+}
+export interface SettingsContentProps {
+    normalizedConfig: NormalizedConfig;
+    features: SettingsContentFeatures;
+    showUserProfile?: boolean;
+    userProfile?: SettingsContentUserProfile;
+    showFooter?: boolean;
+    footerText?: string;
+    appVersion?: string;
+    customSections?: CustomSettingsSection[];
+    emptyStateText?: string;
+    devSettings?: DevSettingsProps;
+    gamificationConfig?: GamificationSettingsConfig;
+}

package/dist/presentation/screens/components/utils/featureChecker.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Feature Checker Utilities
+ * Centralized logic for checking if features are enabled
+ */
+import type { SettingsContentFeatures } from "../types/SettingsContentProps";
+import type { CustomSettingsSection } from "../../types";
+/**
+ * Check if any settings features are enabled
+ */
+export declare function hasAnyFeaturesEnabled(features: SettingsContentFeatures, customSections: CustomSettingsSection[]): boolean;

package/dist/presentation/screens/hooks/useFeatureDetection.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Feature Detection Hook
+ * Single Responsibility: Detect which features should be shown
+ */
+import type { NormalizedConfig } from "../utils/normalizeConfig";
+/**
+ * Hook to detect which features should be shown
+ */
+export declare function useFeatureDetection(normalizedConfig: NormalizedConfig, navigation: {
+    navigate: (route: string) => void;
+} | null, options?: {
+    notificationServiceAvailable?: boolean;
+}): {
+    appearance: boolean;
+    language: boolean;
+    notifications: boolean;
+    about: boolean;
+    legal: boolean;
+    disclaimer: boolean;
+    userProfile: boolean;
+    feedback: boolean;
+    rating: boolean;
+    faqs: boolean;
+    subscription: boolean;
+    wallet: boolean;
+    gamification: boolean;
+    videoTutorial: boolean;
+};

package/dist/presentation/screens/hooks/useSettingsScreen.d.ts

@@ -0,0 +1,36 @@
+/**
+ * useSettingsScreen Hook
+ * Refactored: Extracted business logic from SettingsScreen component
+ */
+import type { SettingsConfig } from "../types";
+export interface UseSettingsScreenParams {
+    config?: SettingsConfig;
+    showUserProfile?: boolean;
+    featureOptions?: {
+        notificationServiceAvailable?: boolean;
+    };
+    appVersion?: string;
+    onClose?: () => void;
+}
+export declare function useSettingsScreen({ config, showUserProfile, featureOptions, appVersion: providedVersion, onClose, }: UseSettingsScreenParams): {
+    normalizedConfig: import("../utils/normalizeConfig").NormalizedConfig;
+    features: {
+        appearance: boolean;
+        language: boolean;
+        notifications: boolean;
+        about: boolean;
+        legal: boolean;
+        disclaimer: boolean;
+        userProfile: boolean;
+        feedback: boolean;
+        rating: boolean;
+        faqs: boolean;
+        subscription: boolean;
+        wallet: boolean;
+        gamification: boolean;
+        videoTutorial: boolean;
+    };
+    shouldShowUserProfile: boolean;
+    appVersion: string;
+    handleClose: () => void;
+};

package/dist/presentation/screens/types/BaseTypes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Base Feature Types
+ * Core types for feature visibility and configuration
+ */
+/**
+ * Feature visibility configuration
+ * - true: Always show (if navigation screen exists)
+ * - false: Never show
+ * - 'auto': Automatically detect (check if navigation screen exists and package is available)
+ */
+export type FeatureVisibility = boolean | "auto";

package/dist/presentation/screens/types/ContentConfig.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Content Feature Configuration Types
+ * Types for content-related features (About, Legal, Disclaimer)
+ */
+import type { FeatureVisibility } from "./BaseTypes";
+import type { AppearanceTexts } from "../../../domains/appearance/types";
+/**
+ * Base configuration interface for content features
+ */
+interface BaseContentConfig {
+    /** Show section */
+    enabled?: FeatureVisibility;
+    /** Custom navigation route */
+    route?: string;
+    /** Custom navigation handler (overrides route) */
+    onPress?: () => void;
+    /** Custom title */
+    title?: string;
+    /** Custom description */
+    description?: string;
+    /** Custom icon name (Ionicons) */
+    icon?: string;
+    /** Custom section title for grouping */
+    sectionTitle?: string;
+}
+/**
+ * About Settings Configuration
+ */
+export interface AboutConfig extends BaseContentConfig {
+    /** Default route name when no custom route provided */
+    defaultRoute?: string;
+}
+/**
+ * Legal Settings Configuration
+ */
+export interface LegalConfig extends BaseContentConfig {
+    /** Default route name when no custom route provided */
+    defaultRoute?: string;
+}
+/**
+ * Disclaimer Settings Configuration
+ */
+export interface DisclaimerConfig extends BaseContentConfig {
+}
+/**
+ * Appearance Settings Configuration
+ */
+export interface AppearanceConfig extends BaseContentConfig {
+    /** Show theme toggle */
+    showTheme?: boolean;
+    /** Default route name when no custom route provided */
+    defaultRoute?: string;
+    /** Appearance screen texts (theme mode labels, descriptions, etc.) */
+    texts?: AppearanceTexts;
+}
+/**
+ * Language Settings Configuration
+ */
+export interface LanguageConfig extends BaseContentConfig {
+    /** Default language display when no language is detected */
+    defaultLanguageDisplay?: string;
+}
+/**
+ * Notifications Settings Configuration
+ */
+export interface NotificationsConfig extends BaseContentConfig {
+    /** Show notification toggle switch */
+    showToggle?: boolean;
+    /** Initial toggle value */
+    initialValue?: boolean;
+    /** Toggle change handler */
+    onToggleChange?: (value: boolean) => void;
+    /** Default route name when no custom route provided */
+    defaultRoute?: string;
+}
+export {};

package/dist/presentation/screens/types/CustomSection.d.ts

@@ -0,0 +1,38 @@
+import type { ReactNode } from "react";
+import type { IconName } from "@umituz/react-native-design-system/atoms";
+/**
+ * Custom Settings Item
+ */
+export interface CustomSettingsItem {
+    /** Item unique ID */
+    id: string;
+    /** Item title */
+    title: string;
+    /** Optional subtitle or description */
+    subtitle?: string;
+    /** Icon name (Ionicons) */
+    icon: IconName;
+    /** Press handler */
+    onPress: () => void;
+    /** Optional right icon (Ionicons) */
+    rightIcon?: IconName;
+    /** Optional icon color */
+    iconColor?: string;
+    /** Optional icon background color */
+    iconBgColor?: string;
+}
+/**
+ * Custom Settings Section
+ */
+export interface CustomSettingsSection {
+    /** Section title */
+    title: string;
+    /** Section content (React nodes) - takes priority over items */
+    content?: ReactNode;
+    /** List of settings items to render */
+    items?: CustomSettingsItem[];
+    /** Section order (lower = higher in list) */
+    order?: number;
+    /** Section ID for identification */
+    id?: string;
+}