@umituz/react-native-settings 5.3.37 → 5.3.38

package/dist/domains/video-tutorials/presentation/components/VideoTutorialSection.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Video Tutorial Section Component
+ * Renders Video Tutorial entry point for settings
+ */
+import React from 'react';
+export interface VideoTutorialConfig {
+    enabled?: boolean;
+    title?: string;
+    description?: string;
+    onPress?: () => void;
+}
+export interface VideoTutorialSectionProps {
+    config: VideoTutorialConfig;
+    renderSection: (props: {
+        title: string;
+        children: React.ReactNode;
+    }) => React.ReactElement | null;
+    renderItem: (props: {
+        title: string;
+        icon: string;
+        onPress: () => void;
+        isLast?: boolean;
+    }) => React.ReactElement | null;
+}
+export declare const VideoTutorialSection: React.FC<VideoTutorialSectionProps>;

package/dist/domains/video-tutorials/presentation/screens/VideoTutorialsScreen.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Video Tutorials Screen
+ * Single Responsibility: Display video tutorials list
+ *
+ * Usage:
+ *   <VideoTutorialsScreen
+ *     tutorials={[...]}
+ *     featuredTutorials={[...]}
+ *     title="Video Tutorials"
+ *     onTutorialPress={(id) => openVideo(id)}
+ *   />
+ */
+import React from "react";
+import type { VideoTutorial } from "../../types";
+export interface VideoTutorialsScreenProps {
+    tutorials: VideoTutorial[];
+    featuredTutorials?: VideoTutorial[];
+    title?: string;
+    featuredTitle?: string;
+    allTutorialsTitle?: string;
+    emptyMessage?: string;
+    isLoading?: boolean;
+    onTutorialPress?: (tutorial: VideoTutorial) => void;
+}
+export declare const VideoTutorialsScreen: React.FC<VideoTutorialsScreenProps>;

