@umituz/react-native-settings 5.3.37 → 5.3.38

package/dist/domains/legal/domain/entities/LegalConfig.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Legal Config
+ * Configuration for the Legal section
+ */
+export interface LegalConfig {
+    /** Section title */
+    title?: string;
+    /** Section description */
+    description?: string;
+    /** Navigation route name */
+    route?: string;
+    /** Default navigation route name */
+    defaultRoute?: string;
+    /** Privacy Policy title */
+    privacyTitle?: string;
+    /** Terms of Service title */
+    termsTitle?: string;
+    /** EULA title */
+    eulaTitle?: string;
+    /** Privacy Policy URL */
+    privacyUrl?: string;
+    /** Terms of Service URL */
+    termsUrl?: string;
+    /** EULA URL */
+    eulaUrl?: string;
+    /** Custom onPress handler (overrides navigation) */
+    onPress?: () => void;
+}

package/dist/domains/legal/domain/services/ContentValidationService.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Content Validation Service
+ * Single Responsibility: Validate content and URL requirements
+ * Extracted from screens to follow SOLID principles
+ */
+export declare class ContentValidationService {
+    /**
+     * Check if content is valid
+     */
+    static hasValidContent(content?: string, url?: string): boolean;
+    /**
+     * Check if URL section should be shown
+     */
+    static shouldShowUrlSection(url?: string, onUrlPress?: () => void): boolean;
+    /**
+     * Check if legal item should be shown
+     */
+    static shouldShowLegalItem(onPress?: () => void, title?: string): boolean;
+}

package/dist/domains/legal/domain/services/StyleCacheService.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Style Cache Service
+ * Single Responsibility: Manage style caching to prevent memory leaks
+ * Extracted from components to follow SOLID principles
+ */
+import type { DesignTokens } from "@umituz/react-native-design-system/theme";
+export interface StyleCacheOptions {
+    maxSize?: number;
+    cacheKey?: string;
+}
+export declare class StyleCacheService {
+    private static caches;
+    private static readonly DEFAULT_MAX_SIZE;
+    /**
+     * Get or create cached styles
+     */
+    static getCachedStyles<T>(cacheName: string, cacheKey: string, styleFactory: () => T, maxSize?: number): T;
+    /**
+     * Clear specific cache
+     */
+    static clearCache(cacheName: string): void;
+    /**
+     * Clear all caches
+     */
+    static clearAllCaches(): void;
+    /**
+     * Get cache size
+     */
+    static getCacheSize(cacheName: string): number;
+    /**
+     * Create cache key from design tokens
+     */
+    static createTokenCacheKey(tokens: DesignTokens, additionalKeys?: Record<string, any>): string;
+    /**
+     * Create simple cache key
+     */
+    static createSimpleCacheKey(key: string): string;
+}

package/dist/domains/legal/domain/services/UrlHandlerService.d.ts

@@ -0,0 +1,32 @@
+/**
+ * URL Handler Service
+ * Single Responsibility: Handle URL operations
+ * Extracted from screens to follow SOLID principles
+ * Performance optimized with caching and error handling
+ */
+export declare class UrlHandlerService {
+    /**
+     * Get Linking module - using static import for stability
+     */
+    private static getLinkingModule;
+    /**
+     * Clean cache to prevent memory leaks
+     */
+    private static cleanCache;
+    /**
+     * Validate URL format to prevent invalid operations
+     */
+    private static isValidUrl;
+    /**
+     * Open URL in external browser with performance optimizations
+     */
+    static openUrl(url: string): Promise<void>;
+    /**
+     * Check if URL can be opened with caching
+     */
+    static canOpenUrl(url: string): Promise<boolean>;
+    /**
+     * Clear all caches (useful for testing or memory cleanup)
+     */
+    static clearCache(): void;
+}

package/dist/domains/legal/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Legal Domain
+ * Terms, privacy policy, licenses
+ */
+export * from './presentation/screens/LegalScreen';
+export * from './presentation/screens/PrivacyPolicyScreen';
+export * from './presentation/screens/TermsOfServiceScreen';
+export { LegalContentScreen } from './presentation/screens/LegalContentScreen';

