@umituz/react-native-settings 5.3.37 → 5.3.38

package/dist/domains/cloud-sync/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cloud Sync Domain
+ * Cloud synchronization settings and status
+ */
+export { CloudSyncSetting } from "./presentation/components/CloudSyncSetting";
+export type { CloudSyncSettingProps } from "./presentation/components/CloudSyncSetting";

package/dist/domains/cloud-sync/presentation/components/CloudSyncSetting.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cloud Sync Setting Component
+ * Displays cloud sync status and allows triggering sync
+ */
+import React from "react";
+export interface CloudSyncSettingProps {
+    title?: string;
+    description?: string;
+    isSyncing?: boolean;
+    lastSynced?: Date | null;
+    onPress?: () => void;
+    disabled?: boolean;
+}
+export declare const CloudSyncSetting: React.FC<CloudSyncSettingProps>;

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

@@ -0,0 +1,14 @@
+/**
+ * Dev Domain
+ * Development-only settings and utilities
+ * Only visible in __DEV__ mode
+ */
+export { DevSettingsSection } from "./presentation/components/DevSettingsSection";
+export type { DevSettingsProps } from "./presentation/components/DevSettingsSection";
+export { StorageClearSetting } from "./presentation/components/StorageClearSetting";
+export type { StorageClearSettingProps } from "./presentation/components/StorageClearSetting";
+export { EnvViewerSetting } from "./presentation/components/EnvViewerSetting";
+export type { EnvViewerSettingProps } from "./presentation/components/EnvViewerSetting";
+export { EnvViewerScreen } from "./presentation/screens/EnvViewerScreen";
+export type { EnvViewerScreenProps } from "./presentation/screens/EnvViewerScreen";
+export type { EnvVariable, EnvConfig } from "./types";

package/dist/domains/dev/presentation/components/DevSettingsSection.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Dev Settings Section Component
+ * Only visible in __DEV__ mode
+ * Provides development utilities like clearing storage
+ *
+ * NOTE: This component uses hardcoded English text since it's DEV-only
+ * and doesn't need localization support.
+ */
+import React from "react";
+declare const DEFAULT_TEXTS: {
+    sectionTitle: string;
+    clearTitle: string;
+    clearDescription: string;
+    confirmTitle: string;
+    confirmMessage: string;
+    cancelButton: string;
+    confirmButton: string;
+    successTitle: string;
+    successMessage: string;
+    errorTitle: string;
+    errorMessage: string;
+};
+export interface DevSettingsProps {
+    /** Enable dev settings section (default: true in __DEV__ mode) */
+    enabled?: boolean;
+    /** Callback after storage is cleared - use this to reload the app and reset app state (e.g., onboarding) */
+    onAfterClear?: () => Promise<void>;
+    /** Custom texts (optional - defaults to English) */
+    texts?: Partial<typeof DEFAULT_TEXTS>;
+    /** Custom dev components to render BEFORE the "Clear All Data" button (e.g., OnboardingResetSetting) */
+    customDevComponents?: React.ReactNode[];
+}
+export declare const DevSettingsSection: React.FC<DevSettingsProps>;
+export {};

package/dist/domains/dev/presentation/components/EnvViewerSetting.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Environment Viewer Setting Item
+ * List item to navigate to environment variables screen
+ * DEV-only feature
+ */
+import React from "react";
+import type { EnvConfig } from "../../types";
+export interface EnvViewerSettingProps {
+    /** Environment configuration to pass to viewer screen */
+    config: EnvConfig;
+    /** Custom title (default: "Environment Variables") */
+    title?: string;
+    /** Custom description (default: "View app configuration") */
+    description?: string;
+    /** Screen name to navigate to */
+    screenName: string;
+    /** Custom navigation handler (overrides route) */
+    onPress?: () => void;
+}
+export declare const EnvViewerSetting: React.FC<EnvViewerSettingProps>;

