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

package/dist/responsive/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @umituz/react-native-design-system/responsive - Public API
+ *
+ * Responsive sizing and layout utilities for React Native.
+ * For device detection, use '@umituz/react-native-design-system/device'.
+ */
+export { useResponsive } from './useResponsive';
+export type { UseResponsiveReturn } from './useResponsive';
+export { calculateResponsiveSize, calculateResponsiveSizes, calculateResponsiveSizeSubtle, calculateLineHeight, createResponsiveSizes, } from './utils';
+export { getResponsiveLogoSize, getResponsiveInputHeight, getResponsiveHorizontalPadding, getResponsiveVerticalPadding, getScreenLayoutConfig, getResponsiveBottomPosition, getResponsiveFABPosition, getResponsiveTabBarHeight, getResponsiveTabBarConfig, type ResponsiveTabBarConfig, type ScreenLayoutConfig, getResponsiveModalMaxHeight, getResponsiveMinModalHeight, getResponsiveModalWidth, getResponsiveModalHeight, getResponsiveModalBorderRadius, getResponsiveModalMaxWidth, getResponsiveBackdropOpacity, getResponsiveModalLayout, getResponsiveBottomSheetLayout, getResponsiveDialogLayout, type ResponsiveModalLayout, type ResponsiveBottomSheetLayout, type ResponsiveDialogLayout, getResponsiveIconContainerSize, getResponsiveGridColumns, getResponsiveGridCellSize, type GridCellSizeConfig, getResponsiveMaxWidth, getResponsiveFontSize, MODAL_CONFIG, } from './responsive';
+export { IOS_HIG, PLATFORM_CONSTANTS, isValidTouchTarget, getMinTouchTarget, } from './platformConstants';
+export { DEVICE_BREAKPOINTS } from './config';
+export { useScreenWidth, useScreenHeight, useScreenDimensions, } from './useScreenDimensions';

package/dist/responsive/padding/paddingUtils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Padding Utilities
+ */
+export declare const getResponsiveVerticalPadding: (insets?: {
+    top?: number;
+    bottom?: number;
+}) => number;
+export declare const getResponsiveHorizontalPadding: (basePadding?: number, insets?: {
+    left?: number;
+    right?: number;
+}) => number;

package/dist/responsive/platformConstants.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Platform-Specific Constants
+ *
+ * Design system constants that ensure compliance with platform guidelines.
+ * These values are based on official Human Interface Guidelines (HIG) from Apple and Material Design from Google.
+ */
+/**
+ * iOS Human Interface Guidelines (HIG) Constants
+ *
+ * @see https://developer.apple.com/design/human-interface-guidelines/layout
+ */
+export declare const IOS_HIG: {
+    /**
+     * Minimum Touch Target Size
+     *
+     * Apple requires a minimum tappable area of 44pt x 44pt for ALL interactive controls.
+     * This is enforced during App Store review.
+     *
+     * @critical Violating this can result in App Store rejection
+     */
+    readonly MIN_TOUCH_TARGET: 44;
+    /**
+     * Recommended Minimum Touch Target Size
+     *
+     * For better accessibility and usability, Apple recommends 48pt x 48pt.
+     */
+    readonly RECOMMENDED_TOUCH_TARGET: 48;
+    /**
+     * Minimum Text Size
+     *
+     * Minimum font size for body text to ensure readability.
+     */
+    readonly MIN_TEXT_SIZE: 17;
+};
+/**
+ * Universal Platform Constants
+ *
+ * These values work across both iOS and Android, taking the more restrictive requirement.
+ */
+export declare const PLATFORM_CONSTANTS: {
+    /**
+     * Minimum Touch Target Size
+     *
+     * Uses iOS requirement (44pt) as it's more restrictive than Android (48dp).
+     * This ensures compliance on both platforms.
+     */
+    readonly MIN_TOUCH_TARGET: number;
+    /**
+     * Recommended Touch Target Size
+     *
+     * Uses the higher value between iOS and Android recommendations.
+     */
+    readonly RECOMMENDED_TOUCH_TARGET: 48;
+    /**
+     * Minimum Text Size
+     *
+     * Uses iOS requirement as it's larger.
+     */
+    readonly MIN_TEXT_SIZE: number;
+};
+/**
+ * Helper function to validate touch target size
+ *
+ * @param size - The size to validate (in pt/dp)
+ * @returns true if size meets platform requirements
+ */
+export declare const isValidTouchTarget: (size: number) => boolean;
+/**
+ * Helper function to get minimum touch target for component
+ *
+ * @param componentType - The type of component ('button' | 'input' | 'icon' | 'generic')
+ * @returns The minimum touch target size for that component type
+ */
+export declare const getMinTouchTarget: (componentType?: "button" | "input" | "icon" | "generic") => number;

