@hoddy-ui/next 2.5.69 → 2.5.73

package/dist/index.d.mts

@@ -714,8 +714,156 @@ declare const useNavScreenOptions: (type: "stack" | "tab" | "drawer") => any;
 declare const UIThemeContext: React.Context<ThemeContext>;
 declare const UIThemeProvider: ({ children }: ThemeProviderProps) => React.JSX.Element;
 
+declare const useAppState: () => {
+    isActive: boolean;
+};
+
+interface UseBlinkAnimationProps {
+    delay?: number;
+    blinkDuration?: number;
+    minOpacity?: number;
+    maxOpacity?: number;
+}
+declare const useBlinkAnimation: ({ delay, blinkDuration, minOpacity, maxOpacity, }?: UseBlinkAnimationProps) => {
+    animatedStyle: {
+        opacity: number;
+    };
+};
+
+interface UseFadeAnimationProps {
+    duration?: number;
+    delay?: number;
+    closeAfter?: number | null;
+}
+declare const useFadeAnimation: ({ duration, delay, closeAfter, }?: UseFadeAnimationProps) => {
+    animatedStyle: {
+        opacity: number;
+    };
+};
+
+interface UseFloatAnimationProps {
+    duration?: number;
+    delay?: number;
+    closeAfter?: number | null;
+    closeDuration?: number;
+    floatDistance?: number;
+    floatDuration?: number;
+}
+declare const useFloatAnimation: ({ duration, delay, closeAfter, closeDuration, floatDistance, floatDuration, }?: UseFloatAnimationProps) => {
+    animatedStyle: {
+        opacity: number;
+        transform: {
+            translateY: number;
+        }[];
+    };
+};
+
+interface UseGrowAnimationProps {
+    duration?: number;
+    delay?: number;
+    closeAfter?: number | null;
+    initialScale?: number;
+}
+declare const useGrowAnimation: ({ duration, delay, closeAfter, initialScale, }?: UseGrowAnimationProps) => {
+    animatedStyle: {
+        transform: {
+            scale: number;
+        }[];
+    };
+};
+
+interface UseRollAnimationProps {
+    duration?: number;
+    delay?: number;
+    closeAfter?: number | null;
+    initialTranslateY?: number;
+    initialRotate?: string;
+}
+declare const useRollAnimation: ({ duration, delay, closeAfter, initialTranslateY, initialRotate, }?: UseRollAnimationProps) => {
+    animatedStyle: {
+        transform: ({
+            translateY: number;
+            rotate?: undefined;
+        } | {
+            rotate: string;
+            translateY?: undefined;
+        })[];
+    };
+};
+
+interface UseSlideAnimationProps {
+    duration?: number;
+    delay?: number;
+    direction?: "up" | "down" | "left" | "right";
+    closeAfter?: number | null;
+    initialValue?: number;
+}
+declare const useSlideAnimation: ({ duration, delay, direction, closeAfter, initialValue, }?: UseSlideAnimationProps) => {
+    animatedStyle: {
+        transform: {
+            translateY: number;
+        }[];
+    } | {
+        transform: {
+            translateX: number;
+        }[];
+    };
+};
+
+interface UseThrownUpAnimationProps {
+    delay?: number;
+    closeAfter?: number | null;
+}
+declare const useThrownUpAnimation: ({ delay, closeAfter, }?: UseThrownUpAnimationProps) => {
+    animatedStyle: {
+        transform: {
+            translateY: number;
+        }[];
+        opacity: number;
+    };
+};
+
+/**
+ * Unified Animator component that handles multiple animation types with type-safe props.
+ *
+ * Each animation type only accepts its relevant props, ensuring type safety and better developer experience.
+ *
+ * @example
+ * // Fade animation - only accepts base props
+ * <Animator type="fade" duration={1000} closeAfter={3000}>
+ *   <Text>This will fade in and out</Text>
+ * </Animator>
+ *
+ * @example
+ * // Slide animation - only accepts direction and initialValue props
+ * <Animator type="slide" direction="up" duration={800} closeAfter={2000}>
+ *   <View>This will slide up from bottom</View>
+ * </Animator>
+ *
+ * @example
+ * // Grow animation - only accepts initialScale prop
+ * <Animator type="grow" initialScale={0.5} duration={600}>
+ *   <Button>This will grow from 50% scale</Button>
+ * </Animator>
+ *
+ * @example
+ * // Blink animation - only accepts blink-specific props
+ * <Animator type="blink" blinkDuration={1000} minOpacity={0.3}>
+ *   <Icon>This will blink continuously</Icon>
+ * </Animator>
+ *
+ * @example
+ * // TypeScript will show errors for invalid prop combinations:
+ * // ❌ This will cause a TypeScript error:
+ * // <Animator type="fade" direction="up"> // direction is not valid for fade
+ * //
+ * // ✅ This is correct:
+ * // <Animator type="slide" direction="up">
+ */
+declare const Animator: FC<AnimatorProps>;
+
 declare const HoddyUI: {
     initialize: typeof initialize;
 };
 