package/dist/domains/dev/presentation/components/StorageClearSetting.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Storage Clear Setting Component
+ * Single Responsibility: Display storage clear setting (DEV only)
+ * Only visible in __DEV__ mode
+ */
+import React from "react";
+export interface StorageClearSettingProps {
+    title?: string;
+    description?: string;
+    onPress?: () => void;
+    iconColor?: string;
+}
+export declare const StorageClearSetting: React.FC<StorageClearSettingProps>;

package/dist/domains/dev/presentation/screens/EnvViewerScreen.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Environment Variables Viewer Screen
+ * Displays environment configuration for debugging
+ * DEV-only feature with hardcoded English text
+ */
+import React from "react";
+import type { EnvConfig } from "../../types";
+export interface EnvViewerScreenProps {
+    /** Environment configuration */
+    config: EnvConfig;
+}
+export declare const EnvViewerScreen: React.FC<EnvViewerScreenProps>;

package/dist/domains/dev/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Dev Domain Types
+ * Environment variable types for dev tools
+ */
+export interface EnvVariable {
+    /** Environment variable key */
+    key: string;
+    /** Environment variable value (masked if sensitive) */
+    value: string;
+    /** Whether this is a sensitive value (API keys, secrets) */
+    sensitive?: boolean;
+}
+export interface EnvConfig {
+    /** List of environment variables to display */
+    variables: EnvVariable[];
+    /** App version info */
+    version?: string;
+    /** Build number */
+    buildNumber?: string;
+    /** Environment name (development, staging, production) */
+    environmentName?: string;
+}

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

@@ -0,0 +1,17 @@
+/**
+ * @umituz/react-native-disclaimer - Public API
+ *
+ * Disclaimer component for React Native apps
+ * Display legal notices, warnings, and important information
+ *
+ * Usage:
+ *   import { DisclaimerSetting, DisclaimerScreen } from '@umituz/react-native-disclaimer';
+ */
+export { DisclaimerSetting } from './presentation/components/DisclaimerSetting';
+export type { DisclaimerSettingProps } from './presentation/components/DisclaimerSetting';
+export { DisclaimerCard } from './presentation/components/DisclaimerCard';
+export type { DisclaimerCardProps } from './presentation/components/DisclaimerCard';
+export { DisclaimerModal } from './presentation/components/DisclaimerModal';
+export type { DisclaimerModalProps } from './presentation/components/DisclaimerModal';
+export { DisclaimerScreen } from './presentation/screens/DisclaimerScreen';
+export type { DisclaimerScreenProps } from './presentation/screens/DisclaimerScreen';

package/dist/domains/disclaimer/presentation/components/DisclaimerCard.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Disclaimer Card Component
+ * Extracted from DisclaimerSetting to follow single responsibility and 200-line rules
+ */
+import React from 'react';
+export interface DisclaimerCardProps {
+    title: string;
+    shortMessage: string;
+    iconName: string;
+    iconColor: string;
+    backgroundColor: string;
+    onPress: () => void;
+}
+export declare const DisclaimerCard: React.FC<DisclaimerCardProps>;

package/dist/domains/disclaimer/presentation/components/DisclaimerModal.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Disclaimer Modal Component
+ * Extracted from DisclaimerSetting to follow single responsibility and 200-line rules
+ */
+import React from 'react';
+export interface DisclaimerModalProps {
+    visible: boolean;
+    title: string;
+    content: string;
+    onClose: () => void;
+}
+export declare const DisclaimerModal: React.FC<DisclaimerModalProps>;

package/dist/domains/disclaimer/presentation/components/DisclaimerSetting.d.ts

