rn-iconify 1.0.0 → 2.0.0

package/lib/typescript/alias/createIconAliases.d.ts

@@ -0,0 +1,77 @@
+/**
+ * createIconAliases - Factory function for creating type-safe icon aliases
+ * Provides full TypeScript autocomplete for alias names
+ */
+import type { IconAliasMap, CreateIconAliasesConfig, IconAliasResult } from './types';
+/**
+ * Create a type-safe icon alias system
+ *
+ * This function creates:
+ * - A typed Icon component with autocomplete for alias names
+ * - A Provider component to wrap your app
+ * - A resolve function to convert aliases to full icon names
+ *
+ * @example Basic usage
+ * ```tsx
+ * // icons.ts
+ * import { createIconAliases } from 'rn-iconify';
+ *
+ * export const { Icon, Provider: IconProvider, aliases } = createIconAliases({
+ *   aliases: {
+ *     back: 'mdi:arrow-left',
+ *     forward: 'mdi:arrow-right',
+ *     menu: 'heroicons:bars-3',
+ *     close: 'mdi:close',
+ *     home: 'mdi:home',
+ *     settings: 'lucide:settings',
+ *   } as const,
+ * });
+ *
+ * // App.tsx
+ * import { Icon, IconProvider } from './icons';
+ *
+ * function App() {
+ *   return (
+ *     <IconProvider>
+ *       <Icon name="back" size={24} />    {// TypeScript autocomplete! }
+ *       <Icon name="menu" color="blue" />
+ *     </IconProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example With navigation
+ * ```tsx
+ * import { Icon } from './icons';
+ *
+ * <Tab.Screen
+ *   options={{
+ *     tabBarIcon: ({ color, size }) => (
+ *       <Icon name="home" color={color} size={size} />
+ *     ),
+ *   }}
+ * />
+ * ```
+ */
+export declare function createIconAliases<T extends IconAliasMap>(config: CreateIconAliasesConfig<T>): IconAliasResult<T>;
+/**
+ * Quick helper to create aliases without full type safety
+ * Useful for simple cases or when aliases are dynamic
+ *
+ * @example
+ * ```tsx
+ * import { defineAliases, Icon, IconAliasProvider } from 'rn-iconify';
+ *
+ * const aliases = defineAliases({
+ *   back: 'mdi:arrow-left',
+ *   menu: 'heroicons:bars-3',
+ * });
+ *
+ * <IconAliasProvider aliases={aliases}>
+ *   <Icon name="back" />
+ * </IconAliasProvider>
+ * ```
+ */
+export declare function defineAliases<T extends IconAliasMap>(aliases: T): T;
+export default createIconAliases;
+//# sourceMappingURL=createIconAliases.d.ts.map

package/lib/typescript/alias/createIconAliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIconAliases.d.ts","sourceRoot":"","sources":["../../../src/alias/createIconAliases.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EACV,YAAY,EAIZ,uBAAuB,EACvB,eAAe,EAChB,MAAM,SAAS,CAAC;AAsBjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EACtD,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC,GACjC,eAAe,CAAC,CAAC,CAAC,CAkHpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAKnE;AAED,eAAe,iBAAiB,CAAC"}

