@umituz/react-native-settings 5.3.30 → 5.3.32

package/dist/account.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @umituz/react-native-settings/account
+ *
+ * Subpath export for apps that use @umituz/react-native-auth.
+ * Import auth-dependent hooks and components from here.
+ *
+ * Usage:
+ *   import {
+ *     useSettingsScreenConfigWithAuth,
+ *     AccountScreen,
+ *     ProfileSection,
+ *   } from '@umituz/react-native-settings/account';
+ *
+ *   // Pass AccountScreen and ProfileSection as props to SettingsStackNavigator:
+ *   <SettingsStackNavigator
+ *     AccountScreenComponent={AccountScreen}
+ *     ProfileSectionComponent={ProfileSection}
+ *     ...
+ *   />
+ */
+export { AccountScreen, ProfileSection } from "@umituz/react-native-auth";
+export { useAuth, useUserProfile, useAuthHandlers } from "@umituz/react-native-auth";
+export type { AccountScreenConfig } from "@umituz/react-native-auth";
+export { useSettingsScreenConfig } from './presentation/hooks/useSettingsScreenConfig';
+export { useSettingsScreenConfig as useSettingsScreenConfigWithAuth } from './presentation/hooks/useSettingsScreenConfig';
+export type { UseSettingsScreenConfigParams, SettingsScreenConfigResult, SettingsFeatures, } from './presentation/hooks/useSettingsScreenConfig';
+export type { AccountConfig } from './presentation/navigation/types';

package/dist/application/ports/ISettingsRepository.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Settings Repository Interface and Types
+ *
+ * Defines the contract for settings storage operations
+ * and the core types used throughout the settings domain.
+ */
+/**
+ * User settings data structure
+ */
+export interface UserSettings {
+    userId: string;
+    theme: 'light' | 'dark' | 'auto';
+    language: string;
+    notificationsEnabled: boolean;
+    emailNotifications: boolean;
+    pushNotifications: boolean;
+    soundEnabled: boolean;
+    vibrationEnabled: boolean;
+    privacyMode: boolean;
+    disclaimerAccepted: boolean;
+    updatedAt: Date;
+}
+/**
+ * Settings operation result
+ */
+export interface SettingsResult<T> {
+    success: boolean;
+    data?: T;
+    error?: SettingsError;
+}
+/**
+ * Settings error types
+ */
+export interface SettingsError {
+    code: string;
+    message: string;
+}
+/**
+ * Settings repository interface
+ */
+export interface ISettingsRepository {
+    getSettings(userId: string): Promise<SettingsResult<UserSettings>>;
+    saveSettings(settings: UserSettings): Promise<SettingsResult<void>>;
+    deleteSettings(userId: string): Promise<SettingsResult<void>>;
+}

package/dist/domains/about/domain/entities/AppInfo.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Domain Entity - Application Information
+ * Pure business logic, no external dependencies
+ * Part of About Domain
+ */
+export interface AppInfo {
+    /** Application name */
+    name: string;
+    /** Application version (semver format) */
+    version: string;
+    /** Application description */
+    description?: string;
+    /** Developer/Company name */
+    developer?: string;
+    /** Contact email */
+    contactEmail?: string;
+    /** Website URL */
+    websiteUrl?: string;
+    /** Website display text */
+    websiteDisplay?: string;
+    /** More apps URL */
+    moreAppsUrl?: string;
+}
+/**
+ * Configuration interface for About component
+ * Fully configurable by parent application
+ */
+export interface AboutConfig {
+    /** Application information */
+    appInfo?: Partial<AppInfo>;
+    /** Custom theme colors */
+    theme?: {
+        primary?: string;
+        secondary?: string;
+        background?: string;
+        text?: string;
+        border?: string;
+    };
+    /** Custom styling options */
+    style?: {
+        containerStyle?: Record<string, unknown>;
+        itemStyle?: Record<string, unknown>;
+        textStyle?: Record<string, unknown>;
+        iconStyle?: Record<string, unknown>;
+    };
+    /** Custom actions */
+    actions?: {
+        onWebsitePress?: () => void;
+        onEmailPress?: () => void;
+        onMoreAppsPress?: () => void;
+    };
+    /** Localized texts for section headers and labels */
+    texts?: {
+        title?: string;
+        contact?: string;
+        more?: string;
+        developer?: string;
+        email?: string;
+        website?: string;
+        moreApps?: string;
+        loading?: string;
+        errorPrefix?: string;
+        noInfo?: string;
+        versionPrefix?: string;
+    };
+    /** Navigation route name */
+    route?: string;
+    /** Default navigation route name */
+    defaultRoute?: string;
+    /** Section title */
+    title?: string;
+    /** Section description */
+    description?: string;
+    /** Custom onPress handler (overrides navigation) */
+    onPress?: () => void;
+}