package/dist/domains/video-tutorials/types/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Video Tutorial Types
+ * Single Responsibility: Define type definitions for video tutorials
+ */
+export interface VideoTutorial {
+    readonly id: string;
+    readonly title: string;
+    readonly description: string;
+    readonly videoUrl: string;
+    readonly thumbnailUrl: string;
+    readonly duration: number;
+    readonly category: VideoTutorialCategory;
+    readonly difficulty: "beginner" | "intermediate" | "advanced";
+    readonly featured: boolean;
+    readonly tags: readonly string[];
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+    readonly viewCount: number;
+}
+export type VideoTutorialCategory = "getting-started" | "ai-generation" | "editing" | "effects" | "exporting" | "tips-tricks" | "troubleshooting";
+export interface VideoTutorialFilters {
+    readonly category?: VideoTutorialCategory;
+    readonly difficulty?: VideoTutorial["difficulty"];
+    readonly featured?: boolean;
+    readonly tags?: readonly string[];
+}

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @umituz/react-native-settings - Public API
+ *
+ * Settings management for React Native apps
+ * User preferences, theme, language, notifications
+ *
+ * Usage:
+ *   import { useSettings, SettingsScreen, AppearanceScreen, SettingsItemCard, DisclaimerSetting } from '@umituz/react-native-settings';
+ */
+export type { ISettingsRepository, UserSettings, SettingsError, SettingsResult, } from './application/ports/ISettingsRepository';
+export { getSettingsService } from './infrastructure/services/SettingsService';
+export { SettingsRepository } from './infrastructure/repositories/SettingsRepository';
+export { useSettings } from './presentation/hooks/useSettings';
+export { useSettingsQuery } from './presentation/hooks/queries/useSettingsQuery';
+export { useUpdateSettingsMutation, useResetSettingsMutation } from './presentation/hooks/mutations/useSettingsMutations';
+export { SettingsScreen } from './presentation/screens/SettingsScreen';
+export type { SettingsScreenProps } from './presentation/screens/SettingsScreen';
+export { AppearanceScreen } from './presentation/screens/AppearanceScreen';
+export { SettingsStackNavigator } from './presentation/navigation/SettingsStackNavigator';
+export type { SettingsStackNavigatorProps, SettingsStackParamList, AppInfo, LegalUrls, UserProfileDisplay, AdditionalScreen, FAQData, AccountConfig, } from './presentation/navigation/types';
+export type { SettingsConfig, CustomSettingsSection, } from './presentation/screens/types';
+export { SettingsItemCard } from './presentation/components/SettingsItemCard';
+export type { SettingsItemCardProps } from './presentation/components/SettingsItemCard';
+export { SettingsSection } from './presentation/components/SettingsSection';
+export type { SettingsSectionProps } from './presentation/components/SettingsSection';
+export { SettingsFooter } from './presentation/components/SettingsFooter';
+export type { SettingsFooterProps } from './presentation/components/SettingsFooter';
+export * from './domains/about';
+export * from './domains/legal';
+export * from './domains/disclaimer';
+export * from './domains/appearance';
+export * from './domains/feedback';
+export * from './domains/faqs';
+export { StarRating, RatingPromptModal, useAppRating, DEFAULT_RATING_CONFIG, type RatingValue, type Rating, type RatingStats, type RatingConfig as AppStoreRatingConfig, type RatingState as AppStoreRatingState, type RatingTranslations as AppStoreRatingTranslations, type UseAppRatingResult, type StarRatingProps, type RatingPromptModalProps, } from "./domains/rating";
+export * from "./domains/video-tutorials";
+export * from "./domains/cloud-sync";
+export * from "./domains/dev";
+export * from "./domains/gamification";
+export * from "./domains/localization";
+export * from "./domains/notifications";
+export { createAppearanceConfig, createLanguageConfig, createNotificationsConfig, createAboutConfig, createLegalConfig, createFeedbackConfig, createRatingConfig, createFAQConfig, createSubscriptionConfig, createGamificationConfig, type TranslationFunction, type FeedbackFormData, } from './presentation/utils';

package/dist/infrastructure/repositories/SettingsRepository.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Settings Repository Implementation
+ *
+ * Handles data access for user settings using @umituz/react-native-design-system
+ */
+import type { ISettingsRepository, UserSettings, SettingsResult } from '../../application/ports/ISettingsRepository';
+export declare class SettingsRepository implements ISettingsRepository {
+    private readonly defaultSettings;
+    getSettings(userId: string): Promise<SettingsResult<UserSettings>>;
+    saveSettings(settings: UserSettings): Promise<SettingsResult<void>>;
+    deleteSettings(userId: string): Promise<SettingsResult<void>>;
+}

package/dist/infrastructure/services/SettingsService.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Settings Service
+ *
+ * Orchestrates settings operations using SettingsRepository
+ */
+import type { UserSettings, SettingsResult } from '../../application/ports/ISettingsRepository';
+export declare class SettingsService {
+    private repository;
+    constructor();
+    getSettings(userId: string): Promise<SettingsResult<UserSettings>>;
+    saveSettings(settings: UserSettings): Promise<SettingsResult<void>>;
+    resetSettings(userId: string): Promise<SettingsResult<void>>;
+}
+export declare function getSettingsService(): SettingsService;

package/dist/infrastructure/utils/configFactory.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Configuration Factory
+ * Generic configuration creator to reduce duplication in base-configs
+ */
+/**
+ * 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";
+/**
+ * Base configuration type for all settings items
+ */
+export interface BaseConfigType {
+    enabled?: FeatureVisibility;
+    title?: string;
+    description?: string;
+    icon?: string;
+    route?: string;
+    onPress?: () => void;
+}
+/**
+ * Configuration parameters for creating a settings item config
+ */
+export interface ConfigCreatorParams {
+    icon: string;
+    routeOrOnPress?: string | (() => void);
+    defaultRoute?: string;
+}
+/**
+ * Generic configuration creator function
+ * Reduces duplication across all config creators
+ */
+export declare const createBaseConfig: <T extends BaseConfigType = BaseConfigType>(params: ConfigCreatorParams) => T;
+/**
+ * Create a configuration with extended properties
+ */
+export declare const createConfigWithExtensions: <T extends BaseConfigType>(baseParams: ConfigCreatorParams, extensions: Partial<Omit<T, keyof BaseConfigType>>) => T;