package/dist/responsive/positioning/positioningUtils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Positioning Utilities
+ */
+export declare const getResponsiveBottomPosition: (basePosition?: number, insets?: {
+    bottom?: number;
+}) => number;
+export declare const getResponsiveFABPosition: (insets?: {
+    bottom?: number;
+    right?: number;
+}) => {
+    bottom: number;
+    right: number;
+};

package/dist/responsive/responsive.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Responsive Design Utilities
+ *
+ * Centralized responsive sizing and spacing utilities.
+ */
+export { getResponsiveLogoSize, getResponsiveInputHeight, getResponsiveIconContainerSize, getResponsiveMaxWidth, getResponsiveFontSize, getResponsiveGridColumns, getResponsiveGridCellSize, type GridCellSizeConfig, } from './responsiveSizing';
+export { getResponsiveHorizontalPadding, getResponsiveVerticalPadding, getScreenLayoutConfig, getResponsiveBottomPosition, getResponsiveFABPosition, getResponsiveTabBarHeight, getResponsiveTabBarConfig, type ResponsiveTabBarConfig, type ScreenLayoutConfig, } from './responsiveLayout';
+export { getResponsiveModalMaxHeight, getResponsiveMinModalHeight, getResponsiveModalWidth, getResponsiveModalHeight, getResponsiveModalBorderRadius, getResponsiveModalMaxWidth, getResponsiveBackdropOpacity, getResponsiveModalLayout, getResponsiveBottomSheetLayout, getResponsiveDialogLayout, type ResponsiveModalLayout, type ResponsiveBottomSheetLayout, type ResponsiveDialogLayout, } from './responsiveModal';
+export { DEVICE_BREAKPOINTS, RESPONSIVE_PERCENTAGES, SIZE_CONSTRAINTS, LAYOUT_CONSTANTS, HEIGHT_THRESHOLDS, GRID_CONFIG, VALIDATION_CONSTRAINTS, MODAL_CONFIG, } from './config';

package/dist/responsive/responsiveLayout.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Responsive Layout Utilities - Barrel Export
+ */
+export { getScreenLayoutConfig } from './screen/screenLayoutConfig';
+export type { ScreenLayoutConfig } from './screen/screenLayoutConfig';
+export { getResponsiveVerticalPadding, getResponsiveHorizontalPadding } from './padding/paddingUtils';
+export { getResponsiveBottomPosition, getResponsiveFABPosition } from './positioning/positioningUtils';
+export { getResponsiveTabBarHeight, getResponsiveTabBarConfig } from './tabbar/tabBarConfig';
+export type { ResponsiveTabBarConfig } from './tabbar/tabBarConfig';

package/dist/responsive/responsiveModal.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Responsive Modal Utilities
+ * Modal, bottom sheet, and dialog layout utilities.
+ */
+export interface ResponsiveModalLayout {
+    width: number;
+    height: number;
+    maxWidth: number;
+    borderRadius: number;
+    backdropOpacity: number;
+    horizontalPadding: number;
+}
+export interface ResponsiveBottomSheetLayout {
+    minHeight: number;
+    maxHeight: number;
+    borderRadius: number;
+}
+export interface ResponsiveDialogLayout {
+    width: number;
+    maxHeight: number;
+    borderRadius: number;
+}
+export declare const getResponsiveModalMaxHeight: (dimensions?: {
+    height: number;
+}) => string;
+export declare const getResponsiveMinModalHeight: (dimensions?: {
+    height: number;
+}) => number;
+export declare const getResponsiveModalWidth: (dimensions?: {
+    width: number;
+}) => number;
+export declare const getResponsiveModalHeight: (dimensions?: {
+    height: number;
+}) => number;
+export declare const getResponsiveModalBorderRadius: () => number;
+export declare const getResponsiveModalMaxWidth: () => number;
+export declare const getResponsiveBackdropOpacity: () => number;
+export declare const getResponsiveModalLayout: (dimensions?: {
+    width: number;
+    height: number;
+}) => ResponsiveModalLayout;
+export declare const getResponsiveBottomSheetLayout: (dimensions?: {
+    width: number;
+    height: number;
+}) => ResponsiveBottomSheetLayout;
+export declare const getResponsiveDialogLayout: (dimensions?: {
+    width: number;
+    height: number;
+}) => ResponsiveDialogLayout;