-export { AdaptiveStatusBar, AlertX, type AlertXProps, type AnimationType, type AnimatorProps, Avatar, type AvatarProps, Button, type ButtonProps, CheckBox, type CheckboxProps, Divider, type DividerProps, type FlashMessageProps, FormWrapper, type FormWrapperProps, Grid, GridItem, type GridItemProps, type GridProps, IconButton, type IconButtonProps, LinkButton, type LinkButtonProps, type ListItemProps, type ListItemTextProps, type ListProps, Locator, type LocatorInputProps, type LocatorProps, OTPInput, type OTPInputProps, Popup, type PopupProps, RatingInput, type RatingInputProps, RatingStars, type RatingStarsProps, SafeAreaView, type SafeAreaViewProps, SelectMenu, type SelectMenuProps, Spinner, type SpinnerProps, TextField, TextField2, type TextFieldProps, type ThemeActionTypes, type ThemeContext, type ThemeModes, type ThemeProviderProps, type ThemeState, type ThemeTypes, Typography, type TypographyProps, UIThemeContext, UIThemeProvider, type colorTypes, HoddyUI as default, type extraColorTypes, getLocationFromPlaceId, getPredictionsFromCoords, getPredictionsFromQuery, type locatorLocation, type predictionType, showFlashMessage, useColors, useNavScreenOptions, useTheme, useThemeContext };
+export { AdaptiveStatusBar, AlertX, type AlertXProps, type AnimationType, Animator, type AnimatorProps, Avatar, type AvatarProps, Button, type ButtonProps, CheckBox, type CheckboxProps, Divider, type DividerProps, type FlashMessageProps, FormWrapper, type FormWrapperProps, Grid, GridItem, type GridItemProps, type GridProps, IconButton, type IconButtonProps, LinkButton, type LinkButtonProps, type ListItemProps, type ListItemTextProps, type ListProps, Locator, type LocatorInputProps, type LocatorProps, OTPInput, type OTPInputProps, Popup, type PopupProps, RatingInput, type RatingInputProps, RatingStars, type RatingStarsProps, SafeAreaView, type SafeAreaViewProps, SelectMenu, type SelectMenuProps, Spinner, type SpinnerProps, TextField, TextField2, type TextFieldProps, type ThemeActionTypes, type ThemeContext, type ThemeModes, type ThemeProviderProps, type ThemeState, type ThemeTypes, Typography, type TypographyProps, UIThemeContext, UIThemeProvider, type colorTypes, HoddyUI as default, type extraColorTypes, getLocationFromPlaceId, getPredictionsFromCoords, getPredictionsFromQuery, type locatorLocation, type predictionType, showFlashMessage, useAppState, useBlinkAnimation, useColors, useFadeAnimation, useFloatAnimation, useGrowAnimation, useNavScreenOptions, useRollAnimation, useSlideAnimation, useTheme, useThemeContext, useThrownUpAnimation };

