@umituz/react-native-design-system 4.28.22 → 4.29.0

package/dist/theme/hooks/useCommonStyles.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Common Styles - Reusable Style Patterns
+ *
+ * Centralized style utilities to reduce duplication across screens.
+ * These styles are composable and follow DRY principles.
+ *
+ * Usage:
+ * ```typescript
+ * import { useCommonStyles } from '@umituz/react-native-design-system-theme';
+ *
+ * const MyComponent = () => {
+ *   const commonStyles = useCommonStyles();
+ *   return <View style={commonStyles.screenContainer}>...</View>;
+ * };
+ * ```
+ */
+/**
+ * Hook to get common styles with dynamic theme support
+ * Memoized to prevent unnecessary re-renders
+ */
+export declare const useCommonStyles: () => {
+    form: import("react-native").ViewStyle;
+    formHeader: import("react-native").ViewStyle;
+    screenTitle: import("react-native").TextStyle;
+    sectionTitle: import("react-native").TextStyle;
+    subtitle: import("react-native").TextStyle;
+    bodyText: import("react-native").TextStyle;
+    secondaryText: import("react-native").TextStyle;
+    section: import("react-native").ViewStyle;
+    sectionPadded: import("react-native").ViewStyle;
+    paddedHorizontal: import("react-native").ViewStyle;
+    paddedVertical: import("react-native").ViewStyle;
+    padded: import("react-native").ViewStyle;
+    centerContainer: import("react-native").ViewStyle;
+    centerContainerPadded: import("react-native").ViewStyle;
+    row: import("react-native").ViewStyle;
+    rowBetween: import("react-native").ViewStyle;
+    rowCenter: import("react-native").ViewStyle;
+    scrollView: import("react-native").ViewStyle;
+    scrollContent: import("react-native").ViewStyle;
+    scrollContentGrow: import("react-native").ViewStyle;
+    scrollContentCentered: import("react-native").ViewStyle;
+    screenContainer: import("react-native").ViewStyle;
+    flexContainer: import("react-native").ViewStyle;
+    screenContainerSecondary: import("react-native").ViewStyle;
+};

package/dist/theme/hooks/useThemedStyles.d.ts

@@ -0,0 +1,34 @@
+/**
+ * useThemedStyles Hook
+ * Helper hook for creating StyleSheets with theme support
+ *
+ * Usage:
+ * ```typescript
+ * const createStyles = (theme: Theme) => StyleSheet.create({
+ *   container: {
+ *     backgroundColor: theme.colors.backgroundPrimary,
+ *   }
+ * });
+ *
+ * const Component = () => {
+ *   const styles = useThemedStyles(createStyles);
+ *   return <View style={styles.container} />;
+ * };
+ * ```
+ */
+import type { ImageStyle, TextStyle, ViewStyle } from 'react-native';
+import type { Theme } from '../core/themes';
+type NamedStyles<T> = {
+    [P in keyof T]: ViewStyle | TextStyle | ImageStyle;
+};
+/**
+ * Hook for creating themed styles
+ * Returns memoized styles that update when theme changes
+ */
+export declare function useThemedStyles<T extends NamedStyles<T>>(createStyles: (theme: Theme) => T): T;
+/**
+ * Alternative: Direct StyleSheet creation with theme
+ * Returns memoized styles that update when theme changes
+ */
+export declare function useThemedStyleSheet<T extends NamedStyles<T>>(styleFactory: (theme: Theme) => T): T;
+export {};