package/lib/typescript/alias/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Icon Alias System
+ * Create custom icon name mappings for consistent usage across your app
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { createIconAliases } from 'rn-iconify';
+ *
+ * const { Icon, Provider } = createIconAliases({
+ *   aliases: {
+ *     back: 'mdi:arrow-left',
+ *     menu: 'heroicons:bars-3',
+ *   } as const,
+ * });
+ *
+ * <Provider>
+ *   <Icon name="back" />
+ * </Provider>
+ * ```
+ *
+ * @example With generic Icon component
+ * ```tsx
+ * import { Icon, IconAliasProvider } from 'rn-iconify';
+ *
+ * <IconAliasProvider aliases={{ back: 'mdi:arrow-left' }}>
+ *   <Icon name="back" />
+ *   <Icon name="mdi:home" />  // Full names still work
+ * </IconAliasProvider>
+ * ```
+ */
+export type { IconAliasMap, IconAliases, AliasName, GenericIconProps, IconAliasContextValue, IconAliasProviderProps, CreateIconAliasesConfig, IconAliasResult, } from './types';
+export { IconAliasContext, IconAliasProvider, useIconAliasContext, useResolveIcon, } from './IconAliasContext';
+export { Icon } from './Icon';
+export { createIconAliases, defineAliases } from './createIconAliases';
+export { createIconAliases as default } from './createIconAliases';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/alias/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/alias/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,YAAY,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAE,iBAAiB,IAAI,OAAO,EAAE,MAAM,qBAAqB,CAAC"}

package/lib/typescript/alias/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Icon Alias System Types
+ * Type definitions for the icon alias feature
+ */
+import type { IconProps } from '../types';
+/**
+ * Icon alias definition - maps alias name to full icon name
+ * @example { back: 'mdi:arrow-left', menu: 'heroicons:bars-3' }
+ */
+export type IconAliasMap = Record<string, string>;
+/**
+ * Type-safe alias configuration
+ * Uses 'as const' for full TypeScript inference
+ */
+export type IconAliases<T extends IconAliasMap> = {
+    readonly [K in keyof T]: T[K];
+};
+/**
+ * Extract alias names from an alias map
+ */
+export type AliasName<T extends IconAliasMap> = keyof T & string;
+/**
+ * Props for the generic Icon component
+ * Accepts either a full icon name (prefix:name) or an alias
+ */
+export interface GenericIconProps<TAlias extends string = string> extends Omit<IconProps<TAlias>, 'name'> {
+    /**
+     * Icon name - can be:
+     * - Full icon name: "mdi:home", "heroicons:user"
+     * - Alias name: "back", "menu" (if aliases are configured)
+     */
+    name: TAlias | string;
+}
+/**
+ * Icon alias context value
+ */
+export interface IconAliasContextValue {
+    /**
+     * Registered aliases
+     */
+    aliases: IconAliasMap;
+    /**
+     * Resolve an alias or icon name to full icon name
+     * @param name Alias or full icon name
+     * @returns Full icon name (prefix:name format)
+     */
+    resolveIcon: (name: string) => string;
+    /**
+     * Check if a name is a registered alias
+     */
+    isAlias: (name: string) => boolean;
+    /**
+     * Register additional aliases at runtime
+     */
+    registerAliases: (newAliases: IconAliasMap) => void;
+}
+/**
+ * Props for IconAliasProvider
+ */
+export interface IconAliasProviderProps {
+    /**
+     * Icon alias definitions
+     */
+    aliases: IconAliasMap;
+    /**
+     * Allow extending parent aliases (default: true)
+     */
+    extend?: boolean;
+    /**
+     * Children components
+     */
+    children: React.ReactNode;
+}
+/**
+ * Configuration for createIconAliases
+ */
+export interface CreateIconAliasesConfig<T extends IconAliasMap> {
+    /**
+     * Alias definitions
+     */
+    aliases: T;
+    /**
+     * Validate icon names at creation time (dev only)
+     * @default true
+     */
+    validate?: boolean;
+}
+/**
+ * Return type for createIconAliases
+ */
+export interface IconAliasResult<T extends IconAliasMap> {
+    /**
+     * The alias map
+     */
+    aliases: IconAliases<T>;
+    /**
+     * Type-safe Icon component with alias support
+     */
+    Icon: React.ComponentType<GenericIconProps<AliasName<T>>>;
+    /**
+     * Provider component for alias context
+     */
+    Provider: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    /**
+     * Resolve function
+     */
+    resolve: (name: AliasName<T> | string) => string;
+    /**
+     * Type helper for alias names
+     */
+    AliasName: AliasName<T>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/alias/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/alias/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,YAAY,IAAI;IAChD,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,CAC9D,SAAQ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACvC;;;;OAIG;IACH,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;;;OAIG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAEtC;;OAEG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAEnC;;OAEG;IACH,eAAe,EAAE,CAAC,UAAU,EAAE,YAAY,KAAK,IAAI,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,YAAY;IAC7D;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC;IAEX;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,YAAY;IACrD;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAExB;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1D;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,CAAC,CAAC;IAE7D;;OAEG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,MAAM,CAAC;IAEjD;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;CACzB"}

package/lib/typescript/animated/AnimatedIcon.d.ts

@@ -0,0 +1,45 @@
+/**
+ * AnimatedIcon - Wrapper component for animated icons
+ * Provides animation capabilities to any icon component
+ */
+import React from 'react';
+import type { AnimatedIconProps, AnimationControls } from './types';
+/**
+ * AnimatedIcon wrapper component
+ * Wraps any icon component to add animation capabilities
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { AnimatedIcon } from 'rn-iconify/animated';
+ * import { Mdi } from 'rn-iconify';
+ *
+ * <AnimatedIcon animate="spin">
+ *   <Mdi name="loading" size={24} />
+ * </AnimatedIcon>
+ * ```
+ *
+ * @example With custom configuration
+ * ```tsx
+ * <AnimatedIcon
+ *   animate={{ type: 'rotate', duration: 2000, easing: 'linear' }}
+ *   autoPlay={true}
+ * >
+ *   <Mdi name="sync" size={24} />
+ * </AnimatedIcon>
+ * ```
+ *
+ * @example With ref for animation control
+ * ```tsx
+ * const animationRef = useRef<AnimationControls>(null);
+ *
+ * <AnimatedIcon ref={animationRef} animate="bounce" autoPlay={false}>
+ *   <Mdi name="heart" size={24} />
+ * </AnimatedIcon>
+ *
+ * // Later
+ * animationRef.current?.start();
+ * ```
+ */
+export declare const AnimatedIcon: React.ForwardRefExoticComponent<AnimatedIconProps & React.RefAttributes<AnimationControls>>;
+export default AnimatedIcon;
+//# sourceMappingURL=AnimatedIcon.d.ts.map