package/dist/infrastructure/utils/constants/textLimits.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Text Length Limits
+ * Standardized text length constraints used across the application
+ */
+export declare const TEXT_LENGTH_LIMITS: {
+    /** Short titles and labels (100 characters) */
+    readonly TITLE_SHORT: 100;
+    /** Standard titles (200 characters) */
+    readonly TITLE: 200;
+    /** Descriptions and short text (500 characters) */
+    readonly DESCRIPTION: 500;
+    /** Long text and body content (1000 characters) */
+    readonly BODY: 1000;
+    /** User ID maximum length (128 characters) */
+    readonly USER_ID: 128;
+};

package/dist/infrastructure/utils/sanitizers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Sanitization Utilities
+ *
+ * Provides sanitization functions for user input and props.
+ */
+/**
+ * Sanitize title prop
+ */
+export declare function sanitizeTitle(title: string): string;
+/**
+ * Sanitize description prop
+ */
+export declare function sanitizeDescription(description: string | undefined): string | undefined;

package/dist/infrastructure/utils/validation/core.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Core Validation Utilities
+ * Base validation interfaces and types
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    error?: string;
+}

package/dist/infrastructure/utils/validation/formValidators.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Form Validators
+ * Domain-specific form validation functions
+ */
+import type { ValidationResult } from "./core";
+/**
+ * Feedback form validation
+ */
+export declare const validateFeedbackForm: (data: {
+    type: string;
+    rating: number;
+    description: string;
+}) => ValidationResult;
+/**
+ * Reminder form validation
+ */
+export declare const validateReminderForm: (data: {
+    title: string;
+    body?: string;
+    frequency: string;
+    hour?: number;
+    minute?: number;
+    weekday?: number;
+    maxTitleLength?: number;
+    maxBodyLength?: number;
+}) => ValidationResult;

package/dist/infrastructure/utils/validation/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validation Utilities
+ */
+export type { ValidationResult } from "./core";
+export { validateFeedbackForm, validateReminderForm } from "./formValidators";

package/dist/infrastructure/utils/validators.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Validation Utilities
+ *
+ * Provides validation functions for component props.
+ */
+export interface ValidationWarning {
+    message: string;
+    value: unknown;
+}
+/**
+ * Validate settings item title
+ */
+export declare function validateTitle(title: unknown): ValidationWarning | null;
+/**
+ * Validate settings item description
+ */
+export declare function validateDescription(description: unknown): ValidationWarning | null;
+/**
+ * Validate switch props
+ */
+export declare function validateSwitchProps(showSwitch: boolean, onSwitchChange?: ((value: boolean) => void) | null): ValidationWarning | null;

package/dist/presentation/components/SettingsFooter.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+export interface SettingsFooterProps {
+    versionText?: string;
+    appVersion?: string;
+    versionLabel?: string;
+}
+export declare const SettingsFooter: React.FC<SettingsFooterProps>;

package/dist/presentation/components/SettingsItemCard.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+import { type StyleProp, type ViewStyle } from "react-native";
+import type { IconName } from "@umituz/react-native-design-system/atoms";
+export interface SettingsItemCardProps {
+    title: string;
+    description?: string;
+    icon: IconName;
+    onPress?: () => void;
+    containerStyle?: StyleProp<ViewStyle>;
+    sectionTitle?: string;
+    rightIcon?: IconName;
+    iconBgColor?: string;
+    iconColor?: string;
+    showChevron?: boolean;
+    showSwitch?: boolean;
+    switchValue?: boolean;
+    onSwitchChange?: (value: boolean) => void;
+    disabled?: boolean;
+    noBackground?: boolean;
+    hideMargin?: boolean;
+}
+export declare const SettingsItemCard: React.FC<SettingsItemCardProps>;