package/dist/responsive/responsiveSizing.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Responsive Sizing Utilities
+ * Responsive sizing utilities for UI components.
+ */
+export { getResponsiveGridColumns, getResponsiveGridCellSize, type GridCellSizeConfig, } from './gridUtils';
+/**
+ * Responsive logo/icon size
+ * @param baseSize - Base logo size (default: 140)
+ */
+/**
+ * Responsive logo/icon size
+ * @param baseSize - Base logo size (default: 140)
+ * @param dimensions - Optional dimensions override
+ */
+export declare const getResponsiveLogoSize: (baseSize?: number, dimensions?: {
+    width: number;
+}) => number;
+/**
+ * Responsive multiline input height
+ * @param baseHeight - Base input height (default: 200)
+ * @param dimensions - Optional dimensions override
+ */
+export declare const getResponsiveInputHeight: (baseHeight?: number, dimensions?: {
+    height: number;
+}) => number;
+/**
+ * Responsive icon container size
+ * @param baseSize - Base container size (default: 140)
+ * @param dimensions - Optional dimensions override
+ */
+export declare const getResponsiveIconContainerSize: (baseSize?: number, dimensions?: {
+    width: number;
+}) => number;
+/**
+ * Responsive max width for content
+ * @param baseWidth - Base content width (default: 400)
+ * @param dimensions - Optional dimensions override
+ */
+export declare const getResponsiveMaxWidth: (baseWidth?: number, dimensions?: {
+    width: number;
+}) => number;
+/**
+ * Responsive font size
+ * @param baseFontSize - Base font size
+ * @param dimensions - Optional dimensions override
+ */
+export declare const getResponsiveFontSize: (baseFontSize: number, dimensions?: {
+    width: number;
+}) => number;

package/dist/responsive/screen/screenLayoutConfig.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Screen Layout Configuration
+ */
+export interface ScreenLayoutConfig {
+    readonly maxContentWidth: number | undefined;
+    readonly horizontalPadding: number;
+    readonly verticalPadding: number;
+    readonly spacingMultiplier: number;
+}
+export declare const getScreenLayoutConfig: (insets?: {
+    left?: number;
+    right?: number;
+    top?: number;
+    bottom?: number;
+}) => ScreenLayoutConfig;

package/dist/responsive/tabbar/tabBarConfig.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tab Bar Configuration
+ */
+export interface ResponsiveTabBarConfig {
+    readonly height: number;
+    readonly paddingBottom: number;
+    readonly paddingTop: number;
+    readonly iconSize: number;
+    readonly fabSize: number;
+    readonly fabOffsetY: number;
+}
+export declare const getResponsiveTabBarHeight: (insets?: {
+    bottom?: number;
+}) => number;
+export declare const getResponsiveTabBarConfig: (insets?: {
+    bottom?: number;
+}) => ResponsiveTabBarConfig;

package/dist/responsive/types/responsiveTypes.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Responsive Hook Type Definitions
+ */
+import type { DeviceType, IPadLayoutInfo } from '../../device/detection';
+import type { ResponsiveModalLayout, ResponsiveBottomSheetLayout, ResponsiveDialogLayout } from '../responsive';
+import type { ResponsiveTabBarConfig, ScreenLayoutConfig } from '../responsiveLayout';
+export interface UseResponsiveReturn {
+    readonly width: number;
+    readonly height: number;
+    readonly isSmallDevice: boolean;
+    readonly isTabletDevice: boolean;
+    readonly isLandscapeDevice: boolean;
+    readonly deviceType: DeviceType;
+    readonly insets: {
+        readonly top: number;
+        readonly bottom: number;
+        readonly left: number;
+        readonly right: number;
+    };
+    readonly iPadLayout: IPadLayoutInfo | null;
+    readonly logoSize: number;
+    readonly inputHeight: number;
+    readonly iconContainerSize: number;
+    readonly maxContentWidth: number;
+    readonly minTouchTarget: number;
+    readonly horizontalPadding: number;
+    readonly verticalPadding: number;
+    readonly bottomPosition: number;
+    readonly fabPosition: {
+        readonly bottom: number;
+        readonly right: number;
+    };
+    readonly screenLayoutConfig: ScreenLayoutConfig;
+    readonly modalMaxHeight: string;
+    readonly modalMinHeight: number;
+    readonly gridColumns: number;
+    readonly spacingMultiplier: number;
+    readonly tabBarConfig: ResponsiveTabBarConfig;
+    readonly modalLayout: ResponsiveModalLayout;
+    readonly bottomSheetLayout: ResponsiveBottomSheetLayout;
+    readonly dialogLayout: ResponsiveDialogLayout;
+    readonly onboardingIconSize: number;
+    readonly onboardingIconMarginTop: number;
+    readonly onboardingIconMarginBottom: number;
+    readonly onboardingTitleMarginBottom: number;
+    readonly onboardingDescriptionMarginTop: number;
+    readonly onboardingTextPadding: number;
+    readonly getLogoSize: (baseSize?: number) => number;
+    readonly getInputHeight: (baseHeight?: number) => number;
+    readonly getIconSize: (baseSize?: number) => number;
+    readonly getMaxWidth: (baseWidth?: number) => number;
+    readonly getFontSize: (baseFontSize: number) => number;
+    readonly getGridCols: (mobile?: number, tablet?: number) => number;
+}