package/dist/domains/about/domain/repositories/IAboutRepository.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Repository interface for About data
+ * Defines contract for data access layer
+ */
+import { AppInfo } from '../entities/AppInfo';
+export interface IAboutRepository {
+    /**
+     * Get application information
+     */
+    getAppInfo(): Promise<AppInfo>;
+    /**
+     * Save application information
+     */
+    saveAppInfo(appInfo: AppInfo): Promise<void>;
+    /**
+     * Update application information
+     */
+    updateAppInfo(updates: Partial<AppInfo>): Promise<AppInfo>;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * About Domain
+ * User information, app details, version info
+ */
+export * from './presentation/screens/AboutScreen';
+export * from './presentation/components/AboutContent';
+export * from './presentation/components/AboutSection';
+export * from './presentation/components/AboutSettingItem';
+export * from './presentation/components/AboutHeader';
+export * from './domain/entities/AppInfo';

package/dist/domains/about/infrastructure/repositories/AboutRepository.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Repository implementation for About data
+ * Handles data persistence and retrieval
+ * Optimized for performance and memory safety
+ */
+import { AppInfo } from '../../domain/entities/AppInfo';
+import { IAboutRepository } from '../../domain/repositories/IAboutRepository';
+export declare class AboutRepository implements IAboutRepository {
+    private appInfo;
+    private isDestroyed;
+    getAppInfo(): Promise<AppInfo>;
+    saveAppInfo(appInfo: AppInfo): Promise<void>;
+    updateAppInfo(updates: Partial<AppInfo>): Promise<AppInfo>;
+    /**
+     * Cleanup method to prevent memory leaks
+     */
+    destroy(): void;
+}

package/dist/domains/about/presentation/components/AboutContent.d.ts

@@ -0,0 +1,14 @@
+/**
+ * About Content Component
+ * Displays the list of about items organized in sections
+ */
+import React from 'react';
+import { AppInfo } from '../../domain/entities/AppInfo';
+import { AboutConfig } from '../../domain/entities/AppInfo';
+export interface AboutContentProps {
+    /** App information to display */
+    appInfo: AppInfo;
+    /** Configuration for actions */
+    config: AboutConfig;
+}
+export declare const AboutContent: React.FC<AboutContentProps>;

package/dist/domains/about/presentation/components/AboutHeader.d.ts

@@ -0,0 +1,21 @@
+/**
+ * About Header Component
+ * Displays app name, version, and description
+ */
+import React from 'react';
+import { ViewStyle, TextStyle } from 'react-native';
+import { AppInfo } from '../../domain/entities/AppInfo';
+export interface AboutHeaderProps {
+    /** App information to display */
+    appInfo: AppInfo;
+    /** Custom container style */
+    containerStyle?: ViewStyle;
+    /** Custom title style */
+    titleStyle?: TextStyle;
+    /** Custom version style */
+    versionStyle?: TextStyle;
+    descriptionStyle?: TextStyle;
+    versionPrefix?: string;
+    testID?: string;
+}
+export declare const AboutHeader: React.FC<AboutHeaderProps>;

package/dist/domains/about/presentation/components/AboutSection.d.ts

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

package/dist/domains/about/presentation/components/AboutSettingItem.d.ts

@@ -0,0 +1,39 @@
+/**
+ * About Setting Item Component
+ * Reusable setting item for about screen
+ * Fully configurable and generic
+ * Optimized for performance and memory safety
+ */
+import React from 'react';
+import { ViewStyle, TextStyle } from 'react-native';
+export interface AboutSettingItemProps {
+    /** Icon component (any React component) */
+    icon?: React.ReactNode;
+    /** Main title text */
+    title: string;
+    /** Optional description text */
+    description?: string;
+    /** Optional value to display on the right */
+    value?: string;
+    /** Callback when pressed */
+    onPress?: () => void;
+    /** Show chevron arrow on right */
+    showChevron?: boolean;
+    /** Custom container style */
+    containerStyle?: ViewStyle;
+    /** Custom title style */
+    titleStyle?: TextStyle;
+    /** Custom description style */
+    descriptionStyle?: TextStyle;
+    /** Custom value style */
+    valueStyle?: TextStyle;
+    /** Custom icon container style */
+    iconContainerStyle?: ViewStyle;
+    /** Make item look disabled */
+    disabled?: boolean;
+    /** Test ID for E2E testing */
+    testID?: string;
+    /** Custom chevron color */
+    chevronColor?: string;
+}
+export declare const AboutSettingItem: React.FC<AboutSettingItemProps>;

package/dist/domains/about/presentation/hooks/useAboutInfo.d.ts

@@ -0,0 +1,2 @@
+import type { UseAboutInfoOptions, UseAboutInfoReturn } from './useAboutInfo.types';
+export declare const useAboutInfo: (options?: UseAboutInfoOptions) => UseAboutInfoReturn;

package/dist/domains/about/presentation/hooks/useAboutInfo.types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * useAboutInfo Hook Types
+ * Type definitions for about info hook
+ */
+import type { AppInfo, AboutConfig } from '../../domain/entities/AppInfo';
+export interface UseAboutInfoOptions {
+    /** Initial configuration */
+    initialConfig?: AboutConfig;
+    /** Auto-initialize on mount */
+    autoInit?: boolean;
+}
+export interface UseAboutInfoReturn {
+    /** Current app info */
+    appInfo: AppInfo | null;
+    /** Loading state */
+    loading: boolean;
+    /** Error state */
+    error: string | null;
+    /** Initialize with config */
+    initialize: (config: AboutConfig) => Promise<void>;
+    /** Update with new config */
+    update: (config: AboutConfig) => Promise<void>;
+    /** Update app info */
+    updateAppInfo: (updates: Partial<AppInfo>) => Promise<void>;
+    /** Refresh current app info */
+    refresh: () => Promise<void>;
+    /** Reset to initial state */
+    reset: () => void;
+}

package/dist/domains/about/presentation/screens/AboutScreen.d.ts

@@ -0,0 +1,21 @@
+export interface AboutScreenProps {
+    /** Configuration for the about screen */
+    config: import('../../domain/entities/AppInfo').AboutConfig;
+    /** Custom container style */
+    containerStyle?: import('react-native').ViewStyle;
+    /** Custom header style */
+    headerStyle?: import('react-native').ViewStyle;
+    /** Custom title style */
+    titleStyle?: import('react-native').TextStyle;
+    /** Custom version style */
+    versionStyle?: import('react-native').TextStyle;
+    /** Show app header with name and version */
+    showHeader?: boolean;
+    /** Custom header component */
+    headerComponent?: React.ReactNode;
+    /** Custom footer component */
+    footerComponent?: React.ReactNode;
+    /** Test ID for E2E testing */
+    testID?: string;
+}
+export declare const AboutScreen: React.FC<AboutScreenProps>;

package/dist/domains/about/presentation/screens/AboutScreenContent.d.ts

@@ -0,0 +1,15 @@
+/**
+ * AboutScreen Content Component
+ * Pure presentational component for About screen
+ * No business logic, only rendering
+ */
+import React from 'react';
+import { AboutConfig, AppInfo } from '../../domain/entities/AppInfo';
+import type { DesignTokens } from '@umituz/react-native-design-system/theme';
+import type { AboutScreenProps } from './AboutScreen';
+export interface AboutScreenContentProps extends Omit<AboutScreenProps, 'config'> {
+    appInfo: AppInfo;
+    config: AboutConfig;
+    _tokens: DesignTokens;
+}
+export declare const AboutScreenContent: React.FC<AboutScreenContentProps>;

package/dist/domains/about/utils/AppInfoFactory.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AppInfo Factory Utility
+ * Creates AppInfo objects from AboutConfig
+ */
+import { AppInfo, AboutConfig } from '../domain/entities/AppInfo';
+/**
+ * Creates a default AppInfo object from AboutConfig
+ */
+export declare const createDefaultAppInfo: (config: AboutConfig) => AppInfo;

package/dist/domains/appearance/data/colorPalettes.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Dynamic Color Palettes
+ *
+ * Generic color palettes that can be customized by host applications
+ * These serve as sensible defaults for appearance customization
+ */
+export interface ColorPalette {
+    name: string;
+    colors: string[];
+}
+/**
+ * Generic primary color palette
+ * Suitable for most applications
+ */
+export declare const DEFAULT_PRIMARY_COLORS: ColorPalette;
+/**
+ * Generic secondary color palette
+ * Neutral colors for secondary elements
+ */
+export declare const DEFAULT_SECONDARY_COLORS: ColorPalette;
+/**
+ * Generic accent color palette
+ * Vibrant colors for accent elements
+ */
+export declare const DEFAULT_ACCENT_COLORS: ColorPalette;

package/dist/domains/appearance/hooks/useAppearance.d.ts

@@ -0,0 +1,11 @@
+import { type CustomThemeColors } from "@umituz/react-native-design-system/theme";
+import type { ThemeMode } from "../types";
+export declare const useAppearance: () => {
+    themeMode: ThemeMode;
+    customColors: CustomThemeColors;
+    defaultColors: CustomThemeColors;
+    isLoading: boolean;
+    setThemeMode: (mode: ThemeMode) => void;
+    setCustomColors: (colors: CustomThemeColors) => void;
+    reset: () => void;
+};

package/dist/domains/appearance/hooks/useAppearanceActions.d.ts

@@ -0,0 +1,9 @@
+import type { CustomThemeColors } from "@umituz/react-native-design-system/theme";
+import type { ThemeMode } from "../types";
+export declare const useAppearanceActions: () => {
+    themeMode: ThemeMode;
+    localCustomColors: CustomThemeColors;
+    handleThemeSelect: (mode: ThemeMode) => void;
+    handleColorChange: (key: keyof CustomThemeColors, color: string) => void;
+    handleResetColors: () => void;
+};

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

@@ -0,0 +1,9 @@
+/**
+ * Appearance Domain
+ * Theme management, dark mode
+ */
+export * from './presentation/screens/AppearanceScreen';
+export * from './presentation/components';
+export { useAppearance } from './hooks/useAppearance';
+export { useAppearanceActions } from './hooks/useAppearanceActions';
+export * from './types';

package/dist/domains/appearance/presentation/components/AppearanceHeader.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Appearance Header Component
+ * Single Responsibility: Render appearance screen header
+ */
+import React from "react";
+import { type StyleProp, type ViewStyle } from "react-native";
+import type { DesignTokens } from "@umituz/react-native-design-system/theme";
+export interface AppearanceHeaderProps {
+    tokens: DesignTokens;
+    title?: string;
+    subtitle?: string;
+    titleType?: "headlineLarge" | "headlineMedium" | "headlineSmall";
+    subtitleType?: "bodyLarge" | "bodyMedium" | "bodySmall";
+    titleColor?: "primary" | "secondary" | "tertiary";
+    subtitleColor?: "primary" | "secondary" | "tertiary";
+    style?: StyleProp<ViewStyle>;
+}
+export declare const AppearanceHeader: React.FC<AppearanceHeaderProps>;

package/dist/domains/appearance/presentation/components/AppearancePreview.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Appearance Preview Component
+ * Single Responsibility: Render color preview section
+ */
+import React from "react";
+import type { DesignTokens } from "@umituz/react-native-design-system/theme";
+import type { CustomThemeColors } from "../../types";
+export interface PreviewColorItem {
+    key: keyof CustomThemeColors;
+    label: string;
+    fallbackColor: string;
+}
+export interface AppearancePreviewProps {
+    tokens: DesignTokens;
+    localCustomColors: CustomThemeColors;
+    title?: string;
+    description?: string;
+    previewColors?: PreviewColorItem[];
+    showPreview?: boolean;
+}
+export declare const AppearancePreview: React.FC<AppearancePreviewProps>;

package/dist/domains/appearance/presentation/components/AppearanceSection.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { ViewStyle } from 'react-native';
+import { AppearanceSectionConfig } from '../../types';
+export interface AppearanceSectionProps {
+    config?: AppearanceSectionConfig;
+    onPress?: () => void;
+    containerStyle?: ViewStyle;
+    sectionTitle?: string;
+    /** Optional explicit title override */
+    title?: string;
+    /** Optional explicit description override */
+    description?: string;
+    noBackground?: boolean;
+    hideMargin?: boolean;
+}
+export declare const AppearanceSection: React.FC<AppearanceSectionProps>;

package/dist/domains/appearance/presentation/components/ColorPicker.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Color Picker Component
+ *
+ * Simple color picker for theme customization
+ * Single Responsibility: Render color selection UI
+ */
+import React from "react";
+interface ColorPickerProps {
+    label: string;
+    value: string;
+    onValueChange: (color: string) => void;
+    colors: string[];
+}
+export declare const ColorPicker: React.FC<ColorPickerProps>;
+export {};

package/dist/domains/appearance/presentation/components/CustomColorsSection.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Custom Colors Section Component
+ * Single Responsibility: Render custom color picker section
+ */
+import React from "react";
+import type { DesignTokens } from "@umituz/react-native-design-system/theme";
+import type { CustomThemeColors } from "../../types";
+export interface ColorFieldConfig {
+    key: keyof CustomThemeColors;
+    label: string;
+    defaultColor: string;
+    colorPalette: string[];
+}
+export interface CustomColorsSectionProps {
+    tokens: DesignTokens;
+    localCustomColors: CustomThemeColors;
+    onColorChange: (key: keyof CustomThemeColors, color: string) => void;
+    onResetColors: () => void;
+    title?: string;
+    description?: string;
+    resetButtonText?: string;
+    colorFields?: ColorFieldConfig[];
+    showResetButton?: boolean;
+}
+export declare const CustomColorsSection: React.FC<CustomColorsSectionProps>;

package/dist/domains/appearance/presentation/components/ThemeModeSection.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Theme Mode Section Component
+ * Single Responsibility: Render theme mode selection section
+ */
+import React from "react";
+import type { DesignTokens } from "@umituz/react-native-design-system/theme";
+import type { ThemeMode } from "../../types";
+export interface ThemeOptionConfig {
+    mode: ThemeMode;
+    title: string;
+    subtitle?: string;
+    description?: string;
+    features?: string[];
+    featuresTitle?: string;
+}
+export interface ThemeModeSectionProps {
+    tokens: DesignTokens;
+    themeMode: ThemeMode;
+    onThemeSelect: (mode: ThemeMode) => void;
+    title?: string;
+    description?: string;
+    themes?: ThemeOptionConfig[];
+}
+export declare const ThemeModeSection: React.FC<ThemeModeSectionProps>;

package/dist/domains/appearance/presentation/components/ThemeOption.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Theme Option Component
+ *
+ * Theme mode selection option (Light/Dark)
+ * Single Responsibility: Render theme option UI
+ */
+import React from "react";
+import type { ThemeMode } from "../../types";
+interface ThemeOptionProps {
+    mode: ThemeMode;
+    title: string;
+    subtitle?: string;
+    description?: string;
+    features?: string[];
+    featuresTitle?: string;
+    isSelected: boolean;
+    onSelect: () => void;
+}
+export declare const ThemeOption: React.FC<ThemeOptionProps>;
+export {};

package/dist/domains/appearance/presentation/components/index.d.ts

@@ -0,0 +1,6 @@
+export { ThemeOption } from "./ThemeOption";
+export { ColorPicker } from "./ColorPicker";
+export { AppearanceHeader } from "./AppearanceHeader";
+export { ThemeModeSection, type ThemeOptionConfig } from "./ThemeModeSection";
+export { CustomColorsSection, type ColorFieldConfig } from "./CustomColorsSection";
+export { AppearancePreview, type PreviewColorItem } from "./AppearancePreview";

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

@@ -0,0 +1,16 @@
+/**
+ * Appearance Screen
+ *
+ * Screen for managing appearance settings including theme mode and custom colors.
+ * Uses ScreenLayout from design system for consistent UI.
+ */
+import React from "react";
+import type { AppearanceTexts } from "../../types";
+export interface AppearanceScreenProps {
+    texts?: AppearanceTexts;
+    headerComponent?: React.ReactNode;
+    showThemeSection?: boolean;
+    showColorsSection?: boolean;
+    showPreviewSection?: boolean;
+}
+export declare const AppearanceScreen: React.FC<AppearanceScreenProps>;

package/dist/domains/appearance/types/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Appearance Domain Types
+ *
+ * Types for appearance settings including theme mode and custom colors
+ */
+import type { ThemeMode as BaseThemeMode, CustomThemeColors } from "@umituz/react-native-design-system/theme";
+export type ThemeMode = BaseThemeMode | 'auto';
+export type { CustomThemeColors };
+export interface AppearanceSettings {
+    themeMode: ThemeMode;
+    customColors?: CustomThemeColors;
+}
+export interface AppearanceState {
+    settings: AppearanceSettings;
+    isInitialized: boolean;
+}
+export interface AppearanceSectionConfig {
+    /** Section title */
+    title?: string;
+    /** Section description/value */
+    description?: string;
+    /** Navigation route name */
+    route?: string;
+    /** Default navigation route name */
+    defaultRoute?: string;
+    /** Custom onPress handler (overrides navigation) */
+    onPress?: () => void;
+}
+export interface ThemeModeTextConfig {
+    title: string;
+    subtitle?: string;
+    description?: string;
+    features: string[];
+}
+export interface AppearanceTexts {
+    title?: string;
+    subtitle?: string;
+    themeSectionTitle?: string;
+    themeSectionDescription?: string;
+    featuresSectionTitle?: string;
+    colorsSectionTitle?: string;
+    colorsSectionDescription?: string;
+    previewSectionTitle?: string;
+    previewSectionDescription?: string;
+    resetButtonText?: string;
+    lightMode?: ThemeModeTextConfig;
+    darkMode?: ThemeModeTextConfig;
+}