package/dist/index.d.ts

@@ -714,8 +714,156 @@ declare const useNavScreenOptions: (type: "stack" | "tab" | "drawer") => any;
 declare const UIThemeContext: React.Context<ThemeContext>;
 declare const UIThemeProvider: ({ children }: ThemeProviderProps) => React.JSX.Element;
 
+declare const useAppState: () => {
+    isActive: boolean;
+};
+
+interface UseBlinkAnimationProps {
+    delay?: number;
+    blinkDuration?: number;
+    minOpacity?: number;
+    maxOpacity?: number;
+}
+declare const useBlinkAnimation: ({ delay, blinkDuration, minOpacity, maxOpacity, }?: UseBlinkAnimationProps) => {
+    animatedStyle: {
+        opacity: number;
+    };
+};
+
+interface UseFadeAnimationProps {
+    duration?: number;
+    delay?: number;
+    closeAfter?: number | null;
+}
+declare const useFadeAnimation: ({ duration, delay, closeAfter, }?: UseFadeAnimationProps) => {
+    animatedStyle: {
+        opacity: number;
+    };
+};
+
+interface UseFloatAnimationProps {
+    duration?: number;
+    delay?: number;
+    closeAfter?: number | null;
+    closeDuration?: number;
+    floatDistance?: number;
+    floatDuration?: number;
+}
+declare const useFloatAnimation: ({ duration, delay, closeAfter, closeDuration, floatDistance, floatDuration, }?: UseFloatAnimationProps) => {
+    animatedStyle: {
+        opacity: number;
+        transform: {
+            translateY: number;
+        }[];
+    };
+};
+
+interface UseGrowAnimationProps {
+    duration?: number;
+    delay?: number;
+    closeAfter?: number | null;
+    initialScale?: number;
+}
+declare const useGrowAnimation: ({ duration, delay, closeAfter, initialScale, }?: UseGrowAnimationProps) => {
+    animatedStyle: {
+        transform: {
+            scale: number;
+        }[];
+    };
+};
+
+interface UseRollAnimationProps {
+    duration?: number;
+    delay?: number;
+    closeAfter?: number | null;
+    initialTranslateY?: number;
+    initialRotate?: string;
+}
+declare const useRollAnimation: ({ duration, delay, closeAfter, initialTranslateY, initialRotate, }?: UseRollAnimationProps) => {
+    animatedStyle: {
+        transform: ({
+            translateY: number;
+            rotate?: undefined;
+        } | {
+            rotate: string;
+            translateY?: undefined;
+        })[];
+    };
+};
+
+interface UseSlideAnimationProps {
+    duration?: number;
+    delay?: number;
+    direction?: "up" | "down" | "left" | "right";
+    closeAfter?: number | null;
+    initialValue?: number;
+}
+declare const useSlideAnimation: ({ duration, delay, direction, closeAfter, initialValue, }?: UseSlideAnimationProps) => {
+    animatedStyle: {
+        transform: {
+            translateY: number;
+        }[];
+    } | {
+        transform: {
+            translateX: number;
+        }[];
+    };
+};
+
+interface UseThrownUpAnimationProps {
+    delay?: number;
+    closeAfter?: number | null;
+}
+declare const useThrownUpAnimation: ({ delay, closeAfter, }?: UseThrownUpAnimationProps) => {
+    animatedStyle: {
+        transform: {
+            translateY: number;
+        }[];
+        opacity: number;
+    };
+};
+
+/**
+ * Unified Animator component that handles multiple animation types with type-safe props.
+ *
+ * Each animation type only accepts its relevant props, ensuring type safety and better developer experience.
+ *
+ * @example
+ * // Fade animation - only accepts base props
+ * <Animator type="fade" duration={1000} closeAfter={3000}>
+ *   <Text>This will fade in and out</Text>
+ * </Animator>
+ *
+ * @example
+ * // Slide animation - only accepts direction and initialValue props
+ * <Animator type="slide" direction="up" duration={800} closeAfter={2000}>
+ *   <View>This will slide up from bottom</View>
+ * </Animator>
+ *
+ * @example
+ * // Grow animation - only accepts initialScale prop
+ * <Animator type="grow" initialScale={0.5} duration={600}>
+ *   <Button>This will grow from 50% scale</Button>
+ * </Animator>
+ *
+ * @example
+ * // Blink animation - only accepts blink-specific props
+ * <Animator type="blink" blinkDuration={1000} minOpacity={0.3}>
+ *   <Icon>This will blink continuously</Icon>
+ * </Animator>
+ *
+ * @example
+ * // TypeScript will show errors for invalid prop combinations:
+ * // ❌ This will cause a TypeScript error:
+ * // <Animator type="fade" direction="up"> // direction is not valid for fade
+ * //
+ * // ✅ This is correct:
+ * // <Animator type="slide" direction="up">
+ */
+declare const Animator: FC<AnimatorProps>;
+
 declare const HoddyUI: {
     initialize: typeof initialize;
 };
 