package/lib/typescript/animated/AnimatedIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimatedIcon.d.ts","sourceRoot":"","sources":["../../../src/animated/AnimatedIcon.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAA0C,MAAM,OAAO,CAAC;AAG/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,YAAY,6FA4DvB,CAAC;AASH,eAAe,YAAY,CAAC"}

package/lib/typescript/animated/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Animated Icons Module
+ * Provides animation capabilities for rn-iconify icons
+ *
+ * @example Basic usage with preset
+ * ```tsx
+ * import { Mdi } from 'rn-iconify';
+ *
+ * // Direct usage with animate prop
+ * <Mdi name="loading" animate="spin" />
+ * <Mdi name="heart" animate="pulse" />
+ * <Mdi name="bell" animate="shake" />
+ * ```
+ *
+ * @example Using AnimatedIcon wrapper
+ * ```tsx
+ * import { AnimatedIcon } from 'rn-iconify/animated';
+ * import { Mdi } from 'rn-iconify';
+ *
+ * <AnimatedIcon animate="bounce">
+ *   <Mdi name="star" size={24} />
+ * </AnimatedIcon>
+ * ```
+ *
+ * @example Custom animation configuration
+ * ```tsx
+ * <Mdi
+ *   name="sync"
+ *   animate={{
+ *     type: 'rotate',
+ *     duration: 2000,
+ *     easing: 'linear',
+ *     loop: true,
+ *   }}
+ * />
+ * ```
+ *
+ * @example Animation control with ref
+ * ```tsx
+ * import { useRef } from 'react';
+ * import { AnimatedIcon, AnimationControls } from 'rn-iconify/animated';
+ *
+ * function MyComponent() {
+ *   const animRef = useRef<AnimationControls>(null);
+ *
+ *   const handlePress = () => {
+ *     if (animRef.current?.isAnimating) {
+ *       animRef.current.stop();
+ *     } else {
+ *       animRef.current?.start();
+ *     }
+ *   };
+ *
+ *   return (
+ *     <TouchableOpacity onPress={handlePress}>
+ *       <AnimatedIcon ref={animRef} animate="spin" autoPlay={false}>
+ *         <Mdi name="refresh" size={24} />
+ *       </AnimatedIcon>
+ *     </TouchableOpacity>
+ *   );
+ * }
+ * ```
+ */
+export type { AnimationPreset, AnimationDirection, AnimationEasing, AnimationConfig, AnimationType, ResolvedAnimationConfig, AnimationState, AnimationControls, AnimatedIconProps, } from './types';
+export { DEFAULT_ANIMATION_DURATIONS, DEFAULT_ANIMATION_LOOPS } from './types';
+export { ANIMATION_PRESETS, getEasingFunction, resolveAnimation, isAnimationPreset, getDefaultDuration, getDefaultLoop, } from './presets';
+export { useIconAnimation } from './useIconAnimation';
+export { AnimatedIcon } from './AnimatedIcon';
+export { AnimatedIcon as default } from './AnimatedIcon';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/animated/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/animated/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAGH,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAG/E,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,YAAY,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/typescript/animated/presets.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Animation presets for rn-iconify
+ * Pre-configured animations for common use cases
+ */
+import type { AnimationPreset, AnimationConfig, ResolvedAnimationConfig, AnimationType, AnimationEasing } from './types';
+/**
+ * Preset animation configurations
+ */
+export declare const ANIMATION_PRESETS: Record<AnimationPreset, AnimationConfig>;
+/**
+ * Convert easing string to React Native Easing function
+ */
+export declare function getEasingFunction(easing: AnimationEasing): (value: number) => number;
+/**
+ * Resolve animation type to full configuration
+ */
+export declare function resolveAnimation(animation: AnimationType, overrides?: {
+    duration?: number;
+    loop?: boolean;
+    easing?: AnimationEasing;
+    delay?: number;
+}): ResolvedAnimationConfig;
+/**
+ * Check if a string is a valid animation preset
+ */
+export declare function isAnimationPreset(value: string): value is AnimationPreset;
+/**
+ * Get default duration for a preset
+ */
+export declare function getDefaultDuration(preset: AnimationPreset): number;
+/**
+ * Get default loop setting for a preset
+ */
+export declare function getDefaultLoop(preset: AnimationPreset): boolean;
+//# sourceMappingURL=presets.d.ts.map