package/dist/domains/legal/presentation/components/LegalDocumentsList.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Legal Documents List Component
+ *
+ * Displays list of legal documents (Privacy, Terms, EULA).
+ */
+import React from "react";
+interface LegalDocumentsListProps {
+    documentsHeader?: string;
+    privacyTitle?: string;
+    privacyDescription?: string;
+    termsTitle?: string;
+    termsDescription?: string;
+    eulaTitle?: string;
+    eulaDescription?: string;
+    onPrivacyPress?: () => void;
+    onTermsPress?: () => void;
+    onEulaPress?: () => void;
+    eulaUrl?: string;
+}
+export declare const LegalDocumentsList: React.FC<LegalDocumentsListProps>;
+export {};

package/dist/domains/legal/presentation/components/LegalItem.d.ts

@@ -0,0 +1,35 @@
+/**
+ * LegalItem Component
+ *
+ * Single Responsibility: Display a single legal document item
+ * Reusable component for Privacy Policy, Terms of Service, and EULA items
+ */
+import React from "react";
+export interface LegalItemProps {
+    /**
+     * Icon name from theme library (Ionicons)
+     * If not provided, will use emoji icon
+     */
+    iconName?: string;
+    /**
+     * Icon emoji or text (fallback if iconName not provided)
+     */
+    icon?: string;
+    /**
+     * Title text
+     */
+    title: string;
+    /**
+     * Optional description text
+     */
+    description?: string;
+    /**
+     * Callback when item is pressed
+     */
+    onPress?: () => void;
+    /**
+     * Test ID for E2E testing
+     */
+    testID?: string;
+}
+export declare const LegalItem: React.FC<LegalItemProps>;

package/dist/domains/legal/presentation/components/LegalScreenHeader.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Legal Screen Header Component
+ *
+ * Displays title and description for legal screen.
+ */
+import React from "react";
+interface LegalScreenHeaderProps {
+    title?: string;
+    description?: string;
+}
+export declare const LegalScreenHeader: React.FC<LegalScreenHeaderProps>;
+export {};

package/dist/domains/legal/presentation/components/LegalSection.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import { ViewStyle } from 'react-native';
+import { LegalConfig } from '../../domain/entities/LegalConfig';
+export interface LegalSectionProps {
+    config?: LegalConfig;
+    onPress?: () => void;
+    containerStyle?: ViewStyle;
+    title?: string;
+    description?: string;
+    sectionTitle?: string;
+    noBackground?: boolean;
+    hideMargin?: boolean;
+}
+export declare const LegalSection: React.FC<LegalSectionProps>;

package/dist/domains/legal/presentation/screens/LegalContentScreen.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Base Legal Content Screen Component
+ * Shared logic for legal document screens
+ */
+import React from "react";
+import { StyleSheet } from "react-native";
+import { type DesignTokens } from "@umituz/react-native-design-system/theme";
+export interface LegalContentScreenProps {
+    content?: string;
+    url?: string;
+    title: string;
+    viewOnlineText?: string;
+    openText?: string;
+    onUrlPress?: () => void;
+    testID?: string;
+    styleCacheKey: string;
+    createStyles: (tokens: DesignTokens) => ReturnType<typeof StyleSheet.create>;
+}
+export declare const LegalContentScreen: React.FC<LegalContentScreenProps>;

package/dist/domains/legal/presentation/screens/LegalScreen.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Legal Screen Component
+ *
+ * Single Responsibility: Layout and orchestration of legal documents list
+ * Uses ScreenLayout from design system for consistent UI.
+ */
+import React from "react";
+export interface LegalScreenProps {
+    title?: string;
+    description?: string;
+    documentsHeader?: string;
+    privacyTitle?: string;
+    privacyDescription?: string;
+    termsTitle?: string;
+    termsDescription?: string;
+    eulaTitle?: string;
+    eulaDescription?: string;
+    onPrivacyPress?: () => void;
+    onTermsPress?: () => void;
+    onEulaPress?: () => void;
+    eulaUrl?: string;
+    testID?: string;
+}
+export declare const LegalScreen: React.FC<LegalScreenProps>;

package/dist/domains/legal/presentation/screens/PrivacyPolicyScreen.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Privacy Policy Screen Component
+ * Display Privacy Policy content
+ */
+import React from "react";
+export interface PrivacyPolicyScreenProps {
+    content?: string;
+    url?: string;
+    title: string;
+    viewOnlineText?: string;
+    openText?: string;
+    onUrlPress?: () => void;
+    testID?: string;
+}
+export declare const PrivacyPolicyScreen: React.FC<PrivacyPolicyScreenProps>;

