@umituz/react-native-settings 5.3.34 → 5.3.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-settings",
-  "version": "5.3.34",
+  "version": "5.3.36",
   "description": "Complete settings hub for React Native apps - consolidated package with settings, localization, about, legal, appearance, feedback, FAQs, rating, and gamification",
   "main": "./src/index.ts",
   "types": "./dist/index.d.ts",
@@ -154,7 +154,7 @@
     "@tanstack/query-async-storage-persister": "^5.66.7",
     "@tanstack/react-query": "^5.0.0",
     "@tanstack/react-query-persist-client": "^5.66.7",
-    "@types/react": "~19.0.0",
+    "@types/react": "^19.1.0",
     "@typescript-eslint/eslint-plugin": "^7.18.0",
     "@typescript-eslint/parser": "^7.18.0",
     "@umituz/react-native-auth": "^4.3.39",

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Ümit UZ
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,355 +0,0 @@
-# @umituz/react-native-settings
-
-Comprehensive settings management for React Native apps with modular domain-based architecture.
-
-## Purpose
-
-Complete settings solution with pre-built screens, components, and state management for React Native applications.
-
-## File Path
-
-Main package entry: `src/index.ts`
-
-## Installation
-
-```bash
-npm install @umituz/react-native-settings
-```
-
-## Peer Dependencies
-
-Required packages (check package.json for versions):
-- zustand
-- @umituz/react-native-storage
-- @umituz/react-native-design-system
-- @umituz/react-native-localization
-- @react-navigation/native
-- @react-navigation/stack
-- react-native-safe-area-context
-
-## Strategy
-
-### Package Architecture
-
-The package follows Domain-Driven Design (DDD) with four layers:
-
-1. **Domain Layer**: Business logic and entities
-2. **Application Layer**: Interfaces and orchestration
-3. **Infrastructure Layer**: Data persistence
-4. **Presentation Layer**: UI components and screens
-
-### Integration Approach
-
-1. Import components from `@umituz/react-native-settings`
-2. Use pre-built screens for standard settings
-3. Customize via configuration objects
-4. Extend with custom sections when needed
-5. Follow design system for consistency
-
-### Domain Structure
-
-Each feature domain is self-contained:
-- `about/`: App information and version
-- `appearance/`: Theme and color management
-- `legal/`: Legal documents and policies
-- `disclaimer/`: Legal notices and warnings
-- `feedback/`: User feedback collection
-- `faqs/`: FAQ management
-- `rating/`: Rating system
-- `video-tutorials/`: Video tutorials
-- `cloud-sync/`: Cloud synchronization
-- `dev/`: Development utilities
-
-## Restrictions (Forbidden)
-
-### ❌ DO NOT
-
-- Create custom settings screens from scratch
-- Duplicate existing component functionality
-- Mix settings logic with business logic
-- Hardcode feature availability
-- Bypass feature detection system
-- Access storage repositories directly from UI
-- Create custom settings item components
-- Ignore design system tokens
-- Mix UI and data layers inappropriately
-
-### ❌ NEVER
-
-- Modify internal package files
-- Override core component behavior
-- Skip type checking
-- Use deprecated APIs
-- Ignore accessibility requirements
-- Bypass error boundaries
-- Hardcode colors or spacing
-- Create circular dependencies between layers
-
-### ❌ AVOID
-
-- Over-complicating configuration
-- Creating one-off solutions
-- Inconsistent styling
-- Skipping proper error handling
-- Not testing on both platforms
-- Ignoring performance optimization
-- Bypassing TypeScript strict mode
-
-## Rules
-
-### ✅ ALWAYS
-
-- Use TypeScript strict mode
-- Import from package exports
-- Follow component documentation strategies
-- Reference implementation files for current patterns
-- Use design system tokens for styling
-- Handle errors gracefully
-- Support both iOS and Android
-- Include proper accessibility labels
-- Test with feature flags
-- Follow DDD layer separation
-
-### ✅ MUST
-
-- Use SettingsScreen for main settings UI
-- Use SettingsItemCard for all settings items
-- Normalize configuration before use
-- Handle loading and error states
-- Provide proper TypeScript types
-- Export types for reuse
-- Follow naming conventions
-- Document custom components
-- Test all new features
-- Maintain backward compatibility
-
-### ✅ SHOULD
-
-- Use auto-detection for features
-- Group related settings together
-- Provide meaningful section titles
-- Support both modal and push navigation
-- Include user profile for authenticated users
-- Add custom sections via config
-- Use feature flags appropriately
-- Optimize performance with memoization
-- Follow AI agent guidelines
-- Keep documentation up to date
-
-## Component Reference
-
-### Main Components
-
-File: `src/index.ts`
-
-**Screens:**
-- `SettingsScreen`: Main settings screen
-  - Implementation: `src/presentation/screens/SettingsScreen.tsx`
-  - Documentation: `SETTINGS_SCREEN_GUIDE.md`
-
-**Components:**
-- `SettingsItemCard`: Reusable settings item
-  - Implementation: `src/presentation/components/SettingsItemCard/SettingsItemCard.tsx`
-  - Strategy: `src/presentation/components/SettingsItemCard/STRATEGY.md`
-
-- `SettingsSection`: Section container
-  - Implementation: `src/presentation/components/SettingsSection/SettingsSection.tsx`
-
-- `SettingsContent`: Content composer
-  - Implementation: `src/presentation/screens/components/SettingsContent/SettingsContent.tsx`
-
-**Hooks:**
-- `useSettings`: Main settings hook
-  - Implementation: `src/presentation/hooks/useSettings.ts`
-
-- `useFeatureDetection`: Feature detection
-  - Implementation: `src/presentation/screens/hooks/useFeatureDetection.ts`
-
-### Domain Components
-
-Each domain has its own components:
-
-**Appearance:**
-- Screen: `src/domains/appearance/presentation/screens/AppearanceScreen.tsx`
-- Components: `src/domains/appearance/presentation/components/`
-- Hooks: `src/domains/appearance/hooks/`
-
-**About:**
-- Screen: `src/domains/about/presentation/screens/AboutScreen.tsx`
-- Components: `src/domains/about/presentation/components/`
-- Hooks: `src/domains/about/presentation/hooks/`
-
-**Other Domains:**
-- Legal: `src/domains/legal/`
-- Disclaimer: `src/domains/disclaimer/`
-- Feedback: `src/domains/feedback/`
-- FAQs: `src/domains/faqs/`
-- Rating: `src/domains/rating/`
-- Video Tutorials: `src/domains/video-tutorials/`
-- Cloud Sync: `src/domains/cloud-sync/`
-- Dev: `src/domains/dev/`
-
-## Configuration
-
-### Settings Configuration
-
-Type definition: `src/presentation/screens/types/SettingsConfig.ts`
-
-Configuration structure:
-- `appearance`: Theme settings
-- `language`: Language selection
-- `notifications`: Notification preferences
-- `about`: App information
-- `legal`: Legal documents
-- `disclaimer`: Legal notices
-- `userProfile`: User profile display
-- `feedback`: Feedback system
-- `rating`: Rating feature
-- `faqs`: FAQ access
-- `subscription`: Subscription/upgrade
-- `wallet`: Wallet/payment
-- `customSections`: App-specific sections
-
-### Feature Flags
-
-Use feature flags to control visibility:
-- `true`: Always show feature
-- `false`: Never show feature
-- `'auto'`: Auto-detect based on navigation
-
-## AI Agent Guidelines
-
-### When Implementing Settings
-
-1. **Read Strategy Documentation First**
-   - Check `STRATEGY.md` files in component directories
-   - Review `AI_AGENT_GUIDELINES.md`
-   - Understand restrictions and rules
-
-2. **Reference Implementation Files**
-   - Check file paths in documentation
-   - Look at similar existing implementations
-   - Follow established patterns
-
-3. **No Code Examples**
-   - Documentation contains strategy, not syntax
-   - Reference implementation files directly
-   - File paths stay valid when code changes
-
-4. **Follow Component Structure**
-   - Use existing components from package
-   - Don't recreate what already exists
-   - Extend via configuration, not modification
-
-5. **Check Restrictions Before Coding**
-   - Review what's forbidden
-   - Verify rules to follow
-   - Ask if unclear
-
-### Common Patterns
-
-**Adding Settings Screen:**
-Reference: `SETTINGS_SCREEN_GUIDE.md`
-- Use SettingsScreen component
-- Configure via SettingsConfig
-- Don't build from scratch
-
-**Adding Settings Item:**
-Reference: `src/presentation/components/SettingsItemCard/STRATEGY.md`
-- Use SettingsItemCard component
-- Follow props interface
-- Don't create custom items
-
-**Adding Domain Feature:**
-Reference: Similar domain README
-- Follow domain structure
-- Implement required layers
-- Document with strategy format
-
-## Documentation Structure
-
-### Key Documentation Files
-
-- `README.md`: This file - package overview
-- `DOCUMENTATION_TEMPLATE.md`: Template for new docs
-- `AI_AGENT_GUIDELINES.md`: AI coding guidelines
-- `SETTINGS_SCREEN_GUIDE.md`: Screen strategy
-- `ARCHITECTURE.md`: Architecture overview
-- `TESTING.md`: Testing guide
-
-### Domain Documentation
-
-Each domain has README.md with:
-- Purpose and file paths
-- Strategy for usage
-- Restrictions (what not to do)
-- Rules (what must be done)
-- Component references
-- AI agent guidelines
-
-### Component Documentation
-
-Each component directory may contain:
-- `README.md`: Component reference
-- `STRATEGY.md`: Detailed strategy guide
-- Implementation file with TypeScript types
-
-## Quick Reference
-
-### Import Patterns
-
-```typescript
-// From package
-import { ComponentName } from '@umituz/react-native-settings';
-
-// Types
-import type { SettingsConfig, UserProfile } from '@umituz/react-native-settings';
-```
-
-### File Locations
-
-```
-src/
-├── domains/              # Feature domains
-│   ├── about/
-│   ├── appearance/
-│   ├── legal/
-│   └── ...
-├── presentation/         # UI layer
-│   ├── components/       # Shared components
-│   ├── screens/          # Screens
-│   ├── hooks/            # Hooks
-│   └── navigation/       # Navigation
-├── application/          # Interfaces
-├── infrastructure/       # Data layer
-└── index.ts             # Package exports
-```
-
-## Related Documentation
-
-### Core Documentation
-- **Architecture**: `ARCHITECTURE.md`
-- **Testing**: `TESTING.md`
-- **AI Guidelines**: `AI_AGENT_GUIDELINES.md`
-- **Settings Screen**: `SETTINGS_SCREEN_GUIDE.md`
-- **Documentation Template**: `DOCUMENTATION_TEMPLATE.md`
-- **Migration**: `DOCUMENTATION_MIGRATION.md`
-
-### Community
-- **Contributing**: `CONTRIBUTING.md`
-- **Code of Conduct**: `CODE_OF_CONDUCT.md`
-- **Security**: `SECURITY.md`
-- **Changelog**: `CHANGELOG.md`
-
-### Component Documentation
-- **Domain READMEs**: Check individual domain directories
-- **Component Strategies**: Check component STRATEGY.md files
-- **Component READMEs**: Check component directories
-
-## License
-
-MIT
-
-## Version History
-
-See package.json for version information.

package/dist/account.d.ts

@@ -1,27 +0,0 @@
-/**
- * @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

@@ -1,45 +0,0 @@
-/**
- * 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

@@ -1,76 +0,0 @@
-/**
- * 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

@@ -1,19 +0,0 @@
-/**
- * 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

@@ -1,10 +0,0 @@
-/**
- * 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

@@ -1,18 +0,0 @@
-/**
- * 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

@@ -1,14 +0,0 @@
-/**
- * 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

@@ -1,21 +0,0 @@
-/**
- * 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

@@ -1,14 +0,0 @@
-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

@@ -1,39 +0,0 @@
-/**
- * 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

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