package/dist/responsive/useResponsive.d.ts

@@ -0,0 +1,7 @@
+/**
+ * useResponsive Hook
+ * Refactored: Extracted compute functions
+ */
+import type { UseResponsiveReturn } from "./types/responsiveTypes";
+export declare const useResponsive: () => UseResponsiveReturn;
+export type { UseResponsiveReturn } from './types/responsiveTypes';

package/dist/responsive/useScreenDimensions.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Screen dimension hooks — single source of truth for screen width/height.
+ *
+ * Always import from here instead of calling useWindowDimensions() inline
+ * or Dimensions.get() at module level (which is static and never updates on
+ * orientation change, iPad Split View, or Stage Manager).
+ */
+/**
+ * Returns the current window width (reactive — updates on orientation change).
+ * Use inside React components / hooks instead of Dimensions.get("window").width.
+ */
+export declare function useScreenWidth(): number;
+/**
+ * Returns the current window height (reactive — updates on orientation change).
+ * Use inside React components / hooks instead of Dimensions.get("window").height.
+ */
+export declare function useScreenHeight(): number;
+/**
+ * Returns both width and height (reactive).
+ * Convenience wrapper for components that need both dimensions.
+ */
+export declare function useScreenDimensions(): {
+    width: number;
+    height: number;
+};

package/dist/responsive/utils.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Responsive Utility Functions
+ *
+ * Centralized responsive calculations to avoid code duplication.
+ * All components should use these utilities instead of manual calculations.
+ */
+/**
+ * Calculate responsive size from base value
+ * Multiplies base size by spacingMultiplier and floors the result
+ *
+ * @param baseSize - Base size in pixels (e.g., 16, 24, 32)
+ * @param spacingMultiplier - Multiplier from design tokens (0.9, 1.0, 1.2)
+ * @returns Responsive size in pixels (floored for integer values)
+ *
+ * @example
+ * const responsive = useResponsive();
+ * const padding = calculateResponsiveSize(16, responsive.spacingMultiplier); // 14.4 → 14
+ */
+export declare const calculateResponsiveSize: (baseSize: number, spacingMultiplier: number) => number;
+/**
+ * Calculate multiple responsive sizes at once
+ * Useful for component configs with multiple size properties
+ *
+ * @param sizes - Object with base sizes
+ * @param spacingMultiplier - Multiplier from design tokens
+ * @returns Object with responsive sizes
+ *
+ * @example
+ * const baseConfig = { padding: 16, margin: 24, fontSize: 14 };
+ * const responsiveConfig = calculateResponsiveSizes(baseConfig, spacingMultiplier);
+ * // { padding: 14, margin: 21, fontSize: 12 }
+ */
+export declare const calculateResponsiveSizes: <T extends Record<string, number>>(sizes: T, spacingMultiplier: number) => { [K in keyof T]: number; };
+/**
+ * Calculate responsive size with subtle scaling
+ * For values that shouldn't scale as much (e.g., borderWidth, borderRadius)
+ * Uses 0.8x of the spacing multiplier
+ *
+ * @param baseSize - Base size in pixels
+ * @param spacingMultiplier - Multiplier from design tokens
+ * @returns Responsive size with subtle scaling
+ *
+ * @example
+ * const borderWidth = calculateResponsiveSizeSubtle(2, spacingMultiplier); // 2 → 2 (small tablets)
+ */
+export declare const calculateResponsiveSizeSubtle: (baseSize: number, spacingMultiplier: number) => number;
+/**
+ * Calculate responsive line height from font size
+ * Standard 1.5x ratio for readability
+ *
+ * @param fontSize - Font size in pixels
+ * @param spacingMultiplier - Multiplier from design tokens
+ * @returns Line height in pixels
+ *
+ * @example
+ * const lineHeight = calculateLineHeight(16, spacingMultiplier); // 24 → 20
+ */
+export declare const calculateLineHeight: (fontSize: number, spacingMultiplier: number) => number;
+/**
+ * Create responsive StyleSheet values
+ * Converts an object with base sizes to responsive sizes
+ *
+ * @param baseStyles - Object with base style values
+ * @param spacingMultiplier - Multiplier from design tokens
+ * @returns Responsive style values
+ *
+ * @example
+ * const baseSizes = { width: 100, height: 50, padding: 16 };
+ * const responsiveSizes = createResponsiveSizes(baseSizes, spacingMultiplier);
+ */
+export declare const createResponsiveSizes: <T extends Record<string, number>>(baseSizes: T, spacingMultiplier: number) => T;