package/dist/domains/legal/presentation/screens/TermsOfServiceScreen.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Terms of Service Screen Component
+ * Display Terms of Service content
+ */
+import React from "react";
+export interface TermsOfServiceScreenProps {
+    content?: string;
+    url?: string;
+    title: string;
+    viewOnlineText?: string;
+    openText?: string;
+    onUrlPress?: () => void;
+    testID?: string;
+}
+export declare const TermsOfServiceScreen: React.FC<TermsOfServiceScreenProps>;

package/dist/domains/localization/domain/repositories/ILocalizationRepository.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Localization Repository Interface
+ * Defines language configuration and types
+ */
+export interface Language {
+    code: string;
+    name: string;
+    nativeName: string;
+    flag?: string;
+    isRTL?: boolean;
+}
+export interface ILocalizationRepository {
+    getSupportedLanguages(): Language[];
+    getLanguageByCode(code: string): Language | undefined;
+    isLanguageSupported(code: string): boolean;
+}

package/dist/domains/localization/index.d.ts

@@ -0,0 +1,16 @@
+export { LocalizationManager } from './presentation/providers/LocalizationManager';
+export { useLocalization } from './infrastructure/hooks/useLocalization';
+export { useLocalizationStore } from './infrastructure/storage/LocalizationStore';
+export { useTranslationFunction } from './infrastructure/hooks/useTranslation';
+export { useLanguageSelection } from './infrastructure/hooks/useLanguageSelection';
+export { useLanguageSwitcher } from './infrastructure/components/useLanguageSwitcher';
+export { useLanguageNavigation } from './infrastructure/components/useLanguageNavigation';
+export { LanguageSwitcher } from './infrastructure/components/LanguageSwitcher';
+export { LanguageSelectionScreen } from './presentation/screens/LanguageSelectionScreen';
+export type { LanguageSelectionScreenProps } from './presentation/screens/LanguageSelectionScreen.types';
+export { LanguageSection } from './presentation/components/LanguageSection';
+export type { LanguageSectionProps, LanguageSectionConfig } from './presentation/components/LanguageSection';
+export { default as i18n } from './infrastructure/config/i18n';
+export { I18nInitializer } from './infrastructure/config/I18nInitializer';
+export { DEFAULT_LANGUAGE, getLanguageByCode, isLanguageSupported, getDefaultLanguage, getDeviceLocale, searchLanguages, } from './infrastructure/config/languages';
+export type { Language, ILocalizationRepository } from './domain/repositories/ILocalizationRepository';

package/dist/domains/localization/infrastructure/components/LanguageSwitcher.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Language Switcher Component
+ * Displays current language and allows switching
+ */
+import React from 'react';
+import { type StyleProp, type ViewStyle, type TextStyle } from 'react-native';
+export interface LanguageSwitcherProps {
+    showName?: boolean;
+    showFlag?: boolean;
+    color?: string;
+    onPress?: () => void;
+    style?: StyleProp<ViewStyle>;
+    textStyle?: StyleProp<TextStyle>;
+    iconStyle?: StyleProp<TextStyle>;
+    testID?: string;
+    disabled?: boolean;
+    accessibilityLabel?: string;
+}
+export declare const LanguageSwitcher: React.FC<LanguageSwitcherProps>;

package/dist/domains/localization/infrastructure/components/LanguageSwitcher.styles.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Language Switcher Component Styles
+ */
+export declare const styles: {
+    container: {
+        flexDirection: "row";
+        alignItems: "center";
+        gap: number;
+        paddingHorizontal: number;
+        paddingVertical: number;
+    };
+    disabled: {
+        opacity: number;
+    };
+    flag: {
+        fontSize: number;
+        textAlign: "center";
+    };
+    languageName: {
+        fontSize: number;
+        fontWeight: "600";
+        textAlign: "center";
+    };
+    icon: {
+        fontSize: number;
+        textAlign: "center";
+    };
+};
+export declare const DEFAULT_CONFIG_VALUES: {
+    hitSlop: {
+        readonly top: 10;
+        readonly bottom: 10;
+        readonly left: 10;
+        readonly right: 10;
+    };
+    activeOpacity: number;
+};

package/dist/domains/localization/infrastructure/components/useLanguageNavigation.d.ts