package/dist/presentation/components/SettingsNavigationItem.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Generic Settings Navigation Item
+ * Consolidates VideoTutorialSettingsItem, GamificationSettingsItem,
+ * WalletSettingsItem, and SubscriptionSettingsItem into one reusable component
+ */
+import React from "react";
+import type { IconName } from "@umituz/react-native-design-system/atoms";
+import type { SettingsStackParamList } from "../navigation/types";
+/**
+ * Base configuration for navigation items
+ */
+export interface SettingsNavigationItemConfig {
+    title?: string;
+    description?: string;
+    icon?: string;
+    sectionTitle?: string;
+    route?: keyof SettingsStackParamList;
+    onPress?: () => void;
+}
+/**
+ * Props for generic settings navigation item
+ */
+export interface SettingsNavigationItemProps<T extends SettingsNavigationItemConfig = SettingsNavigationItemConfig> {
+    /** Item configuration */
+    config: T;
+    /** Default icon if not specified in config */
+    defaultIcon?: IconName;
+    /** Default route if not specified in config */
+    defaultRoute?: keyof SettingsStackParamList;
+    /** Function to render custom description */
+    renderDescription?: (config: T) => string | undefined;
+    /** Remove background styling */
+    noBackground?: boolean;
+    /** Remove margin */
+    hideMargin?: boolean;
+}
+/**
+ * Generic Settings Navigation Item Component
+ *
+ * @example
+ * ```tsx
+ * <SettingsNavigationItem
+ *   config={videoConfig}
+ *   defaultIcon="play-circle-outline"
+ *   defaultRoute="VideoTutorial"
+ * />
+ * ```
+ *
+ * @example With custom description
+ * ```tsx
+ * <SettingsNavigationItem
+ *   config={gamificationConfig}
+ *   defaultIcon="trophy-outline"
+ *   defaultRoute="Gamification"
+ *   renderDescription={(cfg) => `${level} • ${points}`}
+ * />
+ * ```
+ */
+declare const SettingsNavigationItemComponent: <T extends SettingsNavigationItemConfig>({ config, defaultIcon, defaultRoute, renderDescription, noBackground, hideMargin, }: SettingsNavigationItemProps<T>) => React.JSX.Element;
+/**
+ * Memoized Settings Navigation Item
+ * Uses shallow comparison by default
+ */
+export declare const SettingsNavigationItem: typeof SettingsNavigationItemComponent & {
+    displayName?: string;
+};
+export {};

package/dist/presentation/components/SettingsSection.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+export interface SettingsSectionProps {
+    title: string;
+    children: React.ReactNode;
+}
+export declare const SettingsSection: React.FC<SettingsSectionProps>;

package/dist/presentation/components/settings/SettingsItemCardContent.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+import { type IconName } from "@umituz/react-native-design-system/atoms";
+export interface SettingsItemCardContentProps {
+    icon: IconName;
+    title: string;
+    description?: string;
+    iconBgColor: string;
+    iconColor: string;
+    disabled?: boolean;
+    rightElement: React.ReactElement;
+}
+export declare const SettingsItemCardContent: React.FC<SettingsItemCardContentProps>;

package/dist/presentation/components/settings/SettingsItemCardRightElement.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+import { type IconName } from "@umituz/react-native-design-system/atoms";
+export interface SettingsItemCardRightElementProps {
+    showSwitch: boolean;
+    switchValue?: boolean;
+    onSwitchChange?: (value: boolean) => void;
+    disabled?: boolean;
+    shouldShowChevron: boolean;
+    rightIcon: IconName;
+}
+export declare const SettingsItemCardRightElement: React.FC<SettingsItemCardRightElementProps>;