package/dist/theme/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @umituz/react-native-design-system-theme - Public API
+ *
+ * Theme management system for React Native apps
+ * Provides colors, design tokens, and theme state management
+ *
+ * Usage:
+ *   import { useAppDesignTokens, useDesignSystemTheme, lightColors, darkColors } from '@umituz/react-native-design-system-theme';
+ */
+export { lightColors, darkColors, getColorPalette, withAlpha, type ColorPalette, type ThemeMode, } from './core/ColorPalette';
+export { applyCustomColors, type CustomThemeColors, } from './core/CustomColors';
+export { BASE_TOKENS, spacing, typography, borders, type Spacing, type Typography, type Borders, type BaseTokens, type IconSizes, type Opacity, type AvatarSizes, type ComponentSizes, } from './core/BaseTokens';
+export { createDesignTokens, } from './core/TokenFactory';
+export type { DesignTokens, ResponsiveSpacing, ResponsiveTypography, ResponsiveBorderRadius, } from './types/ThemeTypes';
+export { useAppDesignTokens } from './hooks/useAppDesignTokens';
+export { useTheme as useDesignSystemTheme } from './infrastructure/stores/themeStore';
+export { useTheme } from './infrastructure/stores/themeStore';
+export { useThemedStyles, useThemedStyleSheet } from './hooks/useThemedStyles';
+export { useCommonStyles } from './hooks/useCommonStyles';
+export { DesignSystemProvider } from './infrastructure/providers/DesignSystemProvider';
+export { lightTheme, darkTheme, createResponsiveValue, type Theme, } from './core/themes';
+export { ThemeStorage } from './infrastructure/storage/ThemeStorage';
+export { createNavigationTheme, type NavigationTheme, } from './core/NavigationTheme';

package/dist/theme/infrastructure/providers/DesignSystemProvider.d.ts

@@ -0,0 +1,17 @@
+import React, { ReactNode } from 'react';
+import type { ThemeMode } from '../../core/ColorPalette';
+import type { CustomThemeColors } from '../../core/CustomColors';
+import type { SplashScreenProps } from '../../../molecules/splash/types';
+interface DesignSystemProviderProps {
+    children: ReactNode;
+    customColors?: CustomThemeColors;
+    initialThemeMode?: ThemeMode;
+    fonts?: Record<string, any>;
+    showLoadingIndicator?: boolean;
+    splashConfig?: Pick<SplashScreenProps, 'appName' | 'tagline' | 'icon' | 'colors'>;
+    loadingComponent?: ReactNode;
+    onInitialized?: () => void;
+    onError?: (error: unknown) => void;
+}
+export declare const DesignSystemProvider: React.FC<DesignSystemProviderProps>;
+export {};

package/dist/theme/infrastructure/storage/ThemeStorage.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Theme Storage
+ * Persists theme mode and custom colors using AsyncStorage
+ */
+import type { ThemeMode } from '../../core/ColorPalette';
+import type { CustomThemeColors } from '../../core/CustomColors';
+export declare class ThemeStorage {
+    static getThemeMode(): Promise<ThemeMode | null>;
+    static setThemeMode(mode: ThemeMode): Promise<void>;
+    static clearThemeMode(): Promise<void>;
+    static getCustomColors(): Promise<CustomThemeColors | undefined>;
+    static setCustomColors(colors?: CustomThemeColors): Promise<void>;
+    static clearCustomColors(): Promise<void>;
+}

package/dist/theme/infrastructure/stores/themeStore.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Theme Store - Zustand State Management
+ *
+ * Single source of truth for theme mode AND custom colors.
+ * Uses AsyncStorage for persistence via ThemeStorage.
+ */
+import { type Theme } from '../../core/themes';
+import type { ThemeMode } from '../../core/ColorPalette';
+import type { CustomThemeColors } from '../../core/CustomColors';
+interface ThemeState {
+    theme: Theme;
+    themeMode: ThemeMode;
+    customColors?: CustomThemeColors;
+    defaultColors?: CustomThemeColors;
+    defaultThemeMode: ThemeMode;
+    isDark: boolean;
+    isInitialized: boolean;
+    _updateInProgress: boolean;
+    _initInProgress: boolean;
+    _lastUpdateId?: number;
+}
+interface ThemeActions {
+    setThemeMode: (mode: ThemeMode) => Promise<void>;
+    setCustomColors: (colors?: CustomThemeColors) => Promise<void>;
+    setDefaultColors: (colors: CustomThemeColors) => void;
+    setDefaultThemeMode: (mode: ThemeMode) => void;
+    resetToDefaults: () => Promise<void>;
+    toggleTheme: () => Promise<void>;
+    initialize: () => Promise<void>;
+}
+export declare const useTheme: import("zustand").UseBoundStore<import("zustand").StoreApi<ThemeState & ThemeActions>>;
+export {};