@@ -0,0 +1,4 @@
+export declare const useLanguageNavigation: (navigationScreen: string) => {
+    currentLang: import("../storage/types/Language").Language;
+    navigateToLanguageSelection: () => void;
+};

package/dist/domains/localization/infrastructure/components/useLanguageSwitcher.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Language Switcher Hook
+ * Manages the logic for the LanguageSwitcher component
+ */
+import type { Language } from '../storage/types/Language';
+export interface UseLanguageSwitcherProps {
+    onPress?: () => void;
+    disabled?: boolean;
+}
+export declare const useLanguageSwitcher: ({ onPress, disabled }: UseLanguageSwitcherProps) => {
+    currentLang: Language;
+    handlePress: () => void;
+};

package/dist/domains/localization/infrastructure/config/DeviceLocale.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Device Locale Detection
+ * Detects and maps device locale to supported language
+ */
+export declare const DEFAULT_LANGUAGE = "en-US";
+/**
+ * Get device locale and map it to supported language
+ * Called ONLY on first launch (when no saved language preference exists)
+ */
+export declare const getDeviceLocale: () => string;

package/dist/domains/localization/infrastructure/config/I18nInitializer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * i18n Initializer
+ *
+ * Namespace-based i18n configuration
+ * Usage: t('namespace:key') e.g., t('common:cancel')
+ */
+export declare class I18nInitializer {
+    private static reactI18nextInitialized;
+    static initialize(appTranslations: Record<string, any>, languageCode?: string): void;
+    /**
+     * Add translations at runtime
+     */
+    static addTranslations(languageCode: string, namespaceResources: Record<string, any>): void;
+}

package/dist/domains/localization/infrastructure/config/LanguageQuery.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Language Query Functions
+ * Provides functions to query and search languages
+ */
+import type { Language } from '../storage/types/Language';
+export declare const getSupportedLanguages: () => Language[];
+export declare const getLanguageByCode: (code: string) => Language | undefined;
+export declare const isLanguageSupported: (code: string) => boolean;
+export declare const getDefaultLanguage: () => Language;
+export declare const searchLanguages: (query: string) => Language[];

package/dist/domains/localization/infrastructure/config/LocaleMapping.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Locale Mapping Configuration
+ * Maps device locales to supported app locales
+ */
+export declare const LOCALE_MAPPING: Record<string, string>;

package/dist/domains/localization/infrastructure/config/NamespaceResolver.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Namespace Resolver
+ * Resolves available namespaces from translations
+ */
+export declare class NamespaceResolver {
+    /**
+     * Get all available namespaces from package and app translations
+     */
+    static getNamespaces(appTranslations: Record<string, any>, languageCode: string): string[];
+    static getDefaultNamespace(): string;
+}

package/dist/domains/localization/infrastructure/config/ResourceBuilder.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Resource Builder
+ * Builds i18n resources from package and app translations
+ */
+export declare class ResourceBuilder {
+    /**
+     * Build resources with package + app translations
+     */
+    static buildResources(appTranslations: Record<string, any>, languageCode: string): Record<string, Record<string, any>>;
+}