package/dist/presentation/components/settings/SettingsItemCardSection.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+export interface SettingsItemCardSectionProps {
+    sectionTitle?: string;
+}
+export declare const SettingsItemCardSection: React.FC<SettingsItemCardSectionProps>;

package/dist/presentation/hooks/mutations/useSettingsMutations.d.ts

@@ -0,0 +1,20 @@
+/**
+ * useSettingsMutations Hook
+ *
+ * Mutations for updating and resetting user settings
+ */
+import type { UserSettings } from '../../../application/ports/ISettingsRepository';
+export declare const useUpdateSettingsMutation: (userId: string) => import("@tanstack/react-query").UseMutationResult<{
+    updatedAt: Date;
+    userId: string;
+    theme: "light" | "dark" | "auto";
+    language: string;
+    notificationsEnabled: boolean;
+    emailNotifications: boolean;
+    pushNotifications: boolean;
+    soundEnabled: boolean;
+    vibrationEnabled: boolean;
+    privacyMode: boolean;
+    disclaimerAccepted: boolean;
+}, Error, Partial<UserSettings>, unknown>;
+export declare const useResetSettingsMutation: (userId: string) => import("@tanstack/react-query").UseMutationResult<UserSettings, Error, void, unknown>;

package/dist/presentation/hooks/queries/useSettingsQuery.d.ts

@@ -0,0 +1,7 @@
+/**
+ * useSettingsQuery Hook
+ *
+ * Fetches user settings using TanStack Query
+ */
+export declare const SETTINGS_QUERY_KEY: string[];
+export declare const useSettingsQuery: (userId: string) => import("@tanstack/react-query").UseQueryResult<import("../../..").UserSettings, Error>;

package/dist/presentation/hooks/useSettings.d.ts

@@ -0,0 +1,26 @@
+/**
+ * useSettings Hook
+ *
+ * Primary hook for accessing and managing user settings.
+ * Integrates with TanStack Query mutations and queries.
+ */
+import type { UserSettings } from '../../application/ports/ISettingsRepository';
+export declare const useSettings: (userId: string) => {
+    settings: UserSettings;
+    loading: boolean;
+    error: string;
+    updateSettings: (updates: Partial<UserSettings>) => Promise<{
+        updatedAt: Date;
+        userId: string;
+        theme: "light" | "dark" | "auto";
+        language: string;
+        notificationsEnabled: boolean;
+        emailNotifications: boolean;
+        pushNotifications: boolean;
+        soundEnabled: boolean;
+        vibrationEnabled: boolean;
+        privacyMode: boolean;
+        disclaimerAccepted: boolean;
+    }>;
+    resetSettings: () => Promise<UserSettings>;
+};

package/dist/presentation/hooks/useSettingsScreenConfig.d.ts

@@ -0,0 +1,41 @@
+/**
+ * useSettingsScreenConfig Hook
+ *
+ * One-stop hook for settings screen configuration.
+ * Handles auth, feedback, and all settings config internally.
+ * Apps pass subscription config from subscription package.
+ */
+import type { SettingsConfig, SettingsTranslations } from "../screens/types";
+import type { FeedbackFormData } from "../utils/config-creators";
+import type { AppInfo, FAQData, UserProfileDisplay, AdditionalScreen, AccountConfig } from "../navigation/types";
+export interface SettingsFeatures {
+    notifications?: boolean;
+    appearance?: boolean;
+    language?: boolean;
+    feedback?: boolean;
+    rating?: boolean;
+    faqs?: boolean;
+    about?: boolean;
+    legal?: boolean;
+    gamification?: boolean;
+    videoTutorial?: boolean;
+    subscription?: boolean;
+}
+export interface UseSettingsScreenConfigParams {
+    appInfo: AppInfo;
+    faqData?: FAQData;
+    isPremium: boolean;
+    onFeedbackSubmit: (data: FeedbackFormData) => Promise<void>;
+    additionalScreens?: AdditionalScreen[];
+    features?: SettingsFeatures;
+    translations?: SettingsTranslations;
+}
+export interface SettingsScreenConfigResult {
+    settingsConfig: SettingsConfig;
+    userProfile: UserProfileDisplay;
+    accountConfig: AccountConfig;
+    translatedFaqData: FAQData | undefined;
+    isLoading: boolean;
+    isAuthReady: boolean;
+}
+export declare const useSettingsScreenConfig: (params: UseSettingsScreenConfigParams) => SettingsScreenConfigResult;

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