@@ -0,0 +1,34 @@
+/**
+ * DisclaimerSetting Component
+ *
+ * Displays customizable disclaimer with important legal notice
+ * Used in About screens for apps that require disclaimers
+ *
+ * Features:
+ * - Tappable card that opens full disclaimer modal
+ * - Warning icon with background color
+ * - Internationalized title and message
+ * - Full-screen modal with scrollable content
+ * - NO shadows (CLAUDE.md compliance)
+ * - Universal across iOS, Android, Web (NO Platform.OS checks)
+ *
+ * Usage:
+ * - Import and use in AboutScreen
+ * - Requires translations: settings.disclaimer.title, settings.disclaimer.message, settings.disclaimer.shortMessage
+ */
+import React from 'react';
+export interface DisclaimerSettingProps {
+    /** Custom title */
+    title?: string;
+    /** Custom content */
+    content?: string;
+    /** Custom short message */
+    shortMessage?: string;
+    /** Custom icon name */
+    iconName?: string;
+    /** Custom icon color */
+    iconColor?: string;
+    /** Custom background color */
+    backgroundColor?: string;
+}
+export declare const DisclaimerSetting: React.FC<DisclaimerSettingProps>;

package/dist/domains/disclaimer/presentation/screens/DisclaimerScreen.d.ts

@@ -0,0 +1,27 @@
+/**
+ * DisclaimerScreen Component
+ *
+ * Full-screen disclaimer display for navigation-based usage
+ * Can be registered as a screen in navigation stack
+ *
+ * Features:
+ * - SafeAreaView wrapper for proper display
+ * - Scrollable content for long disclaimers
+ * - Customizable title and content via props or translations
+ * - NO shadows (CLAUDE.md compliance)
+ * - Universal across iOS, Android, Web
+ */
+import React from 'react';
+export interface DisclaimerScreenProps {
+    /** Custom title (overrides translation) */
+    title?: string;
+    /** Custom title translation key */
+    titleKey?: string;
+    /** Custom content (overrides translation) */
+    content?: string;
+    /** Custom content translation key */
+    contentKey?: string;
+    /** Custom icon name */
+    iconName?: string;
+}
+export declare const DisclaimerScreen: React.FC<DisclaimerScreenProps>;

package/dist/domains/faqs/domain/entities/FAQEntity.d.ts