package/dist/theme/types/ThemeTypes.d.ts

@@ -0,0 +1,88 @@
+import { type TextStyle } from 'react-native';
+import { type ColorPalette, type ThemeMode } from '../core/ColorPalette';
+import { type BaseTokens, type Spacing, type Typography, type Borders } from '../core/tokens/BaseTokens';
+/**
+ * Responsive Spacing Type
+ */
+export type ResponsiveSpacing = Spacing;
+/**
+ * Responsive Border Radius Type
+ */
+export type ResponsiveBorderRadius = Borders['radius'];
+/**
+ * Responsive Typography Type
+ */
+export type ResponsiveTypography = Typography & {
+    displayLarge: TextStyle & {
+        responsiveFontSize: number;
+    };
+    displayMedium: TextStyle & {
+        responsiveFontSize: number;
+    };
+    displaySmall: TextStyle & {
+        responsiveFontSize: number;
+    };
+    headlineLarge: TextStyle & {
+        responsiveFontSize: number;
+    };
+    headlineMedium: TextStyle & {
+        responsiveFontSize: number;
+    };
+    headlineSmall: TextStyle & {
+        responsiveFontSize: number;
+    };
+    titleLarge: TextStyle & {
+        responsiveFontSize: number;
+    };
+    titleMedium: TextStyle & {
+        responsiveFontSize: number;
+    };
+    titleSmall: TextStyle & {
+        responsiveFontSize: number;
+    };
+    bodyLarge: TextStyle & {
+        responsiveFontSize: number;
+    };
+    bodyMedium: TextStyle & {
+        responsiveFontSize: number;
+    };
+    bodySmall: TextStyle & {
+        responsiveFontSize: number;
+    };
+    labelLarge: TextStyle & {
+        responsiveFontSize: number;
+    };
+    labelMedium: TextStyle & {
+        responsiveFontSize: number;
+    };
+    labelSmall: TextStyle & {
+        responsiveFontSize: number;
+    };
+};
+/**
+ * Combined Design Tokens Type
+ * Now responsive by default
+ */
+export type DesignTokens = {
+    colors: ColorPalette;
+    spacing: ResponsiveSpacing;
+    typography: ResponsiveTypography;
+    iconSizes: BaseTokens['iconSizes'];
+    opacity: BaseTokens['opacity'];
+    avatarSizes: BaseTokens['avatarSizes'];
+    radius: ResponsiveBorderRadius;
+    borderRadius: ResponsiveBorderRadius;
+    borders: Borders & {
+        card: Borders['card'] & {
+            borderColor: string;
+        };
+        input: Borders['input'] & {
+            borderColor: string;
+        };
+    };
+    spacingMultiplier: number;
+    baseSpacing: Spacing;
+    baseTypography: Typography;
+    baseBorderRadius: Borders['radius'];
+};
+export type { ThemeMode };

package/dist/timezone/domain/entities/Timezone.d.ts

@@ -0,0 +1,9 @@
+import type { TimezoneInfo, TimezoneCalendarDay } from './TimezoneTypes';
+import type { ITimezoneCore, ITimezoneFormatting, ITimezoneManipulation, ITimezoneComparison, ITimezoneCalendar } from './TimezoneCapabilities';
+export type { TimezoneInfo, TimezoneCalendarDay };
+/**
+ * Timezone Service Interface
+ * Aggregates all timezone capabilities into a single service contract
+ */
+export interface ITimezoneService extends ITimezoneCore, ITimezoneFormatting, ITimezoneManipulation, ITimezoneComparison, ITimezoneCalendar {
+}