@@ -0,0 +1,9 @@
+/**
+ * Settings Stack Navigator
+ *
+ * Complete settings navigation with all screens.
+ * Receives appInfo and legalUrls from app.
+ */
+import React from "react";
+import type { SettingsStackNavigatorProps } from "./types";
+export declare const SettingsStackNavigator: React.FC<SettingsStackNavigatorProps>;

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

@@ -0,0 +1,5 @@
+/**
+ * Navigation Hooks
+ */
+export { useNavigationHandlers } from "./useNavigationHandlers";
+export { useSettingsScreens } from "./useSettingsScreens";

package/dist/presentation/navigation/hooks/useNavigationHandlers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Navigation Handlers Hook
+ * Provides URL handlers and config generation for settings screens
+ */
+import type { AppInfo, LegalUrls } from "../types";
+import type { AboutConfig } from "../../../domains/about";
+interface NavigationHandlersResult {
+    handlePrivacyPress: () => void;
+    handleTermsPress: () => void;
+    handleEulaPress: () => void;
+    aboutConfig: AboutConfig;
+}
+export declare const useNavigationHandlers: (appInfo: AppInfo, legalUrls: LegalUrls, aboutTranslations?: AboutConfig["texts"]) => NavigationHandlersResult;
+export {};

package/dist/presentation/navigation/hooks/useSettingsNavigation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Typed Settings Navigation Hook
+ *
+ * Provides type-safe navigation for Settings stack screens.
+ * Replaces unsafe `as never` casts throughout the codebase.
+ */
+import type { StackNavigationProp } from '@react-navigation/stack';
+import type { SettingsStackParamList } from '../types';
+/**
+ * Type for Settings navigation prop
+ */
+export type SettingsNavigationProp = StackNavigationProp<SettingsStackParamList>;
+/**
+ * Hook to get typed navigation for Settings screens
+ *
+ * @example
+ * ```typescript
+ * const navigation = useSettingsNavigation();
+ * navigation.navigate('LanguageSelection'); // Fully typed!
+ * ```
+ */
+export declare const useSettingsNavigation: () => SettingsNavigationProp;

package/dist/presentation/navigation/hooks/useSettingsScreens.d.ts

@@ -0,0 +1,12 @@
+import type { StackScreen } from "@umituz/react-native-design-system/molecules";
+import type { SettingsStackNavigatorProps } from "../types";
+import type { AboutConfig } from "../../../domains/about/domain/entities/AppInfo";
+import type { LegalScreenProps } from "../../../domains/legal/presentation/screens/LegalScreen";
+import type { NotificationSettingsTranslations, QuietHoursTranslations } from "../../../domains/notifications/infrastructure/services/types";
+export interface UseSettingsScreensProps extends SettingsStackNavigatorProps {
+    aboutConfig: AboutConfig;
+    legalProps: LegalScreenProps;
+    notificationTranslations: NotificationSettingsTranslations;
+    quietHoursTranslations: QuietHoursTranslations;
+}
+export declare const useSettingsScreens: (props: UseSettingsScreensProps) => StackScreen[];