package/dist/responsive/validation.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Input Validation Utilities
+ *
+ * Centralized validation for all responsive utility functions.
+ * Ensures type safety and prevents runtime errors.
+ */
+/**
+ * Custom error class for responsive utilities
+ */
+export declare class ResponsiveValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validates a numeric input parameter
+ * @param value - The value to validate
+ * @param paramName - Parameter name for error messages
+ * @param min - Minimum allowed value
+ * @param max - Maximum allowed value
+ * @throws ResponsiveValidationError if validation fails
+ */
+export declare const validateNumber: (value: number | undefined, paramName: string, min?: number, max?: number) => number;
+/**
+ * Validates font size input
+ * @param fontSize - Font size to validate
+ * @param paramName - Parameter name for error messages
+ * @returns Validated font size
+ */
+export declare const validateFontSize: (fontSize: number, paramName?: string) => number;
+/**
+ * Validates screen dimensions
+ * @param width - Screen width
+ * @param height - Screen height
+ * @throws ResponsiveValidationError if validation fails
+ */
+export declare const validateScreenDimensions: (width: number, height: number) => void;
+/**
+ * Validates safe area insets
+ * @param insets - Safe area insets object
+ * @throws ResponsiveValidationError if validation fails
+ */
+export declare const validateSafeAreaInsets: (insets: {
+    top?: number;
+    bottom?: number;
+    left?: number;
+    right?: number;
+}) => void;
+/**
+ * Validates grid column parameters
+ * @param mobileColumns - Number of columns for mobile
+ * @param tabletColumns - Number of columns for tablet
+ * @throws ResponsiveValidationError if validation fails
+ */
+export declare const validateGridColumns: (mobileColumns?: number, tabletColumns?: number) => void;
+/**
+ * Clamps a value between min and max bounds
+ * @param value - Value to clamp
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns Clamped value
+ */
+export declare const clamp: (value: number, min: number, max: number) => number;
+/**
+ * Safely calculates a percentage of a value
+ * @param value - Base value
+ * @param percentage - Percentage (0-1)
+ * @returns Calculated percentage
+ */
+export declare const safePercentage: (value: number, percentage: number) => number;

package/dist/safe-area/constants/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Constants for safe area calculations
+ */
+export declare const SAFE_AREA_DEFAULTS: {
+    readonly MIN_HEADER_PADDING: 0;
+    readonly MIN_CONTENT_PADDING: 0;
+    readonly MIN_STATUS_BAR_PADDING: 0;
+    readonly ADDITIONAL_PADDING: 0;
+};
+export declare const PLATFORM_BEHAVIORS: {
+    readonly IOS_STATUS_BAR_USES_SAFE_AREA: true;
+};
+/**
+ * Default configuration that can be overridden by applications
+ */
+export declare const DEFAULT_CONFIG: {
+    readonly minHeaderPadding: 0;
+    readonly minContentPadding: 0;
+    readonly minStatusBarPadding: 0;
+    readonly additionalPadding: 0;
+    readonly iosStatusBarUsesSafeArea: true;
+};

package/dist/safe-area/hooks/useSafeAreaInsets.d.ts