@@ -0,0 +1,21 @@
+/**
+ * FAQ Entity Definitions
+ */
+export interface FAQItem {
+    id: string;
+    question: string;
+    answer: string;
+    categoryId?: string;
+    tags?: readonly string[];
+    featured?: boolean;
+    order?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface FAQCategory {
+    id: string;
+    title: string;
+    items: FAQItem[];
+    description?: string;
+    icon?: string;
+    order?: number;
+}

package/dist/domains/faqs/domain/services/FAQSearchService.d.ts

@@ -0,0 +1,12 @@
+/**
+ * FAQ Search Service
+ * Handles searching FAQ items with advanced features
+ */
+import { FAQItem, FAQCategory } from "../entities/FAQEntity";
+export declare class FAQSearchService {
+    static searchItems(query: string, items: FAQItem[]): FAQItem[];
+    static searchCategories(query: string, categories: FAQCategory[]): FAQCategory[];
+    static getFeaturedItems(items: FAQItem[]): FAQItem[];
+    static sortByOrder(items: FAQItem[]): FAQItem[];
+    static sortCategoriesByOrder(categories: FAQCategory[]): FAQCategory[];
+}

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

@@ -0,0 +1,8 @@
+/**
+ * FAQs Domain
+ * Frequently asked questions
+ */
+export * from './presentation/screens/FAQScreen';
+export * from './presentation/components';
+export * from './presentation/hooks';
+export * from './domain/entities/FAQEntity';

package/dist/domains/faqs/presentation/components/FAQCategory.d.ts

@@ -0,0 +1,21 @@
+/**
+ * FAQ Category Component
+ * Renders a category with its FAQ items
+ * Uses design system tokens for theming
+ */
+import React from 'react';
+import { ViewStyle } from 'react-native';
+import { FAQCategory as FAQCategoryType } from '../../domain/entities/FAQEntity';
+import { FAQItemStyles } from './FAQItem';
+export interface FAQCategoryStyles {
+    container?: ViewStyle;
+    titleStyle?: object;
+    itemStyles?: FAQItemStyles;
+}
+export interface FAQCategoryProps {
+    category: FAQCategoryType;
+    isExpanded: (itemId: string) => boolean;
+    onToggleItem: (itemId: string) => void;
+    styles?: FAQCategoryStyles;
+}
+export declare const FAQCategoryComponent: React.FC<FAQCategoryProps>;

package/dist/domains/faqs/presentation/components/FAQEmptyState.d.ts

@@ -0,0 +1,20 @@
+/**
+ * FAQ Empty State Component
+ * Shown when no search results found
+ * Uses design system tokens for theming
+ */
+import React from 'react';
+import { ViewStyle, TextStyle } from 'react-native';
+export interface FAQEmptyStateStyles {
+    container?: ViewStyle;
+    icon?: TextStyle;
+    titleStyle?: object;
+    messageStyle?: object;
+}
+export interface FAQEmptyStateProps {
+    title: string;
+    message: string;
+    icon?: string;
+    styles?: FAQEmptyStateStyles;
+}
+export declare const FAQEmptyState: React.FC<FAQEmptyStateProps>;

package/dist/domains/faqs/presentation/components/FAQItem.d.ts

@@ -0,0 +1,24 @@
+/**
+ * FAQ Item Component
+ * Individual FAQ question/answer item
+ * Uses design system tokens for theming
+ */
+import React from 'react';
+import { ViewStyle } from 'react-native';
+import { FAQItem as FAQItemType } from '../../domain/entities/FAQEntity';
+export interface FAQItemStyles {
+    container?: ViewStyle;
+    header?: ViewStyle;
+    content?: ViewStyle;
+    questionStyle?: object;
+    answerContainer?: ViewStyle;
+    answerStyle?: object;
+}
+export interface FAQItemProps {
+    item: FAQItemType;
+    isExpanded: boolean;
+    onToggle: () => void;
+    isLast?: boolean;
+    styles?: FAQItemStyles;
+}
+export declare const FAQItemComponent: React.FC<FAQItemProps>;

package/dist/domains/faqs/presentation/components/FAQSearchBar.d.ts

@@ -0,0 +1,18 @@
+/**
+ * FAQ Search Bar Component
+ * Search input for filtering FAQ items
+ * Uses design system tokens for theming
+ */
+import React from 'react';
+import { ViewStyle, TextStyle } from 'react-native';
+export interface FAQSearchBarStyles {
+    container?: ViewStyle;
+    input?: TextStyle;
+}
+export interface FAQSearchBarProps {
+    value: string;
+    onChangeText: (text: string) => void;
+    placeholder: string;
+    styles?: FAQSearchBarStyles;
+}
+export declare const FAQSearchBar: React.FC<FAQSearchBarProps>;

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

@@ -0,0 +1,11 @@
+/**
+ * @umituz/react-native-faqs - Components
+ */
+export { FAQItemComponent } from './FAQItem';
+export type { FAQItemProps } from './FAQItem';
+export { FAQEmptyState } from './FAQEmptyState';
+export type { FAQEmptyStateProps } from './FAQEmptyState';
+export { FAQSearchBar } from './FAQSearchBar';
+export type { FAQSearchBarProps } from './FAQSearchBar';
+export { FAQCategoryComponent } from './FAQCategory';
+export type { FAQCategoryProps } from './FAQCategory';

package/dist/domains/faqs/presentation/hooks/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @umituz/react-native-faqs - Hooks
+ */
+export { useFAQSearch } from './useFAQSearch';
+export { useFAQExpansion } from './useFAQExpansion';

package/dist/domains/faqs/presentation/hooks/useFAQExpansion.d.ts

@@ -0,0 +1,12 @@
+/**
+ * FAQ Expansion Hook
+ * Manages FAQ item expansion state
+ */
+export interface UseFAQExpansionResult {
+    expandedItems: Set<string>;
+    isExpanded: (itemId: string) => boolean;
+    toggleExpansion: (itemId: string) => void;
+    expandAll: (itemIds: string[]) => void;
+    collapseAll: () => void;
+}
+export declare function useFAQExpansion(): UseFAQExpansionResult;

package/dist/domains/faqs/presentation/hooks/useFAQSearch.d.ts

@@ -0,0 +1,12 @@
+/**
+ * FAQ Search Hook
+ * Handles FAQ search state and filtering with debounce
+ */
+import { FAQCategory } from '../../domain/entities/FAQEntity';
+export interface UseFAQSearchResult {
+    searchQuery: string;
+    setSearchQuery: (query: string) => void;
+    filteredCategories: FAQCategory[];
+    hasResults: boolean;
+}
+export declare function useFAQSearch(categories: FAQCategory[]): UseFAQSearchResult;

package/dist/domains/faqs/presentation/screens/FAQScreen.d.ts

@@ -0,0 +1,33 @@
+/**
+ * FAQ Screen Component
+ * Full-screen FAQ viewer with search functionality
+ * Uses design system tokens for theming
+ */
+import React from 'react';
+import { ViewStyle, TextStyle } from 'react-native';
+import { FAQCategory } from '../../domain/entities/FAQEntity';
+import { FAQSearchBarStyles } from '../components/FAQSearchBar';
+import { FAQEmptyStateStyles } from '../components/FAQEmptyState';
+import { FAQCategoryStyles } from '../components/FAQCategory';
+export interface FAQScreenStyles {
+    container?: ViewStyle;
+    header?: ViewStyle;
+    title?: TextStyle;
+    content?: ViewStyle;
+    searchBar?: FAQSearchBarStyles;
+    emptyState?: FAQEmptyStateStyles;
+    category?: FAQCategoryStyles;
+}
+export interface FAQScreenProps {
+    categories: FAQCategory[];
+    searchPlaceholder: string;
+    emptySearchTitle: string;
+    emptySearchMessage: string;
+    headerTitle: string;
+    onBack?: () => void;
+    renderHeader?: (props: {
+        onBack: () => void;
+    }) => React.ReactElement | null;
+    styles?: FAQScreenStyles;
+}
+export declare const FAQScreen: React.FC<FAQScreenProps>;

package/dist/domains/feedback/domain/entities/FeedbackEntity.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Feedback Entity
+ */
+export type FeedbackType = 'general' | 'bug_report' | 'feature_request' | 'improvement' | 'other';
+export type FeedbackStatus = 'pending' | 'reviewed' | 'resolved' | 'closed';
+export type FeedbackRating = 1 | 2 | 3 | 4 | 5;
+export interface FeedbackEntity {
+    id: string;
+    userId: string | null;
+    userEmail?: string | null;
+    type: FeedbackType;
+    title: string;
+    description: string;
+    rating?: FeedbackRating;
+    status: FeedbackStatus;
+    deviceInfo?: {
+        platform: string;
+        osVersion: string;
+        appVersion: string;
+    };
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare function createFeedback(userId: string | null, type: FeedbackType, title: string, description: string, userEmail?: string | null, rating?: FeedbackRating, deviceInfo?: FeedbackEntity['deviceInfo'], metadata?: Record<string, unknown>): Omit<FeedbackEntity, 'id'>;

package/dist/domains/feedback/domain/repositories/IFeedbackRepository.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Feedback Repository Interface
+ */
+import type { FeedbackEntity } from '../entities/FeedbackEntity';
+export interface FeedbackError {
+    message: string;
+    code?: 'SUBMIT_FAILED' | 'FETCH_FAILED' | 'DELETE_FAILED' | 'VALIDATION_ERROR';
+}
+export type FeedbackResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: FeedbackError;
+};
+export interface IFeedbackRepository {
+    submitFeedback(feedback: FeedbackEntity | Omit<FeedbackEntity, 'id'>): Promise<FeedbackResult<FeedbackEntity>>;
+    getUserFeedback(userId: string): Promise<FeedbackResult<FeedbackEntity[]>>;
+    deleteFeedback(feedbackId: string): Promise<FeedbackResult<boolean>>;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * Feedback Domain
+ * User feedback, bug reports
+ */
+export * from './presentation/components/FeedbackForm';
+export * from './presentation/components/FeedbackModal';
+export * from './presentation/components/SupportSection';
+export * from './presentation/hooks/useFeedbackForm';
+export * from './domain/entities/FeedbackEntity';
+export * from './domain/repositories/IFeedbackRepository';

package/dist/domains/feedback/presentation/components/FeedbackForm.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Feedback Form Component
+ * Form for submitting user feedback with type, rating, and description
+ */
+import React from "react";
+import type { FeedbackFormProps } from "./FeedbackFormProps";
+export declare const FeedbackForm: React.FC<FeedbackFormProps>;

package/dist/domains/feedback/presentation/components/FeedbackForm.styles.d.ts

@@ -0,0 +1,48 @@
+import type { useAppDesignTokens } from "@umituz/react-native-design-system/theme";
+export declare const getFeedbackFormStyles: (_tokens: ReturnType<typeof useAppDesignTokens>) => {
+    container: {
+        width: "100%";
+    };
+    typeContainer: {
+        marginBottom: number;
+    };
+    typeScroll: {
+        gap: number;
+    };
+    typeButton: {
+        flexDirection: "row";
+        alignItems: "center";
+        paddingHorizontal: number;
+        paddingVertical: number;
+        borderRadius: number;
+        borderWidth: number;
+        gap: number;
+    };
+    ratingContainer: {
+        alignItems: "center";
+        marginBottom: number;
+    };
+    stars: {
+        flexDirection: "row";
+        gap: number;
+    };
+    starButton: {
+        padding: number;
+    };
+    inputContainer: {
+        marginBottom: number;
+    };
+    textArea: {
+        textAlignVertical: "top";
+        minHeight: number;
+        borderWidth: number;
+        borderRadius: number;
+        padding: number;
+    };
+    errorText: {
+        marginTop: number;
+    };
+    submitButton: {
+        width: "100%";
+    };
+};

package/dist/domains/feedback/presentation/components/FeedbackFormProps.d.ts

@@ -0,0 +1,26 @@
+/**
+ * FeedbackForm Props Types
+ */
+import type { FeedbackType, FeedbackRating } from "../../domain/entities/FeedbackEntity";
+export interface FeedbackFormTexts {
+    ratingLabel: string;
+    descriptionPlaceholder: string;
+    submitButton: string;
+    submittingButton: string;
+    feedbackTypes: Array<{
+        type: FeedbackType;
+        label: string;
+    }>;
+    defaultTitle: (type: FeedbackType) => string;
+}
+export interface FeedbackFormProps {
+    onSubmit: (data: {
+        type: FeedbackType;
+        rating: FeedbackRating;
+        description: string;
+        title: string;
+    }) => Promise<void>;
+    texts: FeedbackFormTexts;
+    initialType?: FeedbackType;
+    isSubmitting?: boolean;
+}

package/dist/domains/feedback/presentation/components/FeedbackModal.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Feedback Modal Component
+ * Modal wrapper for providing feedback
+ */
+import React from "react";
+import type { FeedbackType, FeedbackRating } from "../../domain/entities/FeedbackEntity";
+import type { FeedbackFormProps } from "./FeedbackFormProps";
+export interface FeedbackModalProps {
+    visible: boolean;
+    onClose: () => void;
+    onSubmit: (data: {
+        type: FeedbackType;
+        rating: FeedbackRating;
+        description: string;
+        title: string;
+    }) => Promise<void>;
+    initialType?: FeedbackType;
+    isSubmitting?: boolean;
+    title?: string;
+    subtitle?: string;
+    texts: FeedbackFormProps['texts'];
+}
+export declare const FeedbackModal: React.FC<FeedbackModalProps>;