package/dist/domains/localization/infrastructure/config/TranslationLoader.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Translation Loader
+ *
+ * Loads package translations
+ */
+export declare class TranslationLoader {
+    /**
+     * Load package translations (empty by default - apps provide their own)
+     */
+    static loadPackageTranslations(): Record<string, Record<string, unknown>>;
+    /**
+     * Deep merge translations (override wins)
+     */
+    static mergeTranslations(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown>;
+    private static isObject;
+}

package/dist/domains/localization/infrastructure/config/constants/defaultLanguages.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Default Languages Configuration
+ * Applications can override this by providing their own language list
+ */
+import type { Language } from '../../storage/types/Language';
+export declare const DEFAULT_LANGUAGES: Language[];

package/dist/domains/localization/infrastructure/config/i18n.d.ts

@@ -0,0 +1,7 @@
+/**
+ * i18n Instance
+ *
+ * Raw i18n instance - use I18nInitializer for configuration
+ */
+import i18n from 'i18next';
+export default i18n;

package/dist/domains/localization/infrastructure/config/languages.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Languages Configuration - Main Export
+ * Central export point for all language-related functionality
+ */
+export { DEFAULT_LANGUAGE, getDeviceLocale } from './DeviceLocale';
+export { getSupportedLanguages, getLanguageByCode, isLanguageSupported, getDefaultLanguage, searchLanguages, } from './LanguageQuery';
+export { LOCALE_MAPPING } from './LocaleMapping';

package/dist/domains/localization/infrastructure/hooks/useLanguageSelection.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Language Selection Hook
+ * Manages language selection state and filtering with debounce
+ */
+export declare const useLanguageSelection: () => {
+    searchQuery: string;
+    setSearchQuery: import("react").Dispatch<import("react").SetStateAction<string>>;
+    selectedCode: string;
+    filteredLanguages: import("../storage/types/Language").Language[];
+    handleLanguageSelect: (code: string, onComplete?: () => void) => Promise<void>;
+};

package/dist/domains/localization/infrastructure/hooks/useLocalization.d.ts

@@ -0,0 +1,12 @@
+import type { Language } from '../../domain/repositories/ILocalizationRepository';
+export declare const useLocalization: () => {
+    t: (key: string, defaultValueOrOptions?: string | import("./useTranslation").TranslationOptions) => string;
+    currentLanguage: string;
+    currentLanguageObject: Language;
+    isRTL: boolean;
+    isInitialized: boolean;
+    setLanguage: (languageCode: string) => Promise<void>;
+    initialize: () => Promise<void>;
+    isLanguageSupported: (code: string) => boolean;
+    supportedLanguages: import("../storage/types/Language").Language[];
+};

package/dist/domains/localization/infrastructure/hooks/useTranslation.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Translation Hook
+ *
+ * Provides translation function with proper language change reactivity.
+ * Keys use dot notation only: "namespace.key.subkey"
+ * The first segment before the dot is the i18next namespace.
+ */
+export interface TranslationOptions {
+    count?: number;
+    ns?: string | string[];
+    defaultValue?: string;
+    [key: string]: unknown;
+}
+/**
+ * Hook for translation functionality.
+ * Uses react-i18next for automatic language change reactivity.
+ *
+ * Keys must use dot notation: t('namespace.key.subkey')
+ * The first segment is the i18next namespace: t('common.ok'), t('settings.title')
+ */
+export declare const useTranslationFunction: () => {
+    t: (key: string, defaultValueOrOptions?: string | TranslationOptions) => string;
+};

package/dist/domains/localization/infrastructure/repository/LanguageRepository.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Language Repository
+ * Manages language data with repository pattern
+ * Provides dynamic language management for multiple applications
+ */
+import type { Language } from '../storage/types/Language';
+declare class LanguageRepository {
+    private languages;
+    registerLanguages(languages: Language[]): void;
+    getLanguages(): Language[];
+    clearLanguages(): void;
+    getLanguageByCode(code: string): Language | undefined;
+    searchLanguages(query: string): Language[];
+    isLanguageSupported(code: string): boolean;
+    getDefaultLanguage(): Language;
+}
+export declare const languageRepository: LanguageRepository;
+export {};

package/dist/domains/localization/infrastructure/storage/LanguageInitializer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Language Initializer
+ *
+ * Handles the initialization of localization system
+ * - Device locale detection
+ * - Language validation and fallback
+ * - i18n setup
+ */
+export declare class LanguageInitializer {
+    /**
+     * Initialize localization system
+     */
+    static initialize(): Promise<{
+        languageCode: string;
+        isRTL: boolean;
+    }>;
+    private static determineLanguageCode;
+    private static validateAndSetupLanguage;
+    private static setupFallbackLanguage;
+}

package/dist/domains/localization/infrastructure/storage/LanguageSwitcher.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Language Switcher
+ *
+ * Handles switching between languages
+ * - Language validation
+ * - Persistence
+ */
+export declare class LanguageSwitcher {
+    /**
+     * Switch to a new language
+     */
+    static switchLanguage(languageCode: string): Promise<{
+        languageCode: string;
+        isRTL: boolean;
+    }>;
+}

package/dist/domains/localization/infrastructure/storage/LocalizationStore.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Localization Store
+ * Manages localization state using createStore pattern for consistency
+ */
+import type { LocalizationState, LocalizationActions, LocalizationGetters } from "./types/LocalizationState";
+export declare const useLocalizationStore: import("zustand").UseBoundStore<import("zustand").StoreApi<LocalizationState & LocalizationActions & LocalizationGetters>>;