@@ -0,0 +1,10 @@
+/**
+ * useSafeAreaInsets Hook
+ * Get safe area insets with fallback for race conditions
+ *
+ * This wrapper catches the case where the hook is called before
+ * SafeAreaProvider is fully initialized, returning safe default values
+ * instead of throwing an error.
+ */
+import type { EdgeInsets } from 'react-native-safe-area-context';
+export declare const useSafeAreaInsets: () => EdgeInsets;

package/dist/safe-area/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Safe Area Module
+ * Refactored: Simplified to only provide essential safe area utilities.
+ *
+ * We use manual inset management in ScreenLayout for maximum stability
+ * across different React Native versions and devices.
+ */
+export { useSafeAreaInsets } from './hooks/useSafeAreaInsets';
+export { SafeAreaProvider, initialWindowMetrics, SafeAreaView } from 'react-native-safe-area-context';
+export type { Edge, SafeAreaProviderProps } from 'react-native-safe-area-context';

package/dist/storage/__tests__/mocks/asyncStorage.mock.d.ts

@@ -0,0 +1,19 @@
+/**
+ * AsyncStorage Mock
+ *
+ * Mock implementation for testing
+ */
+export declare class AsyncStorageMock {
+    private storage;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+    getAllKeys(): Promise<readonly string[]>;
+    multiGet(keys: readonly string[]): Promise<readonly (readonly [string, string | null])[]>;
+    __clear(): void;
+    __size(): number;
+    __has(key: string): boolean;
+    __get(key: string): string | undefined;
+}
+export declare const AsyncStorage: AsyncStorageMock;

package/dist/storage/__tests__/setup.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Test Setup
+ *
+ * Global test configuration and mocks
+ */
+import 'jest-environment-jsdom';
+export declare const mockPerformance: () => {
+    now: jest.Mock<number, [], any>;
+    mark: jest.Mock<any, any, any>;
+    measure: jest.Mock<any, any, any>;
+};
+export declare const trackMemoryUsage: () => {
+    addListener: (listener: () => void) => () => boolean;
+    getListenerCount: () => number;
+    cleanup: () => void;
+};

package/dist/storage/application/ports/IStorageRepository.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Storage Repository Interface (Port)
+ *
+ * Domain-Driven Design: Application port for storage operations
+ * Infrastructure layer implements this interface
+ */
+import type { StorageResult } from '../../domain/entities/StorageResult';
+/**
+ * Storage Repository Interface
+ * Defines contract for storage operations
+ */
+export interface IStorageRepository {
+    /**
+     * Get item from storage with JSON parsing
+     */
+    getItem<T>(key: string, defaultValue: T): Promise<StorageResult<T>>;
+    /**
+     * Set item in storage with JSON serialization
+     */
+    setItem<T>(key: string, value: T): Promise<StorageResult<T>>;
+    /**
+     * Get string value (no JSON parsing)
+     */
+    getString(key: string, defaultValue: string): Promise<StorageResult<string>>;
+    /**
+     * Set string value (no JSON serialization)
+     */
+    setString(key: string, value: string): Promise<StorageResult<string>>;
+    /**
+     * Remove item from storage
+     */
+    removeItem(key: string): Promise<StorageResult<void>>;
+    /**
+     * Check if key exists in storage
+     */
+    hasItem(key: string): Promise<boolean>;
+    /**
+     * Clear all storage data
+     */
+    clearAll(): Promise<StorageResult<void>>;
+    /**
+     * Get multiple items at once
+     */
+    getMultiple(keys: string[]): Promise<StorageResult<Record<string, string | null>>>;
+    /**
+     * Get all keys from storage
+     */
+    getAllKeys(): Promise<StorageResult<string[]>>;
+}

package/dist/storage/cache/__tests__/setup.d.ts

@@ -0,0 +1,3 @@
+/**
+ * Test Setup
+ */

package/dist/storage/cache/domain/Cache.d.ts

@@ -0,0 +1,22 @@
+/**
+ * In-Memory Cache
+ */
+import type { CacheEntry, CacheConfig, CacheStats } from './types/Cache';
+import { CacheStatsTracker } from './CacheStatsTracker';
+export declare class Cache<T = unknown> {
+    protected store: Map<string, CacheEntry<T>>;
+    private config;
+    protected statsTracker: CacheStatsTracker;
+    private strategies;
+    constructor(config?: CacheConfig);
+    set(key: string, value: T, ttl?: number): void;
+    get(key: string): T | undefined;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    invalidatePattern(pattern: string): number;
+    clear(): void;
+    getStats(): CacheStats;
+    keys(): string[];
+    private isExpired;
+    private evictOne;
+}