package/lib/typescript/animated/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/animated/presets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,eAAe,EAAE,eAAe,CA0FtE,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAqBpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,aAAa,EACxB,SAAS,CAAC,EAAE;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,uBAAuB,CA2CzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAE/D"}

package/lib/typescript/animated/types.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Animation types for rn-iconify
+ * Supports preset animations and custom configurations
+ */
+import type { EasingFunction } from 'react-native';
+/**
+ * Built-in animation presets
+ */
+export type AnimationPreset = 'spin' | 'pulse' | 'bounce' | 'shake' | 'ping' | 'wiggle';
+/**
+ * Animation direction for reversible animations
+ */
+export type AnimationDirection = 'normal' | 'reverse' | 'alternate' | 'alternate-reverse';
+/**
+ * Animation easing options
+ */
+export type AnimationEasing = 'linear' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'bounce' | EasingFunction;
+/**
+ * Custom animation configuration
+ */
+export interface AnimationConfig {
+    /**
+     * Animation type
+     */
+    type: 'rotate' | 'scale' | 'opacity' | 'translate' | 'sequence';
+    /**
+     * Animation duration in milliseconds
+     * @default 1000
+     */
+    duration?: number;
+    /**
+     * Whether to loop the animation
+     * @default true for spin/pulse/bounce/ping, false for shake/wiggle
+     */
+    loop?: boolean;
+    /**
+     * Number of times to loop (-1 for infinite)
+     * @default -1
+     */
+    iterations?: number;
+    /**
+     * Animation easing function
+     * @default varies by preset: 'linear' for spin, 'ease-in-out' for pulse/wiggle, 'bounce' for bounce, 'ease-out' for shake/ping
+     */
+    easing?: AnimationEasing;
+    /**
+     * Animation direction
+     * @default 'normal'
+     */
+    direction?: AnimationDirection;
+    /**
+     * Delay before animation starts (ms)
+     * @default 0
+     */
+    delay?: number;
+    /**
+     * For rotate: degrees to rotate (default: 360)
+     * For scale: min/max scale values
+     * For opacity: min/max opacity values
+     * For translate: x/y translation values
+     */
+    from?: number | {
+        x?: number;
+        y?: number;
+    };
+    to?: number | {
+        x?: number;
+        y?: number;
+    };
+}
+/**
+ * Animation prop type - can be a preset string or custom config
+ */
+export type AnimationType = AnimationPreset | AnimationConfig;
+/**
+ * Resolved animation configuration with all defaults applied
+ */
+export interface ResolvedAnimationConfig {
+    type: AnimationConfig['type'];
+    duration: number;
+    loop: boolean;
+    iterations: number;
+    easing: AnimationEasing;
+    direction: AnimationDirection;
+    delay: number;
+    from: number | {
+        x: number;
+        y: number;
+    };
+    to: number | {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Animation state for tracking animation lifecycle
+ */
+export type AnimationState = 'idle' | 'running' | 'paused' | 'completed';
+/**
+ * Animation control interface returned by useIconAnimation
+ */
+export interface AnimationControls {
+    /**
+     * Start the animation
+     */
+    start: () => void;
+    /**
+     * Stop the animation
+     */
+    stop: () => void;
+    /**
+     * Pause the animation
+     */
+    pause: () => void;
+    /**
+     * Resume a paused animation
+     */
+    resume: () => void;
+    /**
+     * Reset animation to initial state
+     */
+    reset: () => void;
+    /**
+     * Current animation state
+     */
+    state: AnimationState;
+    /**
+     * Whether animation is currently running
+     */
+    isAnimating: boolean;
+}
+/**
+ * Props for animated icon components
+ */
+export interface AnimatedIconProps {
+    /**
+     * Icon element to animate
+     */
+    children: React.ReactNode;
+    /**
+     * Animation to apply
+     * Can be a preset name or custom configuration
+     * @example 'spin'
+     * @example { type: 'rotate', duration: 2000, easing: 'linear' }
+     */
+    animate?: AnimationType;
+    /**
+     * Animation duration override (ms)
+     * @default varies by preset
+     */
+    animationDuration?: number;
+    /**
+     * Whether animation should loop
+     * @default true
+     */
+    animationLoop?: boolean;
+    /**
+     * Animation easing override
+     */
+    animationEasing?: AnimationEasing;
+    /**
+     * Delay before animation starts (ms)
+     * @default 0
+     */
+    animationDelay?: number;
+    /**
+     * Whether to start animation immediately
+     * @default true
+     */
+    autoPlay?: boolean;
+    /**
+     * Callback when animation completes (for non-looping animations)
+     */
+    onAnimationComplete?: () => void;
+    /**
+     * Width of the animation container
+     */
+    width?: number;
+    /**
+     * Height of the animation container
+     */
+    height?: number;
+    /**
+     * Test ID for testing
+     */
+    testID?: string;
+}
+/**
+ * Default animation durations by preset
+ */
+export declare const DEFAULT_ANIMATION_DURATIONS: Record<AnimationPreset, number>;
+/**
+ * Default animation loop settings by preset
+ */
+export declare const DEFAULT_ANIMATION_LOOPS: Record<AnimationPreset, boolean>;
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/animated/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/animated/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/animated/useIconAnimation.d.ts

@@ -0,0 +1,64 @@
+/**
+ * useIconAnimation - Hook for managing icon animations
+ * Handles Animated values, timing, and animation lifecycle
+ */
+import { Animated } from 'react-native';
+import type { AnimationType, AnimationControls, AnimationEasing } from './types';
+interface UseIconAnimationOptions {
+    /**
+     * Animation configuration
+     */
+    animation?: AnimationType;
+    /**
+     * Duration override (ms)
+     */
+    duration?: number;
+    /**
+     * Loop override
+     */
+    loop?: boolean;
+    /**
+     * Easing override
+     */
+    easing?: AnimationEasing;
+    /**
+     * Delay before animation starts (ms)
+     */
+    delay?: number;
+    /**
+     * Whether to start automatically
+     * @default true
+     */
+    autoPlay?: boolean;
+    /**
+     * Callback when animation completes
+     */
+    onComplete?: () => void;
+}
+interface UseIconAnimationReturn extends AnimationControls {
+    /**
+     * Animated style to apply to the icon
+     */
+    animatedStyle: {
+        transform?: Array<{
+            rotate: Animated.AnimatedInterpolation<string>;
+        } | {
+            scale: Animated.Value;
+        } | {
+            translateX: Animated.Value;
+        } | {
+            translateY: Animated.Value;
+        }>;
+        opacity?: Animated.Value;
+    };
+    /**
+     * Whether animation is enabled
+     */
+    hasAnimation: boolean;
+}
+/**
+ * Hook for managing icon animations
+ */
+export declare function useIconAnimation(options?: UseIconAnimationOptions): UseIconAnimationReturn;
+export default useIconAnimation;
+//# sourceMappingURL=useIconAnimation.d.ts.map

package/lib/typescript/animated/useIconAnimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIconAnimation.d.ts","sourceRoot":"","sources":["../../../src/animated/useIconAnimation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EACV,aAAa,EAEb,iBAAiB,EAEjB,eAAe,EAChB,MAAM,SAAS,CAAC;AAGjB,UAAU,uBAAuB;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,UAAU,sBAAuB,SAAQ,iBAAiB;IACxD;;OAEG;IACH,aAAa,EAAE;QACb,SAAS,CAAC,EAAE,KAAK,CACb;YAAE,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAA;SAAE,GAClD;YAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAA;SAAE,GACzB;YAAE,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAA;SAAE,GAC9B;YAAE,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAA;SAAE,CACjC,CAAC;QACF,OAAO,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;KAC1B,CAAC;IAEF;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,sBAAsB,CA+S9F;AAED,eAAe,gBAAgB,CAAC"}