package/dist/timezone/domain/entities/TimezoneCapabilities.d.ts

@@ -0,0 +1,129 @@
+import type { TimezoneInfo, TimezoneCalendarDay } from './TimezoneTypes';
+/**
+ * Core timezone detection and information checks
+ */
+export interface ITimezoneCore {
+    /** Get current device timezone (IANA identifier) */
+    getCurrentTimezone(): string;
+    /** Get timezone offset in minutes */
+    getTimezoneOffset(): number;
+    /** Get complete timezone information */
+    getTimezoneInfo(): TimezoneInfo;
+    /** Get current date as ISO string (YYYY-MM-DDTHH:mm:ss.sssZ) */
+    getCurrentISOString(): string;
+    /** Get current date object */
+    getNow(): Date;
+    /** Get list of common timezones for selection */
+    getTimezones(): TimezoneInfo[];
+    /** Get timezone offset for specific timezone in minutes */
+    getTimezoneOffsetFor(timezone: string, date?: Date | string | number): number;
+}
+/**
+ * Date and time formatting capabilities
+ */
+export interface ITimezoneFormatting {
+    /** Format date with locale support */
+    formatDate(date: Date | string | number, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+    /** Format time with locale support */
+    formatTime(date: Date | string | number, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+    /** Format date to ISO string (YYYY-MM-DD) */
+    formatDateToString(date: Date | string | number): string;
+    /** Format to display date string (DD.MM.YYYY) */
+    formatToDisplayDate(date: Date | string | number): string;
+    /** Format to display date time string (DD.MM.YYYY HH:mm) */
+    formatToDisplayDateTime(date: Date | string | number): string;
+    /** Format date to ISO datetime string (YYYY-MM-DDTHH:mm:ss.sssZ) */
+    formatToISOString(date: Date | string | number): string;
+    /** Format duration in milliseconds to human readable string */
+    formatDuration(milliseconds: number): string;
+    /** Format time as minutes:seconds (e.g., "3:45", "12:05") */
+    formatTimeShort(seconds: number): string;
+    /** Format date with relative time labels (Today, Yesterday, X days ago, X weeks ago) */
+    formatRelativeDate(date: Date | string | number, locale: string, translations?: {
+        today?: string;
+        yesterday?: string;
+        daysAgo?: string;
+        weeksAgo?: string;
+    }): string;
+    /** Format date in short format (Jan 1, 2024) */
+    formatShortDate(date: Date | string | number, locale: string): string;
+    /** Get relative time from now ("5 minutes ago", "in 2 hours") */
+    fromNow(date: Date | string | number, locale?: string): string;
+}
+/**
+ * Date manipulation and calculation capabilities
+ */
+export interface ITimezoneManipulation {
+    /** Parse input to Date object */
+    parse(date: Date | string | number): Date;
+    /** Add days to a date */
+    addDays(date: Date | string | number, days: number): Date;
+    /** Get start of day (00:00:00) */
+    startOfDay(date: Date | string | number): Date;
+    /** Get end of day (23:59:59.999) */
+    endOfDay(date: Date | string | number): Date;
+    /** Get middle of day (12:00:00) */
+    getMiddleOfDay(date: Date | string | number): Date;
+    /** Set specific time of day (hours and minutes) */
+    setTimeOfDay(date: Date | string | number, hours: number, minutes: number): Date;
+    /** Convert date from one timezone to another */
+    convertTimezone(date: Date | string | number, fromTimezone: string, toTimezone: string): Date;
+    /** Add business days (skip weekends) */
+    addBusinessDays(date: Date | string | number, days: number): Date;
+    /** Clamp date to range */
+    clampDate(date: Date | string | number, min: Date | string | number, max: Date | string | number): Date;
+}
+/**
+ * Date checking and comparison capabilities
+ */
+export interface ITimezoneComparison {
+    /** Check if date is today */
+    isToday(date: Date | string | number): boolean;
+    /** Check if two dates are the same day */
+    isSameDay(date1: Date | string | number, date2: Date | string | number): boolean;
+    /** Check if date is in the future */
+    isFuture(date: Date | string | number): boolean;
+    /** Check if date is in the past */
+    isPast(date: Date | string | number): boolean;
+    /** Check if date is valid */
+    isValid(date: Date | string | number): boolean;
+    /** Check if date is between two dates (inclusive) */
+    isBetween(date: Date | string | number, start: Date | string | number, end: Date | string | number): boolean;
+    /** Check if date is on weekend */
+    isWeekend(date: Date | string | number): boolean;
+    /** Check if date is first day of month */
+    isFirstDayOfMonth(date: Date | string | number): boolean;
+    /** Check if date is last day of month */
+    isLastDayOfMonth(date: Date | string | number): boolean;
+    /** Check if two dates are same hour */
+    areSameHour(date1: Date | string | number, date2: Date | string | number): boolean;
+    /** Check if two dates are same minute */
+    areSameMinute(date1: Date | string | number, date2: Date | string | number): boolean;
+    /** Check if two date ranges overlap */
+    areRangesOverlapping(start1: Date | string | number, end1: Date | string | number, start2: Date | string | number, end2: Date | string | number): boolean;
+}
+/**
+ * Advanced calendar and range capabilities
+ */
+export interface ITimezoneCalendar {
+    /** Get calendar days for a month */
+    getCalendarDays(year: number, month: number): TimezoneCalendarDay[];
+    /** Get days until a future date (returns 0 if past) */
+    getDaysUntil(date: Date | string | number): number;
+    /** Get difference in days between two dates */
+    getDifferenceInDays(date1: Date | string | number, date2: Date | string | number): number;
+    /** Calculate age from birth date */
+    getAge(birthDate: Date | string | number): number;
+    /** Get earliest date from array */
+    min(dates: Array<Date | string | number>): Date;
+    /** Get latest date from array */
+    max(dates: Array<Date | string | number>): Date;
+    /** Get ISO week number (1-53) */
+    getWeek(date: Date | string | number): number;
+    /** Get quarter (1-4) */
+    getQuarter(date: Date | string | number): number;
+    /** Get number of days in month */
+    getDaysInMonth(date: Date | string | number): number;
+    /** Get array of dates in range */
+    getDateRange(start: Date | string | number, end: Date | string | number): Date[];
+}

package/dist/timezone/domain/entities/TimezoneTypes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Timezone Types
+ */
+/**
+ * Timezone information from device
+ */
+export interface TimezoneInfo {
+    /** IANA timezone identifier (e.g., "America/New_York", "Europe/Istanbul") */
+    timezone: string;
+    /** UTC offset in minutes (negative for west, positive for east) */
+    offset: number;
+    /** Human-readable timezone display name */
+    displayName: string;
+}
+/**
+ * Calendar day representation
+ * Generic structure - can be extended by apps for app-specific data
+ */
+export interface TimezoneCalendarDay {
+    /** Date object for this day */
+    date: Date;
+    /** Day of month (1-31) */
+    day: number;
+    /** Day of week (0 = Sunday, 6 = Saturday) */
+    dayOfWeek: number;
+    /** Month (0-11, 0 = January) */
+    month: number;
+    /** Year (e.g., 2024) */
+    year: number;
+    /** Whether this day is in the current month */
+    isCurrentMonth: boolean;
+    /** Whether this day is today */
+    isToday: boolean;
+    /** ISO date string (YYYY-MM-DD) */
+    isoDate: string;
+}

package/dist/timezone/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @umituz/react-native-timezone - Public API
+ *
+ * Timezone detection and date/time utilities for React Native apps
+ *
+ * Usage:
+ *   import { useTimezone, timezoneService } from '@umituz/react-native-timezone';
+ */
+export type { TimezoneInfo, TimezoneCalendarDay, ITimezoneService, } from './domain/entities/Timezone';
+export { timezoneService, TimezoneService } from './infrastructure/services/TimezoneService';
+export { useTimezone } from './presentation/hooks/useTimezone';
+export type { UseTimezoneReturn } from './presentation/hooks/useTimezone';
+export { formatTimeComponent, parseTimeComponent, millisecondsToSeconds, } from './infrastructure/utils/TimeUtils';

package/dist/timezone/infrastructure/services/BusinessCalendarManager.d.ts

@@ -0,0 +1,30 @@
+/**
+ * BusinessCalendarManager
+ *
+ * Business date utilities for work days and month boundaries
+ * Handles weekend detection and business day calculations
+ */
+export declare class BusinessCalendarManager {
+    /**
+     * Check if date is on weekend (Saturday or Sunday)
+     */
+    isWeekend(date: Date | string | number): boolean;
+    /**
+     * Add business days (skips weekends)
+     * Positive days adds, negative days subtracts
+     */
+    addBusinessDays(date: Date | string | number, days: number): Date;
+    /**
+     * Check if date is first day of month
+     */
+    isFirstDayOfMonth(date: Date | string | number): boolean;
+    /**
+     * Check if date is last day of month
+     */
+    isLastDayOfMonth(date: Date | string | number): boolean;
+    /**
+     * Get number of days in month
+     */
+    getDaysInMonth(date: Date | string | number): number;
+    private parse;
+}

package/dist/timezone/infrastructure/services/CalendarManager.d.ts

@@ -0,0 +1,30 @@
+import { TimezoneCalendarDay } from '../../domain/entities/Timezone';
+/**
+ * CalendarManager
+ * Handles calendar grid generation and date comparisons
+ */
+export declare class CalendarManager {
+    /**
+     * Get calendar days for a specific month
+     */
+    getCalendarDays(year: number, month: number, formatDateFn: (date: Date) => string): TimezoneCalendarDay[];
+    private createDay;
+    isSameDay(date1: Date | string | number, date2: Date | string | number): boolean;
+    isToday(date: Date | string | number): boolean;
+    addDays(date: Date | string | number, days: number): Date;
+    startOfDay(date: Date | string | number): Date;
+    endOfDay(date: Date | string | number): Date;
+    setTimeOfDay(date: Date | string | number, hours: number, minutes: number): Date;
+    getDifferenceInDays(date1: Date | string | number, date2: Date | string | number): number;
+    getDaysUntil(date: Date | string | number): number;
+    isFuture(date: Date | string | number): boolean;
+    isPast(date: Date | string | number): boolean;
+    parse(date: Date | string | number): Date;
+    isValid(date: Date | string | number): boolean;
+    getAge(birthDate: Date | string | number): number;
+    isBetween(date: Date | string | number, start: Date | string | number, end: Date | string | number): boolean;
+    min(dates: Array<Date | string | number>): Date;
+    max(dates: Array<Date | string | number>): Date;
+    getWeek(date: Date | string | number): number;
+    getQuarter(date: Date | string | number): number;
+}

package/dist/timezone/infrastructure/services/DateComparisonUtils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * DateComparisonUtils
+ *
+ * Precise date comparison utilities and relative time formatting
+ * Handles hour/minute precision comparisons and "from now" formatting
+ */
+export declare class DateComparisonUtils {
+    /**
+     * Check if two dates are same hour
+     */
+    areSameHour(date1: Date | string | number, date2: Date | string | number): boolean;
+    /**
+     * Check if two dates are same minute
+     */
+    areSameMinute(date1: Date | string | number, date2: Date | string | number): boolean;
+    /**
+     * Get middle of day (12:00:00)
+     */
+    getMiddleOfDay(date: Date | string | number): Date;
+    /**
+     * Get relative time from now ("5 minutes ago", "in 2 hours")
+     */
+    fromNow(date: Date | string | number, locale: string): string;
+    private parse;
+}

package/dist/timezone/infrastructure/services/DateFormatter.d.ts

@@ -0,0 +1,43 @@
+export declare class DateFormatter {
+    formatDate(date: Date | string | number, locale: string, options?: Intl.DateTimeFormatOptions): string;
+    formatTime(date: Date | string | number, locale: string, options?: Intl.DateTimeFormatOptions): string;
+    formatDateTime(date: Date | string | number, locale: string, options?: Intl.DateTimeFormatOptions): string;
+    formatDateToString(date: Date | string | number): string;
+    formatToISOString(date: Date | string | number): string;
+    formatToDisplayDate(date: Date | string | number): string;
+    formatToDisplayDateTime(date: Date | string | number): string;
+    formatRelativeTime(date: Date | string | number, locale: string): string;
+    parse(date: Date | string | number): Date;
+    formatDuration(milliseconds: number): string;
+    /**
+     * Format time as minutes:seconds (e.g., "3:45", "12:05")
+     * @param seconds - Time in seconds
+     * @returns Formatted time string
+     */
+    formatTimeShort(seconds: number): string;
+    /**
+     * Format date with relative time labels (Today, Yesterday, X days ago, X weeks ago)
+     * @param date - Date to format
+     * @param locale - Locale code
+     * @param translations - Optional translations for "Today", "Yesterday", "days ago", "weeks ago"
+     * @returns Formatted relative date string
+     */
+    formatRelativeDate(date: Date | string | number, locale: string, translations?: {
+        today?: string;
+        yesterday?: string;
+        daysAgo?: string;
+        weeksAgo?: string;
+    }): string;
+    /**
+     * Get default translation for relative time keys
+     */
+    private getDefaultTranslation;
+    /**
+     * Format date in short format (Jan 1, 2024)
+     */
+    formatShortDate(date: Date | string | number, locale: string): string;
+    /**
+     * Alias for formatRelativeTime - more semantic name for "time ago" formatting
+     */
+    fromNow(date: Date | string | number, locale: string): string;
+}

package/dist/timezone/infrastructure/services/DateRangeUtils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * DateRangeUtils
+ *
+ * Date range utilities for working with date intervals
+ * Handles range generation, overlap detection, and clamping
+ */
+export declare class DateRangeUtils {
+    /**
+     * Get array of dates in range (inclusive)
+     */
+    getDateRange(start: Date | string | number, end: Date | string | number): Date[];
+    /**
+     * Check if two date ranges overlap
+     */
+    areRangesOverlapping(start1: Date | string | number, end1: Date | string | number, start2: Date | string | number, end2: Date | string | number): boolean;
+    /**
+     * Clamp date to range
+     */
+    clampDate(date: Date | string | number, min: Date | string | number, max: Date | string | number): Date;
+    private parse;
+}

package/dist/timezone/infrastructure/services/TimezoneProvider.d.ts

@@ -0,0 +1,33 @@
+import { TimezoneInfo } from '../../domain/entities/Timezone';
+/**
+ * TimezoneProvider
+ * Responsible for discovering device timezone and providing available timezones
+ */
+export declare class TimezoneProvider {
+    private cache;
+    /**
+     * Get current device timezone using Intl API
+     */
+    getCurrentTimezone(): string;
+    /**
+     * Get current timezone offset in minutes
+     */
+    getTimezoneOffset(): number;
+    /**
+     * Get complete timezone information
+     */
+    getTimezoneInfo(): TimezoneInfo;
+    /**
+     * Get list of common timezones (cached)
+     * Generic implementation for all apps
+     */
+    getTimezones(): TimezoneInfo[];
+    /**
+     * Get timezone offset for specific timezone in minutes
+     */
+    getTimezoneOffsetFor(timezone: string, date?: Date | string | number): number;
+    /**
+     * Convert date from one timezone to another
+     */
+    convertTimezone(date: Date | string | number, fromTimezone: string, toTimezone: string): Date;
+}