-export { AdaptiveStatusBar, AlertX, type AlertXProps, type AnimationType, type AnimatorProps, Avatar, type AvatarProps, Button, type ButtonProps, CheckBox, type CheckboxProps, Divider, type DividerProps, type FlashMessageProps, FormWrapper, type FormWrapperProps, Grid, GridItem, type GridItemProps, type GridProps, IconButton, type IconButtonProps, LinkButton, type LinkButtonProps, type ListItemProps, type ListItemTextProps, type ListProps, Locator, type LocatorInputProps, type LocatorProps, OTPInput, type OTPInputProps, Popup, type PopupProps, RatingInput, type RatingInputProps, RatingStars, type RatingStarsProps, SafeAreaView, type SafeAreaViewProps, SelectMenu, type SelectMenuProps, Spinner, type SpinnerProps, TextField, TextField2, type TextFieldProps, type ThemeActionTypes, type ThemeContext, type ThemeModes, type ThemeProviderProps, type ThemeState, type ThemeTypes, Typography, type TypographyProps, UIThemeContext, UIThemeProvider, type colorTypes, HoddyUI as default, type extraColorTypes, getLocationFromPlaceId, getPredictionsFromCoords, getPredictionsFromQuery, type locatorLocation, type predictionType, showFlashMessage, useColors, useNavScreenOptions, useTheme, useThemeContext };
+export { AdaptiveStatusBar, AlertX, type AlertXProps, type AnimationType, Animator, type AnimatorProps, Avatar, type AvatarProps, Button, type ButtonProps, CheckBox, type CheckboxProps, Divider, type DividerProps, type FlashMessageProps, FormWrapper, type FormWrapperProps, Grid, GridItem, type GridItemProps, type GridProps, IconButton, type IconButtonProps, LinkButton, type LinkButtonProps, type ListItemProps, type ListItemTextProps, type ListProps, Locator, type LocatorInputProps, type LocatorProps, OTPInput, type OTPInputProps, Popup, type PopupProps, RatingInput, type RatingInputProps, RatingStars, type RatingStarsProps, SafeAreaView, type SafeAreaViewProps, SelectMenu, type SelectMenuProps, Spinner, type SpinnerProps, TextField, TextField2, type TextFieldProps, type ThemeActionTypes, type ThemeContext, type ThemeModes, type ThemeProviderProps, type ThemeState, type ThemeTypes, Typography, type TypographyProps, UIThemeContext, UIThemeProvider, type colorTypes, HoddyUI as default, type extraColorTypes, getLocationFromPlaceId, getPredictionsFromCoords, getPredictionsFromQuery, type locatorLocation, type predictionType, showFlashMessage, useAppState, useBlinkAnimation, useColors, useFadeAnimation, useFloatAnimation, useGrowAnimation, useNavScreenOptions, useRollAnimation, useSlideAnimation, useTheme, useThemeContext, useThrownUpAnimation };